Creazione di una tabella di test
Questa pagina descrive i passaggi per creare una piccola tabella Bigtable che puoi utilizzare per testare gli snippet di codice. La tabella contiene dati di serie temporali per smartphone e tablet.
Queste istruzioni utilizzano la Google Cloud console e l'
cbtinterfaccia a riga di comando
, creata appositamente per Bigtable.
Prima di iniziare
Prima di creare una tabella di test, completa i seguenti prerequisiti.
Configura l'autenticazione
Nella Google Cloud console, attiva Cloud Shell.
Nella parte inferiore della Google Cloud console viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già inclusa e installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
Per informazioni sulla configurazione dell'autenticazione per un ambiente di produzione, consulta Configurare le credenziali predefinite dell'applicazione per il codice in esecuzione su Google Cloud .
Concedi ruolo IAM
Per ottenere le autorizzazioni necessarie per creare una tabella di test, chiedi all'amministratore di concederti il ruolo IAM Amministratore Bigtable (roles/bigtable.admin) nel progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Installa l'
cbt interfaccia a riga di comando
Esegui il seguente comando per installare l'interfaccia a riga di comando
cbtCLI
:
gcloud components install cbt
Crea un'istanza
Nel progetto che preferisci, crea un'istanza di test per archiviare la tabella di test. La tabella è piccola, quindi hai bisogno solo di un'istanza a nodo singolo.
Apri la pagina Crea istanza nella Google Cloud console.
In Nome istanza, inserisci
Test instance.In ID istanza, inserisci
test-instance.Per Tipo di archiviazione, seleziona SSD.
Per ID cluster, inserisci
test-instance-c1.In Regione, seleziona una regione vicina a te.
In Zona, seleziona una zona nella regione selezionata.
In Nodi, inserisci
1.Fai clic sul pulsante Crea per creare l'istanza.
Connettersi all'istanza
Configura l'interfaccia a riga di comando
cbtCLI in modo che utilizzi il tuo progetto e la tua istanza creando un file.cbtrc, sostituendoPROJECT_IDcon l'ID del progetto in cui hai creato l'istanza Bigtable:echo project = PROJECT_ID >> ~/.cbtrc && echo instance = test-instance >> ~/.cbtrc
Verifica di aver configurato correttamente il file
.cbtrc:cat ~/.cbtrc
Il terminale mostra i contenuti del file
.cbtrc, che è simile al seguente:project = PROJECT_ID instance = test-instance
Ora puoi utilizzare l' interfaccia a riga di comando
cbtcon la tua istanza.
Crea una tabella di test
Crea una tabella denominata
test_tablecon due famiglie di colonne. Per ogni famiglia di colonne, imposta un criterio di garbage collection per conservare un massimo di 2 celle per colonna:cbt createtable test_table "families=stats_summary:maxversions=2,stats_detail:maxversions=2,cell_plan:maxversions=2"Elenca le famiglie di colonne:
cbt ls test_tableIl terminale mostra un output simile al seguente:
Family Name GC Policy ----------- --------- stats_detail versions() > 2 stats_summary versions() > 2 cell_plan versions() > 2
Compila la tabella
Copia i seguenti comandi nella finestra del terminale e premi
Enter.cbt set test_table phone#4c410523#20190501 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190405.003 cell_plan:data_plan_01gb=true cell_plan:data_plan_05gb=true cbt set test_table phone#4c410523#20190502 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190405.004 cell_plan:data_plan_05gb=true cbt set test_table phone#4c410523#20190505 stats_summary:connected_cell=0 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190406.000 cbt set test_table phone#5c10102#20190501 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190401.002 cell_plan:data_plan_10gb=true cbt set test_table tablet#5c10102#20190502 stats_summary:connected_cell=1 stats_summary:connected_wifi=0 stats_summary:os_build=PQ2A.190406.000 cell_plan:data_plan_10gb=trueUtilizza il comando
cbt readper leggere i dati che hai aggiunto alla tabella:cbt read test_tableIl terminale mostra un output simile al seguente. Tieni presente che i timestamp vengono assegnati automaticamente alle celle perché la richiesta di scrittura non li include.
---------------------------------------- phone#4c410523#20190501 cell_plan:data_plan_01gb @ 2023/09/23-11:44:10.535000 "true" cell_plan:data_plan_05gb @ 2023/09/23-11:44:10.535000 "true" stats_summary:connected_cell @ 2023/09/23-11:44:10.535000 "1" stats_summary:connected_wifi @ 2023/09/23-11:44:10.535000 "1" stats_summary:os_build @ 2023/09/23-11:44:10.535000 "PQ2A.190405.003" ---------------------------------------- phone#4c410523#20190502 cell_plan:data_plan_05gb @ 2023/09/23-11:44:11.545000 "true" stats_summary:connected_cell @ 2023/09/23-11:44:11.545000 "1" stats_summary:connected_wifi @ 2023/09/23-11:44:11.545000 "1" stats_summary:os_build @ 2023/09/23-11:44:11.545000 "PQ2A.190405.004" ---------------------------------------- phone#4c410523#20190505\ stats_summary:connected_cell @ 2023/09/23-11:44:12.503000 "0" stats_summary:connected_wifi @ 2023/09/23-11:44:12.503000 "1" stats_summary:os_build @ 2023/09/23-11:44:12.503000 "PQ2A.190406.000" ---------------------------------------- phone#5c10102#20190501 cell_plan:data_plan_10gb @ 2023/09/23-11:44:13.553000 "true" stats_summary:connected_cell @ 2023/09/23-11:44:13.553000 "1" stats_summary:connected_wifi @ 2023/09/23-11:44:13.553000 "1" stats_summary:os_build @ 2023/09/23-11:44:13.553000 "PQ2A.190401.002" ---------------------------------------- tablet#5c10102#20190502 cell_plan:data_plan_10gb @ 2023/09/23-11:44:14.480000 "true" stats_summary:connected_cell @ 2023/09/23-11:44:14.480000 "1" stats_summary:connected_wifi @ 2023/09/23-11:44:14.480000 "0" stats_summary:os_build @ 2023/09/23-11:44:14.480000 "PQ2A.190406.000"(Facoltativo) Scrivi nuovi valori nelle stesse righe e colonne. Bigtable crea nuove celle con nuovi timestamp per archiviare le nuove versioni dei dati. Copia i seguenti comandi nella finestra del terminale e premi
Enter.cbt set test_table phone#4c410523#20190501 stats_summary:connected_cell=2 stats_summary:connected_wifi=5 stats_summary:os_build=PQ2A.190405.003 cell_plan:data_plan_01gb=true cell_plan:data_plan_05gb=false cbt set test_table phone#4c410523#20190502 stats_summary:connected_cell=2 stats_summary:connected_wifi=5 stats_summary:os_build=PQ2A.190405.004 cell_plan:data_plan_05gb=false cbt set test_table phone#4c410523#20190505 stats_summary:connected_cell=1 stats_summary:connected_wifi=4 stats_summary:os_build=PQ2A.190406.000 cbt set test_table phone#5c10102#20190501 stats_summary:connected_cell=3 stats_summary:connected_wifi=3 stats_summary:os_build=PQ2A.190401.002 cell_plan:data_plan_10gb=false cbt set test_table tablet#5c10102#20190502 stats_summary:connected_cell=2 stats_summary:connected_wifi=0 stats_summary:os_build=PQ2A.190406.000 cell_plan:data_plan_10gb=falseUtilizza il comando
cbt readper leggere tutti i dati nella tabella:cbt read test_tableIl terminale mostra un output simile al seguente. Ogni colonna ora contiene due celle con timestamp univoci.
---------------------------------------- phone#4c410523#20190501 cell_plan:data_plan_01gb @ 2024/07/09-17:48:21.191000 "true" cell_plan:data_plan_01gb @ 2024/07/09-17:46:09.369000 "true" cell_plan:data_plan_05gb @ 2024/07/09-17:48:21.191000 "false" cell_plan:data_plan_05gb @ 2024/07/09-17:46:09.369000 "true" stats_summary:connected_cell @ 2024/07/09-17:48:21.191000 "2" stats_summary:connected_cell @ 2024/07/09-17:46:09.369000 "1" stats_summary:connected_wifi @ 2024/07/09-17:48:21.191000 "5" stats_summary:connected_wifi @ 2024/07/09-17:46:09.369000 "1" stats_summary:os_build @ 2024/07/09-17:48:21.191000 "PQ2A.190405.003" stats_summary:os_build @ 2024/07/09-17:46:09.369000 "PQ2A.190405.003" ---------------------------------------- phone#4c410523#20190502 cell_plan:data_plan_05gb @ 2024/07/09-17:48:22.205000 "false" cell_plan:data_plan_05gb @ 2024/07/09-17:46:10.455000 "true" stats_summary:connected_cell @ 2024/07/09-17:48:22.205000 "2" stats_summary:connected_cell @ 2024/07/09-17:46:10.455000 "1" stats_summary:connected_wifi @ 2024/07/09-17:48:22.205000 "5" stats_summary:connected_wifi @ 2024/07/09-17:46:10.455000 "1" stats_summary:os_build @ 2024/07/09-17:48:22.205000 "PQ2A.190405.004" stats_summary:os_build @ 2024/07/09-17:46:10.455000 "PQ2A.190405.004" ---------------------------------------- phone#4c410523#20190505 stats_summary:connected_cell @ 2024/07/09-17:48:23.206000 "1" stats_summary:connected_cell @ 2024/07/09-17:46:11.402000 "0" stats_summary:connected_wifi @ 2024/07/09-17:48:23.206000 "4" stats_summary:connected_wifi @ 2024/07/09-17:46:11.402000 "1" stats_summary:os_build @ 2024/07/09-17:48:23.206000 "PQ2A.190406.000" stats_summary:os_build @ 2024/07/09-17:46:11.402000 "PQ2A.190406.000" ---------------------------------------- phone#5c10102#20190501 cell_plan:data_plan_10gb @ 2024/07/09-17:48:24.172000 "false" cell_plan:data_plan_10gb @ 2024/07/09-17:46:12.388000 "true" stats_summary:connected_cell @ 2024/07/09-17:48:24.172000 "3" stats_summary:connected_cell @ 2024/07/09-17:46:12.388000 "1" stats_summary:connected_wifi @ 2024/07/09-17:48:24.172000 "3" stats_summary:connected_wifi @ 2024/07/09-17:46:12.388000 "1" stats_summary:os_build @ 2024/07/09-17:48:24.172000 "PQ2A.190401.002" stats_summary:os_build @ 2024/07/09-17:46:12.388000 "PQ2A.190401.002" ---------------------------------------- tablet#5c10102#20190502 cell_plan:data_plan_10gb @ 2024/07/09-17:48:25.194000 "false" cell_plan:data_plan_10gb @ 2024/07/09-17:46:13.391000 "true" stats_summary:connected_cell @ 2024/07/09-17:48:25.194000 "2" stats_summary:connected_cell @ 2024/07/09-17:46:13.391000 "1" stats_summary:connected_wifi @ 2024/07/09-17:48:25.194000 "0" stats_summary:connected_wifi @ 2024/07/09-17:46:13.391000 "0" stats_summary:os_build @ 2024/07/09-17:48:25.194000 "PQ2A.190406.000" stats_summary:os_build @ 2024/07/09-17:46:13.391000 "PQ2A.190406.000"
Utilizza i dati di test
Ora puoi utilizzare test_table su test-instance per testare esempi di codice o query.
Libera spazio
Per evitare che al tuo Google Cloud account vengano addebitati costi relativi alle risorse create durante questi passaggi, elimina l'istanza non appena hai finito di eseguire i test. L'eliminazione del file .cbtrc ti consente di lavorare su un progetto diverso.
Se vuoi conservare l'istanza ma eliminare la tabella, puoi utilizzare il comando
deletetable:cbt deletetable test_tableSe non prevedi di utilizzare l'istanza per ulteriori test, eliminala. Questa azione elimina anche la tabella.
cbt deleteinstance test-instanceElimina il file .cbtrc:
rm ~/.cbtrc