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

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

   Para salvar os arquivos de rastreamento de SQL, o bucket poderá estar em qualquer Cloud Object Store que o Autonomous Database suportar.

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

   1. Abra a Console do Oracle Cloud Infrastructure.
   2. Selecione Armazenamento no menu.
   3. Em Armazenamento, selecione Serviço 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 os arquivos de rastreamento de SQL só são suportados com buckets criados na camada de armazenamento padrão; certifique-se de escolher Padrão como camada de armazenamento ao criar o seu bucket. Consulte Visão Geral de Armazenamento de Objetos para obter informações sobre a Camada Padrão de Armazenamento de Objetos.

2. Crie uma credencial para a 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 de SQL e para especificar as credenciais de acesso ao Cloud Object Storage.
   1. Defina a propriedade de banco de dados DEFAULT_LOGGING_BUCKET para especificar o bucket de registro em 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 que você criou 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 de SQL pode ser qualquer um suportado pelo Autonomous Database.

   2. Defina a propriedade de banco de dados DEFAULT_CREDENTIAL como a credencial que você criou na Etapa 2.

      A inclusão do nome do esquema com a credencial é obrigatória. Neste exemplo, o esquema é "ADMIN".

      Por exemplo:

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

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

1. (Opcional) Defina um identificador de cliente para o aplicativo. Esta etapa é opcional, mas recomendada. O rastreamento de SQL usa o identificador de cliente como componente do nome do arquivo de rastreamento quando ele é gravado no Armazenamento de Objetos na Nuvem.

   Por exemplo:

   BEGIN
     DBMS_SESSION.SET_IDENTIFIER('sqlt_test');
   END;
   /

2. (Opcional) Defina um nome de módulo para o aplicativo. Esta etapa é opcional, mas recomendada. O rastreamento de SQL usa o nome do módulo como componente do nome do arquivo de rastreamento quando ele é gravado no Cloud Object Store.

   Por exemplo:

   BEGIN
     DBMS_APPLICATION_INFO.SET_MODULE('modname', null);
   END;
   /

3. Ative o recurso de Rastreamento de 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 dele. Embora você execute sua carga de trabalho na sessão do banco de dados, os dados de rastreamento de SQL são coletados.

5. Desativar Rastreamento SQL.

   Quando você desativar o rastreamento de SQL, os dados coletados para a sessão serão gravados em uma tabela na sua sessão e em um arquivo de rastreamento no bucket configurado quando você configurar o rastreamento de SQL. Consulte Desativar Rastreamento de SQL no Autonomous Database para obter detalhes.

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

1. Desative o recurso Rastreamento de SQL.

   ALTER SESSION SET SQL_TRACE = FALSE;

2. (Opcional) conforme necessário para seu ambiente, talvez você queira redefinir a propriedade de banco de dados DEFAULT_LOGGING_BUCKET para limpar o valor do bucket de registro em log no Cloud Object Storage.

   Por exemplo:

   ALTER DATABASE PROPERTY SET DEFAULT_LOGGING_BUCKET = '';

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

sqltrace/sqlt_test/modname/sqltrace_5415_56432.trc

1. Copie o arquivo de rastreamento do Armazenamento de Objetos 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 obrigatórios.

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

Quando você ativa o Rastreamento de SQL, as mesmas informações de rastreamento salvas no arquivo de rastreamento do Armazenamento de Objetos na Nuvem estão disponíveis na view SESSION_CLOUD_TRACE na sessão em que o rastreamento foi ativado.

DESC SESSION_CLOUD_TRACE

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

SELECT trace FROM SESSION_CLOUD_TRACE ORDER BY row_number;