Hello World C#
Questo esempio di codice è un'applicazione "Hello World" scritta in C#. L'esempio mostra come completare le seguenti attività:
- Configura l'autenticazione
- Connettiti a un'istanza Bigtable
- Crea una nuova tabella.
- Scrivere i dati nella tabella.
- Leggi i dati.
- Elimina la tabella.
Configura l'autenticazione
Per utilizzare gli esempi di .NET questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
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.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Per ulteriori informazioni, vedi Set up authentication for a local development environment.
Esecuzione del campione
Questo codice comunica con Bigtable utilizzando le librerie C# Admin API e C# Data API nelle librerie client di Google Cloud per .NET.
Per eseguire questo programma di esempio, segui le
istruzioni per gli esempi.NET Bigtable su GitHub.
Completa i passaggi Crea ed esegui e Guida rapida per creare risorse
che puoi 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 mostra alcune operazioni semplici.
Connessione a Bigtable
Per iniziare, crea due oggetti client che puoi utilizzare per connetterti a
Bigtable. Le API Admin C# BigtableTableAdminClient
ti aiutano a creare ed eliminare istanze e tabelle. Le API Data BigtableClient
C# ti aiutano a leggere e scrivere dati
delle tabelle.
Creazione di una tabella
Chiama il metodo CreateTable()
nella classe BigtableTableAdminClient
per
generare un oggetto Table
che memorizza i saluti "hello
world". La tabella ha una singola famiglia di colonne che conserva una versione
di ogni valore.
Scrittura di righe in una tabella
Utilizza l'array di stringhe s_greetings[]
, che contiene tre semplici saluti, come
origine dei dati da scrivere nella tabella. Per prima cosa, scrivi una singola riga nella tabella
utilizzando MutateRow()
. Quindi, scorri il resto
dell'array per creare un oggetto MutateRowsRequest
che contenga una voce per ogni saluto. Invia la richiesta di scrittura di tutte le
voci contemporaneamente con MutateRows()
. Quindi, scorri
la risposta restituita per controllare il codice di stato di ogni voce e assicurarti
che sia stata scritta correttamente.
Creare 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 meno recenti idonee per la garbage collection ma non ancora eliminate.
Lettura di una riga in base alla chiave di riga
Utilizza il metodo ReadRow()
, passando il filtro
che hai appena creato, per ottenere una versione di ogni valore in quella riga.
Scansione di tutte le righe della tabella
Chiama il metodo ReadRows()
, passando il filtro, per ottenere tutte le righe della tabella. Poiché hai passato il filtro,
Bigtable restituisce una sola versione di ogni valore.
Eliminazione di una tabella
Elimina la tabella con il metodo DeleteTable()
.
In sintesi
Ecco l'esempio di codice completo senza commenti.