Crear y configurar perfiles de aplicaciones

En esta página se explica cómo crear y gestionar los perfiles de aplicación, o perfiles de aplicación, de una instancia de Bigtable. También se muestra cómo usar un perfil de aplicación personalizado para conectarse a Bigtable.

Antes de leer esta página, debes saber qué son los perfiles de aplicaciones y cómo funcionan. En concreto, asegúrate de entender la diferencia entre un perfil de aplicación estándar (un perfil de aplicación configurado para usar recursos de computación estándar) y un perfil de aplicación de Data Boost (un perfil de aplicación que usa recursos de computación sin servidor de Data Boost para ejecutar trabajos de lectura de alto rendimiento). Para obtener más información sobre Data Boost y en qué se diferencia de la computación con nodos de clúster aprovisionados, consulta la descripción general de Data Boost.

Si usas perfiles de aplicación estándar para configurar la réplica, también debes familiarizarte con la descripción general de la réplica de Bigtable y consultar los ejemplos de ajustes de réplica para decidir qué ajustes son los más adecuados para tu caso práctico.

Roles obligatorios

Para obtener los permisos que necesitas para crear, configurar o eliminar un perfil de aplicación, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Bigtable (roles/bigtable.admin) en la instancia. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Crear un perfil de aplicación

Puedes crear muchos perfiles de aplicación personalizados diferentes para cada instancia. Usa perfiles de aplicación personalizados para controlar cómo interactúa cada aplicación o cada función distinta de una aplicación con una instancia. Por ejemplo, puedes usar un perfil de aplicación para una aplicación por lotes con el fin de aislar su tráfico en un solo clúster, y otro perfil de aplicación para proporcionar alta disponibilidad a otra aplicación.

Crear un perfil de aplicación estándar

Para crear un perfil de aplicación estándar, sigue estos pasos:

Consola

.
  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia en la que quieras crear el perfil de aplicación.

  3. En el panel de la izquierda, haga clic en Perfiles de aplicación.

  4. Haz clic en Crear perfil de aplicación.

  5. Selecciona Estándar.

  6. Haz clic en Siguiente.

  7. Introduce el ID de perfil de la aplicación.

    El ID de perfil de aplicación es un identificador permanente del perfil de aplicación. Tu aplicación proporciona este ID cuando se conecta a Bigtable.

  8. Escribe una descripción del perfil de la aplicación.

  9. En Enrutamiento de clústeres, selecciona el enrutamiento de un solo clúster o el de varios clústeres. Más información

  10. Si eliges Un solo clúster:

    1. Usa el menú desplegable para seleccionar el clúster al que quieres dirigir las solicitudes.

    2. Si necesitas habilitar las transacciones de una sola fila, marca la casilla Permitir transacciones de una sola fila.

  11. Si eliges Varios clústeres:

    1. Para enrutar las solicitudes a cualquier clúster de la instancia, selecciona Cualquier clúster en el menú desplegable Grupo de clústeres.
    2. Para limitar el enrutamiento de solicitudes a solo algunos clústeres de la instancia (enrutamiento de grupos de clústeres), marque la casilla de cada clúster que quiera incluir en el grupo de enrutamiento y, a continuación, haga clic en Aceptar.
  12. Haz clic en Crear para crear el perfil de la aplicación.

  13. Actualiza el código de tu aplicación para conectarte a Bigtable de forma que utilice el nuevo perfil de aplicación.

gcloud

  1. Si no sabes el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list
    
  2. Usa el bigtable app-profiles create comando para crear un perfil de aplicación:

    gcloud bigtable app-profiles create APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--description=DESCRIPTION] \
        [--force] \
        [--route-any] \
        [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...] \
        [--route-to=CLUSTER_ID] \
        [--transactional-writes] \
        [--priority=PRIORITY] \
        [–-row-affinity]
    

    Proporciona lo siguiente:

    • APP_PROFILE_ID: identificador permanente del perfil de la aplicación.
    • INSTANCE_ID: identificador permanente de la instancia.

    El comando acepta las siguientes marcas opcionales:

    • --description=DESCRIPTION: una descripción detallada del perfil de la aplicación.
    • --force: Ignora las advertencias sobre posibles problemas y conflictos con otros perfiles de aplicaciones.
    • --route-any: Habilita el enrutamiento entre clústeres para enrutar las solicitudes a cualquier clúster disponible.

      No puedes combinar esta marca con las marcas --route-to o --transactional-writes.

    • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: lista de clústeres a los que se deben dirigir las solicitudes. Usa esta opción si quieres enrutar solicitudes solo a algunos de los clústeres de la instancia.

      No puedes combinar esta marca con las marcas --route-to o --transactional-writes.

    • --route-to=CLUSTER_ID: el ID del clúster al que se deben dirigir todas las solicitudes. Este indicador habilita el enrutamiento de un solo clúster.

      No puedes combinar esta marca con la marca --route-any.

    • --transactional-writes: Habilita las transacciones de una sola fila en el perfil de la aplicación.

      No puedes combinar esta marca con las marcas --route-any o --restrict-to.

    • --priority=PRIORITY: el nivel de prioridad que debe usar el perfil de la aplicación. Los valores aceptados son PRIORITY_HIGH, PRIORITY_MEDIUM y PRIORITY_LOW.

    • –-row-affinity: Habilita el enrutamiento de afinidad de filas en el perfil de la aplicación.

      No puedes combinar esta marca con las marcas --route-to o --transactional-writes.

  3. Actualiza el código de tu aplicación para conectarte a Bigtable de forma que utilice el nuevo perfil de aplicación.

Crear un perfil de aplicación de Data Boost

Para crear un perfil de aplicación de Data Boost (un perfil de aplicación que usa el servicio de computación sin servidor de Data Boost), sigue estos pasos. Para asegurarte de que tu carga de trabajo es compatible con Data Boost, consulta las limitaciones.

Consola

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia en la que quieras crear el perfil de aplicación.

  3. En el panel de la izquierda, haga clic en Perfiles de aplicación.

  4. Haz clic en Crear perfil de aplicación.

  5. Selecciona Data Boost.

  6. Haz clic en Siguiente.

  7. Introduce el ID de perfil de la aplicación.

    El ID de perfil de aplicación es un identificador permanente del perfil de aplicación. Tu aplicación proporciona este ID cuando se conecta a Bigtable.

  8. Escribe una descripción del perfil de la aplicación.

  9. En Enrutamiento de clústeres, selecciona el clúster al que quieres enrutar las solicitudes.

  10. Haz clic en Crear perfil de aplicación para crear el perfil de aplicación.

  11. Actualiza el código de tu aplicación para conectarte a Bigtable de forma que utilice el nuevo perfil de aplicación.

gcloud

  1. Si no sabes el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list
    
  2. Usa el gcloud beta bigtable app-profiles create comando para crear un perfil de aplicación:

    gcloud bigtable app-profiles create APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --data-boost \
        --data-boost-compute-billing-owner=HOST_PAYS \
        --route-to=CLUSTER_ID
    

    Proporciona lo siguiente:

    • APP_PROFILE_ID: identificador permanente del perfil de la aplicación.
    • INSTANCE_ID: identificador permanente de la instancia.
    • CLUSTER_ID: el ID del clúster al que se deben dirigir todas las solicitudes. Este indicador habilita el enrutamiento de un solo clúster.

Conectarse con un perfil de aplicación personalizado

Después de crear un perfil de aplicación personalizado, puedes actualizar el código para que tu aplicación use el perfil de aplicación cuando se conecte a Bigtable.

En los siguientes ejemplos se muestra cómo especificar un perfil de aplicación cuando tu aplicación crea un cliente de Bigtable y se conecta a una instancia. Sustituye [APP_PROFILE_ID] por el valor que corresponda.

C#

var client = BigtableClient.Create(appProfileId: "[APP_PROFILE_ID]");

Go

clientConf := bigtable.ClientConfig{AppProfile:"[APP_PROFILE_ID]"}
client, err = bigtable.NewClientWithConfig(ctx, project, instance, clientConf)

Java de HBase

// If using BigtableOptions directly:
optionsBuilder.setAppProfileId("[APP_PROFILE_ID]");

// If using BigtableOptionsFactory:
configuration.set(BigtableOptionsFactory.APP_PROFILE_ID_KEY, "[APP_PROFILE_ID]");

// If using system properties, set "google.bigtable.app_profile.id" to
// "[APP_PROFILE_ID]"

// If using CloudBigtableIO for Cloud Dataflow:
config.withConfiguration(BigtableOptionsFactory.APP_PROFILE_ID_KEY,
                         "[APP_PROFILE_ID]");

Node.js

const bigtable = new Bigtable({appProfileId: '[APP_PROFILE_ID]'});

Python

from google.cloud import bigtable

client = bigtable.Client(project=project_id)
instance = client.instance(instance_id)
table = bigtable.table.Table(table_id, instance, '[APP_PROFILE_ID]')

Actualizar un perfil de aplicación

Puedes ver los perfiles de aplicación de una instancia y actualizar su configuración en cualquier momento. Bigtable te avisa de las actualizaciones que pueden provocar cambios inesperados en el comportamiento.

Para saber cómo cambiar el perfil de una aplicación de estándar a Data Boost o de Data Boost a estándar, consulta Convertir un perfil de aplicación.

Actualizar un perfil de aplicación estándar

Para actualizar un perfil de aplicación estándar, sigue estos pasos:

Consola

.
  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. En la columna Perfiles de aplicación, haz clic en el perfil de aplicación que quieras ver o actualizar.

    Si no ve el perfil de aplicación que quiere editar, puede consultar una lista completa haciendo clic en el nombre de la instancia y, a continuación, en Perfiles de aplicación, en el panel de la izquierda.

  3. Modifique los ajustes según sea necesario y, a continuación, haga clic en Guardar o en Cancelar para salir sin guardar los cambios.

gcloud

  1. Si no sabes el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list
    
  2. Si no sabes el ID del perfil de aplicación, usa el comando bigtable app-profiles list para ver una lista de los perfiles de aplicación de la instancia:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Sustituye INSTANCE_ID por el identificador permanente de la instancia.

  3. (Opcional) Usa el bigtable app-profiles describe comando para ver los ajustes del perfil de la aplicación:

    gcloud bigtable app-profiles describe APP_PROFILE_ID \
        --instance=INSTANCE_ID
    

    Proporciona lo siguiente:

    • APP_PROFILE_ID: identificador permanente del perfil de la aplicación.
    • INSTANCE_ID: identificador permanente de la instancia.
  4. Usa el comando bigtable app-profiles update para actualizar los ajustes del perfil de la aplicación:

    gcloud bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--description=DESCRIPTION] \
        [--force] \
        [--route-any] \
        [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
        [--route-to=CLUSTER_ID] \
        [--transactional-writes] \
        [--row-affinity]
    

    Proporciona lo siguiente:

    • APP_PROFILE_ID: identificador permanente del perfil de la aplicación.
    • INSTANCE_ID: identificador permanente de la instancia.

    El comando acepta las siguientes marcas opcionales:

    • --description=DESCRIPTION: una descripción detallada del perfil de la aplicación.
    • --force: Ignora las advertencias sobre posibles problemas y conflictos con otros perfiles de aplicaciones.
    • --route-any: Habilita el enrutamiento entre clústeres para enrutar las solicitudes a cualquier clúster disponible.

      No puedes combinar esta marca con las marcas --route-to o --transactional-writes.

    • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: lista de clústeres a los que se deben dirigir las solicitudes. Usa esta opción si quieres enrutar solicitudes solo a algunos de los clústeres de la instancia.

      No puedes combinar esta marca con las marcas --route-to o --transactional-writes.

    • --route-to=CLUSTER_ID: el ID del clúster al que se deben dirigir todas las solicitudes. Este indicador habilita el enrutamiento de un solo clúster.

      No puedes combinar esta marca con la marca --route-any.

    • --transactional-writes: Habilita las transacciones de una sola fila en el perfil de la aplicación.

      No puedes combinar esta marca con la marca --route-any.

    • --priority=PRIORITY: nivel de prioridad que usa el perfil de la aplicación. Los valores aceptados son PRIORITY_HIGH, PRIORITY_MEDIUM y PRIORITY_LOW.

Actualizar el perfil de una aplicación de Data Boost

Para actualizar el clúster del que lee un perfil de aplicación de Data Boost, sigue estos pasos:

Consola

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. En la columna Perfiles de aplicación, haz clic en el perfil de aplicación que quieras ver o actualizar.

    Si no ve el perfil de aplicación que quiere editar, puede ver una lista completa haciendo clic en el nombre de la instancia y, a continuación, en Perfiles de aplicación en el panel de la izquierda.

  3. Seleccione el nuevo clúster al que se debe dirigir el tráfico y, a continuación, haga clic en Guardar.

gcloud

  1. Si no sabes el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list
    
  2. Si no sabes el ID del perfil de aplicación, usa el comando bigtable app-profiles list para ver una lista de los perfiles de aplicación de la instancia:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Sustituye INSTANCE_ID por el identificador permanente de la instancia.

  3. (Opcional) Usa el bigtable app-profiles describe comando para ver los ajustes del perfil de la aplicación:

    gcloud bigtable app-profiles describe APP_PROFILE_ID \
        --instance=INSTANCE_ID
    

    Proporciona lo siguiente:

    • APP_PROFILE_ID: identificador permanente del perfil de la aplicación.
    • INSTANCE_ID: identificador permanente de la instancia.
  4. Usa el comando gcloud beta bigtable app-profiles update para actualizar los ajustes del perfil de la aplicación:

    gcloud beta bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --route-to=CLUSTER_ID
    

    Proporciona lo siguiente:

    • APP_PROFILE_ID: identificador permanente del perfil de la aplicación.
    • INSTANCE_ID: identificador permanente de la instancia.
    • CLUSTER_ID: el ID del nuevo clúster del que se va a leer

Convertir un perfil de aplicación

Puedes convertir un perfil de aplicación estándar en un perfil de aplicación Data Boost o viceversa. Antes de convertir un perfil de aplicación, consulta las directrices de Cambios en el perfil de aplicación.

Cambiar de estándar a Data Boost

Antes de actualizar un perfil de aplicación de estándar (nodos aprovisionados para computación) a computación sin servidor de Data Boost, consulta las métricas de elegibilidad de Data Boost. También debes tener en cuenta las limitaciones de Aumento de datos.

Consola

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. En la columna Perfiles de aplicación, haga clic en el perfil de aplicación que quiera actualizar.

    Si no ve el perfil de aplicación que quiere editar, puede consultar una lista completa haciendo clic en el nombre de la instancia y, a continuación, en Perfiles de aplicación, en el panel de la izquierda.

  3. Selecciona Data Boost.

  4. Selecciona el clúster al que se deben dirigir las solicitudes.

  5. Haz clic en Guardar.

gcloud

  1. Si no sabes el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list
    
  2. Si no sabes el ID del perfil de aplicación, usa el comando bigtable app-profiles list para ver una lista de los perfiles de aplicación de la instancia:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Sustituye INSTANCE_ID por el identificador permanente de la instancia.

  3. (Opcional) Usa el bigtable app-profiles describe comando para ver los ajustes del perfil de la aplicación:

    gcloud bigtable app-profiles describe APP_PROFILE_ID \
        --instance=INSTANCE_ID
    

    Proporciona lo siguiente:

    • APP_PROFILE_ID: identificador permanente del perfil de la aplicación.
    • INSTANCE_ID: identificador permanente de la instancia.
  4. Usa el comando gcloud beta bigtable app-profiles update para convertir un perfil de aplicación de estándar a Data Boost:

    gcloud bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --data-boost \
        --data-boost-compute-billing-owner=HOST_PAYS \
        --route-to=CLUSTER_ID
    

    Proporciona lo siguiente:

    • APP_PROFILE_ID: identificador permanente del perfil de la aplicación.
    • INSTANCE_ID: identificador permanente de la instancia.
    • CLUSTER_ID: el ID del clúster al que se deben dirigir todas las solicitudes. Este indicador habilita el enrutamiento de un solo clúster.

Cambiar de Data Boost a estándar

Para cambiar un perfil de aplicación de Data Boost (computación sin servidor) a estándar (nodos aprovisionados para computación), sigue estos pasos:

Consola

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. En la columna Perfiles de aplicación, haga clic en el perfil de aplicación que quiera actualizar.

    Si no ve el perfil de aplicación que quiere editar, puede consultar una lista completa haciendo clic en el nombre de la instancia y, a continuación, en Perfiles de aplicación, en el panel de la izquierda.

  3. Selecciona Estándar.

  4. Haz clic en Siguiente.

  5. Opcional: Edita la descripción del perfil de aplicación.

  6. En Enrutamiento de clústeres, selecciona el enrutamiento de un solo clúster o el de varios clústeres. Más información

  7. Si eliges Un solo clúster:

    1. Usa el menú desplegable para seleccionar el clúster al que quieres dirigir las solicitudes.

    2. Si necesitas habilitar las transacciones de una sola fila, marca la casilla Permitir transacciones de una sola fila.

  8. Si eliges Varios clústeres:

    1. Para enrutar las solicitudes a cualquier clúster de la instancia, selecciona Cualquier clúster en el menú desplegable Grupo de clústeres.
    2. Para limitar el enrutamiento de solicitudes a solo algunos clústeres de la instancia (enrutamiento de grupos de clústeres), marque la casilla de cada clúster que quiera incluir en el grupo de enrutamiento y, a continuación, haga clic en Aceptar.
  9. Haz clic en Guardar.

gcloud

  1. Si no sabes el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list
    
  2. Si no sabes el ID del perfil de aplicación, usa el comando bigtable app-profiles list para ver una lista de los perfiles de aplicación de la instancia:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Sustituye INSTANCE_ID por el identificador permanente de la instancia.

  3. (Opcional) Usa el bigtable app-profiles describe comando para ver los ajustes del perfil de la aplicación:

    gcloud bigtable app-profiles describe APP_PROFILE_ID \
        --instance=INSTANCE_ID
    
  4. Usa el gcloud beta bigtable app-profiles update comando para convertir el perfil de la aplicación:

    gcloud bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        --standard \
        [--route-any] \
        [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
        [--route-to=CLUSTER_ID] \
        [--transactional-writes]
    

Proporciona lo siguiente:

  • APP_PROFILE_ID: identificador permanente del perfil de la aplicación.
  • INSTANCE_ID: identificador permanente de la instancia.

El comando acepta las siguientes marcas opcionales:

  • --route-any: Habilita el enrutamiento entre clústeres para enrutar las solicitudes a cualquier clúster disponible.

    No puedes combinar esta marca con las marcas --route-to o --transactional-writes.

  • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: lista de clústeres a los que se deben dirigir las solicitudes. Usa esta opción si quieres enrutar solicitudes solo a algunos de los clústeres de la instancia.

    No puedes combinar esta marca con las marcas --route-to o --transactional-writes.

  • --route-to=CLUSTER_ID: el ID del clúster al que se deben dirigir todas las solicitudes. Este indicador habilita el enrutamiento de un solo clúster.

    No puedes combinar esta marca con la marca --route-any.

  • --transactional-writes: Habilita las transacciones de una sola fila en el perfil de la aplicación.

    No puedes combinar esta marca con las marcas --route-any o --restrict-to.

Eliminar un perfil de aplicación

Puedes eliminar los perfiles de aplicación personalizados de una instancia, pero no el perfil de aplicación predeterminado.

Para eliminar un perfil de aplicación personalizado, sigue estos pasos:

Consola

  1. Abre la lista de instancias de Bigtable en la Google Cloud consola.

    Abrir la lista de instancias

  2. Haz clic en la instancia que contenga el perfil de aplicación que quieras eliminar.

  3. En el panel de la izquierda, haga clic en Perfiles de aplicación.

  4. Abre el menú Más acciones y, a continuación, haz clic en Eliminar perfil de aplicación. Aparecerá un cuadro de diálogo de confirmación.

  5. Sigue las instrucciones del cuadro de diálogo de confirmación y, a continuación, haz clic en Eliminar.

gcloud

  1. Si no sabes el ID de la instancia, usa el comando bigtable instances list para ver una lista de las instancias de tu proyecto:

    gcloud bigtable instances list
    
  2. Si no sabes el ID del perfil de aplicación, usa el comando bigtable app-profiles list para ver una lista de los perfiles de aplicación de la instancia:

    gcloud bigtable app-profiles list --instance=INSTANCE_ID
    

    Sustituye INSTANCE_ID por el identificador permanente de la instancia.

  3. Usa el bigtable app-profiles delete comando para eliminar el perfil de la aplicación:

    gcloud bigtable app-profiles delete APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--force]
    

    Proporciona lo siguiente:

    • APP_PROFILE_ID: identificador permanente del perfil de la aplicación.
    • INSTANCE_ID: identificador permanente de la instancia.

    El comando acepta la siguiente marca opcional:

    --force: Ignora las advertencias sobre posibles problemas y conflictos con otros perfiles de aplicaciones.