Crea y configura perfiles de app

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

Antes de leer esta página, debes comprender qué son los perfiles de app y cómo funcionan. En particular, asegúrate de comprender la diferencia entre un perfil de aplicación estándar (un perfil de aplicación que configuras para usar la computación estándar) y un perfil de aplicación de Data Boost (un perfil de aplicación que usa la computación sin servidores de Data Boost para ejecutar trabajos de lectura de alta capacidad de procesamiento). Para obtener más información sobre Data Boost y cómo 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 replicación, familiarízate con la descripción general de la replicación de Bigtable, revisa los ejemplos de configuración de la replicación y decide qué configuración es la mejor para tu caso de uso.

Si usas un perfil de app de nivel en la memoria (versión preliminar), familiarízate con la descripción general del nivel en la memoria.

Roles obligatorios

Para obtener los permisos que necesitas para crear, configurar o borrar un perfil de app, pídele a tu administrador que te otorgue el rol de IAM administrador de Bigtable (roles/bigtable.admin) en la instancia. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Crea un perfil de aplicación

Puedes crear muchos perfiles de app 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.

Crea un perfil de aplicación estándar

Para crear un perfil de app estándar, sigue estos pasos:

Console

  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 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. Selecciona Estándar.

  6. Haz clic en Siguiente.

  7. 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 Bigtable.

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

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

  10. Si eliges Un solo clúster, sigue estos pasos:

    1. En la lista Clúster, selecciona el clúster al que se enrutarán las solicitudes.

    2. Si necesitas habilitar las transacciones de fila única, selecciona la casilla de verificación Permitir transacciones de fila única.

  11. Si eliges Varios clústeres:

    1. En la lista Grupo de clústeres, para enrutar solicitudes a cualquier clúster de la instancia, selecciona Cualquier clúster.
    2. Para limitar el enrutamiento de solicitudes a solo algunos clústeres de la instancia (enrutamiento de grupo de clústeres), selecciona cada clúster que desees incluir en el grupo de enrutamiento y, luego, haz clic en Aceptar.
    3. Para enrutar las solicitudes de lectura y escritura de una sola fila a un clúster específico en función de la clave de fila de la solicitud, selecciona Habilitar la afinidad de filas.

  12. En Selecciona una prioridad de enrutamiento, asigna una prioridad de enrutamiento a tus solicitudes seleccionando una de las siguientes opciones:

    • Alta: Se usa para solicitudes sensibles a la latencia.
    • Medio: Se usa para solicitudes de uso general.
    • Bajo: Se usa para tareas en segundo plano o operaciones menos urgentes.

  13. Para crear el perfil de la app, haz clic en Crear.

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

gcloud

  1. Si no conoces 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 app:

    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]

    Proporcione lo siguiente:

    • 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: Una descripción detallada del perfil de la app.
    • --force: Ignora las advertencias sobre posibles problemas y conflictos con otros perfiles de aplicación.

    • --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 o --transactional-writes.

    • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: Es una lista de clústeres a los que se deben enrutar las solicitudes. Usa esta opción si deseas 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: Es el ID del 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 app.

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

    • --priority=PRIORITY: Es el nivel de prioridad que debe usar el perfil de la app. Los valores aceptados son PRIORITY_HIGH, PRIORITY_MEDIUM o PRIORITY_LOW.

    • --row-affinity: Habilita el enrutamiento por afinidad de fila en el perfil de la app.

      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 a fin de usar el nuevo perfil de la aplicación.

Crea un perfil de app de nivel en la memoria

Para crear un perfil de app en un clúster con el nivel en memoria habilitado, sigue estos pasos:

Console

  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 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. Selecciona Nivel en la memoria.

  6. Haz clic en Siguiente.

  7. 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 Bigtable.

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

  9. En Enrutamiento del clúster, selecciona un clúster con el nivel en memoria habilitado.

    Los clústeres de nivel en la memoria deben usar el enrutamiento de un solo clúster.

  10. Si necesitas habilitar las transacciones de fila única, selecciona Permitir transacciones de fila única.

  11. En Selecciona una prioridad de enrutamiento, asigna una prioridad de enrutamiento a tus solicitudes seleccionando una de las siguientes opciones:

    • Alta: Se usa para solicitudes sensibles a la latencia.
    • Medio: Se usa para solicitudes de uso general.
    • Bajo: Se usa para tareas en segundo plano o operaciones menos urgentes.

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

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

gcloud

  1. Si no conoces 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 gcloud beta bigtable app-profiles create para crear un perfil de app:

    gcloud beta bigtable app-profiles create APP_PROFILE_ID \
    --instance=INSTANCE_ID \
    --route-to=CLUSTER_ID \
    --use-memory-layer \
    [--description=DESCRIPTION] \
    [--transactional-writes] \
    [--priority=PRIORITY]

    Proporcione lo siguiente:

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

    El comando acepta las siguientes marcas opcionales:

    • --route-to=CLUSTER_ID: Es el ID del clúster al que se deben enrutar todas las solicitudes. Esta marca habilita el enrutamiento de un solo clúster.
    • --use-memory-layer: Enruta las solicitudes con este perfil de la app al nivel en memoria. Esta marca se limita a la edición Enterprise Plus y al enrutamiento de un solo clúster.
    • --description=DESCRIPTION: Una descripción detallada del perfil de la app.
    • --transactional-writes: Habilita las transacciones de fila única en el perfil de la app.
    • --priority=PRIORITY: Es el nivel de prioridad de las solicitudes enviadas con el perfil de la app. Los valores aceptados son PRIORITY_HIGH, PRIORITY_MEDIUM o PRIORITY_LOW. Las prioridades de solicitud no afectan las solicitudes aptas para el nivel en memoria.

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

Crea un perfil de app de Data Boost

Para crear un perfil de aplicación de Data Boost, es decir, un perfil de aplicación que usa la computación sin servidores de Data Boost, sigue estos pasos. Para asegurarte de que tu carga de trabajo sea compatible con Data Boost, revisa las limitaciones.

Console

  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 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. Selecciona Data Boost.

  6. Haz clic en Siguiente.

  7. 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 Bigtable.

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

  9. En Enrutamiento del clúster, selecciona el clúster al que se enrutarán las solicitudes.

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

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

gcloud

  1. Si no conoces 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 gcloud beta bigtable app-profiles create para crear un perfil de app:

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

    Proporcione lo siguiente:

    • APP_PROFILE_ID: Identificador permanente del perfil de la app.
    • INSTANCE_ID: Identificador permanente de la instancia.
    • CLUSTER_ID: Es el ID del clúster al que se deben enrutar todas las solicitudes. Esta marca habilita el enrutamiento de un solo clúster.

Conéctate con un perfil de app personalizado

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

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

C#

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

Comienza a usarlo

clientConf := bigtable.ClientConfig