Documentação do Oracle Cloud Infrastructure

Executar Rastreamento SQL no Autonomous AI Database

Use o rastreamento SQL para ajudá-lo a identificar a origem de uma carga de trabalho excessiva do banco de dados, como uma instrução SQL de alta carga em seu aplicativo.

Tópico principal: Monitorar e Gerenciar Desempenho

Configurar o Rastreamento de SQL no Autonomous AI Database

Mostra as etapas para configurar o rastreamento SQL no Autonomous AI Database.

Observação

Se você ativar o Rastreamento SQL do desempenho do seu aplicativo para a sessão, poderá ficar degradado enquanto a coleta de rastreamento estiver ativada. Esse impacto negativo no desempenho é esperado devido à sobrecarga de coleta e salvamento de dados de rastreamento.

Para configurar seu banco de dados para rastreamento SQL, faça o seguinte:

  1. Crie um bucket para armazenar arquivos de rastreamento no Cloud Object Storage.

    Para salvar os arquivos de rastreamento SQL, o bucket pode estar em qualquer Cloud Object Store compatível com o Autonomous AI Database.

    Por exemplo, para criar um bucket no Oracle Cloud Infrastructure Object Storage, faça o seguinte

    1. Usando o Oracle Cloud Infrastructure Console.
    2. Selecione Armazenamento no menu.
    3. Em Armazenamento, selecione Object Storage e Archive Storage.
    4. Clique em Criar Bucket.
    5. Na página Criar Bucket, informe o Nome do Bucket e clique em Criar.

    Se você estiver usando um Oracle Cloud Infrastructure Object Storage, observe que só há suporte para arquivos de rastreamento SQL com buckets criados na camada de armazenamento padrão. Certifique-se de selecionar Padrão como a camada de armazenamento ao criar seu bucket. Consulte Visão Geral do Serviço Object Storage para obter informações sobre a Camada de Armazenamento de Objetos Padrão.

  2. Crie uma credencial para sua conta do Cloud Object Storage usando DBMS_CLOUD.CREATE_CREDENTIAL.

    Por exemplo:

    BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'DEF_CRED_NAME',
    username => 'adb_user@example.com', 
    password => 'password'
);
END;
/

    Para o Oracle Cloud Infrastructure, o username é o seu nome de usuário do Oracle Cloud Infrastructure. A password é o seu token de autenticação do Oracle Cloud Infrastructure. Consulte Como Trabalhar com Tokens de Autenticação para obter mais informações.

    Consulte Procedimento CREATE_CREDENTIAL para obter detalhes sobre os parâmetros e seus valores, dependendo do Cloud Object Storage.

  3. Defina parâmetros de inicialização para especificar o URL do Cloud Object Storage de um bucket para arquivos de rastreamento SQL e para especificar as credenciais para acessar o Cloud Object Storage.
    1. Defina a propriedade do banco de dados DEFAULT_LOGGING_BUCKET para especificar o bucket de log no Cloud Object Storage.

      Por exemplo, se você criar o bucket com o Oracle Cloud Infrastructure Object Storage: 

      SET DEFINE OFF;
ALTER DATABASE PROPERTY SET 
   DEFAULT_LOGGING_BUCKET = 'https://objectstorage.us-ashburn-1.oraclecloud.com/n/namespace-string/b/bucket_name/o/';

      Em que namespace-string é o namespace do Oracle Cloud Infrastructure Object Storage e bucket_name é o nome do bucket criado anteriormente. Consulte Noções Básicas de Namespaces do serviço Object Storage para obter mais informações.

      Consulte Regiões e Domínios de Disponibilidade para obter uma lista de regiões.

      O Cloud Object Store que você usa para arquivos de Rastreamento SQL pode ser qualquer Cloud Object Store compatível com o Autonomous AI Database.

    2. A propriedade DEFAULT_CREDENTIAL do banco de dados foi definida para a credencial criada na Etapa 2.

      É necessário incluir o nome do esquema com a credencial. Neste exemplo, o esquema é "ADMIN".

      Por exemplo:

      ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME';

Ativar Rastreamento SQL no Autonomous AI Database

Mostra as etapas para ativar o rastreamento SQL para a sessão do banco de dados.

Observação

Se você ativar o rastreamento SQL do desempenho do seu aplicativo para a sessão, poderá ficar degradado enquanto a coleta de rastreamento estiver ativada. Esse impacto negativo no desempenho é esperado devido à sobrecarga de coleta e salvamento de dados de rastreamento.

Antes de ativar o rastreamento SQL, você deve configurar o banco de dados para salvar os arquivos de Rastreamento SQL. Consulte Configurar Rastreamento de SQL no Autonomous AI Database para obter mais informações.

Para ativar o rastreamento SQL, faça o seguinte:

  1. (Opcional) Defina um identificador de cliente para o aplicativo. A etapa é opcional, mas é recomendada. O rastreamento SQL usa o identificador do cliente como um componente do nome do arquivo de rastreamento quando o arquivo de rastreamento é gravado no Cloud Object Store.

    Por exemplo:

    BEGIN
  DBMS_SESSION.SET_IDENTIFIER('sqlt_test');
END;
/
  2. (Opcional) Defina um nome de módulo para o aplicativo. A etapa é opcional, mas é recomendada. O rastreamento SQL usa o nome do módulo como um componente do nome do arquivo de rastreamento quando o arquivo de rastreamento é gravado no Cloud Object Store.

    Por exemplo:

    BEGIN
  DBMS_APPLICATION_INFO.SET_MODULE('modname', null);
END;
/
  3. Ative o recurso Rastreamento SQL.
    ALTER SESSION SET SQL_TRACE = TRUE;
  4. Execute sua carga de trabalho.

    Esta etapa envolve a execução de todo o aplicativo ou de partes específicas do aplicativo. Enquanto você executa sua carga de trabalho na sessão do banco de dados, os dados de rastreamento SQL são coletados.

  5. Desativar rastreamento SQL.

    Quando você desativa o rastreamento SQL, os dados coletados da sessão são gravados em uma tabela da sua sessão e em um arquivo de rastreamento no bucket que você configura ao configurar o rastreamento SQL. Consulte Desativar o Rastreamento de SQL no Autonomous AI Database para obter detalhes.

Desativar Rastreamento SQL no Autonomous AI Database

Mostra as etapas para desativar o rastreamento SQL no Autonomous AI Database.

Para desativar o rastreamento SQL, faça o seguinte:

  1. Desative o recurso de Rastreamento SQL.
    ALTER SESSION SET SQL_TRACE = FALSE;
  2. (Opcional) conforme necessário para o seu ambiente, talvez você queira redefinir a propriedade do banco de dados DEFAULT_LOGGING_BUCKET para limpar o valor do bucket de log no Cloud Object Storage.

    Por exemplo:

    ALTER DATABASE PROPERTY SET DEFAULT_LOGGING_BUCKET = '';

Quando você desativa o rastreamento SQL, os dados de rastreamento coletados enquanto a sessão é executada com o rastreamento ativado são copiados para uma tabela e enviados para um arquivo de rastreamento no Cloud Object Store. Você tem duas opções para exibir dados de rastreamento:

Exibir Arquivo de Rastreamento Salvo no Cloud Object Store no Autonomous AI Database

Descreve a nomeação do arquivo de saída para arquivos de rastreamento SQL e mostra os comandos para usar TKPROF para organizar e exibir dados do arquivo de rastreamento.

Você usa dados de arquivo de rastreamento SQL para analisar o desempenho do aplicativo no Autonomous AI Database. Quando você desativa o rastreamento SQL em sua sessão de banco de dados, os dados são gravados no bucket do Cloud Object Store configurado com DEFAULT_LOGGING_BUCKET.

O recurso de Rastreamento SQL grava os dados de rastreamento coletados na sessão no Cloud Object Store no seguinte formato:

default_logging_bucket/sqltrace/clientID/moduleName/sqltrace_numID1_numID2.trc

Os componentes do nome do arquivo são:

  • default_logging_bucket: é o valor da propriedade do banco de dados DEFAULT_LOGGING_BUCKET. Consulte Configurar Rastreamento de SQL no Autonomous AI Database para obter mais informações.

  • clientID: é o identificador do cliente. Consulte Ativar Rastreamento SQL no Autonomous AI Database para obter mais informações.

  • moduleName: é o nome do módulo. Consulte Ativar Rastreamento SQL no Autonomous AI Database para obter mais informações.

  • numID1_numID2: são dois identificadores que o recurso de Rastreamento SQL fornece. Os valores numéricos numID1 e numID2 diferenciam exclusivamente cada nome de arquivo de rastreamento de outras sessões usando rastreamento e criando arquivos de rastreamento no mesmo bucket no Cloud Object Storage.

    Quando o serviço de banco de dados suporta paralelismo e uma sessão executa uma consulta paralela, o recurso de Rastreamento SQL pode produzir vários arquivos de rastreamento com valores numID1 e numID2 diferentes.

Observação

Quando o rastreamento SQL é ativado e desativado várias vezes dentro da mesma sessão, cada iteração de rastreamento gera um arquivo de rastreamento separado no Cloud Object Store. Para evitar a substituição de rastreamentos anteriores que foram gerados na sessão, os arquivos gerados subsequentemente seguem a mesma convenção de nomenclatura e adicionam um sufixo numérico ao nome do arquivo de rastreamento. Este sufixo numérico começa com o número 1 e é incrementado em 1 para cada iteração de rastreamento posteriormente.

Por exemplo, o seguinte é um exemplo de nome de arquivo de rastreamento gerado quando você define o identificador do cliente como "sql_test" e o nome do módulo como "modname": 

sqltrace/sqlt_test/modname/sqltrace_5415_56432.trc

Você pode executar TKPROF para converter o arquivo de rastreamento em um arquivo de saída legível.

  1. Copie o arquivo de rastreamento do Object Store para o sistema local.
  2. Navegue até o diretório no qual o arquivo de rastreamento é salvo.
  3. Execute o utilitário TKPROF no prompt do sistema operacional usando a seguinte sintaxe:
    tkprof filename1 filename2 [waits=yes|no] [sort=option] [print=n]
    [aggregate=yes|no] [insert=filename3] [sys=yes|no] [table=schema.table]
    [explain=user/password] [record=filename4] [width=n]

    Os arquivos de entrada e saída são os únicos argumentos necessários.

  4. Para exibir a Ajuda on-line, chame TKPROF sem argumentos.

Consulte "Tools for End-to-End Application Tracing" no Oracle Database SQL Tuning Guide para obter informações sobre o uso do utilitário TKPROF.

Exibir Dados de Rastreamento na View SESSION_CLOUD_TRACE no Autonomous AI Database

Quando você ativa o Rastreamento SQL, as mesmas informações de rastreamento salvas no arquivo de rastreamento no Cloud Object Store ficam disponíveis na exibição SESSION_CLOUD_TRACE na sessão em que o rastreamento foi ativado.

Enquanto você ainda estiver na sessão de banco de dados, poderá exibir dados de rastreamento SQL na exibição SESSION_CLOUD_TRACE. A view SESSION_CLOUD_TRACE inclui duas colunas: ROW_NUMBER e TRACE: 

DESC SESSION_CLOUD_TRACE

Name       Null? Type
---------- ----- ------------------------------
ROW_NUMBER       NUMBER
TRACE            VARCHAR2(32767)

O ROW_NUMBER especifica a ordenação dos dados de rastreamento encontrados na coluna TRACE. Cada linha de saída de rastreamento gravada em um arquivo de rastreamento se torna uma linha na tabela e está disponível na coluna TRACE.

Depois de desativar o rastreamento SQL da sessão, você poderá executar consultas na exibição SESSION_CLOUD_TRACE.

Por exemplo:

SELECT trace FROM SESSION_CLOUD_TRACE ORDER BY row_number;

Os dados no SESSION_CLOUD_TRACE persistem durante a sessão. Depois de fazer logout ou fechar a sessão, os dados não estarão mais disponíveis.

Se o Rastreamento SQL estiver ativado e desativado várias vezes dentro da mesma sessão, SESSION_CLOUD_TRACE mostrará os dados de rastreamento de todas as iterações cumulativamente. Assim, reativar o rastreamento em uma sessão após desabilitar o rastreamento anteriormente não remove os dados de rastreamento produzidos pela iteração anterior.