Instanz erstellen und Daten mit der cbt-Befehlszeile schreiben

Wenn Sie sich über Bigtable informieren, erhalten Sie in einer Kurzanleitung einen Einblick in die Grundlagen, die Sie in einer Produktionsumgebung einsetzen.

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

Hinweis

Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch nicht mit Google Cloudvertraut sind, erstellen Sie ein Konto, um die Leistung 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.
Installieren Sie die Google Cloud CLI.
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.
Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind
• Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können ein beliebiges Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
• Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die resourcemanager.projects.create Berechtigung enthält. Rollen zuweisen.
Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit ihm verknüpften Ressourcen entfernen.
• 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 Google Cloud Projekt aus, das Sie erstellt haben:

  gcloud config set project PROJECT_ID

  Ersetzen Sie PROJECT_ID durch Ihren Google Cloud Projektnamen.
Prüfen Sie, ob die Abrechnung für Ihr Google Cloud Projekt aktiviert ist.
Aktivieren Sie die Cloud Bigtable API und die Cloud Bigtable Admin API:
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Rollen zuweisen.
gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com
Weisen Sie Ihrem Nutzerkonto Rollen zu. 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:USER_IDENTIFIER" --role=ROLE
Ersetzen Sie Folgendes:
• PROJECT_ID: Ihre Projekt-ID.
• USER_IDENTIFIER: Die Kennung für Ihr Nutzerkonto. Beispiel: [e-mail].
• ROLE: Die IAM-Rolle, die Sie Ihrem Nutzerkonto zuweisen.

Installieren Sie die Google Cloud CLI.

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:

gcloud init

Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

• Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können ein beliebiges Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
• Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die resourcemanager.projects.create Berechtigung enthält. Rollen zuweisen.

Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit ihm verknüpften Ressourcen entfernen.

• 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 Google Cloud Projekt aus, das Sie erstellt haben:

  gcloud config set project PROJECT_ID

  Ersetzen Sie PROJECT_ID durch Ihren Google Cloud Projektnamen.

Prüfen Sie, ob die Abrechnung für Ihr Google Cloud Projekt aktiviert ist.

Aktivieren Sie die Cloud Bigtable API und die Cloud Bigtable Admin API:

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Rollen zuweisen.

gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com

Weisen Sie Ihrem Nutzerkonto Rollen zu. 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:USER_IDENTIFIER" --role=ROLE

Ersetzen Sie Folgendes:

• PROJECT_ID: Ihre Projekt-ID.
• USER_IDENTIFIER: Die Kennung für Ihr Nutzerkonto. Beispiel: [e-mail].
• ROLE: Die IAM-Rolle, die Sie Ihrem Nutzerkonto zuweisen.
1. 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 CLI so, dass Ihr Projekt und Ihre Instanz verwendet werden. Erstellen Sie dazu eine .cbtrc Datei und ersetzen Sie 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 .cbtrc-Datei korrekt eingerichtet haben:

   cat ~/.cbtrc

   Das Terminal zeigt den Inhalt der .cbtrc-Datei, 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 mit der Spaltenfamilie cf1 und dem Spaltenqualifizierer c1 in die Zeile r1:

   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"

   Für dieselbe Spalte in Zeile r1 sind zwei Werte mit Zeitstempel gespeichert.

   Hinweis: In dieser Kurzanleitung richten Sie nur zwei Zellen ein, aber mit Bigtable können Sie bis zu 10.000 Zellen in einer einzelnen Schreibanfrage einrichten.

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 .cbtrc-Datei 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

• Ein Bigtable-Codelab durcharbeiten.
• Referenzdokumentation zur cbt Befehlszeile ansehen.
• Sehen Sie sich den Beispielquellcode für einen Anwendungsfall zur Betrugserkennung an.
• Eine Hello-World-Anwendung schreiben in C#, C++, Go, Java, Node.js, PHP, Python, Ruby oder mit HBase-Client für Java.