Configura perfiles de aplicación

En esta página se explica cómo crear y administrar los perfiles de aplicación, o perfiles de app, de una instancia de Cloud Bigtable. Además, se muestra cómo usar un perfil de la app personalizado para conectarse con Cloud Bigtable.

Antes de leer esta página, debes comprender qué son los perfiles de app y cómo funcionan. Si usas los perfiles de aplicación con el objetivo de configurar la replicación, debes estar familiarizado con la descripción general de la replicación de Cloud Bigtable y debes revisar los ejemplos de configuración de la replicación, a fin de decidir qué configuración es la mejor para tu caso práctico.

Crea un perfil de la app personalizado

Puedes crear muchos perfiles de app diferentes y personalizados para cada instancia. Úsalos para controlar la manera en que las aplicaciones o las funciones de estas interactúan con una instancia. Por ejemplo, puedes usar un perfil de app en una aplicación por lote para separar su tráfico en un solo clúster, y otro para proporcionar una alta disponibilidad a otra aplicación.

Sigue estos pasos para crear un perfil de aplicación personalizado:

Console

  1. Abre la lista de instancias de Cloud Bigtable en GCP Console.

    Abrir la lista de instancias

  2. Haz clic en la instancia en la que deseas crear el perfil de la app.

  3. En el panel izquierdo, haz clic en Perfiles de aplicación.

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

  5. Ingresa el ID de perfil de aplicación.

    El ID de perfil de la aplicación es un identificador permanente para el perfil de la app. Tu aplicación proporciona este ID cuando se conecta a Cloud Bigtable.

  6. Ingresa una descripción del perfil de la app.

  7. Selecciona un ID de clúster en Enrutamiento de clúster, a fin de usar enrutamiento de un solo clúster o cualquier clúster para usar enrutamiento de varios clústeres. Más información

  8. En Transacciones de fila única, selecciona la casilla de verificación Permitir transacciones de fila única si necesitas habilitar esta opción. Más información

    Debes habilitar el enrutamiento de un solo clúster para habilitar transacciones de fila única.

  9. Haz clic en Crear para crear el perfil de la app.

  10. Actualiza el código de tu aplicación para conectarte a Cloud Bigtable a fin de usar el nuevo perfil de la 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 comando bigtable app-profiles create para crear un perfil de aplicación:

    gcloud bigtable app-profiles create APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--description=DESCRIPTION] \
        [--force] \
        [--route-any] \
        [--route-to=CLUSTER_ID] \
        [--transactional-writes]
    

    Ingresa los siguientes valores:

    • APP_PROFILE_ID: Identificador permanente del perfil de la app
    • INSTANCE_ID: Identificador permanente de la instancia

    El comando acepta las siguientes marcas opcionales:

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

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

    • --route-to=CLUSTER_ID: El ID de clúster al que se deben enrutar todas las solicitudes. Esta marca habilita el enrutamiento de un solo clúster.

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

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

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

  3. Actualiza el código de tu aplicación para conectarte a Cloud Bigtable a fin de usar el nuevo perfil de la aplicación.

Conéctate con un perfil de la app personalizado

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

En los siguientes ejemplos se muestra cómo especificar un perfil de aplicación cuando tu aplicación crea un cliente de Cloud Bigtable y se conecta a una instancia. Reemplaza [APP_PROFILE_ID] con el valor apropiado.

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)

HappyBase

La biblioteca cliente de HappyBase no admite perfiles de app personalizados. Esta biblioteca cliente siempre utiliza el perfil de la app predeterminado.

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]')

Actualiza el perfil de la app

Puedes ver los perfiles de app de una instancia y actualizar su configuración en cualquier momento. Cloud Bigtable te advierte sobre cualquier actualización que pueda causar cambios de comportamiento inesperados.

Sigue estos pasos para ver o actualizar un perfil de la app existente:

Console

  1. Abre la lista de instancias de Cloud Bigtable en GCP Console.

    Abrir la lista de instancias

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

    Si no ves el perfil de la app que deseas editar, puedes ver la lista completa si haces clic en el nombre de la instancia y, luego, en Perfiles de la aplicación en el panel izquierdo.

  3. Actualiza la configuración según sea necesario, luego haz clic en Guardar, o puedes hacer clic en Cancelar para salir sin 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 la 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
    

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

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

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

    Ingresa los siguientes valores:

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

    gcloud bigtable app-profiles update APP_PROFILE_ID \
        --instance=INSTANCE_ID \
        [--description=DESCRIPTION] \
        [--force] \
        [--route-any] \
        [--route-to=CLUSTER_ID] \
        [--transactional-writes]
    

    Ingresa los siguientes valores:

    • APP_PROFILE_ID: Identificador permanente del perfil de la app
    • INSTANCE_ID: Identificador permanente de la instancia

    El comando acepta las siguientes marcas opcionales:

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

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

    • --route-to=CLUSTER_ID: El ID de clúster al que se deben enrutar todas las solicitudes. Esta marca habilita el enrutamiento de un solo clúster.

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

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

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

Borra un perfil de app personalizado

Puedes borrar los perfiles de app personalizados de una instancia, pero no el perfil de la app predeterminado.

Sigue estos pasos para borrar un perfil de la app personalizado:

Console

  1. Abre la lista de instancias de Cloud Bigtable en GCP Console.

    Abrir la lista de instancias

  2. Haz clic en la instancia que contiene el perfil de la app que deseas borrar.

  3. En el panel izquierdo, haz clic en Perfiles de aplicación.

  4. Abre el menú Más acciones, y luego haz clic en Borrar perfil de la aplicación. Aparecerá un diálogo de confirmación.

  5. Sigue las instrucciones del diálogo de confirmación y haz clic en Borrar.

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 la 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
    

    Reemplaza INSTANCE_ID con el identificador permanente de la instancia.

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

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

    Ingresa los siguientes valores:

    • APP_PROFILE_ID: Identificador permanente del perfil de la app
    • 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 aplicación.

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Documentación de Cloud Bigtable