Estatísticas de tamanhos de tabela

O Spanner fornece as seguintes tabelas integradas:

• SPANNER_SYS.TABLE_SIZES_STATS_1HOUR: lista os tamanhos das tabelas e dos índices nos bancos de dados.
• SPANNER_SYS.TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR: lista os tamanhos das tabelas e dos índices nos bancos de dados de cada grupo de localidade.

O tamanho da tabela está em bytes. Os tamanhos das tabelas incluem versões de dados. Você pode usar essas tabelas integradas para monitorar os tamanhos da tabela e do índice ao longo do tempo. Você também pode monitorar os tamanhos dos seus índices à medida que os cria, exclui e modifica (ao inserir mais linhas no índice ou adicionar novas colunas a ele). Além disso, você também pode conferir os tamanhos das tabelas de fluxo de mudanças.

O armazenamento do banco de dados pode ser monitorado com a métrica de armazenamento total do banco de dados. É possível conferir o detalhamento do armazenamento do banco de dados com SPANNER_SYS.TABLE_SIZES_STATS_1HOUR e SPANNER_SYS.TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR.

Acessar estatísticas de tamanhos de tabelas

O Spanner fornece as estatísticas de tamanho da tabela no esquema SPANNER_SYS. Você pode usar as seguintes maneiras para acessar os dados do SPANNER_SYS:

• A página do Spanner Studio de um banco de dados no console Google Cloud .

• O comando gcloud spanner databases execute-sql.

• O método executeSql ou executeStreamingSql.

Os seguintes métodos de leitura única fornecidos pelo Spanner não são compatíveis com SPANNER_SYS:

• realizar uma leitura forte de uma única linha ou de várias linhas em uma tabela;
• realizar uma leitura desatualizada de uma única linha ou várias linhas em uma tabela;
• ler uma única linha ou várias linhas em um índice secundário.

TABLE_SIZES_STATS_1HOUR

SPANNER_SYS.TABLE_SIZES_STATS_1HOUR contém os tamanhos de todas as tabelas no banco de dados, classificadas por interval_end. Os intervalos são baseados em horários, terminando na hora. Internamente, a cada cinco minutos, o Spanner coleta dados de todos os servidores e os disponibiliza na tabela TABLE_SIZES_STATS_1HOUR pouco tempo depois. Em seguida, os dados são calculados por hora. Por exemplo, às 11h59min30s, TABLE_SIZES_STATS_1HOUR mostra os tamanhos médios das tabelas do intervalo de 10h00min00s a 10h59min59s.

Esquema de tabela

Exemplo de consultas

Nesta seção, há várias instruções SQL de exemplo que recuperam estatísticas agregadas de tamanho da tabela. É possível executar essas instruções SQL usando as bibliotecas de cliente, o gcloud spanner ou o consoleGoogle Cloud .

Consultar as quatro maiores tabelas e índices do intervalo mais recente

A consulta a seguir retorna as quatro maiores tabelas e índices do intervalo mais recente:

    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;
  

Saída da consulta

Tendência de tamanho da consulta para uma tabela ou um índice específico nas últimas 24 horas

A consulta a seguir retorna o tamanho da tabela nas últimas 24 horas:

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;

Saída da consulta

TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR

SPANNER_SYS.TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR contém os tamanhos de todas as tabelas no banco de dados, classificadas por interval_end, para cada grupo de localidade. Os intervalos são baseados em horas, terminando na hora. Internamente, a cada cinco minutos, o Spanner coleta dados de todos os servidores e os disponibiliza na tabela TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR pouco tempo depois. Em seguida, os dados são calculados por hora. Por exemplo, às 11h59min30, TABLE_SIZES_STATS_PER_LOCALITY_GROUP_1HOUR mostra os tamanhos médios das tabelas de cada grupo de localidade do intervalo de 10h00min00 a 10h59min59.

Esquema de tabela

Retenção de dados

No mínimo, o Spanner mantém dados para SPANNER_SYS.TABLE_SIZES_STATS_1HOUR em intervalos que abrangem os últimos 30 dias.

A seguir

• Saiba mais sobre outras ferramentas de introspecção.
• Saiba mais sobre outras informações que o Spanner armazena para cada banco de dados nas tabelas de esquema de informações do banco de dados.
• Saiba mais sobre as práticas recomendadas de SQL para o Spanner.
• Saiba mais sobre como investigar a alta utilização da CPU.