Crea una tabla de prueba

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

En estas instrucciones, se usa la consola de Google Cloud y la CLI de cbt, una interfaz de línea de comandos creada específicamente para Bigtable.

Antes de comenzar

Antes de crear una tabla de prueba, completa los siguientes requisitos previos.

Configura la autenticación

Puedes usar las muestras de gcloud CLI en esta página desde cualquiera de los siguientes entornos de desarrollo:

  • Cloud Shell: Para usar una terminal en línea con la CLI de gcloud ya configurada, activa Cloud Shell.

    En la parte inferior de esta página, se inicia una sesión de Cloud Shell y se muestra una ventana de línea de comandos. La sesión puede tardar unos segundos en inicializarse.

  • Shell local: Para usar la CLI de gcloud en un entorno de desarrollo local, instala e inicializa la CLI de gcloud.

Si deseas obtener información sobre cómo configurar la autenticación para un entorno de producción, consulta Configura las credenciales predeterminadas de la aplicación para el código que se ejecuta en Google Cloud..

Otorgar rol de IAM

Si quieres obtener los permisos que necesitas para crear una tabla de prueba, pídele a tu administrador que te otorgue el rol de IAM Administrador de Bigtable (roles/bigtable.admin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

Instala la CLI de cbt

Ejecuta el siguiente comando para instalar la CLI de cbt:

  gcloud components install cbt

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 la consola de Google Cloud.

    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. Configura la CLI de cbt para que use tu proyecto y tu instancia. 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 = test-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 = test-instance

    Ahora puedes usar la CLI de cbt con tu instancia.

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 fragmentos de código, como los que se encuentran en Usa Bigtable con Cloud Functions.

Limpia

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?