Crea una instancia y escribe datos con la CLI de “cbt”

Si estás aprendiendo sobre Bigtable, puedes trabajar con una guía de inicio rápido para conocer los conceptos básicos que aplicarías a gran escala en un entorno de producción.

En esta guía de inicio rápido, harás lo siguiente:

  • Conéctate a una instancia de Bigtable.
  • Realizar tareas administrativas básicas
  • Escribir datos en una tabla
  • Leer datos de una tabla

Antes de comenzar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. Install the Google Cloud CLI.

  3. To initialize the gcloud CLI, run the following command: 

    gcloud init

  4. Create or select a Google Cloud project.

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

  5. Make sure that billing is enabled for your Google Cloud project.

  6. Enable the Cloud Bigtable and Cloud Bigtable Admin APIs: 

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

  7. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/bigtable.admin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="USER_IDENTIFIER" --role=ROLE
    • Replace PROJECT_ID with your project ID.

    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:myemail@example.com.

    • Replace ROLE with each individual role.
    8.
  8. Install the Google Cloud CLI.

  9. To initialize the gcloud CLI, run the following command: 

    gcloud init

  10. Create or select a Google Cloud project.

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

  11. Make sure that billing is enabled for your Google Cloud project.

  12. Enable the Cloud Bigtable and Cloud Bigtable Admin APIs: 

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

  13. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/bigtable.admin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="USER_IDENTIFIER" --role=ROLE
    • Replace PROJECT_ID with your project ID.

    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:myemail@example.com.

    • Replace ROLE with each individual role.
    14.
  14. Ejecuta el siguiente comando para instalar la CLI de cbt: 
    gcloud components install cbt

Crear una instancia de Bigtable.

  1. Abre la página Crear instancia en la consola de Google Cloud.

    Crea una instancia

  2. En Nombre de la instancia, ingresa Quickstart instance.

  3. En ID de instancia (Instance ID), ingresa quickstart-instance.

  4. Haga clic en Continuar.

  5. En Tipo de almacenamiento (Storage type), selecciona SSD.

  6. Haga clic en Continuar.

  7. En ID de clúster, ingresa quickstart-instance-c1.

  8. En Región, selecciona una región cercana.

  9. En Zona, selecciona Cualquier.

  10. En Modo de escalamiento de nodos, elige Asignación manual.

  11. En Cantidad, selecciona 1.

  12. Haz clic en Crear para crear la instancia.

Conéctese a su instancia

  1. Configura la CLI de cbt para que use tu instancia y proyecto. Para ello, crea un archivo .cbtrc y reemplaza PROJECT_ID por el ID del proyecto en el que creaste la instancia de Bigtable:

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

  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 = quickstart-instance

    Ahora puedes usar la CLI de cbt con tu instancia.

Lee y escribe datos

Bigtable almacena datos en tablas, las cuales contienen filas. Cada fila se identifica con una clave de fila.

Los datos de una fila se organizan en familias de columnas, que son grupos de columnas. Un calificador de columna identifica una columna individual dentro de una familia.

Puede haber varias celdas con marcas de tiempo en la intersección de una fila y una columna.

  1. Crea una tabla con el nombre my-table.

    cbt createtable my-table

  2. Genera una lista de tus tablas:

    cbt ls

    El comando muestra un resultado similar a este:

        my-table

  3. Agrega una familia de columnas con el nombre cf1:

    cbt createfamily my-table cf1

  4. Genera una lista de tus familias de columnas:

    cbt ls my-table

    El comando muestra un resultado similar a este:

        Family Name     GC Policy
    -----------     ---------
    cf1             <never>

  5. Escribe los valores test-value1 y test-value2 en la fila r1 con la familia de columnas cf1 y el calificador de columna c1:

    cbt set my-table r1 cf1:c1=test-value1
  cbt set my-table r1 cf1:c1=test-value2

  6. Usa el comando cbt read para leer los datos que agregaste a la tabla:

    cbt read my-table

    La shell muestra un resultado similar al siguiente:

        ----------------------------------------
    r1
      cf1:c1                                   @ 2023/03/22-06:56:11.323000
        "test-value1"
      cf1:c1                                   @ 2023/03/22-06:56:04.361000
        "test-value2"

    Se almacenan dos valores con marca de tiempo para la misma columna en la fila r1.

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta guía de inicio rápido, borra la instancia. Si borras el archivo .cbtrc, estarás listo para trabajar en otro proyecto.

  1. Borra la tabla my-table:

    cbt deletetable my-table

  2. Borra la instancia:

    cbt deleteinstance quickstart-instance

  3. Borra el archivo .cbtrc: 

    rm ~/.cbtrc

  4. Opcional: Revoca credenciales desde gcloud CLI:

    gcloud auth revoke

¿Qué sigue?