Hello World Python
Questo esempio è un'applicazione "hello world", scritta in Python, che illustra come eseguire le seguenti operazioni:
- Configurare l'autenticazione.
- Connettiti a un'istanza Bigtable.
- Crea una nuova tabella.
- Scrivi i dati nella tabella.
- Leggere i dati.
- Elimina la tabella.
La libreria client Python per Bigtable offre due API, asyncio
e un'API sincrona. Se l'applicazione è asincrona, utilizza asyncio
.
Configura l'autenticazione
Per utilizzare gli Python esempi di questa pagina in 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 Set up authentication for a local development environment.
esegui l'esempio
In questo esempio viene utilizzato il pacchetto Bigtable delle librerie client di Cloud per Python per comunicare con Bigtable. Il pacchetto Bigtable è la scelta migliore per le nuove applicazioni. Se devi spostare un carico di lavoro HBase esistente in Bigtable, vedi l'esempio "hello world" che utilizza il pacchetto HappyBase.
Per eseguire questo programma di esempio, segui le istruzioni per l'esempio su GitHub.
Utilizzo delle librerie client di Cloud con Bigtable
L'applicazione di esempio si connette a Bigtable e mostra alcune operazioni.
Installare e importare la libreria client
Utilizza PIP per installare i pacchetti Python richiesti in un ambiente virtualeenv. L'esempio include un file dei requisiti che definisce i pacchetti necessari.
Importa i moduli.
Asincio
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Sincronizza
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Connetti a Bigtable
Connettiti a Bigtable utilizzando
bigtable.Client
.
Asincio
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Sincronizza
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Creare una tabella
Creare l'istanza di un oggetto di tabella utilizzando Instance.table()
. Crea una famiglia di colonne e imposta il relativo
criterio di garbage collection, quindi passa la famiglia di colonne a Table.create()
per creare la tabella.
Scrivere righe in una tabella
Scorri un elenco di stringhe di saluto per creare nuove righe per la tabella.
In ogni iterazione, utilizza Table.row()
per definire una riga
e assegnarle una chiave di riga, chiama Row.set_cell()
per
impostare un valore per la cella corrente e aggiungi la nuova riga a un array di righe.
Infine, chiama Table.mutate_rows()
per aggiungere
le righe alla tabella.
Asincio
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Sincronizza
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Crea un filtro
Prima di leggere i dati che hai scritto, crea un filtro utilizzando row_filters.CellsColumnLimitFilter()
per limitare i dati restituiti da Bigtable. Questo filtro indica a Bigtable di restituire solo la cella più recente in ogni colonna, anche se la tabella contiene celle meno recenti che non sono ancora state rimosse durante la garbage collection.
Asincio
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Sincronizza
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Leggere una riga in base alla relativa chiave di riga
Chiama il metodo Table.read_row()
della tabella per ottenere un riferimento alla riga con una chiave di riga specifica, passando la chiave e il filtro, per ottenere una versione di ogni valore in quella riga.
Asincio
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Sincronizza
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Analizza tutte le righe della tabella
Usare Table.read_rows()
per leggere un intervallo di righe
di una tabella.
Asincio
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Sincronizza
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Eliminazione di una tabella
Elimina una tabella con Table.delete()
.
Organizzazione dei risultati in corso...
Ecco l'esempio completo senza commenti.
Asincio
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Sincronizza
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.