O Spanner fornece tabelas integradas que registram as estatísticas de leitura (ou consulta), gravação e exclusão para suas tabelas (incluindo tabelas de fluxos de alteração) e índices. Com as estatísticas de operações de tabela, é possível fazer o seguinte:
Identifique tabelas com maior tráfego de gravação correspondente ao aumento do armazenamento.
Identifique 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 da tabela incrementa 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 seus gráficos do System Insights.
Disponibilidade
O Spanner fornece as estatísticas das operações de tabela no esquema SPANNER_SYS
. Os dados de SPANNER_SYS
estão disponíveis somente por meio de interfaces SQL. Exemplo:
Uma 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 suas tabelas e índices durante um período específico:
SPANNER_SYS.TABLE_OPERATIONS_STATS_MINUTE
: operações durante intervalos de 1 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 que o nome da tabela especifica.
Os intervalos são baseados em horas. Os intervalos de 1 minuto começam no minuto, os de 10 minutos começam a cada 10 minutos, e os 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 para todas as tabelas de estatísticas de operações de tabela
Nome da coluna | Tipo | Descrição |
---|---|---|
INTERVAL_END |
TIMESTAMP |
Fim do intervalo de tempo 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 que leem a 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
incrementará em 1 para cada tabela acessada pela instrução insert. Além disso,
uma consulta que acessa um índice, sem verificar a tabela, apenas
incrementa a read_query_count
no índice.
Retenção de dados
No mínimo, o Spanner mantém dados para cada tabela pelos períodos a seguir:
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 últimos 30 dias.
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 para o 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 para o 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 para o 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 atual no banco de dados.
Consulte 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 atual 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.