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
.Abre la lista de instancias de Bigtable en la Google Cloud consola.
Haz clic en la instancia en la que quieras crear el perfil de aplicación.
En el panel de la izquierda, haga clic en Perfiles de aplicación.
Haz clic en Crear perfil de aplicación.
Selecciona Estándar.
Haz clic en Siguiente.
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.
Escribe una descripción del perfil de la aplicación.
En Enrutamiento de clústeres, selecciona el enrutamiento de un solo clúster o el de varios clústeres. Más información
Si eliges Un solo clúster:
Usa el menú desplegable para seleccionar el clúster al que quieres dirigir las solicitudes.
Si necesitas habilitar las transacciones de una sola fila, marca la casilla Permitir transacciones de una sola fila.
Si eliges Varios clústeres:
- Para enrutar las solicitudes a cualquier clúster de la instancia, selecciona Cualquier clúster en el menú desplegable Grupo de clústeres.
- 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.
Haz clic en Crear para crear el perfil de la aplicación.
Actualiza el código de tu aplicación para conectarte a Bigtable de forma que utilice el nuevo perfil de aplicación.
gcloud
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
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 sonPRIORITY_HIGH
,PRIORITY_MEDIUM
yPRIORITY_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
.
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
Abre la lista de instancias de Bigtable en la Google Cloud consola.
Haz clic en la instancia en la que quieras crear el perfil de aplicación.
En el panel de la izquierda, haga clic en Perfiles de aplicación.
Haz clic en Crear perfil de aplicación.
Selecciona Data Boost.
Haz clic en Siguiente.
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.
Escribe una descripción del perfil de la aplicación.
En Enrutamiento de clústeres, selecciona el clúster al que quieres enrutar las solicitudes.
Haz clic en Crear perfil de aplicación para crear el perfil de aplicación.
Actualiza el código de tu aplicación para conectarte a Bigtable de forma que utilice el nuevo perfil de aplicación.
gcloud
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
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
.Abre la lista de instancias de Bigtable en la Google Cloud consola.
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.
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
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
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.(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.
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 sonPRIORITY_HIGH
,PRIORITY_MEDIUM
yPRIORITY_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
Abre la lista de instancias de Bigtable en la Google Cloud consola.
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.
Seleccione el nuevo clúster al que se debe dirigir el tráfico y, a continuación, haga clic en Guardar.
gcloud
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
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.(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.
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
Abre la lista de instancias de Bigtable en la Google Cloud consola.
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.
Selecciona Data Boost.
Selecciona el clúster al que se deben dirigir las solicitudes.
Haz clic en Guardar.
gcloud
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
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.(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.
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
Abre la lista de instancias de Bigtable en la Google Cloud consola.
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.
Selecciona Estándar.
Haz clic en Siguiente.
Opcional: Edita la descripción del perfil de aplicación.
En Enrutamiento de clústeres, selecciona el enrutamiento de un solo clúster o el de varios clústeres. Más información
Si eliges Un solo clúster:
Usa el menú desplegable para seleccionar el clúster al que quieres dirigir las solicitudes.
Si necesitas habilitar las transacciones de una sola fila, marca la casilla Permitir transacciones de una sola fila.
Si eliges Varios clústeres:
- Para enrutar las solicitudes a cualquier clúster de la instancia, selecciona Cualquier clúster en el menú desplegable Grupo de clústeres.
- 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.
Haz clic en Guardar.
gcloud
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
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.(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
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
Abre la lista de instancias de Bigtable en la Google Cloud consola.
Haz clic en la instancia que contenga el perfil de aplicación que quieras eliminar.
En el panel de la izquierda, haga clic en Perfiles de aplicación.
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.Sigue las instrucciones del cuadro de diálogo de confirmación y, a continuación, haz clic en Eliminar.
gcloud
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
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.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.