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 eine speziell für Bigtable entwickelte Befehlszeile.

Hinweise

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

Authentifizierung einrichten

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

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 auf Projekte, Ordner und Organisationen verwalten.

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

cbt CLI installieren

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 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=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 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 test_table in 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