Hello World C#
Questo esempio di codice è un'applicazione "Hello World" scritta in C#. L'esempio illustra come completare le attività seguenti:
- Configura l'autenticazione
- Connetti a un'istanza Bigtable
- Crea una nuova tabella.
- Scrivi i dati nella tabella.
- Leggere i dati.
- Elimina la tabella.
Configura l'autenticazione
Per utilizzare gli esempi .NET in questa pagina da un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Esecuzione dell'esempio
Questo codice comunica con Bigtable utilizzando le librerie dell'API C# Admin e dell'API C# Data nelle librerie client di Google Cloud per .NET.
Per eseguire questo programma di esempio, segui le istruzioni di esempi di.NET Bigtable su GitHub.
Completa i passaggi Creazione ed esecuzione e Avvio rapido per creare risorse da utilizzare nella tua applicazione Hello World. Assicurati di modificare il file HelloWorld.cs
per aggiungere i nomi delle risorse che crei.
Utilizzo delle librerie client di Cloud con Bigtable
L'applicazione di esempio si connette a Bigtable e dimostra alcune operazioni semplici.
Connessione a Bigtable
Per iniziare, crea due oggetti client da utilizzare per la connessione a
Bigtable. Le API C# Admin BigtableTableAdminClient
consentono di creare ed eliminare istanze e tabelle. Le API di dati C# BigtableClient
consentono di leggere e scrivere i dati delle tabelle.
Creazione di una tabella
Chiama il metodo CreateTable()
nella classe BigtableTableAdminClient
per generare un oggetto Table
che archivia i saluti "helloworld". La tabella ha una singola famiglia di colonne che conserva una versione
di ciascun valore.
Scrittura di righe in una tabella
Utilizza l'array di stringhe s_greetings[]
, che contiene tre semplici saluti, come
origine di dati per scrivere nella tabella. Scrivi una singola riga nella tabella
utilizzando MutateRow()
. Quindi, esegui il loop del resto dell'array per creare un oggetto MutateRowsRequest
che contenga una voce per ogni saluto. Effettua la richiesta di scrivere tutte le voci contemporaneamente con MutateRows()
. Quindi, esegui il loop della risposta restituita per controllare il codice di stato di ogni voce per assicurarti che sia stata scritta correttamente.
Creazione di un filtro
Prima di leggere i dati che hai scritto, crea un filtro per limitare i dati restituiti da Bigtable. Questo filtro indica a Bigtable di restituire solo la versione più recente di ogni valore, anche se la tabella contiene celle precedenti idonee alla garbage collection, ma non ancora eliminate.
Lettura di una riga tramite la relativa chiave di riga
Utilizza il metodo ReadRow()
, passando il filtro
appena creato, per ottenere una versione di ogni valore in quella riga.
Analisi di tutte le righe della tabella
Richiama il metodo ReadRows()
, passando il
filtro, per visualizzare tutte le righe della tabella. Poiché hai passato il filtro,
Bigtable restituisce solo una versione per ciascun valore.
Eliminazione di una tabella
Elimina la tabella con il metodo DeleteTable()
.
Riepilogo
Ecco l'esempio di codice completo senza commenti.