Crea una tabla de prueba

En esta página, se describen los pasos para crear una tabla pequeña de Cloud Bigtable que puedes usar a fin de probar fragmentos de código. La tabla contiene datos de series temporales para smartphones y tablets.

En estas instrucciones, se usa Google Cloud Console y cbt, la herramienta de línea de comandos creada específicamente para Bigtable.

Antes de seguir estos pasos, debes completar la Guía de inicio rápido para usar cbt a fin de configurar tu herramienta y familiarizarte con Cloud Bigtable.

Crea una instancia

En el proyecto que elijas, crea una instancia de prueba para almacenar tu tabla de prueba. La tabla es pequeña, por lo que solo necesitas una instancia de nodo único.

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

    Crea una instancia

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

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

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

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

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

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

  8. En Nodos, ingresa 1.

  9. Haz clic en Crear para crear la instancia.

Conéctate a la instancia

  1. En la ventana de la terminal local, configura la variable de entorno GOOGLE_APPLICATION_CREDENTIALS. Reemplaza [PATH] por la ruta de acceso del archivo al archivo JSON que contiene la clave de tu cuenta de servicio.

       export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

    Por ejemplo:

       export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"

  2. Crea un archivo .cbtrc; para ello, reemplaza project-id por el ID del proyecto en el que creaste la instancia de prueba de Cloud Bigtable:

       echo project = project-id > ~/.cbtrc
       echo instance = test-instance >> ~/.cbtrc

  3. Verifica que hayas configurado correctamente el archivo .cbtrc:

       cat ~/.cbtrc

    En la terminal, se muestra el contenido del archivo .cbtrc, que es similar a lo siguiente:

    project = project-id
    instance = test-instance

Crea una tabla de prueba

  1. Crea una tabla con el nombre test-table que tenga dos familias de columnas. Para cada familia de columnas, configura una política de recolección de elementos no utilizados a fin de mantener un máximo de 2 celdas por columna:

       cbt createtable test-table "families=stats_summary:maxversions=2,stats_detail:maxversions=2,cell_plan:maxversions=2"

  2. Enumera las familias de columnas:

       cbt ls test-table

    En la terminal, se muestra un resultado similar al siguiente:

        Family Name       GC Policy
        -----------       ---------
        stats_detail        versions() > 2
        stats_summary       versions() > 2
        cell_plan           versions() > 2

Propaga la tabla

  1. Copia los siguientes comandos en tu ventana de la terminal y presiona Enter.

       cbt set test-table phone#4c410523#20190501 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190405.003 cell_plan:data_plan_01gb=true cell_plan:data_plan_05gb=true
        cbt set test-table phone#4c410523#20190502 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190405.004 cell_plan:data_plan_05gb=true
        cbt set test-table phone#4c410523#20190505 stats_summary:connected_cell=0 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190406.000
        cbt set test-table phone#5c10102#20190501 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190401.002 cell_plan:data_plan_10gb=true
        cbt set test-table tablet#5c10102#20190502 stats_summary:connected_cell=1 stats_summary:connected_wifi=0 stats_summary:os_build=PQ2A.190406.000 cell_plan:data_plan_10gb=true

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

       cbt read test-table

    En la terminal, se muestra un resultado similar al siguiente. Ten en cuenta que las marcas de tiempo se asignan a las celdas de manera automática porque la solicitud de escritura no incluye marcas de tiempo.

        ----------------------------------------
        phone#4c410523#20190501
          cell_plan:data_plan_01gb                 @ 2020/09/23-11:44:10.535000
            "true"
          cell_plan:data_plan_05gb                 @ 2020/09/23-11:44:10.535000
            "true"
          stats_summary:connected_cell             @ 2020/09/23-11:44:10.535000
            "1"
          stats_summary:connected_wifi             @ 2020/09/23-11:44:10.535000
            "1"
          stats_summary:os_build                   @ 2020/09/23-11:44:10.535000
            "PQ2A.190405.003"
        ----------------------------------------
        phone#4c410523#20190502
          cell_plan:data_plan_05gb                 @ 2020/09/23-11:44:11.545000
            "true"
          stats_summary:connected_cell             @ 2020/09/23-11:44:11.545000
            "1"
          stats_summary:connected_wifi             @ 2020/09/23-11:44:11.545000
            "1"
          stats_summary:os_build                   @ 2020/09/23-11:44:11.545000
            "PQ2A.190405.004"
        ----------------------------------------
        phone#4c410523#20190505
    stats_summary:connected_cell @ 2020/09/23-11:44:12.503000 "0" stats_summary:connected_wifi @ 2020/09/23-11:44:12.503000 "1" stats_summary:os_build @ 2020/09/23-11:44:12.503000 "PQ2A.190406.000" ---------------------------------------- phone#5c10102#20190501 cell_plan:data_plan_10gb @ 2020/09/23-11:44:13.553000 "true" stats_summary:connected_cell @ 2020/09/23-11:44:13.553000 "1" stats_summary:connected_wifi @ 2020/09/23-11:44:13.553000 "1" stats_summary:os_build @ 2020/09/23-11:44:13.553000 "PQ2A.190401.002" ---------------------------------------- tablet#5c10102#20190502 cell_plan:data_plan_10gb @ 2020/09/23-11:44:14.480000 "true" stats_summary:connected_cell @ 2020/09/23-11:44:14.480000 "1" stats_summary:connected_wifi @ 2020/09/23-11:44:14.480000 "0" stats_summary:os_build @ 2020/09/23-11:44:14.480000 "PQ2A.190406.000"

Usa los datos de prueba

Ahora puedes usar test-table en test-instance para probar los fragmentos de código, como los que se encuentran en Usa Cloud Bigtable con Cloud Functions.

Realiza una limpieza

Para evitar que se generen cargos en tu cuenta de Google Cloud por los recursos creados durante estos pasos, borra la instancia en cuanto termines la prueba. Borrar el archivo .cbtrc te permite trabajar en otro proyecto.

  1. Si deseas conservar la instancia, pero borrar la tabla, puedes usar el comando deletetable:

       cbt deletetable test-table

  2. Si no planeas usar la instancia para realizar más pruebas, bórrala. Esta acción también borra la tabla.

       cbt deleteinstance test-instance

  3. Borra el archivo .cbtrc:

       rm ~/.cbtrc

¿Qué sigue?