Todos os produtos
Search
Central de documentação

PolarDB:SQL Explorer

Última atualização: Jul 04, 2026

O SQL Explorer oferece visibilidade profunda sobre o comportamento da carga de trabalho SQL no PolarDB for PostgreSQL. Use este recurso para:

  • Diagnosticar consultas lentas e identificar as instruções SQL que mais consomem recursos

  • Comparar o desempenho de SQL entre duas janelas de tempo para detectar regressões

  • Auditar todas as instruções DQL, DML e DDL executadas no banco de dados

  • Analisar o tráfego por origem para entender a procedência das requisições

  • Reproduzir o tráfego de produção em um ambiente de teste para validar a capacidade antes do dimensionamento

O SQL Explorer faz parte do Database Autonomy Service (DAS) e integra diversos sub-recursos em uma única interface.

Sub-recursos

Sub-recurso

Funcionalidade

Search (Audit)

Consulte e exporte logs de todas as instruções SQL, incluindo nome do banco de dados, status e tempo de execução

SQL Explorer

Diagnostique a integridade do SQL, solucione problemas de desempenho e analise o tráfego do serviço

SQL Review

Analise a carga global de SQL para localizar instruções suspeitas e obter recomendações de otimização

Traffic Replay and Stress Testing

Reproduza o tráfego de produção e execute testes de estresse para determinar se é necessário dimensionar o tipo de instância

Security Audit

Detecte automaticamente ameaças como injeção de SQL e novas origens de acesso

Transaction Analysis

Visualize o tipo, a contagem e os detalhes das transações de uma thread específica dentro de um intervalo de tempo

Quick Transaction Analysis

Identifique as instruções inicial e final de qualquer transação que contenha uma instrução SQL específica

Pré-requisitos

Antes de ativar o SQL Explorer, certifique-se de que:

Considerações sobre desempenho

O SQL Explorer registra todas as instruções DQL, DML e DDL executadas no cluster. A coleta de dados ocorre diretamente no kernel do banco de dados, com sobrecarga mínima de CPU.

O armazenamento utilizado pelos dados do SQL Explorer é fornecido pelo DAS e não consome espaço de armazenamento na sua instância de banco de dados.
Ativar ou desativar o log de auditoria no SQL Explorer and Audit altera o parâmetro do kernel log_statement :
A ativação do log de auditoria define log_statement = all .
A desativação do log de auditoria define log_statement = ddl .

Faturamento

Enterprise Edition V0

O SQL Explorer utiliza exclusivamente o modelo de pagamento conforme o uso; o faturamento por assinatura não é suportado. As cobranças aparecem sob o item PolarDB na sua fatura.

Região

Preço

Regiões na China continental

USD 0,0013 por GB-hora

China (Hong Kong) e regiões fora da China

USD 0,0019 por GB-hora

Enterprise Edition V0 ou posterior

Para obter os preços mais recentes, consulte Faturamento do DAS.

Ativar o SQL Explorer

  1. Faça login no console do PolarDB.

  2. No canto superior esquerdo, selecione a região onde seu cluster está implantado.

  3. Clique em ID do cluster.

  4. No painel de navegação à esquerda, escolha Log And Audit > SQL Explorer.

  5. Ative o SQL Explorer. Caso a Enterprise Edition do DAS ainda não esteja habilitada, siga as instruções na página para ativá-la.

  6. Clique em uma aba para visualizar as informações correspondentes.

    • Display By Time Range: Selecione um intervalo de tempo para ver a Execution Duration Distribution, a Execution Duration e as Executions de todas as instruções SQL. Visualize e exporte detalhes na seção Full Request Statistics.

      Nota: A interface do SQL Explorer exporta até 1.000 logs de SQL. Para exportar mais logs em um intervalo de tempo maior, utilize o recurso Audit .
    • Display By Comparison: Escolha um período para comparar a Execution Duration Distribution, a Execution Duration e as Executions entre dois intervalos. Os resultados da comparação aparecem na seção Requests By Comparison.

    • Source Statistics: Defina um intervalo de tempo para visualizar todas as origens de requisição.

Referência de parâmetros

Execution Duration Distribution

A aba Execution Duration Distribution exibe como os tempos de execução das consultas SQL estão distribuídos ao longo do intervalo especificado. As estatísticas são coletadas a cada minuto e agrupadas em sete faixas:

Faixa

Significado

[0,1] ms

Tempo de execução de 0 ms a 1 ms

(1,2] ms

Tempo de execução maior que 1 ms e até 2 ms

(2,3] ms

Tempo de execução maior que 2 ms e até 3 ms

(3,10] ms

Tempo de execução maior que 3 ms e até 10 ms

(10,100] ms

Tempo de execução maior que 10 ms e até 100 ms

(0.1,1] s

Tempo de execução maior que 0,1 s e até 1 s

>1 s

Tempo de execução maior que 1 s

As cores do gráfico indicam a integridade do cluster: uma área azul maior significa execução saudável; áreas laranjas ou vermelhas maiores indicam desempenho degradado.

Execution Duration

A aba Execution Duration apresenta as durações de execução de todas as consultas SQL dentro do intervalo de tempo selecionado.

Full Request Statistics

A seção Full Request Statistics mostra detalhes por modelo de SQL, incluindo:

  • Texto do SQL

  • Percentual da duração de execução

  • Duração média de execução

  • Tendência de execução

Fórmula do percentual de duração de execução:

(Execution duration of the SQL template × Number of executions)
÷ (Total execution duration of all SQL statements × Total executions)
× 100%

Um percentual mais alto indica que o cluster dedica proporcionalmente mais recursos a esse modelo de SQL.

Clique em um SQL ID para visualizar a tendência de desempenho e dados de amostra das instruções que utilizam esse modelo de SQL.

SQL Sample

A aba SQL Sample exibe o cliente que iniciou cada requisição SQL amostrada. As amostras de SQL são codificadas em UTF-8.

Modificar o período de retenção de logs SQL

  1. Faça login no console do PolarDB.

  2. No canto superior esquerdo, selecione a região onde seu cluster está implantado.

  3. Clique em ID do cluster.

  4. No painel de navegação à esquerda, escolha Log And Audit > SQL Explorer.

  5. No canto superior direito da página do SQL Explorer, clique em Service Settings.

  6. Modifique a duração de armazenamento e clique em OK.

Se a Enterprise Edition V3 do DAS estiver ativada, você poderá definir durações de retenção diferentes para cada sub-recurso.

Exportar entradas de log SQL

  1. Faça login no console do PolarDB.

  2. No canto superior esquerdo, selecione a região onde seu cluster está implantado.

  3. Clique em ID do cluster.

  4. No painel de navegação à esquerda, escolha Log And Audit > SQL Explorer.

  5. Clique em Audit no lado direito da aba Export.

  6. Configure os Exported Fields e o Export Time Range e clique em OK.

  7. Na caixa de diálogo de confirmação, configure o Task Name e o CSV Separator e clique em Confirm To Submit A Task.

Após enviar a tarefa:
Não é possível cancelar a tarefa.
Se a tarefa falhar, nenhuma cobrança será gerada.
Os dados da tarefa são retidos por 7 dias.
Até 10.000.000 registros são exportados por tarefa. Se a contagem de registros exceder esse limite, reduza o intervalo de tempo e envie novamente.
O processamento e arquivamento dos dados mais recentes levam cerca de 5 minutos. Se precisar dos dados mais atuais, aguarde alguns minutos antes de enviar a exportação.
  1. Após a conclusão da exportação, clique em Task List no canto superior direito da página do SQL Explorer e clique em Download na coluna Actions para baixar o arquivo.

Desativar o SQL Explorer

Aviso

Ao desativar o recurso SQL Explorer, todos os logs de auditoria SQL serão excluídos. Antes de desabilitar o SQL Explorer and Audit, recomendamos exportar os logs de auditoria SQL como um arquivo e baixá-lo para o seu computador. Se você reativar o recurso SQL Explorer and Audit posteriormente, os logs de auditoria SQL começarão a ser registrados a partir do momento da nova ativação.

  1. Faça login no console do PolarDB.

  2. No canto superior esquerdo, selecione a região onde seu cluster está implantado.

  3. Clique em ID do cluster.

  4. No painel de navegação à esquerda, escolha Log And Audit > SQL Explorer.

  5. Clique em Service Settings.

    • Se a Enterprise Edition V3 do DAS estiver ativada, desmarque todos os recursos do módulo SQL Explorer and Audit e clique em Submit.

    • Caso contrário, desative o recurso SQL Explorer and Audit.

  6. Confirme o aviso e clique em Submit And Unsubscribe.

O armazenamento usado pelos dados do SQL Explorer and Audit é liberado aproximadamente uma hora após a desativação do recurso.

Visualizar tamanho do log de auditoria e detalhes de faturamento

  1. Faça login no Console de Gerenciamento da Alibaba Cloud. No canto superior direito, clique em Expenses.

  2. Na barra de navegação à esquerda da página Expenses And Costs, acesse Billing Management > Bill Details.

  3. Na aba Bill Details, clique em Billing Details e pesquise por Instance ID. Filtre os resultados onde a coluna Billing Item exibir sql_explorer.

image

Próximos passos