Abfragen in der Console erstellen

Sie können Ihre Bigtable-Daten mit der Methode Bigtable Studio Query Builder. Der Query Builder ist ein interaktives Formular in der Google Cloud Console, mit dem Sie eine Abfrage erstellen, auf eine Tabelle anwenden und die Ergebnisse dann in der Console ansehen können.

Mit dem Query Builder von Bigtable Studio können Sie Drop-down-Selektoren verwenden eine Kombination von Abfrageklauseln angeben, ohne oder eine Befehlszeile verwenden. Wenn Sie die Abfrage ausführen, ruft die Konsole 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. Bevor Sie diese Seite lesen, sollten Sie sich mit den das Bigtable-Objekt Übersicht .

Für Abfragen, die mit Query Builder ausgeführt werden, gelten die gleichen Preise und Kontingente wie an eine Tabelle gesendet werden.

Wann sollte der Query Builder verwendet werden?

Die Möglichkeit, Bigtable-Daten in der Google Cloud Console abzufragen, ist hilfreich, wenn Sie Folgendes tun möchten:

  • Sie erhalten eine visuelle Darstellung des Schemas Ihrer Tabelle.
  • Überprüfen, ob bestimmte Daten erfolgreich geschrieben wurden
  • Datenintegrität während einer Migration validieren
  • Beheben Sie mögliche Datenprobleme.
  • Vorschau der Ergebnisse anzeigen, die eine bestimmte Kombination von Klauseln zurückgibt, bevor Sie sie in Ihrem Code verwenden. Das kann besonders hilfreich sein, wenn Bigtable-Nutzer ebenso wie erfahrene Nutzer, die den die cbt-Befehlszeile .

Hinweis

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

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Verwenden des Abfragebuilders erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

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

  • 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 für die erste Tabelle in der Instanz alphabetisch ausgeführt und angezeigt. Die Standardabfrage wird mit der Standard-App-Profil und bis zu 100 Zeilen werden zurückgegeben.

  1. Öffnen Sie in der Google Cloud Console 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. Bigtable Studio wird im Query Builder-Modus geöffnet. Der Bereich Explorer enthält eine Liste von der Instanz. Im Bereich Abfrageergebnisse werden die Ergebnisse der die Standardabfrage.

  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 lautet Zeilenschlüssel. Die verbleibenden Überschriften stehen jeweils für eine Spalte im Bigtable-Tabelle, ausgedrückt als Spaltenfamilie und Spalte durch einen Doppelpunkt getrennt. Zum Beispiel könnte die Überschrift cell_plan: data_plan_01gb gibt an, dass die Werte in dieser Spalte aus der data_plan_01gb in der Spaltenfamilie cell_plan.

Drop-down-Menü

Es wird nur der neueste Wert für eine Spalte zurückgegeben. Zeitstempel sind ausgeblendet durch Sie können sie aber einblenden, indem Sie auf die Ein/Aus-Schaltfläche klicken.

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 zur Verwendung mit der Abfrage erstellen. des Website-Builders enthält. Dies kann beispielsweise hilfreich sein, wenn Sie die Abfrage Traffic unter Verwendung eines anderen Clusters als dem die von Ihrer primären Anwendung verwendet werden.

So verwenden Sie ein anderes App-Profil, um die nächste Abfrage auszuführen:

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

Um mehr über die Vorteile verschiedener App-Profile für verschiedene Arbeitslasten, siehe Informationen zur Anwendung Profile . Informationen zum Erstellen eines Anwendungsprofils finden Sie unter Anwendung erstellen und konfigurieren Profile .

Wenn sich die Tabelle in einer Instanz mit Replikation befindet, konfigurieren Sie die Anwendung Profil aus dem Cluster zu lesen, der Ihnen geografisch am nächsten ist.

Der Abfrage Klauseln hinzufügen und sie dann ausführen

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

Abfrageklauseln

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

Die Klauseln „Zeilenschlüssel“, „Zeilenschlüsselbereich“ und „Zeilenschlüsselpräfix“ bestimmen, welche Zeilen aus dem Speicher abgerufen werden. Mit den Regex-, Spalten- und Zeitraumklauseln für den Zeilenschlüssel Einen Filter für die generierte Leseanfrage. Filter, die Sie im Abfragetool verwenden, funktionieren genauso wie in den Clientbibliotheken. Weitere Informationen zu Bigtable-Filtern und zu deren Auswirkungen auf die Leistung 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 mit mehreren Zeilenschlüsselklauseln.

  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 sehen möchten.

Zeilenschlüsselbereich angeben

Geben Sie einen Start- und Endzeilenschlüssel an, um einen Zeilenbereich aus der Tabelle abzurufen. 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

Um nur Zeilen abzurufen, deren Zeilenschlüssel mit einem bestimmten Satz von Zeichen beginnen, nach Zeilenschlüsselpräfix filtern. Ein Zeilenschlüsselpräfix sind die ersten N Zeichen einer Zeile . Konventionsgemäß befindet sich häufig ein Hashtag, ein Pipe-Zeichen oder ein anderes Symbol zwischen den und den 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 Präfix für Zeilenschlüssel ein. Sie müssen keine Platzhaltersymbole eingeben.

Nach Regex für Zeilenschlüssel filtern

Um nur Zeilen abzurufen, deren Zeilenschlüsselwerte mit einem angegebenen regulären Ausdruck übereinstimmen, verwenden Sie Zeilenschlüssel-Regex-Filter. Für eine bessere Leistung sollten Sie der Abfrage einen Bereichs- oder Präfixklausel für den Zeilenschlüssel hinzufügen, bevor Sie den Regex-Filter für den Zeilenschlüssel hinzufügen. Eine Anleitung zum Erstellen eines Regex finden Sie unter Regex für Zeilenschlüssel.

  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

Nach Spalte filtern

Um eine oder mehrere Spalten anzugeben, die in der Abfrage enthalten sein sollen, fügen Sie columns hinzu die Spaltenfamilie und den Spaltenqualifizierer für jede Spalte, nach dem gefiltert werden soll. Die Leseanfrage, die beim Hinzufügen dieser Klausel generiert wird, enthält den Regex-Filter für Spaltenfamilien und den Filter für Spaltenbereiche.

  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 die ID einer Spaltenfamilie. 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 Zeitbereichsklausel mit dem Zeitstempelbereichsfilter hinzu.

  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
  • JJJJ-MM-TTThh:mm:ss:ss[z]
  • JJJJ/MM/TT-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 statt der Ortszeit die UTC-Zeit an. Weitere Informationen zu Zeitstempelformaten finden Sie unter ISO 8601.

Limit angeben

Fügen Sie eine Begrenzungsklausel hinzu, um die maximale Anzahl der zurückgegebenen Zeilen anzugeben.

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

Beschränkungen

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

  • 1.000 Zeichen pro Zelle – Bigtable gibt eine maximal 1.000 Zeichen pro Zelle. Wenn eine Zelle mehr als 1.000 Zeichen enthält, wird ein gekürztes Ergebnis mit der Anzahl der nicht angezeigten Zeichen angezeigt.
  • Maximal 100 Spalten – Bigtable gibt die ersten 100 zurück. Spalten in jeder Zeile, die der Abfrage entsprechen. Spaltenfamilien werden nicht gespeichert in in einer bestimmten Reihenfolge. Spalten sind jedoch lexikografisch innerhalb Spaltenfamilie.
  • Maximal 1.000 Zeilen: Der Query Builder gibt maximal 1.000 Zeilen zurück. die ersten 1.000 Datenzeilen an,die Ihrer Abfrage entsprechen.
  • Base64: Bigtable bemüht sich, Base64-codierte Daten korrekt anzuzeigen. Die Ergebnisse sind jedoch nicht garantiert. Wenn Bigtable kann die Daten nicht in einer Zelle anzeigen, sondern zeigt stattdessen die Größe des Zellenwerts in Byte.

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

  • Serialisierte Daten: Als Protokollpuffer gespeicherte Daten werden nicht angezeigt. Abfrageergebnisse korrekt an. JSON-Daten werden besser unterstützt, sind aber nicht garantiert korrekt.

  • Künstliche Zeitstempel – wenn Ihre Anwendung andere als Zeitstempel zuweist Zeitstempel-Eigenschaft der Zellen hinzu, wenn Daten in Ihre können Sie Zeitraumfilter in Ihrer Abfrage verwenden, um verwenden, die Sie anstelle von Zeitstempeln verwenden, sofern Sie diese als Mikrosekunden. Um zu verstehen, warum Sie in Tabellendaten künstliche Intelligenz findest du unter Zeitstempel.

Nächste Schritte