Testtabelle erstellen

Auf dieser Seite werden die Schritte zum Erstellen einer kleinen Bigtable-Tabelle beschrieben, die Sie zum Testen von Code-Snippets verwenden können. Die Tabelle enthält Zeitachsendaten für Smartphones und Tablets.

In dieser Anleitung werden die Google Cloud Console und die cbt-Befehlszeile , ein Befehlszeile, die speziell für Bigtable entwickelt wurde.

Hinweise

Bevor Sie eine Testtabelle erstellen, müssen Sie die folgenden Voraussetzungen erfüllen.

Authentifizierung einrichten

Sie können die gcloud CLI-Beispiele auf dieser Seite über eine der folgenden Entwicklungsumgebungen verwenden:

  • Cloud Shell: Aktivieren Sie Cloud Shell, um ein Onlineterminal mit der bereits eingerichteten gcloud CLI zu verwenden.

    Unten auf dieser Seite wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Das Initialisieren der Sitzung kann einige Sekunden dauern.

  • Lokale Shell: Zur Verwendung der gcloud CLI in einer lokalen Entwicklungsumgebung müssen Sie die gcloud CLI installieren und initialisieren.

Informationen zum Einrichten der Authentifizierung für eine Produktionsumgebung finden Sie unter Set up Application Default Credentials for code running on Google Cloud.

IAM-Rolle gewähren

Um die Berechtigungen zu erhalten, die Sie zum Erstellen einer Testtabelle benötigen, bitten Sie Ihren Administrator, Ihnen Die IAM-Rolle Bigtable-Administrator (roles/bigtable.admin) für Ihr Projekt. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Installieren Sie die cbt-Befehlszeile

Führen Sie den folgenden Befehl aus, um die cbt-Befehlszeile :

  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.

  1. Öffnen Sie in der Google Cloud Console die Seite Instanz erstellen.

    Instanz erstellen

  2. Geben Sie als Instanzname Test instance ein.

  3. Geben Sie als Instanz-ID test-instance ein.

  4. Wählen Sie als Speichertyp SSD aus.

  5. Geben Sie als Cluster-ID test-instance-c1 ein.

  6. Wählen Sie als Region eine Region in Ihrer Nähe aus.

  7. Wählen Sie als Zone eine Zone in der ausgewählten Region aus.

  8. Geben Sie unter Knoten 1 ein.

  9. Klicken Sie auf Erstellen, um die Instanz zu erstellen.

Verbindung zur Instanz herstellen

  1. Konfigurieren Sie die cbt-Befehlszeile um Ihr Projekt und Ihre Instanz zu verwenden, indem Sie ein Datei .cbtrc, wobei PROJECT_ID durch die ID ersetzt wird für das Projekt, in dem Sie Ihre Bigtable-Instanz erstellt haben:

    echo project = PROJECT_ID >> ~/.cbtrc && echo instance = test-instance >> ~/.cbtrc

  2. Prüfen Sie, ob Sie die Datei .cbtrc 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 cbt-Befehlszeile mit Ihrer Instanz.

Testtabelle erstellen

  1. Erstellen Sie eine Tabelle mit dem Namen test_table und 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"

  2. Listen Sie die Spaltenfamilien auf:

       cbt ls test_table

    Die 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

  1. 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=true

  2. Verwenden Sie den Befehl cbt read, um die Daten zu lesen, die Sie der Tabelle hinzugefügt haben:

       cbt read test_table

    Die 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"

  3. Optional: Schreiben Sie neue Werte in dieselben Zeilen und Spalten. Bigtable erstellt neue Zellen mit neuen Zeitstempeln, um neue Versionen der Daten. Kopieren Sie die folgenden Befehle in Ihr Terminal und drücke 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=false

  4. Verwenden Sie den Befehl cbt read, um alle Daten in der Tabelle zu lesen:

       cbt read test_table

    Die Terminalausgabe sollte in etwa so aussehen: Jede Spalte jetzt enthält 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 auf dem 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.

  1. Wenn Sie die Instanz beibehalten, aber die Tabelle löschen möchten, verwenden Sie den Befehl deletetable:

       cbt deletetable test_table

  2. Wenn 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-instance

  3. Löschen Sie die .cbtrc-Datei:

       rm ~/.cbtrc

Nächste Schritte