Guía de inicio rápido para usar cbt

Si estás aprendiendo sobre Cloud 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, se usa la herramienta de línea de comandos cbt. Si prefieres usar la shell de HBase, sigue la guía de inicio rápido con la shell de HBase en su lugar.

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

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

Puedes realizar esta guía de inicio rápido con Cloud Shell o en la ventana de tu terminal local.

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. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Habilita las API de Cloud Bigtable, Cloud Bigtable Admin.

    Habilita las API

  5. Crea una cuenta de servicio:

    1. En Cloud Console, ve a la página Crear cuenta de servicio.

      Ir a Crear cuenta de servicio
    2. Selecciona un proyecto
    3. Ingresa un nombre en el campo Nombre de cuenta de servicio. Cloud Console completa el campo ID de cuenta de servicio según este nombre.

      Opcional: en el campo Descripción de la cuenta de servicio, ingresa una descripción. Por ejemplo, Service account for quickstart.

    4. Haz clic en Crear y continuar.
    5. Haz clic en el campo Seleccionar una función y, luego, en Bigtable Administrator.

    6. Haga clic en Continuar.
    7. Haz clic en Listo para terminar de crear la cuenta de servicio.

      No cierres la ventana del navegador. La usarás en la próxima tarea.

  6. Para crear una clave de cuenta de servicio, haz lo siguiente:

    1. En Cloud Console, haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
    2. Haga clic en Claves.
    3. Haz clic en Agregar clave, luego haz clic en Crear clave nueva.
    4. Haga clic en Crear. Se descargará un archivo de claves JSON en tu computadora.
    5. Haga clic en Cerrar.
  7. Instala e inicializa el SDK de Cloud.
  8. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  9. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  10. Habilita las API de Cloud Bigtable, Cloud Bigtable Admin.

    Habilita las API

  11. Crea una cuenta de servicio:

    1. En Cloud Console, ve a la página Crear cuenta de servicio.

      Ir a Crear cuenta de servicio
    2. Selecciona un proyecto
    3. Ingresa un nombre en el campo Nombre de cuenta de servicio. Cloud Console completa el campo ID de cuenta de servicio según este nombre.

      Opcional: en el campo Descripción de la cuenta de servicio, ingresa una descripción. Por ejemplo, Service account for quickstart.

    4. Haz clic en Crear y continuar.
    5. Haz clic en el campo Seleccionar una función y, luego, en Bigtable Administrator.

    6. Haga clic en Continuar.
    7. Haz clic en Listo para terminar de crear la cuenta de servicio.

      No cierres la ventana del navegador. La usarás en la próxima tarea.

  12. Para crear una clave de cuenta de servicio, haz lo siguiente:

    1. En Cloud Console, haz clic en la dirección de correo electrónico de la cuenta de servicio que creaste.
    2. Haga clic en Claves.
    3. Haz clic en Agregar clave, luego haz clic en Crear clave nueva.
    4. Haga clic en Crear. Se descargará un archivo de claves JSON en tu computadora.
    5. Haga clic en Cerrar.
  13. Instala e inicializa el SDK de Cloud.

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. En Tipo de almacenamiento (Storage type), selecciona SSD.

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

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

  7. En Zona, selecciona una zona de la región que seleccionaste.

  8. Haz clic en Crear para crear la instancia.

Conéctese a su instancia

  1. Configura 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 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 versiones del valor con marca de tiempo en la intersección de una fila y una columna. Cada versión se denomina celda.

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

  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                                   @ 2019/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