O Spanner fornece tabelas integradas que registram as estatísticas de operações de leitura (ou consulta), gravação e exclusão de tabelas (incluindo tabelas de fluxos de alterações) e índices. Com as estatísticas de operações de tabela, é possível:
Identifique tabelas com aumento no tráfego de gravação correspondente ao aumento no armazenamento.
Identificar tabelas com tráfego inesperado de leitura, gravação e exclusão.
Identifique as tabelas muito usadas.
Quando você consulta ou grava em uma tabela, a contagem de operações correspondentes para a tabela aumenta em 1, independentemente do número de linhas acessadas.
As métricas gerais de operações por segundo de um banco de dados podem ser monitoradas com
Operations per second
, Operations per second by API method
e outras
métricas relacionadas nos gráficos do
Insights do sistema.
Disponibilidade
O Spanner fornece as estatísticas de operações de tabela no esquema SPANNER_SYS
. Os dados de SPANNER_SYS
só estão disponíveis por meio de interfaces
SQL. Exemplo:
A página do Spanner Studio de um banco de dados no console do Google Cloud
O comando
gcloud spanner databases execute-sql
A API
executeQuery
Outros métodos de leitura única fornecidos pelo Spanner não são compatíveis com SPANNER_SYS
.
Estatísticas de operações de tabela
As tabelas a seguir rastreiam as estatísticas de leitura (ou consulta), gravação e exclusão nas tabelas e índices durante um período específico:
SPANNER_SYS.TABLE_OPERATIONS_STATS_MINUTE
: operações durante intervalos de um minutoSPANNER_SYS.TABLE_OPERATIONS_STATS_10MINUTE
: operações durante intervalos de 10 minutosSPANNER_SYS.TABLE_OPERATIONS_STATS_HOUR
: operações durante intervalos de 1 hora
Essas tabelas têm as seguintes propriedades:
Cada tabela contém dados para intervalos de tempo não sobrepostos do comprimento especificado pelo nome da tabela.
Os intervalos são baseados em horas. Intervalos de 1 minuto começam no minuto, intervalos de 10 minutos começam a cada 10 minutos a partir da hora e intervalos de 1 hora começam na hora.
Por exemplo, às 11:59:30, os intervalos mais recentes disponíveis para as consultas SQL são:
- 1 minuto: 11:58:00–11:58:59
- 10 minutos: 11:40:00–11:49:59
- 1 hora: 10:00:00–10:59:59
Esquema de todas as tabelas de estatísticas de operações da tabela
Nome da coluna | Tipo | Descrição |
---|---|---|
INTERVAL_END |
TIMESTAMP |
Fim do intervalo em que os tamanhos da tabela foram coletados. |
TABLE_NAME |
STRING |
Nome da tabela ou do índice. |
READ_QUERY_COUNT |
INT64 |
Número de consultas ou leituras lidas na tabela. |
WRITE_COUNT |
INT64 |
Número de consultas gravadas na tabela. |
DELETE_COUNT |
INT64 |
Número de consultas que realizam exclusões na tabela. |
Se você inserir dados no banco de dados usando mutações, o write_count
será incrementado em 1 para cada tabela acessada pela instrução "insert". Além disso,
uma consulta que acessa um índice, sem verificar a tabela subjacente, apenas
incrementa o read_query_count
no índice.
Retenção de dados
No mínimo, o Spanner mantém dados para cada tabela pelos seguintes períodos:
SPANNER_SYS.TABLE_OPERATIONS_STATS_MINUTE
: intervalos que abrangem as seis horas anteriores.SPANNER_SYS.TABLE_OPERATIONS_STATS_10MINUTE
: intervalos que abrangem os quatro dias anteriores.SPANNER_SYS.TABLE_OPERATIONS_STATS_HOUR
: intervalos que abrangem os 30 dias anteriores.
Exemplo de consultas
Esta seção inclui vários exemplos de instruções SQL que recuperam estatísticas de operações de tabelas agregadas. É possível executar essas instruções SQL usando as bibliotecas de cliente ou a gcloud spanner.
Consultar as tabelas e os índices com mais operações de gravação no intervalo mais recente
SELECT interval_end, table_name, write_count FROM spanner_sys.table_operations_stats_minute WHERE interval_end = ( SELECT MAX(interval_end) FROM spanner_sys.table_operations_stats_minute) ORDER BY write_count DESC;
Consultar as tabelas e os índices com mais operações de exclusão no intervalo mais recente
SELECT interval_end, table_name, delete_count FROM spanner_sys.table_operations_stats_minute WHERE interval_end = ( SELECT MAX(interval_end) FROM spanner_sys.table_operations_stats_minute) ORDER BY delete_count DESC;
Consultar as tabelas e os índices com mais operações de leitura e consulta no intervalo mais recente
SELECT interval_end, table_name, read_query_count FROM spanner_sys.table_operations_stats_minute WHERE interval_end = ( SELECT MAX(interval_end) FROM spanner_sys.table_operations_stats_minute) ORDER BY read_query_count DESC;
Consultar o uso de uma tabela nas últimas seis horas
SELECT interval_end, read_query_count, write_count, delete_count FROM spanner_sys.table_operations_stats_minute WHERE table_name = table_name ORDER BY interval_end DESC;
Em que:
table_name
precisa ser uma tabela ou um índice existente no banco de dados.
Consultar o uso de uma tabela nos últimos 14 dias
GoogleSQL
SELECT interval_end, read_query_count, write_count, delete_count FROM spanner_sys.table_operations_stats_hour WHERE interval_end > TIMESTAMP_ADD(CURRENT_TIMESTAMP(), INTERVAL -14 DAY) AND table_name = table_name ORDER BY interval_end DESC;
Em que:
table_name
precisa ser uma tabela ou um índice existente no banco de dados.
Consultar tabelas e índices sem uso nas últimas 24 horas
GoogleSQL
(SELECT t.table_name FROM information_schema.tables AS t WHERE t.table_catalog = "" AND t.table_schema = "" AND t.table_type = "BASE TABLE" UNION ALL SELECT cs.change_stream_name FROM information_schema.change_streams cs WHERE cs.change_stream_catalog = "" AND cs.change_stream_schema = "" UNION ALL SELECT idx.index_name FROM information_schema.indexes idx WHERE idx.index_type = "INDEX" AND idx.table_catalog = "" AND idx.table_schema = "") EXCEPT ALL (SELECT DISTINCT(table_name) FROM spanner_sys.table_operations_stats_hour WHERE interval_end > TIMESTAMP_ADD(CURRENT_TIMESTAMP(), INTERVAL -24 HOUR));
A seguir
Use as estatísticas de tamanhos de tabela para determinar os tamanhos das tabelas e dos índices.
Saiba mais sobre outras ferramentas de introspecção.
Saiba mais sobre as práticas recomendadas de SQL para o Spanner.