Hello World Ruby
Questo esempio di codice è un'applicazione "Hello World" che viene eseguita su Ruby. 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 Ruby 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.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla gcloud CLI con la tua identità federata.
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 esempio di codice utilizza il pacchetto libreria client Ruby per Bigtable della libreria client Google Cloud per Ruby per comunicare con Bigtable.
Per eseguire questo programma di esempio, segui le istruzioni per l'esempio su GitHub.
Utilizzo della libreria client di Cloud con Bigtable
L'applicazione di esempio si connette a Bigtable e mostra alcune operazioni semplici.
Richiedere la libreria client
L'esempio richiede google/cloud/bigtable
, che fornisce il modulo Bigtable
.
Connessione a Bigtable
Stabilisci le variabili che utilizzerai nella tua applicazione, sostituendo
"YOUR_PROJECT_ID" con l'ID di un progetto Google Cloud valido. Quindi
crea un nuovo oggetto Bigtable
che utilizzerai per
connetterti a Bigtable.
Creazione di una tabella
Controlla se la tabella esiste già. In caso contrario, chiama il metodo create_table()
per creare un oggetto Table
. La tabella ha una singola famiglia di colonne che conserva una
versione di ogni valore.
Scrittura di righe in una tabella
Poi, utilizza un array di stringhe di saluti per creare nuove righe per la tabella. Per
ogni saluto, crea una voce utilizzando il metodo new_mutation_entry()
della tabella. Poi, utilizza il metodo set_cell()
della voce per assegnare la famiglia di colonne, il qualificatore di colonna, il saluto e un
timestamp alla voce. Infine, scrivi la voce nella tabella utilizzando il metodo
mutate_row()
della tabella.
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 versioni precedenti che non sono state sottoposte a garbage collection.
Lettura di una riga in base alla chiave di riga
Crea un oggetto riga, quindi chiama il metodo read_row()
,
passando il filtro, per ottenere una versione di ogni valore nella riga.
Scansione di tutte le righe della tabella
Chiama il metodo read_rows()
, 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 delete()
della tabella.
In sintesi
Ecco l'esempio di codice completo senza commenti.