Hello World Python
Questo esempio è un "Hello World" scritta in Python, illustra come fare quanto segue:
- 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 una località dell'ambiente di sviluppo, installare e inizializzare gcloud CLI quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.
- Install the Google Cloud CLI.
-
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.
Per ulteriori informazioni, vedi 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 è per le nuove applicazioni. Se devi spostare un carico di lavoro HBase esistente in Bigtable, consulta "hello world" esempio che utilizza HappyBase pacchetto.
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 aziendali.
Installa e importa la libreria client
Utilizza PIP per installare i pacchetti Python richiesti in un nell'ambiente virtualenv. L'esempio include un requisiti che definisce i pacchetti necessari.
Importa i moduli.
Asyncio
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 ulteriori informazioni, vedi Configura 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 ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Connettiti a Bigtable
Connettiti a Bigtable utilizzando
bigtable.Client
Asyncio
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 ulteriori informazioni, vedi Configura 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 ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Creare una tabella
Creare un'istanza di un oggetto tabella utilizzando Instance.table()
. Creare una famiglia di colonne e impostarne la
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
imposta un valore per la cella corrente; e aggiungere la nuova riga a un array di righe.
Infine, chiama Table.mutate_rows()
per aggiungere
le righe alla tabella.
Asyncio
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 ulteriori informazioni, vedi Configura 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 ulteriori informazioni, vedi Configura 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 che
Bigtable viene restituito. Questo filtro indica a Bigtable
restituisce solo la cella più recente in ogni colonna, anche se la tabella contiene
celle più vecchie che non sono state ancora rimosse durante la garbage collection.
Asyncio
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 ulteriori informazioni, vedi Configura 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 ulteriori informazioni, vedi Configura 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 a
riga con una chiave di riga specifica, passando la chiave e il filtro, per ottenere
di ogni valore nella stessa riga.
Asyncio
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 ulteriori informazioni, vedi Configura 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 ulteriori informazioni, vedi Configura 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.
Asyncio
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 ulteriori informazioni, vedi Configura 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 ulteriori informazioni, vedi Configura 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.
Asyncio
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 ulteriori informazioni, vedi Configura 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 ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.