Abfragen in der Konsole erstellen

Sie können Ihre Bigtable-Daten mit dem Query Builder von Bigtable Studio abfragen und ansehen. Der Query Builder ist ein interaktives Formular in der Google Cloud Konsole, mit dem Sie eine Abfrage erstellen, sie für eine Tabelle ausführen und die Ergebnisse dann in der Konsole ansehen können.

Mit dem Query Builder von Bigtable Studio können Sie Drop-down-Auswahlen verwenden, um eine Kombination von Abfrageklauseln anzugeben, ohne eine Anwendung schreiben oder eine CLI verwenden zu müssen. Wenn Sie die Abfrage ausführen, ruft die Console die Bigtable Data API auf, die Daten zurückgibt, die Ihrer Abfrage entsprechen.

In diesem Dokument wird beschrieben, wie Sie den Query Builder verwenden, und es werden Tipps zur Optimierung Ihrer Abfragen gegeben. Voraussetzung dafür ist die Kenntnis der Übersicht über Bigtable .

Für Abfragen, die im Query Builder ausgeführt werden, gelten dieselben Preise und Kontingente wie für alle anderen Abfragen, die an eine Tabelle gesendet werden.

Wann sollte der Query Builder verwendet werden?

Die Möglichkeit, Ihre Bigtable-Daten in der Google Cloud Konsole abzufragen, ist hilfreich, wenn Sie Folgendes tun müssen:

  • Schnell eine visuelle Darstellung des Schemas Ihrer Tabelle abrufen
  • Prüfen, ob bestimmte Daten erfolgreich geschrieben wurden
  • Datenintegrität während einer Migration prüfen
  • Mögliche Datenprobleme beheben
  • Eine Vorschau der Ergebnisse ansehen, die eine bestimmte Kombination von Klauseln zurückgibt, bevor Sie sie in Ihrem Code verwenden Dies kann besonders für neue Bigtable-Nutzer sowie für erfahrene Nutzer hilfreich sein, die die cbt CLI nicht verwenden möchten.

Hinweis

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Bigtable Reader (roles/bigtable.reader) für das Projekt zu erteilen, um die für die Nutzung des Query Builders erforderlichen Berechtigungen zu erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die für die Verwendung des Query Builders erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen , um die notwendigen Berechtigungen anzuzeigen, die erforderlich sind:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind für die Verwendung des Query Builders erforderlich:

  • bigtable.tables.get
  • bigtable.instances.get
  • bigtable.appProfiles.list
  • bigtable.tables.list
  • bigtable.tables.readRows

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Wenn Sie keine Tabelle zum Abfragen haben, können Sie eine kleine Testtabelle erstellen und Ihre Abfragen darauf ausführen.

Query Builder öffnen

Wenn Sie den Query Builder öffnen, wird eine Standardabfrage ausgeführt und für die erste Tabelle in der Instanz in alphabetischer Reihenfolge angezeigt. Die Standardabfrage wird mit dem Standardanwendungsprofil ausgeführt und es werden bis zu 100 Zeilen zurückgegeben.

  1. Öffnen Sie in der Google Cloud Konsole die Liste der Bigtable-Instanzen.

    Liste der Instanzen öffnen

  2. Klicken Sie auf den Namen der Instanz, die die Tabelle enthält, die Sie abfragen möchten.

  3. Klicken Sie im Navigationsbereich auf Bigtable Studio. Die Seite Bigtable Studio wird im Query Builder-Modus geöffnet. Im Bereich Explorer wird eine Liste der Tabellen in der Instanz angezeigt und im Bereich Abfrageergebnisse werden die Ergebnisse der Standardabfrage angezeigt.

  4. Optional: Minimieren Sie den Bereich Explorer , um den Bereich des Query Builders zu vergrößern.

Datenanzeigeformat

Die Ergebnisse des Query Builders werden in einer Tabelle angezeigt. Die erste Überschrift und Spalte ist Zeilenschlüssel. Die übrigen Überschriften stellen jeweils eine Spalte in der Bigtable-Tabelle dar, ausgedrückt als Spaltenfamilie und Spaltenqualifizierer, getrennt durch einen Doppelpunkt. Die Überschrift cell_plan: data_plan_01gb gibt beispielsweise an, dass die Werte in dieser Spalte aus der Spalte data_plan_01gb in der Spaltenfamilie cell_plan stammen.

Drop-down-Menü

Es wird nur der letzte Wert für eine Spalte zurückgegeben. Zeitstempel sind standardmäßig ausgeblendet. Sie können sie aber mit dem Schalter einblenden.

Tabelle auswählen

Wählen Sie im Drop-down-Menü Tabelle die ID der Tabelle aus, die Sie abfragen möchten.

Optional: Anwendungsprofil angeben

Sie können ein Anwendungsprofil verwenden, das Sie speziell für die Verwendung mit dem Query Builder erstellen. Dies kann beispielsweise hilfreich sein, wenn Sie den Abfragetraffic isolieren möchten, indem Sie einen anderen Cluster als den verwenden, der von Ihrer primären Anwendung verwendet wird.

So verwenden Sie ein anderes Anwendungsprofil, um Ihre nächste Abfrage auszuführen:

  1. Klicken Sie auf Zur Abfrage hinzufügen.
  2. Klicken Sie auf Anwendungsprofil ändern (Standard). Ein neues Drop-down-Menü wird angezeigt.
  3. Wählen Sie im Drop-down-Menü Anwendungsprofil ein Anwendungsprofil aus der Liste der Anwendungsprofile der Instanz aus.

Weitere Informationen zu den Vorteilen der Verwendung verschiedener Anwendungsprofile für verschiedene Arbeitslasten finden Sie unter Anwendungsprofile . Informationen zum Erstellen eines Anwendungsprofils finden Sie unter Anwendungsprofile erstellen und konfigurieren .

Wenn sich Ihre Tabelle in einer Instanz mit Replikation befindet, konfigurieren Sie Ihr Anwendungsprofil so, dass Daten aus dem Cluster gelesen werden, der sich geografisch am nächsten befindet.

Klauseln zur Abfrage hinzufügen und dann ausführen

  1. Nachdem Sie die Tabelle und das Anwendungsprofil ausgewählt haben, fügen Sie der Abfrage Klauseln hinzu. Details zu den verfügbaren Klauseln finden Sie im nächsten Abschnitt.
  2. Nachdem Sie alle Klauseln hinzugefügt haben, klicken Sie auf Ausführen.
  3. Rufen Sie die Ergebnisse auf.

Abfrageklauseln

Mit dem Query Builder fügen Sie Ihrer Abfrage Klauseln hinzu. Wenn Sie die Abfrage ausführen, erstellt und sendet der Query Builder eine Leseanfrage an Ihre Tabelle. Weitere Informationen zu Leseanfragen finden Sie unter Lesevorgänge.

Die Klauseln für Zeilenschlüssel, Zeilenschlüsselbereich und Zeilenschlüsselpräfix bestimmen die Zeilen, die aus dem Speicher abgerufen werden. Die Klauseln für Zeilenschlüssel-Regex, Spalten und Zeitraum fügen der generierten Leseanfrage einen Filter hinzu. Filter, die Sie im Query Builder verwenden, funktionieren genauso wie in den Clientbibliotheken. Weitere Informationen zu Bigtable-Filtern und dazu, wie sich ihre Verwendung auf die Leistung auswirken kann, finden Sie unter Filter und Filter verwenden .

Zeilenschlüssel angeben

Wenn Sie eine einzelne Zeile aus der Tabelle abrufen möchten, geben Sie einen Zeilenschlüsselwert an. Sie können mehrere Zeilenschlüsselklauseln hinzufügen.

  1. Klicken Sie auf Zur Abfrage hinzufügen.
  2. Wählen Sie in der Drop-down-Liste Zeilenschlüssel aus.
  3. Geben Sie den genauen Wert des Zeilenschlüssels ein, für den Sie Werte ansehen möchten.

Zeilenschlüsselbereich angeben

Wenn Sie einen Bereich von Zeilen aus der Tabelle abrufen möchten, geben Sie einen Start- und einen Endzeilenschlüssel an. Bigtable speichert Daten in lexikografischer Reihenfolge nach Zeilenschlüssel.

  1. Klicken Sie auf Zur Abfrage hinzufügen.
  2. Wählen Sie in der Drop-down-Liste Zeilenschlüsselbereich aus.
  3. Geben Sie den vollständigen Startzeilenschlüssel ein.
  4. Geben Sie den vollständigen Endzeilenschlüssel ein.

Zeilenschlüsselpräfix angeben

Wenn Sie nur Zeilen abrufen möchten, deren Zeilenschlüssel mit einer bestimmten Zeichenfolge beginnen, filtern Sie nach Zeilenschlüsselpräfix. Ein Zeilenschlüsselpräfix besteht aus den ersten N Zeichen eines Zeilenschlüssels. Konventionsgemäß befindet sich oft ein Hashtag, ein senkrechter Strich oder ein anderes Symbol zwischen dem Präfix und dem Rest des Zeilenschlüssels.

  1. Klicken Sie auf Zur Abfrage hinzufügen.
  2. Wählen Sie in der Drop-down-Liste Zeilenschlüsselpräfix aus.
  3. Geben Sie ein Zeilenschlüsselpräfix ein. Sie müssen keine Platzhaltersymbole eingeben.

Nach Zeilenschlüssel-Regex filtern

Wenn Sie nur Zeilen abrufen möchten, deren Zeilenschlüsselwerte einem bestimmten regulären Ausdruck entsprechen, verwenden Sie einen Zeilenschlüssel-Regex-Filter. Für eine bessere Leistung fügen Sie der Abfrage eine Klausel für den Zeilenschlüsselbereich oder das Zeilenschlüsselpräfix hinzu, bevor Sie den Zeilenschlüssel-Regex-Filter hinzufügen. Eine Anleitung zum Erstellen Ihres regulären Ausdrucks finden Sie unter Zeilenschlüssel Regex .

  1. Klicken Sie auf Zur Abfrage hinzufügen.
  2. Wählen Sie in der Drop-down-Liste Zeilenschlüssel-Regex aus.
  3. Geben Sie einen regulären Ausdruck ein, der die RE2 Syntax verwendet.

Nach Spalte filtern

Wenn Sie eine oder mehrere Spalten angeben möchten, die in die Abfrage aufgenommen werden sollen, fügen Sie eine Spalten -Klausel hinzu und wählen Sie für jede Spalte, nach der Sie filtern möchten, die Spaltenfamilie und den Spaltenqualifizierer aus. Die Leseanfrage, die beim Hinzufügen dieser Klausel generiert wird, enthält den Spaltenfamilien-Regex Filter und den Spaltenbereichs Filter .

  1. Klicken Sie auf Zur Abfrage hinzufügen.
  2. Wählen Sie in der Drop-down-Liste Spalten aus.
  3. Klicken Sie in das Feld „Spalten“. Eine Liste der Spaltenfamilien wird angezeigt.
  4. Klicken Sie auf eine Spaltenfamilien-ID. Eine Liste der Spaltenqualifizierer wird angezeigt.
  5. Klicken Sie auf einen Spaltenqualifizierer.

Nach Zeitraum filtern

Wenn Sie nur Zellen mit einem Zeitstempel in einem bestimmten Bereich abrufen möchten, fügen Sie eine Zeitraumklausel hinzu, die den Zeitstempelbereichsfilter verwendet.

  1. Klicken Sie auf Zur Abfrage hinzufügen.
  2. Wählen Sie in der Drop-down-Liste Zeitraum aus.
  3. Geben Sie einen Startzeitstempel ein.
  4. Geben Sie einen Endzeitstempel ein.

Geben Sie einen Zeitstempel in einem der folgenden Formate an:

  • Ein Unix-Zeitstempel in Mikrosekunden, z. B. 3023483279876000
  • YYYY-MM-DDThh:mm:ss:ss[z]
  • YYYY/MM/DD-hh:mm:ss.sss[z]
  • MM/TT/JJJJ
  • JJJJ/MM/TT

Das optionale T ist ein Literal, das die Zeit angibt, und das optionale z gibt die UTC-Zeit anstelle der Ortszeit an. Weitere Informationen zu Zeitstempel formaten finden Sie unter ISO 8601 .

Limit angeben

Wenn Sie eine maximale Anzahl von zurückgegebenen Zeilen angeben möchten, fügen Sie eine Limitklausel hinzu.

  1. Klicken Sie auf Zur Abfrage hinzufügen.
  2. Wählen Sie in der Drop-down-Liste Limit aus.
  3. Geben Sie eine Zahl zwischen 1 und 1.000 ein.

Beschränkungen

Für den Query Builder gelten die folgenden Beschränkungen.

  • 1.000 Zeichen pro Zelle : Bigtable gibt maximal 1.000 Zeichen pro Zelle zurück. Wenn eine Zelle mehr als 1.000 Zeichen enthält, wird ein abgeschnittenes Ergebnis angezeigt, das mit der Anzahl der nicht angezeigten Zeichen versehen ist.
  • Maximal 100 Spalten : Bigtable gibt die ersten 100 Spalten in jeder Zeile zurück, die der Abfrage entsprechen. Spaltenfamilien werden nicht in einer bestimmten Reihenfolge gespeichert, aber Spalten werden innerhalb ihrer Spaltenfamilie lexikografisch sortiert.
  • Maximal 1.000 Zeilen : Der Query Builder gibt maximal die ersten 1.000 Zeilen mit Daten zurück, die Ihrer Abfrage entsprechen.
  • Base64 : Bigtable versucht, Base64-codierte Daten genau anzuzeigen, aber Ergebnisse können nicht garantiert werden. Wenn Bigtable die Daten in einer Zelle nicht anzeigen kann, wird stattdessen die Größe des Zellenwerts in Byte angezeigt.

  • Ältere Daten : Sie können nur die letzte Zelle (oder Version) in den Spalten abrufen, die Sie abfragen. Weitere Informationen zu diesem Konzept finden Sie unter Bigtable-Speicher modell und Allgemeine Konzepte

  • Serialisierte Daten : Daten, die als Protocol Buffers gespeichert sind, werden in den Abfrageergebnissen nicht korrekt angezeigt. JSON-Daten werden besser unterstützt, aber es kann nicht garantiert werden, dass sie korrekt angezeigt werden.

  • Künstliche Zeitstempel : Wenn Ihre Anwendung beim Schreiben von Daten in Ihre Tabelle keine Zeitstempelzahlen für die Zeitstempeleiigenschaft von Zellen zuweist, können Sie in Ihrer Abfrage Zeitbereichsfilter verwenden, um einen Bereich der Werte abzurufen, die Sie anstelle von Zeitstempeln verwenden, sofern Sie sie als Mikrosekunden angeben. Informationen dazu, warum Ihre Tabellendaten möglicherweise künstliche Zeitstempel verwenden, finden Sie unter Zeitstempel.

Nächste Schritte