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

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 Standardanmeldedaten für Anwendungen für Code einrichten, der in Google Cloud ausgeführt wird.

IAM-Rolle gewähren

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

Möglicherweise können Sie 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 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.

  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 so, dass Ihr Projekt und Ihre Instanz verwendet werden. Erstellen Sie dazu eine .cbtrc-Datei und ersetzen Sie dabei PROJECT_ID durch die ID des Projekts, in dem Sie die 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 verwenden.

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                 @ 2020/09/23-11:44:10.535000
        "true"
      cell_plan:data_plan_05gb                 @ 2020/09/23-11:44:10.535000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:10.535000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:10.535000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:10.535000
        "PQ2A.190405.003"
    ----------------------------------------
    phone#4c410523#20190502
      cell_plan:data_plan_05gb                 @ 2020/09/23-11:44:11.545000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:11.545000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:11.545000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:11.545000
        "PQ2A.190405.004"
    ----------------------------------------
    phone#4c410523#20190505
    
      stats_summary:connected_cell             @ 2020/09/23-11:44:12.503000
        "0"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:12.503000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:12.503000
        "PQ2A.190406.000"
    ----------------------------------------
    phone#5c10102#20190501
      cell_plan:data_plan_10gb                 @ 2020/09/23-11:44:13.553000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:13.553000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:13.553000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:13.553000
        "PQ2A.190401.002"
    ----------------------------------------
    tablet#5c10102#20190502
      cell_plan:data_plan_10gb                 @ 2020/09/23-11:44:14.480000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:14.480000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:14.480000
        "0"
      stats_summary:os_build                   @ 2020/09/23-11:44:14.480000
             "PQ2A.190406.000"

Testdaten verwenden

Sie können jetzt das test-table für test-instance verwenden, um Code-Snippets auszuprobieren, wie sie unter Bigtable mit Cloud Functions verwenden.

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