Statistiques sur les tailles de table

Spanner fournit les tables intégrées suivantes :

• SPANNER_SYS.TABLE_SIZES_STATS_1HOUR : liste les tailles de vos tables et index dans vos bases de données.
• SPANNER_SYS.TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR : liste la taille de vos tables et index dans vos bases de données pour chaque groupe de localités.

La taille de la table est exprimée en octets. Les tailles de table incluent les versions de données. Vous pouvez utiliser ces tables intégrées pour surveiller la taille de vos tables et de vos index au fil du temps. Vous pouvez également surveiller la taille de vos index lorsque vous les créez, les supprimez et les modifiez (lorsque vous insérez des lignes supplémentaires dans l'index ou lorsque vous y ajoutez des colonnes). Vous pouvez également examiner la taille de vos tables de flux de modifications.

Vous pouvez surveiller l'espace de stockage de la base de données à l'aide de la métrique "Espace de stockage total de la base de données". Vous pouvez consulter la répartition du stockage de la base de données avec SPANNER_SYS.TABLE_SIZES_STATS_1HOUR et SPANNER_SYS.TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR.

Accéder aux statistiques sur la taille des tables

Spanner fournit les statistiques sur la taille des tables dans le schéma SPANNER_SYS. Vous pouvez accéder aux données SPANNER_SYS de différentes manières :

• Page Spanner Studio d'une base de données dans la console Google Cloud .

• La commande gcloud spanner databases execute-sql.

• La méthode executeSql ou executeStreamingSql.

Les méthodes de lecture unique suivantes fournies par Spanner ne sont pas compatibles avec SPANNER_SYS :

• effectuer une lecture forte à partir d'une ou de plusieurs lignes d'une table ;
• effectuer une lecture non actualisée à partir d'une ou de plusieurs lignes d'une table ;
• lire à partir d'une ou de plusieurs lignes d'un index secondaire.

TABLE_SIZES_STATS_1HOUR

SPANNER_SYS.TABLE_SIZES_STATS_1HOUR contient la taille de toutes les tables de votre base de données, triées par interval_end. Les intervalles sont définis selon l'heure réelle et se terminent à l'heure juste. En interne, toutes les cinq minutes, Spanner collecte les données de tous les serveurs, puis les met à disposition dans la table TABLE_SIZES_STATS_1HOUR peu de temps après. Les données sont ensuite moyennées pour chaque heure. Par exemple, à 11h59min30, TABLE_SIZES_STATS_1HOUR affiche la taille moyenne des tables pour l'intervalle de 10h00min00 à 10h59min59.

Schéma de la table

Exemples de requêtes

Cette section présente plusieurs exemples d'instructions SQL permettant d'extraire des statistiques globales sur la taille des tables. Vous pouvez exécuter ces instructions SQL à l'aide des bibliothèques clientes, de gcloud spanner ou de la consoleGoogle Cloud .

Interroger les quatre plus grandes tables et index pour l'intervalle le plus récent

La requête suivante renvoie les quatre plus grandes tables et index pour l'intervalle le plus récent :

    SELECT interval_end,
          table_name,
          used_bytes
    FROM spanner_sys.table_sizes_stats_1hour
    WHERE interval_end = (
          SELECT MAX(interval_end)
          FROM spanner_sys.table_sizes_stats_1hour)
    ORDER BY used_bytes DESC
    LIMIT 4;
  

Sortie de la requête

Tendance de la taille des requêtes pour une table ou un index spécifiques au cours des dernières 24 heures

La requête suivante renvoie la taille de la table au cours des dernières 24 heures :

SELECT interval_end, used_bytes
  FROM spanner_sys.table_sizes_stats_1hour
WHERE interval_end > TIMESTAMP_ADD(CURRENT_TIMESTAMP(), INTERVAL -24 HOUR)
  AND table_name = "table_name"
ORDER BY interval_end DESC;

SELECT interval_end, used_bytes
  FROM spanner_sys.table_sizes_stats_1hour
WHERE interval_end > spanner.timestamptz_subtract(now(), '24 HOUR')
  AND table_name = 'table_name'
ORDER BY interval_end DESC;

Sortie de la requête

TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR

SPANNER_SYS.TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR contient la taille de toutes les tables de votre base de données, triées par interval_end, pour chaque groupe de localités. Les intervalles sont définis selon l'heure réelle et se terminent à l'heure juste. En interne, toutes les cinq minutes, Spanner collecte les données de tous les serveurs, puis les met à disposition dans la table TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR peu de temps après. Les données sont ensuite moyennées pour chaque heure. Par exemple, à 11h59min30s, TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR affiche la taille moyenne des tables pour chaque groupe de localités de l'intervalle 10h00min00s à 10h59min59s.

Schéma de la table

Conservation des données

Spanner conserve les données de SPANNER_SYS.TABLE_SIZES_STATS_1HOUR pendant au moins 30 jours.

Étapes suivantes

• Découvrez d'autres outils d'introspection.
• Découvrez les autres informations stockées par Spanner pour chaque base de données dans les tables du schéma d'informations de cette base de données.
• Explorez les bonnes pratiques SQL relatives à Spanner.
• En savoir plus sur l'investigation de l'utilisation élevée du processeur.