Testtabelle erstellen
Auf dieser Seite werden die Schritte zum Erstellen einer kleinen Bigtable-Tabelle beschrieben, mit der Sie Code-Snippets testen können. Die Tabelle enthält Zeitachsendaten für Smartphones und Tablets.
In dieser Anleitung werden die Google Cloud console und die
cbt CLI
verwendet, eine
Befehlszeilenschnittstelle, die speziell für Bigtable entwickelt wurde.
Hinweis
Bevor Sie eine Testtabelle erstellen, müssen die folgenden Voraussetzungen erfüllt sein.
Authentifizierung einrichten
Aktivieren Sie Cloud Shell in der Google Cloud console.
Unten in der Google Cloud console wird eine Cloud Shell Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.
Informationen zum Einrichten der Authentifizierung für eine Produktionsumgebung finden Sie unter Standardanmeldedaten für Anwendungen für Code einrichten, der in ausgeführt wird Google Cloud .
IAM-Rolle gewähren
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Bigtable Administrator (roles/bigtable.admin) für Ihr Projekt zu erteilen, um die Berechtigungen zu erhalten, die Sie zum Erstellen einer Testtabelle benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
cbt-Befehlszeile installieren
Führen Sie den folgenden Befehl aus, um die
cbt Befehlszeile
zu installieren:
gcloud components install cbt
Instanz erstellen
Erstellen Sie in dem Projekt Ihrer Wahl eine Testinstanz, um Ihre Testtabelle zu speichern. Die Tabelle ist klein, sodass Sie nur eine Instanz mit einem einzigen Knoten benötigen.
Öffnen Sie in der Google Cloud console die Seite Instanz erstellen.
Geben Sie als Instanzname
Test instanceein.Geben Sie als Instanz-ID
test-instanceein.Wählen Sie als Speichertyp SSD aus.
Geben Sie als Cluster-ID
test-instance-c1ein.Wählen Sie als Region eine Region in Ihrer Nähe aus.
Wählen Sie als Zone eine Zone in der ausgewählten Region aus.
Geben Sie unter Knoten
1ein.Klicken Sie auf Erstellen, um die Instanz zu erstellen.
Verbindung zur Instanz herstellen
Konfigurieren Sie die
cbtCLI so, dass Ihr Projekt und Ihre Instanz verwendet werden. Erstellen Sie dazu eine.cbtrcDatei und ersetzen SiePROJECT_IDdurch die ID des Projekts, in dem Sie die Bigtable-Instanz erstellt haben:echo project = PROJECT_ID >> ~/.cbtrc && echo instance = test-instance >> ~/.cbtrc
Prüfen Sie, ob Sie die
.cbtrc-Datei korrekt eingerichtet haben:cat ~/.cbtrc
Das Terminal zeigt den Inhalt der Datei
.cbtrc, der in etwa so aussieht:project = PROJECT_ID instance = test-instance
Jetzt können Sie die
cbtBefehlszeile mit Ihrer Instanz verwenden.
Testtabelle erstellen
Erstellen Sie eine Tabelle mit dem Namen
test_tableund zwei Spaltenfamilien. Legen Sie für jede Spaltenfamilie eine Richtlinie für die automatische Speicherbereinigung fest, um maximal zwei Zellen pro Spalte beizubehalten:cbt createtable test_table "families=stats_summary:maxversions=2,stats_detail:maxversions=2,cell_plan:maxversions=2"Listen Sie die Spaltenfamilien auf:
cbt ls test_tableDie Terminalausgabe sollte in etwa so aussehen:
Family Name GC Policy ----------- --------- stats_detail versions() > 2 stats_summary versions() > 2 cell_plan versions() > 2
Tabelle ausfüllen
Kopieren Sie die folgenden Befehle in das Terminalfenster und drücken Sie
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=trueVerwenden Sie den Befehl
cbt read, um die Daten zu lesen, die Sie der Tabelle hinzugefügt haben:cbt read test_tableDie Terminalausgabe sollte in etwa so aussehen: Beachten Sie, dass Zeitstempel automatisch Zellen zugewiesen werden, da Ihre Schreibanfrage keine Zeitstempel enthält.
---------------------------------------- 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"Optional: Schreiben Sie neue Werte in dieselben Zeilen und Spalten. Bigtable erstellt neue Zellen mit neuen Zeitstempeln, um die neuen Versionen der Daten zu speichern. Kopieren Sie die folgenden Befehle in das Terminalfenster und drücken Sie
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=falseVerwenden Sie den Befehl
cbt read, um alle Daten in der Tabelle zu lesen:cbt read test_tableDie Terminalausgabe sollte in etwa so aussehen: Jede Spalte enthält jetzt zwei Zellen mit eindeutigen Zeitstempeln.
---------------------------------------- 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"
Testdaten verwenden
Sie können jetzt die test_table in der test-instance verwenden, um Codebeispiele oder Abfragen zu testen.
Bereinigen
Löschen Sie die Instanz, wenn Sie mit dem Testen fertig sind. Dadurch vermeiden Sie, dass Ihrem Google Cloud Konto die in diesen Schritten erstellten Ressourcen in Rechnung gestellt werden. Wenn Sie die Datei .cbtrc löschen, können Sie mit einem anderen Projekt arbeiten.
Wenn Sie die Instanz beibehalten, aber die Tabelle löschen möchten, verwenden Sie den Befehl
deletetable:cbt deletetable test_tableWenn Sie die Instanz nicht für weitere Tests verwenden möchten, löschen Sie die Instanz. Mit dieser Aktion wird auch die Tabelle gelöscht.
cbt deleteinstance test-instanceLöschen Sie die .cbtrc-Datei:
rm ~/.cbtrc