Hello World Python
Questo esempio è un'applicazione "Hello World", scritta in Python, che illustra come eseguire queste operazioni:
- Configurare l'autenticazione.
- Connettersi a un'istanza Bigtable.
- Crea una nuova tabella.
- Scrivi i dati nella tabella.
- Leggi i dati.
- Elimina la tabella.
La libreria client Python per Bigtable offre due API, asyncio
e un'API sincrona. Se la tua applicazione è asincrona, utilizza asyncio
.
Configura l'autenticazione
Per utilizzare gli Python esempi in 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.
-
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 maggiori informazioni, consulta Set up authentication for a local development environment.
Esegui l'esempio
In questo esempio viene utilizzato il pacchetto Bigtable delle librerie client 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.
Installa e importa la libreria client
Utilizza PIP per installare i pacchetti Python richiesti in un ambiente virtuale. 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 su Bigtable, configura le 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 su Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Connettiti 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 su Bigtable, configura le 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 su Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Creare una tabella
Creare un'istanza di un oggetto 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 benvenuto per creare alcune 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 attuale 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 su Bigtable, configura le 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 su Bigtable, configura le 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 su Bigtable, configura le 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 su Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Leggi 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 nella riga.
Asincio
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione su Bigtable, configura le 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 su Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Analizza tutte le righe della tabella
Utilizza Table.read_rows()
per leggere un intervallo di righe da una tabella.
Asincio
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione su Bigtable, configura le 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 su Bigtable, configura le 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()
.
Riassumendo
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 su Bigtable, configura le 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 su Bigtable, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.