Instanz erstellen und Daten mit der cbt-Befehlszeile schreiben

Wenn Sie sich mit Bigtable vertraut machen, können Sie eine Kurzanleitung durcharbeiten, um einen Eindruck von den Grundlagen zu erhalten, die Sie in einer Produktionsumgebung in großem Maßstab anwenden würden.

In dieser Kurzanleitung führen Sie die folgenden Aktionen aus:

  • Verbindung zu einer Bigtable-Instanz herstellen
  • Grundlegende Verwaltungsaufgaben ausführen
  • Daten in eine Tabelle schreiben
  • Daten aus einer Tabelle lesen

Hinweise

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
  2. Installieren Sie die Google Cloud CLI.
  3. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

    gcloud init
  4. Google Cloud-Projekt erstellen oder auswählen.

    • Erstellen Sie ein Google Cloud-Projekt:

      gcloud projects create PROJECT_ID

      Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud-Projekt, das Sie erstellen.

    • Wählen Sie das von Ihnen erstellte Google Cloud-Projekt aus:

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch den Namen Ihres Google Cloud-Projekts.

  5. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  6. Aktivieren Sie die Cloud Bigtable and Cloud Bigtable Admin APIs:

    gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com
  7. Gewähren Sie Ihrem Google-Konto Rollen. Führen Sie den folgenden Befehl für jede der folgenden IAM-Rollen einmal aus: roles/bigtable.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.
    • Ersetzen Sie EMAIL_ADDRESS durch Ihre E-Mail-Adresse.
    • Ersetzen Sie ROLE durch jede einzelne Rolle.
  8. Installieren Sie die Google Cloud CLI.
  9. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

    gcloud init
  10. Google Cloud-Projekt erstellen oder auswählen.

    • Erstellen Sie ein Google Cloud-Projekt:

      gcloud projects create PROJECT_ID

      Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud-Projekt, das Sie erstellen.

    • Wählen Sie das von Ihnen erstellte Google Cloud-Projekt aus:

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch den Namen Ihres Google Cloud-Projekts.

  11. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  12. Aktivieren Sie die Cloud Bigtable and Cloud Bigtable Admin APIs:

    gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com
  13. Gewähren Sie Ihrem Google-Konto Rollen. Führen Sie den folgenden Befehl für jede der folgenden IAM-Rollen einmal aus: roles/bigtable.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.
    • Ersetzen Sie EMAIL_ADDRESS durch Ihre E-Mail-Adresse.
    • Ersetzen Sie ROLE durch jede einzelne Rolle.
  14. Führen Sie den folgenden Befehl aus, um die cbt-Befehlszeile zu installieren:
    gcloud components install cbt

Bigtable-Instanz erstellen

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

    Instanz erstellen

  2. Geben Sie als Instanzname Quickstart instance ein.

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

  4. Klicken Sie auf Weiter.

  5. Wählen Sie als Speichertyp SSD aus.

  6. Klicken Sie auf Weiter.

  7. Geben Sie als Cluster-ID quickstart-instance-c1 ein.

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

  9. Wählen Sie unter Zone die Option Beliebig aus.

  10. Wählen Sie unter Knotenskalierungsmodus die Option Manuelle Zuordnung aus.

  11. Wählen Sie unter Menge die Option 1 aus.

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

Mit Instanz verbinden

  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 = quickstart-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 = quickstart-instance

    Jetzt können Sie die cbt-Befehlszeile mit Ihrer Instanz verwenden.

Daten lesen und schreiben

Bigtable speichert Daten in Tabellen, die Zeilen enthalten. Jede Zeile wird durch einen Zeilenschlüssel identifiziert.

Daten innerhalb einer Zeile sind in Spaltenfamilien organisiert, d. h. in Gruppen von Spalten. Ein Spaltenqualifizierer identifiziert eine einzelne Spalte innerhalb einer Spaltenfamilie.

Es können mehrere Zellen mit Zeitstempeln am Schnittpunkt zwischen einer Zeile und einer Spalte vorhanden sein.

  1. Erstellen Sie eine Tabelle mit dem Namen my-table.

    cbt createtable my-table
  2. Listen Sie Ihre Tabellen auf:

    cbt ls

    Die Befehlsausgabe sollte in etwa so aussehen:

        my-table

  3. Fügen Sie eine Spaltenfamilie mit dem Namen cf1 hinzu:

    cbt createfamily my-table cf1
  4. Listen Sie die Spaltenfamilien auf:

    cbt ls my-table

    Die Befehlsausgabe sollte in etwa so aussehen:

        Family Name     GC Policy
        -----------     ---------
        cf1             <never>

  5. Schreiben Sie die Werte test-value1 und test-value2 in die Zeile r1. Verwenden Sie dazu die Spaltenfamilie cf1 und den Spaltenqualifizierer c1:

    cbt set my-table r1 cf1:c1=test-value1
      cbt set my-table r1 cf1:c1=test-value2
    
  6. Verwenden Sie den Befehl cbt read, um die Daten zu lesen, die Sie der Tabelle hinzugefügt haben:

    cbt read my-table

    In der Shell wird in etwa Folgendes angezeigt:

        ----------------------------------------
        r1
          cf1:c1                                   @ 2023/03/22-06:56:11.323000
            "test-value1"
          cf1:c1                                   @ 2023/03/22-06:56:04.361000
            "test-value2"

    Zwei Werte mit Zeitstempel werden für dieselbe Spalte in Zeile r1 gespeichert.

Bereinigen

Löschen Sie die Instanz, um zu vermeiden, dass Ihrem Google Cloud-Konto die in dieser Kurzanleitung verwendeten Ressourcen in Rechnung gestellt werden. Wenn Sie die Datei .cbtrc löschen, können Sie mit einem anderen Projekt arbeiten.

  1. Löschen Sie die Tabelle my-table:

    cbt deletetable my-table
  2. Löschen Sie die Instanz:

    cbt deleteinstance quickstart-instance
  3. Löschen Sie die Datei .cbtrc:

    rm ~/.cbtrc

  4. Optional: Widerrufen Sie Anmeldedaten von der gcloud-CLI:

    gcloud auth revoke

Nächste Schritte