Hello World en Ruby
Esta muestra de código es una aplicación “hello world” que se ejecuta en Ruby. En este ejemplo, se muestra cómo completar las siguientes tareas:
- Configura la autenticación
- Conectarse a una instancia de Bigtable
- Crear una tabla nueva
- Escribir datos en la tabla
- Volver a leer datos
- Borrar la tabla
Configura la autenticación
Para usar las muestras de Ruby de esta página desde un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
gcloud init
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ejecuta la muestra
En esta muestra de código, se usa el paquete de la biblioteca cliente de Ruby para Bigtable de la biblioteca cliente de Google Cloud para Ruby a fin de comunicarse con Bigtable.
Para ejecutar el programa de muestra, sigue las instrucciones que se indican en GitHub.
Usa la biblioteca cliente de Cloud con Bigtable
La aplicación de muestra se conecta con Bigtable y demuestra algunas operaciones simples.
Requisitos de la biblioteca cliente
La muestra necesita google/cloud/bigtable
, que proporciona el módulo Bigtable
.
Conéctate a Bigtable
Establece las variables que usarás en tu aplicación y reemplaza “YOUR_PROJECT_ID” con el ID de un proyecto válido de Google Cloud. Luego, crea un objeto Bigtable
nuevo, que usarás para conectarte a Bigtable.
Crea una tabla
Comprueba si tu tabla ya existe. Si no es así, llama al método create_table()
para crear un objeto Table
. La tabla tiene una sola familia de columnas, que contiene una versión de cada valor.
Escribe filas en una tabla
A continuación, usa un arreglo de strings de saludos a fin de crear algunas filas nuevas para la tabla. Por cada saludo, crea una entrada con el método new_mutation_entry()
de la tabla. A continuación, usa el método set_cell()
de la entrada para asignar la familia de columnas, el calificador de columna, el saludo y una marca de tiempo a la entrada. Por último, escribe la entrada en la tabla usando el método mutate_row()
de la tabla.
Crea un filtro
Antes de leer los datos que escribiste, crea un filtro para limitar los datos que muestre Bigtable. El filtro le indica a Bigtable que muestre solo la versión más reciente de cada valor, incluso si la tabla contiene versiones anteriores que no pasaron por el proceso de recolección de elementos no utilizados.
Lee una fila por su clave de fila
Crea un objeto de fila, llama al método read_row()
y, luego, aplica el filtro para obtener una versión de cada valor de la fila.
Analiza todas las filas de una tabla
Llama al método read_rows()
y aplica el filtro para pasar todas las filas de la tabla. Dado que aplicaste el filtro, Bigtable solo mostrará una versión de cada valor.
Borra una tabla
Borra la tabla con el método delete()
.
Revisión general
El código de muestra completo sin comentarios.