Documentação do Oracle Cloud Infrastructure

Gerenciar Conjuntos de Ajuste SQL

Você pode gerenciar conjuntos de ajuste SQL e executar tarefas como criar um conjunto de ajuste SQL e carregar instruções SQL em conjuntos de ajuste SQL no Database Management Diagnostics & Management.

Um conjunto de ajustes SQL é um objeto de banco de dados que serve como um mecanismo para coletar, manter e acessar dados de carga de trabalho SQL para monitoramento e ajuste do desempenho de SQL. Ele permite agrupar instruções SQL e metadados relacionados em um único objeto de banco de dados, que você pode usar como entrada para ferramentas de ajuste, como o SQL Tuning Advisor. Um conjunto de ajustes SQL inclui:

  • Um conjunto de instruções SQL.
  • Contexto de execução associado, como esquema do usuário, nome do módulo de aplicação e ação, lista de valores de bind e ambiente de compilação do cursor.
  • Estatísticas de execução básicas associadas, como tempo decorrido, tempo de CPU, obtenções de buffer, leituras de disco, linhas processadas, extrações do cursor, o número de execuções, o número de execuções concluídas, custo do otimizador e tipo de comando.
  • Planos de execução associados e estatísticas de origem da linha para cada instrução SQL (opcional).

Para gerenciar conjuntos de ajustes SQL em Diagnósticos e Gerenciamento, vá para a página Detalhes do banco de dados gerenciado e clique em Conjuntos de ajustes SQL no painel esquerdo em Recursos. A lista de conjuntos de ajuste SQL existentes para o Banco de Dados Gerenciado é exibida com informações como o nome, o status, o proprietário e o número de instruções no conjunto de ajuste SQL.

Você pode executar as seguintes tarefas relacionadas ao conjunto de ajustes SQL:

  • Crie um novo conjunto de ajustes SQL e carregue instruções SQL de várias origens.
  • Carregue as instruções SQL para um conjunto de ajustes SQL existente.
  • Monitorar detalhes do conjunto de ajustes SQL.
  • Salve instruções SQL de um conjunto de ajustes SQL para outro conjunto de ajustes SQL novo ou existente.
  • Exclua um ou mais conjuntos de ajuste SQL em um conjunto de ajuste SQL.

Além disso, ao criar um conjunto de ajustes SQL ou monitorar detalhes do conjunto de ajustes SQL, você pode especificar um predicado SQL para filtrar as instruções SQL. O predicado SQL se baseia nos atributos do SQLSET_ROW. Para obter informações, consulte SQLSET_ROW Tipo de Objeto em Pacotes PL/SQL do Oracle Database e Referência de Tipos.

Privilégios Necessários para Gerenciar SQL Tuning Sets

Você deve ter um dos seguintes privilégios:

  • ADMINISTER SQL TUNING SET: Permite gerenciar os conjuntos de ajustes SQL de sua propriedade.
  • ADMINISTER ANY SQL TUNING SET: Permite gerenciar qualquer conjunto de ajustes SQL.

Criar um Conjunto de Ajuste SQL

Você pode criar um novo conjunto de ajustes SQL para um Banco de Dados Gerenciado e carregar instruções SQL de várias origens.

  1. Na seção Conjuntos de ajustes SQL da página Detalhes do banco de dados gerenciado, clique em Criar.
  2. Na página Informações do conjunto de ajuste SQL do painel Criar conjunto de ajuste SQL:
    1. Forneça as seguintes informações para criar um conjunto de ajustes SQL vazio:
      1. Nome: Informe um nome para o conjunto de ajuste SQL.
      2. Proprietário: Informe o nome de usuário do banco de dados do proprietário do conjunto de ajustes SQL.
        Observação

        O nome de usuário do proprietário será preenchido automaticamente se as credenciais preferenciais forem definidas no Diagnostics & Management. Por exemplo, se a credencial preferencial de diagnóstico Avançado estiver definida, o usuário do banco de dados associado será o proprietário do conjunto de ajustes SQL. Para obter informações sobre credenciais preferenciais, consulte Definir Credenciais Preferenciais.
      3. Descrição: Opcionalmente, informe uma descrição para o conjunto de ajustes de SQL.
    2. Clique em Próximo.
  3. Na página Carregar SQLs do painel Criar conjunto de ajustes SQL:
    1. Selecione um dos seguintes métodos de carga para coletar e carregar instruções SQL no conjunto de ajustes SQL:
      • Cache de cursor incremental: Selecione essa opção e especifique os seguintes detalhes para selecionar e carregar instruções SQL ativas do cache de cursor para o conjunto de ajuste SQL incrementalmente por um período especificado.
        1. Tempo de captura (seg): Informe o período durante o qual as instruções SQL ativas serão capturadas da área SQL compartilhada.
        2. Intervalo de repetição (seg): Informe a duração do intervalo entre a captura de instruções SQL ativas.
        3. Opção de captura: Selecione uma opção de captura para carregar instruções SQL no conjunto de ajustes SQL:
          • Inserir: Selecione para adicionar apenas novas instruções SQL.
          • Atualizar: Selecione para atualizar as instruções SQL existentes e ignorar quaisquer novas instruções.
          • Mesclar: Selecione para adicionar novas instruções SQL e atualizar as existentes.
        4. Modo de captura: Selecione um modo de captura para as opções de captura Atualizar e Mesclar:
          • Substituir estatísticas antigas: Substitui estatísticas antigas quando o número de execuções é maior que o número armazenado no conjunto de ajustes SQL.
          • Acumular estatísticas: Adiciona novos valores aos valores atuais de uma instrução SQL que já está armazenada. Observe que esse modo detecta uma instrução que expirou, portanto, o valor final das estatísticas é a soma das estatísticas de todos os cursores sob os quais a instrução SQL existia.
        5. SQL Recursiva: Selecione para incluir instruções SQL recursivas no SQL Tuning Set.
        6. Filtro: Informe o predicado SQL para filtrar as instruções SQL que você deseja carregar no conjunto de ajustes SQL. Se um filtro não for especificado, somente as instruções CREATE TABLE, INSERT, SELECT, UPDATE, DELETE e MERGE serão capturadas. O predicado SQL se baseia nos atributos do SQLSET_ROW.
      • Cache de cursor atual: Selecione esta opção e especifique os seguintes detalhes para selecionar e carregar instruções SQL do cache de cursor para o conjunto de ajustes SQL. No caso de bancos de dados RAC, as instruções SQL do cache de cursor da instância RAC conectada são carregadas no SQL Tuning Set.
        1. Classificar resultados por: Selecione até três métricas para especificar a ordem de classificação dos resultados. Isso é útil caso os resultados tenham mais instruções SQL do que os limites que estão sendo definidos.
        2. Porcentagem do resultado: Informe um número para denotar a porcentagem de resultados correspondentes. Os resultados da consulta de filtro incluirão a porcentagem especificada de instruções SQL com a classificação mais alta entre todas as instruções SQL correspondentes. Observe que a classificação se baseia nas métricas especificadas na lista drop-down Classificar resultados por e pelo menos uma métrica deve ser selecionada para usar essa opção.
        3. Limite de resultados: Informe um número para denotar o limite fixo de resultados correspondentes. Os resultados da consulta de filtro serão limitados ao número especificado de instruções SQL. Se alguma métrica for selecionada na lista drop-down Classificar resultados por, a classificação dos resultados será aplicada antes da seleção das principais instruções SQL. O valor 0 indica que todas as instruções SQL correspondentes devem ser incluídas nos resultados.
        4. Opção de carregamento: Selecione uma opção para carregar instruções SQL no conjunto de ajustes SQL:
          • Inserir: Selecione para adicionar apenas novas instruções SQL.
          • Atualizar: Selecione para atualizar as instruções SQL existentes e ignorar quaisquer novas instruções.
          • Mesclar: Selecione para adicionar novas instruções SQL e atualizar as existentes.
        5. Opções avançadas: Expanda esta seção para usar opções avançadas para controlar como as instruções SQL são carregadas:
          • Lista de atributos: Selecione uma opção para especificar quais atributos da instrução SQL devem ser incluídos no conjunto de ajustes SQL:
            • Básico: Inclui todos os atributos (como binds e estatísticas), exceto planos SQL. Isso também inclui o contexto de execução.
            • Típico: Inclui atributos Básicos juntamente com planos SQL. Isso não inclui estatísticas de origem de linha e uma lista de referência de objeto.
            • Todos: Inclui todos os atributos juntamente com o contexto de execução.
          • Fazer commit de linhas: Informe um número para especificar se as instruções SQL serão submetidas a commit de forma incremental ou no final do carregamento. Se 0 for especificado nesse campo, um commit será executado somente uma vez no final do carregamento. Caso contrário, um commit será executado sempre que o número especificado de instruções for carregado.
          • Opção Atualizar: Selecione uma opção de atualização para especificar como atualizar instruções SQL existentes no conjunto de ajustes SQL. Essa seleção é considerada apenas para as opções de carregamento Atualizar e Mesclar:
            • Substituir estatísticas antigas: Atualiza a instrução SQL usando as novas estatísticas, a lista de bind, a lista de objetos etc. Esta é a opção default.
            • Acumular estatísticas: Combina estatísticas quando possível ou substitui os valores existentes pelos valores fornecidos. As estatísticas da instrução SQL que podem ser acumuladas são: elapsed_time, buffer_gets, direct_writes, disk_reads, rows_processed, fetches, executions, end_of_fetch_count, stat_period e active_stat_period.
          • Atualizar atributos: Selecione uma opção para especificar quais atributos da instrução SQL devem ser atualizados no conjunto de ajustes SQL. Essa seleção é considerada apenas para as opções de carregamento Atualizar e Mesclar:
            • Básico: Inclui somente estatísticas e binds.
            • Típico: Inclui atributos Básicos juntamente com planos SQL. Isso não inclui estatísticas de origem de linha e uma lista de referência de objeto.
            • Todos: Inclui todos os atributos juntamente com o contexto de execução.
          • SQL Recursiva: Selecione para incluir instruções SQL recursivas no SQL Tuning Set.
          • Ignorar atributos nulos: Selecione para ignorar atributos quando o novo valor for NULL.
        6. Filtro: Informe o predicado SQL para filtrar as instruções SQL que você deseja carregar no conjunto de ajustes SQL. Se um filtro não for especificado, somente as instruções CREATE TABLE, INSERT, SELECT, UPDATE, DELETE e MERGE serão capturadas. O predicado SQL se baseia nos atributos do SQLSET_ROW.
      • Snapshots do AWR: Selecione essa opção e especifique os seguintes detalhes para selecionar e carregar instruções SQL de snapshots do AWR.
        1. Iniciando snapshot: Informe o ID do snapshot inicial na faixa (não inclusivo).
        2. Finalizando snapshot: Informe o ID do snapshot final no intervalo (inclusive).
        3. Classificar resultados por: Selecione até três métricas para especificar a ordem de classificação dos resultados. Isso é útil caso os resultados tenham mais instruções SQL do que os limites que estão sendo definidos.
        4. Porcentagem do resultado: Informe um número para denotar a porcentagem de resultados correspondentes. Os resultados da consulta de filtro incluirão a porcentagem especificada de instruções SQL com a classificação mais alta entre todas as instruções SQL correspondentes. Observe que a classificação se baseia nas métricas especificadas na lista drop-down Classificar resultados por e pelo menos uma métrica deve ser selecionada para usar essa opção.
        5. Limite de resultados: Informe um número para denotar o limite fixo de resultados correspondentes. Os resultados da consulta de filtro serão limitados ao número especificado de instruções SQL. Se alguma métrica for selecionada na lista drop-down Classificar resultados por, a classificação dos resultados será aplicada antes da seleção das principais instruções SQL. O valor 0 indica que todas as instruções SQL correspondentes devem ser incluídas nos resultados.
        6. Opção de carregamento: Selecione uma opção para carregar instruções SQL no conjunto de ajustes SQL:
          • Inserir: Selecione para adicionar apenas novas instruções SQL.
          • Atualizar: Selecione para atualizar as instruções SQL existentes e ignorar quaisquer novas instruções.
          • Mesclar: Selecione para adicionar novas instruções SQL e atualizar as existentes.
        7. Opções avançadas: Expanda esta seção para usar opções avançadas para controlar como as instruções SQL são carregadas:
          • Lista de atributos: Selecione uma opção para especificar quais atributos da instrução SQL devem ser incluídos no conjunto de ajustes SQL:
            • Básico: Inclui todos os atributos (como binds e estatísticas), exceto planos SQL. Isso também inclui o contexto de execução.
            • Típico: Inclui atributos Básicos juntamente com planos SQL. Isso não inclui estatísticas de origem de linha e uma lista de referência de objeto.
            • Todos: Inclui todos os atributos juntamente com o contexto de execução.
          • Fazer commit de linhas: Informe um número para especificar se as instruções SQL serão submetidas a commit de forma incremental ou no final do carregamento. Se 0 for especificado nesse campo, um commit será executado somente uma vez no final do carregamento. Caso contrário, um commit será executado sempre que o número especificado de instruções for carregado.
          • Opção Atualizar: Selecione uma opção de atualização para especificar como atualizar instruções SQL existentes no conjunto de ajustes SQL. Essa seleção é considerada apenas para as opções de carregamento Atualizar e Mesclar:
            • Substituir estatísticas antigas: Atualiza a instrução SQL usando as novas estatísticas, a lista de bind, a lista de objetos etc. Esta é a opção default.
            • Acumular estatísticas: Combina estatísticas quando possível ou substitui os valores existentes pelos valores fornecidos. As estatísticas da instrução SQL que podem ser acumuladas são: elapsed_time, buffer_gets, direct_writes, disk_reads, rows_processed, fetches, executions, end_of_fetch_count, stat_period e active_stat_period.
          • Atualizar atributos: Selecione uma opção para especificar quais atributos da instrução SQL devem ser atualizados no conjunto de ajustes SQL. Essa seleção é considerada apenas para as opções de carregamento Atualizar e Mesclar:
            • Básico: Inclui somente estatísticas e binds.
            • Típico: Inclui atributos Básicos juntamente com planos SQL. Isso não inclui estatísticas de origem de linha e uma lista de referência de objeto.
            • Todos: Inclui todos os atributos juntamente com o contexto de execução.
          • SQL Recursiva: Selecione para incluir instruções SQL recursivas no SQL Tuning Set.
          • Ignorar atributos nulos: Selecione para ignorar atributos quando o novo valor for NULL.
        8. Filtro: Informe o predicado SQL para filtrar as instruções SQL que você deseja carregar no conjunto de ajustes SQL. Se um filtro não for especificado, somente as instruções CREATE TABLE, INSERT, SELECT, UPDATE, DELETE e MERGE serão capturadas. O predicado SQL se baseia nos atributos do SQLSET_ROW.
      • Ignorar carregamento: Selecione essa opção para criar um conjunto de ajustes de SQL vazio. Você pode carregar as instruções SQL no conjunto de ajustes SQL vazio posteriormente.
    2. Selecione uma das opções disponíveis na lista drop-down Tipo de credencial na seção Credenciais para especificar as credenciais do banco de dados para estabelecer conexão com o Banco de Dados Gerenciado. Para obter informações sobre tipos de credenciais, consulte Usar Credenciais para Executar Tarefas de Diagnóstico e Gerenciamento.
  4. Como alternativa, clique em Mostrar SQL para exibir a instrução SQL que será executada.
  5. Clique em Criar.
O conjunto de ajustes SQL recém-criado é exibido na seção Conjuntos de ajustes SQL. Inicialmente, seu status é Running enquanto as instruções SQL estão sendo carregadas e, depois de criadas com sucesso, o status muda para Completed.

Depois que um conjunto de ajustes SQL for criado, você poderá selecioná-lo e executar as seguintes tarefas:

  • Clique em Carregar SQLs para carregar as instruções SQL para o conjunto de ajustes SQL. Observe que os métodos de carregamento e as etapas envolvidas no carregamento de instruções SQL no conjunto de ajustes SQL são os mesmos detalhados no procedimento de criação do conjunto de ajustes SQL.
  • Clique no ícone Ações (Ações) e clique em Excluir para excluir o conjunto de ajustes SQL.

Monitorar Detalhes do Conjunto de Ajustes SQL

Você pode monitorar os detalhes do conjunto de ajustes SQL e as instruções SQL no conjunto de ajustes SQL.

Na seção Conjuntos de ajuste SQL da página Detalhes do banco de dados gerenciado, clique no nome do conjunto de ajuste SQL para ir para a página Detalhes do conjunto de ajuste SQL. A página Detalhes do conjunto de ajustes SQL fornece informações do conjunto de ajustes SQL, como seu proprietário e o número total de instruções SQL no conjunto de ajustes SQL. Clique em Excluir para excluir o conjunto de ajuste SQL.

Na seção Instruções SQL da página Detalhes do conjunto de ajustes SQL, você pode exibir no máximo 2000 instruções SQL no conjunto de ajustes SQL e executar as seguintes tarefas:

  • Monitore os detalhes de cada instrução SQL, como o ID SQL, o texto SQL e o valor hash do plano.
  • Clique em Mostrar filtro e use as seguintes opções para filtrar a lista de instruções SQL no conjunto de ajustes SQL:
    • Consulta de filtro: Informe o predicado SQL para filtrar as instruções SQL. O predicado SQL se baseia nos atributos do SQLSET_ROW. Para obter informações, consulte SQLSET_ROW Tipo de Objeto em Pacotes PL/SQL do Oracle Database e Referência de Tipos.
    • Classificar resultados por: Selecione até três métricas para classificar as instruções SQL.
    • Porcentagem de resultado (%): Informe um número para denotar a porcentagem de resultados correspondentes. Os resultados da consulta de filtro incluirão a porcentagem especificada de instruções SQL com a classificação mais alta entre todas as instruções SQL correspondentes. Observe que a classificação se baseia nas métricas especificadas na lista drop-down Classificar resultados por e pelo menos uma métrica deve ser selecionada para usar essa opção.
    • Limite de resultados: Informe um número para denotar o limite fixo de resultados correspondentes. Os resultados da consulta de filtro serão limitados ao número especificado de instruções SQL. Se alguma métrica for selecionada na lista drop-down Classificar resultados por, a classificação dos resultados será aplicada antes da seleção das principais instruções SQL. O valor 0 indica que todas as instruções SQL correspondentes devem ser incluídas nos resultados.
    • SQL Recursivo: Selecione para incluir instruções SQL recursivas nos resultados da pesquisa.
  • Clique em Carregar SQLs para carregar as instruções SQL para o conjunto de ajustes SQL. Para obter informações sobre os métodos de carga disponíveis para coletar e carregar instruções SQL em um conjunto de ajustes SQL, consulte Criar um Conjunto de Ajustes SQL.
  • Clique em Salvar como para salvar as instruções SQL em um conjunto de ajustes SQL novo ou existente. Você pode salvar todas as instruções SQL no conjunto de ajustes SQL ou apenas aquelas que correspondem aos critérios de filtragem definidos.

    No painel Salvar conjunto de ajustes SQL:

    1. Forneça os detalhes do conjunto de ajustes SQL no qual você deseja salvar as instruções SQL.
      • Para salvar as instruções SQL em um conjunto de ajustes SQL existente:
        1. Método Salvar: Selecione No conjunto de ajustes SQL existente.
        2. Nome: Selecione o conjunto de ajustes SQL no qual você deseja salvar as instruções SQL.
        3. Mostrar opções avançadas: Especifique detalhes para selecionar e salvar instruções SQL em outro conjunto de ajustes SQL. Para obter informações sobre as opções exibidas nesta seção, consulte Criar um Conjunto de Ajustes SQL.
      • Para salvar as instruções SQL em um novo conjunto de ajustes SQL:
        1. Método Salvar: Selecione No novo conjunto de ajustes SQL.
        2. Nome: Informe um nome para o conjunto de ajuste SQL.
        3. Descrição: Opcionalmente, informe uma descrição para o conjunto de ajustes de SQL.
    2. Selecione uma das opções disponíveis na lista drop-down Tipo de credencial na seção Credenciais para especificar as credenciais do banco de dados para estabelecer conexão com o Banco de Dados Gerenciado. Para obter informações sobre tipos de credenciais, consulte Usar Credenciais para Executar Tarefas de Diagnóstico e Gerenciamento.
    3. Clique em Salvar.
  • Clique em Excluir SQLs para excluir todas as instruções SQL ou aquelas que correspondem aos critérios de filtragem do conjunto de ajustes SQL.