Kurzanleitung: Instanz erstellen und Daten mit der cbt-Befehlszeile schreiben

Instanz erstellen und Daten mit der cbt-Befehlszeile schreiben

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

Hinweis: Sie können Bigtable-Vorgänge entweder über die HBase Shell oder das cbt-Tool ausführen. Wenn Sie damit vertraut sind, verwenden Sie die HBase-Shell. Andernfalls empfehlen wir die Verwendung der cbt CLI. Diese hat weniger Abhängigkeiten und Installationsschritte. Die cbt CLI ist eine Komponente der Google Cloud CLI.

In dieser Anleitung wird die cbt-Befehlszeile verwendet. Wenn Sie HBase Shell bevorzugen, befolgen Sie stattdessen die Kurzanleitung mit HBase Shell.

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

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

Sie können diese Kurzanleitung mit der Cloud Shell oder in Ihrem lokalen Terminalfenster durchführen.

Hinweis

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. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   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 dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

4. Cloud Bigtable, Cloud Bigtable Admin APIs aktivieren.

   Aktivieren Sie die APIs

5. Erstellen Sie ein Dienstkonto:

   1. Wechseln Sie in der Console zur Seite Dienstkonto erstellen.

      Zur Seite „Dienstkonto erstellen“
   2. Wählen Sie Ihr Projekt aus.

   3. Geben Sie im Feld Dienstkontoname einen Namen ein. Die Console füllt das Feld Dienstkonto-ID anhand dieses Namens aus.

      Geben Sie im Feld Dienstkontobeschreibung eine Beschreibung ein. Beispiel: Service account for quickstart.

   4. Klicken Sie auf Erstellen und fortfahren.

   5. Um Zugriff auf Ihr Projekt zu gewähren, weisen Sie Ihrem Dienstkonto die folgenden Rollen zu: Bigtable Administrator .

      Wählen Sie in der Liste Rolle auswählen eine Rolle aus.

      Klicken Sie auf Weitere Rolle hinzufügen, um weitere Rollen hinzuzufügen.

      Hinweis: Das Feld Rolle hat Einfluss darauf, auf welche Ressourcen in Ihrem Projekt das Dienstkonto zugreifen kann. Sie können diese Rollen später widerrufen oder zusätzliche Rollen erteilen. In Produktionsumgebungen sollten Sie die Inhaber-, Bearbeiter- und Betrachterrolle nicht zuweisen. Gewähren Sie stattdessen eine vordefinierte Rolle oder eine benutzerdefinierte Rolle, die Ihren Anforderungen entspricht.
   6. Klicken Sie auf Weiter.

   7. Klicken Sie auf Fertig, um das Erstellen des Dienstkontos abzuschließen.

      Schließen Sie das Browserfenster nicht. Sie verwenden es in der nächsten Aufgabe.

6. Erstellen Sie einen Dienstkontoschlüssel:

   1. Klicken Sie in der Console auf die E-Mail-Adresse des von Ihnen erstellten Dienstkontos.
   2. Klicken Sie auf Schlüssel.
   3. Klicken Sie auf Schlüssel hinzufügen und dann auf Neuen Schlüssel erstellen.
   4. Klicken Sie auf Erstellen. Daraufhin wird eine JSON-Schlüsseldatei auf Ihren Computer heruntergeladen.
   5. Klicken Sie auf Schließen.
7. Installieren und initialisieren Sie Google Cloud CLI.
   Hinweis: Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die neueste Version haben, indem Sie gcloud components update ausführen.

8. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   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 dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

9. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

10. Cloud Bigtable, Cloud Bigtable Admin APIs aktivieren.

    Aktivieren Sie die APIs

11. Erstellen Sie ein Dienstkonto:

    1. Wechseln Sie in der Console zur Seite Dienstkonto erstellen.

       Zur Seite „Dienstkonto erstellen“
    2. Wählen Sie Ihr Projekt aus.

    3. Geben Sie im Feld Dienstkontoname einen Namen ein. Die Console füllt das Feld Dienstkonto-ID anhand dieses Namens aus.

       Geben Sie im Feld Dienstkontobeschreibung eine Beschreibung ein. Beispiel: Service account for quickstart.

    4. Klicken Sie auf Erstellen und fortfahren.

    5. Um Zugriff auf Ihr Projekt zu gewähren, weisen Sie Ihrem Dienstkonto die folgenden Rollen zu: Bigtable Administrator .

       Wählen Sie in der Liste Rolle auswählen eine Rolle aus.

       Klicken Sie auf Weitere Rolle hinzufügen, um weitere Rollen hinzuzufügen.

       Hinweis: Das Feld Rolle hat Einfluss darauf, auf welche Ressourcen in Ihrem Projekt das Dienstkonto zugreifen kann. Sie können diese Rollen später widerrufen oder zusätzliche Rollen erteilen. In Produktionsumgebungen sollten Sie die Inhaber-, Bearbeiter- und Betrachterrolle nicht zuweisen. Gewähren Sie stattdessen eine vordefinierte Rolle oder eine benutzerdefinierte Rolle, die Ihren Anforderungen entspricht.
    6. Klicken Sie auf Weiter.

    7. Klicken Sie auf Fertig, um das Erstellen des Dienstkontos abzuschließen.

       Schließen Sie das Browserfenster nicht. Sie verwenden es in der nächsten Aufgabe.

12. Erstellen Sie einen Dienstkontoschlüssel:

    1. Klicken Sie in der Console auf die E-Mail-Adresse des von Ihnen erstellten Dienstkontos.
    2. Klicken Sie auf Schlüssel.
    3. Klicken Sie auf Schlüssel hinzufügen und dann auf Neuen Schlüssel erstellen.
    4. Klicken Sie auf Erstellen. Daraufhin wird eine JSON-Schlüsseldatei auf Ihren Computer heruntergeladen.
    5. Klicken Sie auf Schließen.
13. Installieren und initialisieren Sie Google Cloud CLI.
    Hinweis: Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die neueste Version haben, indem Sie gcloud components update ausführen.
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. Wählen Sie als Speichertyp SSD aus.

5. Geben Sie als Cluster-ID quickstart-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. 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 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 zeitlich gestaffelte Versionen des Werts am Schnittpunkt zwischen einer Zeile und einer Spalte vorhanden sein. Jede Version wird als Zelle bezeichnet.

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. Geben Sie den Wert test-value in der Zeile r1 ein. Nutzen Sie dazu die Spaltenfamilie cf1 und den Spaltenqualifizierer c1:

      cbt set my-table r1 cf1:c1=test-value

   Hinweis: In dieser Kurzanleitung können Sie nur eine Zelle festlegen. Mit Bigtable können Sie jedoch bis zu 1.000 Zellen in einer einzelnen Schreibanfrage einrichten.

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

      cbt read my-table

   Shell zeigt in etwa Folgendes an:

       ----------------------------------------
       r1
         cf1:c1                                   @ 2019/11/26-15:05:38.840000
           "test-value"

   Da Sie keinen Zeitstempel angegeben haben, wird dieser automatisch hinzugefügt.

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

Weitere Informationen

• Bigtable-Codelab durcharbeiten.
• Sehen Sie sich die Referenzdokumentation zur cbt CLI an.
• Eine Hello-World-Anwendung schreiben in C#, C++, Go, Java, Node.js, PHP, Python, Ruby oder mit HBase-Client für Java.