Este ejemplo de código es una aplicación “Hello World” escrita en C#. En este ejemplo, se muestra cómo completar las siguientes tareas:
- Conectarse a una instancia de Cloud Bigtable
- Crear una tabla nueva
- Escribir datos en la tabla.
- Volver a leer datos.
- Borrar la tabla.
Ejecuta la muestra
Este código se comunica con Cloud Bigtable mediante la API de administrador de C# y las bibliotecas de API de datos de C# en las bibliotecas clientes de Google Cloud para .NET.
Con el fin de ejecutar este programa de muestra, sigue las instrucciones de las muestras de Cloud Bigtable para .NET en GitHub.
Completa los pasos Crear y ejecutar, como también Inicio rápido para crear recursos que puedes utilizar en tu aplicación de Hello World. Asegúrate de editar el archivo HelloWorld.cs
para agregar los nombres de los recursos que creas.
Usa la biblioteca cliente de Cloud con Cloud Bigtable
La aplicación de muestra se conecta con Cloud Bigtable y demuestra algunas operaciones simples.
Conéctate con Cloud Bigtable
Para comenzar, crea dos objetos de cliente que puedas usar a fin de conectarte a Cloud Bigtable. La API de administrador de C# BigtableTableAdminClient
te ayuda a crear y borrar instancias y tablas. La API de datos de C# BigtableClient
te ayuda a leer y escribir datos de tablas.
Crea una tabla
Llama al método CreateTable()
del cliente de administración para generar un objeto Table
que almacene los saludos de “Hello World”. La tabla tiene una sola familia de columnas que contiene una versión de cada valor.
Escribe filas en una tabla
Utiliza el arreglo de strings s_greetings[]
, que contiene tres saludos simples, como una fuente de datos para escribir en la tabla. Primero, escribe una sola fila en la tabla utilizando MutateRow()
. Luego, recorre el resto del arreglo a fin de crear un objeto MutateRowsRequest
que contenga una entrada para cada saludo. Realiza la solicitud para escribir todas las entradas a la vez con MutateRows()
. A continuación, recorre la respuesta que se muestra para verificar el código de estado de cada entrada a fin de asegurarte de que se haya escrito correctamente.
Crear un filtro
Antes de leer los datos que escribiste, crea un filtro para limitar los datos que muestre Cloud Bigtable. El filtro le indica a Cloud Bigtable que muestre solo la versión más reciente de cada valor, incluso si la tabla contiene versiones anteriores que no han pasado por el proceso de recolección de elementos no utilizados.
Lee una fila por su clave de fila
Usa el método ReadRow()
, pasando el filtro que acabas de crear, para obtener una versión de cada valor en esa fila.
Analiza todas las filas de una tabla
Llama al método ReadRows()
, pasando el filtro, para obtener todas las filas de la tabla. Dado que aplicaste el filtro, Cloud Bigtable solo mostrará una versión de cada valor.
Borra una tabla
Borra la tabla con el método DeleteTable()
.
Revisión general
El código de muestra completo sin comentarios.