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 la consola de Google Cloud y la CLI de cbt
, una interfaz de línea de comandos compilada específicamente para Bigtable.
Antes de seguir estos pasos, debes completar la Guía de inicio rápido con la CLI de cbt
para configurar la CLI y familiarizarte con 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.
Abre la página Crear instancia en Google Cloud Console.
En Nombre de la instancia, ingresa
Test instance
.En ID de instancia (Instance ID), ingresa
test-instance
.En Tipo de almacenamiento (Storage type), selecciona SSD.
En ID de clúster, ingresa
test-instance-c1
.En Región, selecciona una región cercana.
En Zona, selecciona una zona de la región que seleccionaste.
En Nodos, ingresa
1
.Haz clic en Crear para crear la instancia.
Conéctate a la instancia
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"
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
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
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"
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
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
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.
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.
Si deseas conservar la instancia, pero borrar la tabla, puedes usar el comando
deletetable
:cbt deletetable test-table
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
Borra el archivo .cbtrc:
rm ~/.cbtrc
¿Qué sigue?
- Explora las muestras de código de Bigtable.
- Obtén información sobre la herramienta Key Visualizer para Bigtable.