Ottieni statistiche sulle query

In questa pagina viene descritto come ottenere le statistiche delle query utilizzando il metodo interfaccia a riga di comando cbt di Google. Puoi Inoltre, puoi ottenere statistiche sulle query utilizzando la libreria client Go per Cloud Bigtable.

I contenuti qui forniti sono destinati agli sviluppatori di applicazioni. Prima di leggi questa pagina, dovresti conoscere Modello di archiviazione Bigtable. Tu dovresti avere familiarità con Best practice per la progettazione degli schemi e comprendere il rendimento.

La possibilità di ottenere informazioni su una query Bigtable è utile per sviluppare un'applicazione. Ti consente di ottenere dati sul rendimento di una query, quindi di modificarla o di modificare il design dello schema per perfezionarne il rendimento.

Sebbene in generale una query sia una richiesta di dati inviata a una tabella, Bigtable restituisce le statistiche delle query solo per le richieste di lettura.

Prima di iniziare

  1. Se non hai già installato Interfaccia a riga di comando cbt , segui le istruzioni nella Interfaccia a riga di comando cbt panoramica inclusi i passaggi per creare un file .cbtrc.
  2. Consulta la sezione Leggi righe del riferimento all'interfaccia a riga di comando cbt per familiarizzare con la sintassi e le opzioni della riga di comando disponibili per l'invio di una richiesta cbt read alla tabella. Tieni presente che la cbtCLI non supporta i filtri.
  3. Assicurati di disporre dell'autorizzazione bigtable.tables.readRows per la tabella o che sei un'entità del ruolo bigtable.reader.

Esegui la query

  1. Crea una query utilizzando la sintassi per Leggi righe.

  2. Esegui questo comando. Il parametro include-stats=full indica a Bigtable di restituire le statistiche delle query.

    cbt read TABLE_ID QUERY include-stats=full

    Sostituisci quanto segue:

    • TABLE_ID: l'ID univoco della tabella che stai fare query
    • QUERY: un interfaccia a riga di comando cbt query con formattazione

    Il terminale mostra i dati letti e un elenco contenente le seguenti statistiche:

    • rows_seen_count: il numero di righe che Bigtable elaborati per la richiesta
    • rows_returned_count: il numero di righe restituite dopo l'applicazione dei filtri
    • cells_seen_count: il numero di celle elaborate per la richiesta
    • cells_returned_count: il numero di celle restituite dopo l'applicazione filtri
    • frontend_server_latency: latenza della richiesta misurata dal pool di server front-end Bigtable, espressa in millisecondi

Interpretazione dei risultati

  • Esamina il rapporto tra le celle visualizzate e quelle restituite. Se il quoziente per cells_seen_count / cells_returned_count è 1 o vicino a 1, ovvero un'indicazione che la query non ha provocato l'elaborazione di dati da parte di Bigtable che alla fine è stato filtrato.

  • Tieni conto del numero di righe restituite. Più elevato è questo numero, maggiore è il lavoro svolto da Bigtable. Il numero ottimale qui dipende il caso d'uso e i requisiti di latenza, ma in generale una query che restituisce se il numero di righe è inferiore, la latenza sarà più bassa.

Esempio

Se vuoi ottenere le statistiche delle query quando leggi tutte le righe che corrispondono orange:*.* in una tabella denominata my-table, puoi eseguire seguenti:

cbt read my-table regex='.*orange' columns='.*:.*' include-stats=full

L'output è simile al seguente:

  ----------------------------------------
  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

Passaggi successivi