Crea y actualiza contadores en Bigtable

Crea y actualiza contadores en Bigtable

Aprende a crear y actualizar contadores en Bigtable con agregados, celdas de tablas que agregan valores en el momento de la escritura. En esta guía de inicio rápido, se usan Google Cloud CLI y la CLI de cbt para crear tres contadores:

• Un contador que mantiene una suma acumulada
• Es un contador que registra el valor mínimo de todos los valores agregados.
• Es un contador que realiza un seguimiento del máximo de todos los valores agregados.

Antes de comenzar

Accede a tu Cuenta de Google.

Si todavía no tienes una cuenta, regístrate para obtener una nueva.

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Después de inicializar gcloud CLI, actualízala y, luego, instala los componentes necesarios:

gcloud components update
gcloud components install cbt

Crea o selecciona un Google Cloud proyecto.

Roles necesarios para seleccionar o crear un proyecto

• Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Obtén más información para otorgar roles.

Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Crea un proyecto de Google Cloud :

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el proyecto Google Cloud que estás creando.

• Selecciona el proyecto Google Cloud que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

Habilita las APIs de Cloud Bigtable y Cloud Bigtable Admin:

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Después de inicializar gcloud CLI, actualízala y, luego, instala los componentes necesarios:

gcloud components update
gcloud components install cbt

Crea o selecciona un Google Cloud proyecto.

Roles necesarios para seleccionar o crear un proyecto

• Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Obtén más información para otorgar roles.

Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Crea un proyecto de Google Cloud :

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el proyecto Google Cloud que estás creando.

• Selecciona el proyecto Google Cloud que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto.

Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

Habilita las APIs de Cloud Bigtable y Cloud Bigtable Admin:

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com

1. Ejecuta los siguientes comandos para asegurarte de que gcloud CLI esté actualizada y que incluya la CLI de cbt:

   gcloud components update

   gcloud components install cbt

Crear una instancia de Bigtable.

1. Usa el comando bigtable instances create para crear una instancia.

   gcloud bigtable instances create counters-quickstart-instance \
       --display-name="Counters quickstart instance" \
       --cluster-config=id="counters-quickstart-cluster",zone="us-east1-c"
   

Conéctate a la instancia

1. Configura la CLI de cbt para que use tu instancia y proyecto. Para ello, crea un archivo .cbtrc.

   echo project = PROJECT_ID >> ~/.cbtrc && echo instance = counters-quickstart-instance >> ~/.cbtrc
   

   Reemplaza PROJECT_ID por el ID del proyecto que estás usando.

2. Verifica que hayas configurado correctamente el archivo .cbtrc.

   cat ~/.cbtrc
   

   La terminal muestra el contenido del archivo .cbtrc, que es similar a lo siguiente:

   project = PROJECT_ID
   instance = counters-quickstart-instance

   Ahora puedes usar la CLI de cbt con tu instancia.

Crea una tabla con familias de columnas de agregación

1. Usa el comando cbt createtable para crear una tabla llamada counters_quickstart_table que tenga tres familias de columnas agregadas. Configura cada familia de columnas con un tipo de agregación diferente:

   • La familia de columnas max_family es de tipo Max con un tipo de entrada de Integer.
   • La familia de columnas min_family es de tipo Min con un tipo de entrada de Integer.
   • La familia de columnas sum_family es de tipo Sum con un tipo de entrada de Integer.

   cbt createtable counters_quickstart_table families=sum_family:never:intsum,min_family:never:intmin,max_family:never:intmax
   

2. Ejecuta el comando cbt ls para generar una lista de tus familias de columnas.

   cbt ls counters_quickstart_table
   

   La shell muestra un resultado similar al siguiente:

   Family Name     GC Policy
   -----------     ---------
   max_family      <never>
   min_family      <never>
   sum_family      <never>
   

Crea contadores en la tabla

1. Usa el comando cbt addtocell para escribir un valor inicial de 5 en una columna nueva de cada una de las tres familias de columnas, con una clave de fila de row-key1 y una marca de tiempo de 0. Esta operación crea celdas agregadas, que se usan como contadores.

   cbt addtocell counters_quickstart_table row-key1 sum_family:sum_column=5@0
   cbt addtocell counters_quickstart_table row-key1 min_family:min_column=5@0
   cbt addtocell counters_quickstart_table row-key1 max_family:max_column=5@0
   

Cómo leer los datos

1. Para ver los valores del contador como números enteros en lugar de bytes, define un archivo yaml que la CLI de cbt pueda usar para dar formato al resultado. Ejecuta lo siguiente:

   echo "families:" > cbtformat.yaml
   echo "  max_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   echo "  min_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   echo "  sum_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   

2. Verifica que hayas configurado correctamente el archivo cbtformat.yaml.

   cat ~/cbtformat.yaml
   

   La terminal muestra el contenido del archivo cbtformat.yaml, que es similar a lo siguiente:

   families:
     max_family:
       default_encoding: BigEndian
       default_type: INT64
     min_family:
       default_encoding: BigEndian
       default_type: INT64
     sum_family:
       default_encoding: BigEndian
       default_type: INT64
   

3. Usa el comando cbt read para pasar el archivo yaml y leer los datos que agregaste a la tabla. La tabla ahora tiene tres columnas, cada una con un tipo de agregación diferente.

   cbt read counters_quickstart_table format-file=$HOME/cbtformat.yaml
   

   La shell muestra un resultado similar al siguiente. Los valores tienen formato de números enteros y las marcas de tiempo están en formato UTC.

   row-key1
     max_family:max_column                    @ 1970/01/01-00:00:00.000000
       5
     min_family:min_column                    @ 1970/01/01-00:00:00.000000
       5
     sum_family:sum_column                    @ 1970/01/01-00:00:00.000000
       5
   

Actualiza los contadores

1. Agrega un valor de 3 a cada columna de la tabla con las mismas marcas de tiempo que usaste cuando creaste las celdas. En cada columna, el valor de la celda se combina con el valor existente según el tipo de agregación de la celda.

   cbt addtocell counters_quickstart_table row-key1 sum_family:sum_column=3@0
   cbt addtocell counters_quickstart_table row-key1 min_family:min_column=3@0
   cbt addtocell counters_quickstart_table row-key1 max_family:max_column=3@0
   

2. Vuelve a usar el comando cbt read para leer los datos de la tabla. Cada celda ahora contiene un valor agregado.

   cbt read counters_quickstart_table format-file=$HOME/cbtformat.yaml
   

   sum_column contiene la suma de 5 y 3 (8), min_column contiene el mínimo de los dos valores que se escribieron en él (3) y max_column contiene el máximo de los dos valores que se escribieron en él (5).

   row-key1
       max_family:max_column                    @ 1970/01/01-00:00:00.000000
           5
       min_family:min_column                    @ 1970/01/01-00:00:00.000000
           3
       sum_family:sum_column                    @ 1970/01/01-00:00:00.000000
           8
   

3. Opcional: Consulta la tabla en la consola de Google Cloud con SQL.

   1. En la consola de Google Cloud , abre la página Instancias de Bigtable.

      Ir a la lista de instancias

   2. Selecciona counters-quickstart-instance en la lista.

   3. En el menú de navegación, haz clic en Bigtable Studio.

   4. Haz clic en la pestaña Editor.

   5. Pega esta consulta en el editor:

      SELECT * FROM `counters_quickstart_table`
      

   6. Haz clic en Ejecutar. Los resultados de la consulta se muestran en la tabla Resultados y se ven de la siguiente manera:

   _key	max_family	min_family	sum_family
   row-key1	{ "max_column": 5 }	{ "min_column": 5 }	{ "sum_column": 8 }

Realiza una limpieza

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página, borra el proyecto de Google Cloud que tiene los recursos.

1. En la terminal, borra la tabla counters_quickstart_table:

   cbt deletetable counters_quickstart_table
   

2. Borra la instancia:

   cbt deleteinstance counters-quickstart-instance
   

3. Borra el archivo .cbtrc:

   rm ~/.cbtrc
   

4. Borra el archivo de formato:

   rm ~/cbtformat.yaml
   

5. Opcional: Revoca credenciales desde gcloud CLI:

   gcloud auth revoke
   

¿Qué sigue?

• Obtén más información sobre los agregados.
• Usar SQL para consultar datos de Bigtable