Abfragestatistiken abrufen

Auf dieser Seite wird beschrieben, wie Sie Abfragestatistiken mit der cbt-Befehlszeile abrufen. Sie können Abfragestatistiken auch mithilfe der Go-Clientbibliothek für Cloud Bigtable abrufen.

Die hier bereitgestellten Inhalte richten sich an App-Entwickler. Bevor Sie diese Seite lesen, sollten Sie sich mit dem Bigtable-Speichermodell vertraut machen. Außerdem sollten Sie mit den Best Practices für das Schemadesign und dem Überblick über die Leistung vertraut sein.

Die Möglichkeit, Informationen zu einer Bigtable-Abfrage abzurufen, kann bei der Entwicklung einer Anwendung nützlich sein. Damit können Sie Daten zur Leistung einer Abfrage abrufen und diese dann anpassen oder das Schemadesign ändern, um die Leistung der Abfrage zu optimieren.

Obwohl eine Abfrage im Allgemeinen eine beliebige Datenanfrage ist, die an eine Tabelle gesendet wird, gibt Bigtable nur Abfragestatistiken für Leseanfragen zurück.

Hinweise

  1. Wenn Sie die cbt-Befehlszeile noch nicht installiert haben, folgen Sie der Anleitung in der Übersicht zur cbt-Befehlszeile, einschließlich der Schritte zum Erstellen einer .cbtrc-Datei.
  2. Sehen Sie sich in der Referenz zur cbt-Befehlszeile den Abschnitt Zeilen lesen an und machen Sie sich mit der Befehlszeilensyntax und den Optionen vertraut, die zum Senden einer cbt read-Anfrage an Ihre Tabelle verfügbar sind. Die cbt-Befehlszeile unterstützt keine Filter.
  3. Sie benötigen die Berechtigung bigtable.tables.readRows für die Tabelle oder Sie sind ein Hauptkonto der Rolle bigtable.reader.

Abfrage ausführen

  1. Erstellen Sie eine Abfrage mit der Syntax für Zeilen lesen.

  2. Führen Sie den folgenden Befehl aus: Der Parameter include-stats=full weist Bigtable an, die Abfragestatistiken zurückzugeben.

    cbt read TABLE_ID QUERY include-stats=full

    Ersetzen Sie Folgendes:

    • TABLE_ID: Die eindeutige ID der abzufragenden Tabelle
    • QUERY: Eine cbt-Abfrage im CLI-Format

    Das Terminal zeigt die gelesenen Daten und eine Liste mit den folgenden Statistiken an:

    • rows_seen_count: Die Anzahl der Zeilen, die Bigtable für die Anfrage verarbeitet hat
    • rows_returned_count: die Anzahl der Zeilen, die nach dem Anwenden von Filtern zurückgegeben wurden
    • cells_seen_count: Die Anzahl der Zellen, die für die Anfrage verarbeitet werden
    • cells_returned_count: Die Anzahl der Zellen, die nach der Anwendung von Filtern zurückgegeben werden
    • frontend_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, weist dies darauf hin, dass Ihre Abfrage nicht dazu geführt hat, dass Bigtable Daten 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 Anzahl hängt von Ihrem Anwendungsfall und Ihren Latenzanforderungen ab. Im Allgemeinen hat eine Abfrage, die weniger Zeilen zurückgibt, jedoch eine geringere Latenz.

Beispiel

Wenn Sie Abfragestatistiken abrufen möchten, sobald Sie alle Zeilen lesen, die mit dem regulären Ausdruck orange:*.* in einer Tabelle namens my-table übereinstimmen, können Sie folgenden Befehl 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

Nächste Schritte