Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.
Guía de inicio rápido: Crea una instancia y escribe datos con la CLI de cbt

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

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

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

  • Conectarse a una instancia de Bigtable
  • Realizar tareas administrativas básicas
  • Escribir datos en una tabla
  • Leer datos de una tabla

Para obtener una versión de esta guía de inicio rápido que usa la shell de HBase en lugar de Google Cloud CLI, consulta la guía de inicio rápido con la shell de HBase. Si no tienes preferencias para HBase, sigue la guía de inicio rápido de esta página.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. Instala y, luego, inicializa Google Cloud CLI.
  3. Crea o selecciona un proyecto de Google Cloud.

    • Crea un proyecto de Cloud:

      gcloud projects create PROJECT_ID
    • Selecciona el proyecto de Cloud que creaste:

      gcloud config set project PROJECT_ID
  4. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  5. Habilita las APIs de Cloud Bigtable and Cloud Bigtable Admin:

    gcloud services enable bigtable.googleapis.combigtableadmin.googleapis.com
  6. Otorga roles a tu Cuenta de Google. Ejecuta el siguiente comando una vez para cada uno de los siguientes roles de IAM: roles/bigtable.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • Reemplaza PROJECT_ID con el ID del proyecto.
    • Reemplaza EMAIL_ADDRESS por tu dirección de correo electrónico.
    • Reemplaza ROLE por cada rol individual.
  7. Instala y, luego, inicializa Google Cloud CLI.
  8. Crea o selecciona un proyecto de Google Cloud.

    • Crea un proyecto de Cloud:

      gcloud projects create PROJECT_ID
    • Selecciona el proyecto de Cloud que creaste:

      gcloud config set project PROJECT_ID
  9. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  10. Habilita las APIs de Cloud Bigtable and Cloud Bigtable Admin:

    gcloud services enable bigtable.googleapis.combigtableadmin.googleapis.com
  11. Otorga roles a tu Cuenta de Google. Ejecuta el siguiente comando una vez para cada uno de los siguientes roles de IAM: roles/bigtable.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • Reemplaza PROJECT_ID con el ID del proyecto.
    • Reemplaza EMAIL_ADDRESS por tu dirección de correo electrónico.
    • Reemplaza ROLE por cada rol individual.
  12. 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 Google Cloud Console.

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

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

  11. En Cantidad, selecciona 1.

  12. Haga clic en Crear para crear la instancia.

Conéctese a su instancia

  1. Ejecuta el siguiente comando para instalar la CLI de cbt, que te permite realizar operaciones en Bigtable:

    gcloud components install cbt

  2. Configura la CLI de cbt a fin de usar 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

  3. 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 herramienta cbt en 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 marca 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 al siguiente:

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

  5. Escribe el valor test-value en la fila r1 mediante la familia de columnas cf1 y el calificador de columna c1:

       cbt set my-table r1 cf1:c1=test-value

    En esta guía de inicio rápido, configuras solo una celda, pero Bigtable te permite configurar hasta 10,000 celdas en una sola solicitud de escritura.

  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 a este:

        ----------------------------------------
        r1
          cf1:c1                                   @ 2021/11/26-15:05:38.840000
            "test-value"

    Si no especificaste una marca de tiempo, se agrega una automáticamente.

Realiza una limpieza

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. Revoca credenciales desde la CLI de gcloud:

       gcloud auth revoke

¿Qué sigue?