Hello World en C#
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:
- Configura la autenticación
- Conéctate 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 .NET de esta página en un entorno de desarrollo local, instala e inicializa gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
Para obtener más información, consulta Set up authentication for a local development environment.
Ejecuta la muestra
Este código se comunica con Bigtable mediante las bibliotecas de la API de administrador de C# y la API de datos de C# en las bibliotecas cliente de Google Cloud para .NET.
Para ejecutar este programa de muestra, sigue las
Instrucciones de las muestras de.NET Bigtable en GitHub.
Completa los pasos Crear y ejecutar, como también Inicio rápido para crear recursos que puedes usar 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 las bibliotecas cliente de Cloud con Bigtable
La aplicación de muestra se conecta con Bigtable y demuestra algunas operaciones simples.
Conéctate a Bigtable
Para comenzar, crea dos objetos de cliente que puedes usar a fin de conectarte a Bigtable. El BigtableTableAdminClient
de las APIs de Administrador de C# te ayuda a crear y borrar instancias y tablas. El C#
Las APIs de datos BigtableClient
te ayudan a leer y escribir tablas
de datos no estructurados.
Crea una tabla
Llama al método CreateTable()
en la clase BigtableTableAdminClient
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
Usa 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 con 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.
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 celdas más antiguas que son aptas para la recolección de elementos no utilizados, pero que aún no se han borrado.
Lee una fila por su clave de fila
Usa el método ReadRow()
, que ingresa el filtro que acabas de crear, para obtener una versión de cada valor de esa fila.
Analiza todas las filas de una tabla
Llama al método ReadRows()
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 DeleteTable()
.
Revisión general
El código de muestra completo sin comentarios.