Crea y actualiza contadores en Bigtable

Antes de comenzar

Sign in to your Google Account.

If you don't already have one, sign up for a new account.

Install the Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a 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

Create or select a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Bigtable API and Cloud Bigtable Admin API APIs:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

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

Install the Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a 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

Create or select a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Bigtable API and Cloud Bigtable Admin API APIs:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant 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 de agregación, 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. Ahora, la tabla 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 }

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que se usaron 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