Tabelas e comandos de sistema no Aurora DSQL

Consulte as seções a seguir para saber mais sobre tabelas e catálogos de sistema compatíveis no Aurora DSQL, bem como consultas úteis para encontrar informações sobre o sistema, como a versão.

Tabelas de sistema

O Aurora DSQL é compatível com o PostgreSQL; portanto, muitas tabelas de catálogo do sistema e visualizações do PostgreSQL também existem no Aurora DSQL.

Tabelas de catálogo e visualizações importantes do PostgreSQL

A tabela a seguir descreve as tabelas e visualizações mais comuns que você pode usar no Aurora DSQL.

Tabelas de catálogo aceitas e não aceitas

A tabela a seguir indica quais tabelas são aceitas e não aceitas no Aurora DSQL.

Visualizações do sistema aceitas e não aceitas

A tabela a seguir indica quais visualizações são aceitas e não aceitas no Aurora DSQL.

A visualização sys.jobs

sys.jobs fornece informações sobre o status dos trabalhos assíncronos. Por exemplo, após a criação de um índice assíncrono, o Aurora DSQL exibe um job_uuid. Você pode usar esse job_uuid com sys.jobs para pesquisar o status do trabalho.

SELECT * FROM sys.jobs;

O Aurora DSQL exibe uma resposta semelhante à seguinte:

           job_id           |  status   | details |  job_type   | class_id | object_id |    object_name    |       start_time       |      update_time
----------------------------+-----------+---------+-------------+----------+-----------+-------------------+------------------------+------------------------
 wqhu6ewifze5xitg3umt24h5ua | completed |         | INDEX_BUILD |     1259 |     26433 | public.nt2_c1_idx | 2025-09-25 22:07:31+00 | 2025-09-25 22:07:46+00
 kkngzf33dndl3daacxehpx5eba | completed |         | ANALYZE     |     1259 |     26419 | public.nt         | 2025-09-25 21:57:05+00 | 2025-09-25 21:57:27+00
 fyopxjb6ovdn7po6lrkj63cyea | completed |         | DROP        |     1259 |     26422 |                   | 2025-09-25 22:05:57+00 | 2025-09-25 22:06:03+00

A tabela a seguir descreve as colunas na visualização sys.jobs.

A visualização sys.iam_pg_role_mappings

A visualização sys.iam_pg_role_mappings fornece informações sobre as permissões concedidas aos usuários do IAM. Por exemplo, se DQSLDBConnect for um perfil do IAM que dá ao Aurora DSQL acesso a não administradores e um usuário chamado testuser receber o perfil DQSLDBConnect e as permissões correspondentes, você poderá consultar a visualização sys.iam_pg_role_mappings para ver quais usuários recebem quais permissões.

SELECT * FROM sys.iam_pg_role_mappings;

Consultas úteis de metadados do sistema

Use essas consultas para acessar estatísticas da tabela e metadados do sistema sem realizar operações caras, como verificações completas da tabela.

Apurar a contagem estimada de linhas de uma tabela

Para apurar a contagem aproximada de linhas em uma tabela sem realizar uma verificação completa, use a seguinte consulta:

SELECT reltuples FROM pg_class WHERE relname = 'table_name';

Esse comando retorna uma saída semelhante à seguinte:

  reltuples
--------------
 9.993836e+08

Essa abordagem é mais eficiente do que SELECT COUNT(*) para tabelas grandes no Aurora DSQL.

Obter a versão principal atual do Aurora DSQL

Para obter a versão principal atual do cluster do Aurora DSQL, use a seguinte consulta:

SELECT * FROM sys.dsql_major_version();

Esse comando retorna uma saída semelhante à seguinte:

 dsql_major_version
--------------------
                  1

Isso retorna a versão principal em que a conexão SQL está ativada no Aurora DSQL.

Obter a versão atual do PostgreSQL

Para obter a versão atual do PostgreSQL do cluster do Aurora DSQL, use a seguinte consulta:

SHOW server_version;

Esse comando retorna uma saída semelhante à seguinte:

 server_version
----------------
 16.13

Isso retorna a versão do PostgreSQL em que a conexão SQL está ativada no Aurora DSQL.

O comando ANALYZE

O comando ANALYZE coleta estatísticas sobre o conteúdo das tabelas no banco de dados e armazena os resultados na visualização de sistema pg_stats. Posteriormente, o planejador de consultas usa essas estatísticas para ajudar a determinar os planos de execução mais eficientes para as consultas.

No Aurora DSQL, não é possível executar o comando ANALYZE em uma transação explícita. ANALYZE não está sujeito ao limite de tempo da transação do banco de dados.

Para reduzir a necessidade de intervenção manual e manter as estatísticas sempre atualizadas, o Aurora DSQL executa automaticamente ANALYZE como um processo em segundo plano. Esse trabalho em segundo plano é acionado automaticamente com base na taxa de alteração observada na tabela. Ele está vinculado ao número de linhas (tuplas) que foram inseridas, atualizadas ou excluídas desde a última análise.

ANALYZE é executado de forma assíncrona em segundo plano e sua atividade pode ser monitorada na visualização de sistema sys.jobs com a seguinte consulta:

SELECT * FROM sys.jobs WHERE job_type = 'ANALYZE';

Considerações importantes

Os trabalhos ANALYZE em segundo plano, acionados automaticamente, coletam os mesmos tipos de estatística de um ANALYZE manual e os aplicam por padrão às tabelas do usuário. As tabelas de sistema e de catálogo são excluídas desse processo automatizado.