Abfragen in der Console erstellen

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

Im Query Builder von Bigtable Studio können Sie Drop-down-Selektoren verwenden, um eine Kombination von Abfrageklauseln anzugeben, ohne eine Anwendung schreiben oder eine Befehlszeile 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 Query Builder verwenden. Außerdem erhalten Sie Tipps zur Optimierung Ihrer Abfragen. Bevor Sie diese Seite lesen, sollten Sie sich mit den Informationen unter Bigtable – Übersicht vertraut machen.

Für im Query Builder ausgeführte Abfragen gelten dieselben Preise und Kontingente wie für jede andere Abfrage, die an eine Tabelle gesendet wird.

Wann sollte Query Builder verwendet werden?

Die Möglichkeit, Ihre Bigtable-Daten in der Google Cloud Console abzufragen, ist in folgenden Fällen hilfreich:

  • Rufen Sie schnell eine visuelle Darstellung des Tabellenschemas ab.
  • Überprüfen Sie, ob bestimmte Daten erfolgreich geschrieben wurden.
  • Datenintegrität während einer Migration validieren
  • Beheben Sie mögliche Datenprobleme.
  • Sehen Sie sich eine Vorschau der Ergebnisse an, die eine bestimmte Kombination von Klauseln zurückgibt, bevor Sie sie in Ihrem Code verwenden. Das ist insbesondere für neue Bigtable-Nutzer sowie für erfahrene Nutzer hilfreich, die die cbt-Befehlszeile nicht verwenden möchten.

Hinweise

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Bigtable-Leser (roles/bigtable.reader) für das Projekt zu gewähren, damit Sie die erforderlichen Berechtigungen für Query Builder erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zur Verwendung von Query Builder erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Query Builder zu verwenden:

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

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

Query Builder öffnen

Wenn Sie Query Builder öffnen, wird eine Standardabfrage für die erste Tabelle in alphabetischer Reihenfolge in der Instanz ausgeführt. Die Standardabfrage wird mit dem standardmäßigen Anwendungsprofil ausgeführt. Es werden bis zu 100 Zeilen zurückgegeben.

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

    Liste der Instanzen öffnen

  2. Klicken Sie auf den Namen der Instanz, die die abzufragende Tabelle enthält.

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

  4. Optional: Minimieren Sie den Bereich Explorer, um den Bereich „Query Builder“ 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 durch einen Doppelpunkt getrennt. 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ü

Nur der neueste Wert für eine Spalte wird zurückgegeben. Zeitstempel sind standardmäßig ausgeblendet, aber Sie können auf die Ein/Aus-Schaltfläche klicken, um sie anzuzeigen.

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 Query Builder erstellen. Dies kann beispielsweise hilfreich sein, wenn Sie den Abfragetraffic isolieren möchten, indem Sie einen anderen Cluster als den von Ihrer primären Anwendung verwendeten verwenden.

Führen Sie die folgenden Schritte aus, um die nächste Abfrage mit einem anderen Anwendungsprofil auszuführen.

  1. Klicken Sie auf Zur Abfrage hinzufügen.
  2. Klicken Sie auf Anwendungsprofil ändern (Standardeinstellung). Ein neues Drop-down-Menü wird angezeigt.
  3. Treffen Sie im Drop-down-Menü Anwendungsprofil eine Auswahl aus der Liste der Anwendungsprofile der Instanz.

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 es aus dem Cluster liest, der Ihnen geografisch am nächsten liegt.

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. Einzelheiten 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. die Ergebnisse aufrufen

Abfrageklauseln

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

Die Zeilenschlüssel-, Zeilenschlüsselbereich- und Zeilenschlüsselpräfix-Klauseln bestimmen, welche Zeilen aus dem Speicher abgerufen werden. Die Regex-Klauseln, Spalten und Zeitraumklauseln für Zeilenschlüssel fügen der generierten Leseanfrage einen Filter hinzu. Die im Query Builder verwendeten Filter funktionieren genauso wie in den Clientbibliotheken. Ausführliche Informationen zu Bigtable-Filtern und deren Auswirkungen auf die Leistung finden Sie unter Filter und Filter verwenden.

Zeilenschlüssel angeben

Um eine einzelne Zeile aus der Tabelle abzurufen, 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 aufrufen 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.

Präfix für Zeilenschlüssel angeben

Wenn Sie nur Zeilen abrufen möchten, deren Zeilenschlüssel mit einem bestimmten Satz von Zeichen beginnen, filtern Sie nach Zeilenschlüsselpräfix. Ein Zeilenschlüsselpräfix sind die ersten N Zeichen eines Zeilenschlüssels. Konventionsgemäß befindet sich zwischen dem Präfix und dem Rest des Zeilenschlüssels oft ein Hashtag, ein Pipe-Zeichen oder ein anderes Symbol.

  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 Präfix für den Zeilenschlüssel 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 Regex-Filter für Zeilenschlüssel. Für eine bessere Leistung sollten Sie der Abfrage einen Zeilenschlüsselbereich oder eine Zeilenschlüsselpräfixklausel hinzufügen, bevor Sie den Regex-Filter für Zeilenschlüssel hinzufügen. Eine Anleitung zum Erstellen von regulären Ausdrücken 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 re2-Syntax verwendet

Nach Spalte filtern

Um eine oder mehrere Spalten anzugeben, die in der Abfrage enthalten sein sollen, fügen Sie eine columns-Klausel hinzu und wählen die Spaltenfamilie und den Spaltenqualifizierer für jede Spalte aus, nach der Sie filtern möchten. Die Leseanfrage, die beim Hinzufügen dieser Klausel generiert wird, enthält den Regex-Filter für Spaltenfamilie und den Spaltenbereichfilter.

  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 innerhalb eines bestimmten Bereichs abrufen möchten, fügen Sie eine Zeitraumklausel hinzu, die den Zeitstempelbereichfilter verwendet.

  1. Klicken Sie auf Zur Abfrage hinzufügen.
  2. Wählen Sie in der Drop-down-Liste die Option 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/DD/YYYY
  • YYYY/MM/DD

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

Limit angeben

Wenn Sie die maximale Anzahl von zurückgegebenen Zeilen festlegen möchten, fügen Sie eine Grenzwertklausel 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.00 ein.

Beschränkungen

Für Query Builder gelten die folgenden Einschrä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 mit der Anzahl der nicht angezeigten Zeichen angezeigt.
  • 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 lexikografisch innerhalb ihrer Spaltenfamilie sortiert.
  • Maximal 1.000 Zeilen: Query Builder gibt maximal die ersten 1.000 Datenzeilen zurück, die Ihrer Abfrage entsprechen.
  • Base64: Bigtable versucht, Base64-codierte Daten genau anzuzeigen, aber die Ergebnisse sind nicht garantiert. Wenn Bigtable die Daten in einer Zelle nicht darstellen kann, wird stattdessen die Größe des Zellenwerts in Byte angezeigt.

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

  • Serialisierte Daten: Daten, die als Protokollpuffer gespeichert sind, werden in den Abfrageergebnissen nicht richtig angezeigt. JSON-Daten werden besser unterstützt, sehen aber nicht zwangsläufig richtig aus.

  • Künstliche Zeitstempel: Wenn Ihre Anwendung den Zeitstempeleigenschaften von Zellen beim Schreiben von Daten in die Tabelle Zahlen zuweist, die keine Zeitstempel sind, können Sie in Ihrer Abfrage Zeitfilter verwenden, um einen Bereich der Werte zu erhalten, die Sie anstelle von Zeitstempeln verwenden, solange Sie diese als Mikrosekunden angeben. Informationen dazu, warum in Ihren Tabellendaten möglicherweise künstliche Zeitstempel verwendet werden, finden Sie unter Zeitstempel

Nächste Schritte