Guía de inicio rápido para usar cbt

En esta página, se explica cómo usar el comando cbt para conectarse con una instancia de Cloud Bigtable, realizar tareas administrativas básicas, y leer y escribir datos en una tabla.

Si conoces HBase, te recomendamos seguir la guía de inicio rápido del shell de HBase.

Antes de comenzar

  1. En GCP Console, en la página de selección de proyecto, selecciona o crea un proyecto de GCP.

    Ir a la página de selección de proyecto

  2. Asegúrate de tener habilitada la facturación para tu proyecto de Google Cloud Platform. Obtén información sobre cómo confirmar que tienes habilitada la facturación para tu proyecto.

  3. Habilita lasCloud Bigtable y Cloud Bigtable AdminAPIAPI.

    Habilita lasAPI

Crea una instancia de Cloud Bigtable

  1. Abre la página Crea una instancia en Google Cloud Platform Console.

    Abrir la página Crea una instancia

    Captura de pantalla de la página “Crear instancia”

  2. En Instance name (Nombre de la instancia), ingresa Quickstart instance.

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

  4. En Instance Type (Tipo de instancia), selecciona Development (Desarrollo).

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

  6. En Cluster ID (ID de clúster), ingresa quickstart-instance-c1.

  7. En Region (Región), selecciona us-east1.

  8. En Zone (Zona), selecciona us-east1-c.

  9. Haz clic en Create (Crear) para crear la instancia.

Conéctate a la instancia

  1. Instala el SDK de Cloud si no lo hiciste antes.

  2. Abre una ventana de la terminal, ya sea de forma local o con Cloud Shell:

    Abrir Cloud Shell

  3. Instala el comando cbt:

    gcloud components update
    gcloud components install cbt
    
  4. Configura cbt a fin de que use tu proyecto y tu instancia. Para ello, crea un archivo .cbtrc que reemplace [PROJECT_ID] con el ID del proyecto en el que creaste la instancia de Cloud Bigtable:

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

Ya puedes usar el comando cbt con tu instancia.

Lee y escribe datos

Cloud 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 grupos o familias de columnas. Un calificador de columna identifica una columna individual dentro de una familia.

Una celda es la intersección de una fila y una columna. Cada celda puede contener muchas versiones de un valor.

  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 al siguiente:

    my-table
    
  3. Agrega una familia de columnas llamada 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. Usa la familia de columnas cf1 y el calificador de columna c1 para colocar el valor test-value en la fila r1:

    cbt set my-table r1 cf1:c1=test-value
    
  6. Utiliza el comando cbt read para leer los datos que agregaste a la tabla:

    cbt read my-table
    

    El shell muestra un resultado similar al siguiente:

    ----------------------------------------
    r1
      cf1:c1                                   @ 2019/03/26-15:05:38.840000
        "test-value"
    
  7. Borra la tabla my-table:

    cbt deletetable my-table
    

Limpiar

Para evitar que se apliquen cargos a tu cuenta de GCP por los recursos que se utilizan en esta guía de inicio rápido, haz lo siguiente:

  1. Abre la lista de instancias de Cloud Bigtable en GCP Console.

    Abrir la lista de instancias

  2. Haz clic en Quickstart instance.
  3. Haz clic en Borrar instancia.

    Captura de pantalla del panel “Borrar instancia”

  4. Escribe quickstart-instance y haz clic en Delete (Borrar) para quitar la instancia.
  5. En la terminal, borra el archivo .cbtrc:
    rm ~/.cbtrc

¿Qué sigue?

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Documentación de Cloud Bigtable