Abfragestatistiken abrufen
Auf dieser Seite wird beschrieben, wie Sie Abfragestatistiken mit der Methode
cbt
-Befehlszeile
. Sie können Abfragestatistiken auch mit der Go-Clientbibliothek für Cloud Bigtable abrufen.
Die hier bereitgestellten Inhalte richten sich an App-Entwickler. Bevor Sie diese Seite lesen, sollten Sie die Bigtable-Speichermodell. Ich sollten auch mit der Best Practices für Schemadesign und die Leistung zu verstehen.
Die Möglichkeit, Informationen zu einer Bigtable-Abfrage abzurufen, kann bei der Entwicklung einer Anwendung nützlich sein. Sie können damit Daten zur Leistung einer Abfrage abrufen und die Abfrage oder das Schemadesign anpassen, um die Leistung der Abfrage zu optimieren.
Im Allgemeinen ist eine Abfrage eine beliebige Datenanfrage, die an eine Tabelle gesendet wird. Bigtable gibt Abfragestatistiken nur für Leseanfragen zurück.
Hinweise
- Wenn Sie die
cbt
-Befehlszeile noch nicht installiert haben, folgen Sie der Anleitung in der Übersicht dercbt
-Befehlszeile, einschließlich der Schritte zum Erstellen einer.cbtrc
-Datei. - Sehen Sie sich den Abschnitt Zeilen lesen der
cbt
-Befehlszeilen-Referenz an, um sich mit der Befehlszeilensyntax und den Optionen zum Senden einercbt read
-Anfrage an Ihre Tabelle vertraut zu machen. Das Feldcbt
-Befehlszeile unterstützt keine Filter. - Sie benötigen die Berechtigung
bigtable.tables.readRows
für die Tabelle oder Sie müssen ein Hauptkonto mit der Rollebigtable.reader
sein.
Abfrage ausführen
Erstellen Sie eine Abfrage mit der Syntax für Zeilen lesen.
Führen Sie den folgenden Befehl aus: Mit dem Parameter
include-stats=full
wird angegeben, Bigtable, um die Abfragestatistiken zurückzugeben.cbt read TABLE_ID QUERY include-stats=full
Dabei gilt:
TABLE_ID
: Die eindeutige ID der abzufragenden TabelleQUERY
: acbt
-Befehlszeile -formatierte Suchanfrage
Im Terminal werden die gelesenen Daten und eine Liste mit den folgenden Statistiken angezeigt:
rows_seen_count
: Die Anzahl der Zeilen, die Bigtable für die Anfrage verarbeitet hatrows_returned_count
: die Anzahl der Zeilen, die nach dem Anwenden von Filtern zurückgegeben werdencells_seen_count
: Die Anzahl der Zellen, die für die Anfrage verarbeitet werdencells_returned_count
: Die Anzahl der Zellen, die nach der Anwendung von Filtern zurückgegeben werdenfrontend_server_latency
: Die Anfragelatenz, die vom Bigtable-Frontend-Serverpool gemessen wird, ausgedrückt in Millisekunden
Ergebnisse interpretieren
Sehen Sie sich das Verhältnis der gesehenen Zellen zu den zurückgegebenen Zellen an. Wenn der Quotient für
cells_seen_count
÷cells_returned_count
= 1 oder nahe 1 ist, wurden durch Ihre Abfrage keine Daten in Bigtable verarbeitet, die letztendlich herausgefiltert wurden.Berücksichtigen Sie die Anzahl der zurückgegebenen Zeilen. Je höher diese Zahl ist, desto mehr Arbeit leistet Bigtable. Die optimale Zahl hängt von Ihren Anwendungsfall und Ihre Latenzanforderungen, im Allgemeinen aber eine Abfrage, die haben weniger Zeilen eine geringere Latenz.
Beispiel
Wenn Sie Abfragestatistiken erhalten möchten, wenn Sie alle Zeilen lesen, die mit dem regulären Ausdruck orange:*.*
in einer Tabelle namens my-table
übereinstimmen, können Sie Folgendes ausführen:
cbt read my-table regex='.*orange' columns='.*:.*' include-stats=full
Die Ausgabe sieht in etwa so aus:
----------------------------------------
orange
Details:Color @ 2022/09/26-14:48:01.286000
"orange"
Details:Size @ 2022/09/26-14:48:01.286000
"medium"
Request Stats
====================
rows_seen_count: 10
rows_returned_count : 1
cells_seen_count: 2
cells_returned_count: 2
frontend_server_latency: 13ms