Obtenir des statistiques de requête

Cette page explique comment obtenir des statistiques sur les requêtes à l'aide du CLI cbt pour en savoir plus. Vous pouvez et obtenir des statistiques sur les requêtes à l'aide de la bibliothèque cliente Go pour Cloud Bigtable.

Le contenu présenté ici est destiné aux développeurs d'applications. Avant de lire cette page, vous devez comprendre le modèle de stockage de Bigtable. Toi vous devez aussi connaître Bonnes pratiques pour la conception de schémas analyser les performances.

Il est possible d'obtenir des informations sur une requête Bigtable utiles lorsque vous développez une application. Cela vous permet d'obtenir des données sur les performances d'une requête, puis d'ajuster la requête ou de modifier la conception de votre schéma pour ajuster ses performances.

Bien qu'en général une requête soit une requête de données envoyée à une table, Bigtable ne renvoie des statistiques que pour les requêtes de lecture.

Avant de commencer

  1. Si vous n'avez pas encore installé CLI cbt , suivez les les instructions sur le CLI cbt présentation y compris les étapes de création d'un fichier .cbtrc.
  2. Consultez la section Lire les lignes de la documentation de référence sur la CLI cbt pour vous familiariser avec la syntaxe et les options de ligne de commande disponibles pour l'envoi d'une requête cbt read à votre table. Notez que la CLI cbt n'est pas compatible avec les filtres.
  3. Assurez-vous de disposer de l'autorisation bigtable.tables.readRows pour la table ou d'être un compte principal du rôle bigtable.reader.

Exécuter votre requête

  1. Créez une requête en utilisant la syntaxe pour Lire les lignes :

  2. Exécutez la commande suivante : Le paramètre include-stats=full indique Bigtable pour renvoyer les statistiques sur les requêtes.

    cbt read TABLE_ID QUERY include-stats=full

    Remplacez les éléments suivants :

    • TABLE_ID: ID unique de la table que vous interrogation
    • QUERY : requête au format de la CLI cbt

    Le terminal affiche les données lues, ainsi qu'une liste contenant les statistiques suivantes:

    • rows_seen_count: le nombre de lignes que Bigtable traité pour la demande
    • rows_returned_count : nombre de lignes renvoyées après l'application des filtres
    • cells_seen_count : nombre de cellules traitées pour la requête
    • cells_returned_count : nombre de cellules renvoyées après l'application de filtres
    • frontend_server_latency : latence de la requête mesurée à partir du pool de serveurs Bigtable de premier plan, exprimée en millisecondes

Interprétation des résultats

  • Examinez le ratio entre le nombre de cellules affichées et le nombre de cellules renvoyées. Si le quotient de cells_seen_count / cells_returned_count est égal à 1 ou est proche de 1, c'est une indique que votre requête n'a pas entraîné le traitement des données par Bigtable. qui a finalement été filtrée.

  • Tenez compte du nombre de lignes renvoyées. Plus ce nombre est élevé, plus il y a de travail de Bigtable. Le nombre optimal ici dépend de votre cas d'utilisation et de vos exigences de latence, mais en général, une requête qui renvoie moins de lignes a une latence plus faible.

Exemple

Si vous souhaitez obtenir des statistiques sur les requêtes lorsque vous lisez toutes les lignes correspondant à l'expression régulière orange:*.* dans une table appelée my-table, vous pouvez exécuter ce qui suit :

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

Le résultat ressemble à ce qui suit :

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

Étapes suivantes