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

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

Abfrage ausführen

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

  2. 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 Tabelle
    • QUERY: a cbt-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 hat
    • rows_returned_count: die Anzahl der Zeilen, die nach dem Anwenden von Filtern zurückgegeben werden
    • 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, 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

Nächste Schritte