DBMS_PROXY_SQL

Descreve os procedimentos para ativar e desativar o offload de consulta para um líder de pool elástico ou um membro de pool elástico. Esse pacote também fornece procedimentos para ativar e gerenciar o ProxySQL para roteamento de instruções.

Resumo dos Subprogramas DBMS_PROXY_SQL

Esta tabela resume os subprogramas incluídos no pacote DBMS_PROXY_SQL.

• Procedimento ACCEPT_MAPPING Execute este procedimento em uma instância de destino ProxySQL para adicionar uma nova entrada de mapeamento correspondente à entrada de mapeamento de um objeto na tabela de roteamento da instância do Autonomous AI Database do roteador.

• Procedimento ADD_MAPPING Execute este procedimento em uma instância do Autonomous AI Database do roteador para adicionar um novo mapeamento na tabela de roteamento.

• Procedimento DISABLE_READ_ONLY_OFFLOAD

  Este procedimento desativa o descarregamento de consultas para um líder de pool elástico do Autonomous AI Database ou para um membro de pool elástico.

• Procedimento DISABLE_ROUTING

  Execute este procedimento em uma instância do roteador para desativar o ProxySQL.

• Procedimento ENABLE_READ_ONLY_OFFLOAD Este procedimento permite o descarregamento de consultas para um líder de pool elástico do Autonomous AI Database ou para um membro de pool elástico.

• Procedimento ENABLE_ROUTING

  Execute este procedimento em uma instância do Autonomous AI Database para designar a instância como uma instância do roteador e para ativar o roteamento automático de instruções.

• Procedimento REJECT_MAPPING

  Execute em uma instância de destino do Autonomous AI Database para remover uma entrada de mapeamento existente da tabela de aceitação.

• Procedimento REMOVE_MAPPING

  Execute este procedimento na instância do Autonomous AI Database do roteador para remover uma entrada de mapeamento existente de um objeto da tabela de roteamento.

ACCEPT_MAPPING Procedimento

Execute este procedimento em uma instância de destino ProxySQL para adicionar uma nova entrada de mapeamento correspondente à entrada de mapeamento de um objeto na tabela de roteamento da instância do Autonomous AI Database do roteador.

Sintaxe

DBMS_PROXY_SQL.ACCEPT_MAPPING (
    object_owner          IN VARCHAR2,
    router_database_ocid  IN VARCHAR2);

Parâmetros

Exemplo

BEGIN
 DBMS_PROXY_SQL.ACCEPT_MAPPING (
    object_owner          => 'DW_USER',
    router_database_ocid  => 'TARGET_DATABASE_OCID');
 END;
/

Observações de Uso

• Execute este procedimento na instância de destino do Autonomous AI Database.

• Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE no pacote DBMS_PROXY_SQL.

• Cada entrada de mapeamento na tabela de roteamento na instância do Autonomous AI Database do roteador deve ter uma entrada correspondente na respectiva instância do Autonomous AI Database de destino.

ADD_MAPPING Procedimento

Execute este procedimento em uma instância do Autonomous AI Database do roteador para adicionar um novo mapeamento na tabela de roteamento.

Sintaxe

DBMS_PROXY_SQL.ADD_MAPPING (
    object_owner   IN VARCHAR2,
    object_name    IN VARCHAR2,
    database_ocid  IN VARCHAR2);

Parâmetros

Exemplos

Exemplo para ativar o roteamento no nível do objeto:

BEGIN
 DBMS_PROXY_SQL.ADD_MAPPING(
    object_owner   => 'DW_USER',
    object_name    => 'INVENTORY',
    database_ocid  => 'TARGET_DATABASE_OCID');
END;
/

Exemplo para ativar o roteamento no nível do esquema:

BEGIN
 DBMS_PROXY_SQL.ADD_MAPPING(
    object_owner   => 'DW_USER',
    object_name    => '*',
    database_ocid  => 'TARGET_DATABASE_OCID');
END;
/

Observações de Uso

• Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE no pacote DBMS_PROXY_SQL.

• Execute este procedimento na instância do Autonomous AI Database do roteador.

DISABLE_READ_ONLY_OFFLOAD Procedimento

Este procedimento desativa o descarregamento de consultas para um líder de pool elástico do Autonomous AI Database ou para um membro de pool elástico.

Sintaxe

DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

Exemplo

EXEC DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

DISABLE_ROUTING Procedimento

Execute este procedimento em uma instância do roteador para desativar ProxySQL.

Sintaxe

DBMS_PROXY_SQL.DISABLE_ROUTING;

Exemplo

BEGIN
   DBMS_PROXY_SQL.DISABLE_ROUTING;
END;
/

Observações de Uso

• Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE no pacote DBMS_PROXY_SQL.

• Execute este procedimento na instância do Autonomous AI Database do roteador.

ENABLE_READ_ONLY_OFFLOAD Procedimento

Este procedimento permite o descarregamento de consultas para um líder de pool elástico do Autonomous AI Database ou para um membro de pool elástico.

Sintaxe

DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD(
      module_name       IN CLOB,
      action_name       IN CLOB);

Parâmetros

Observações de Uso

• Se module_name e action_name forem especificados, o nome do módulo de uma sessão deverá corresponder a um valor na lista de nomes de módulo e seu nome de ação deverá corresponder a um valor na lista de nomes de ação para que a sessão seja considerada para offload.

• Quando o descarregamento de consulta é ativado para uma sessão, você pode encontrar o nome do Clone Atualizável para o qual as consultas são descarregadas. Por exemplo:

SELECT sys_context('userenv', 'con_name') from dual;

Se as consultas não estiverem sendo descarregadas para um Clone Atualizável, essa consulta mostrará o nome do líder do pool elástico (ou o nome do membro do pool elástico).

• As views DBA_PROXY_SQL_ACTIONS e DBA_PROXY_SQL_MODULES exibem a lista de módulos ou ações que são configurados para offload de consulta. É necessário consultar essas exibições em uma sessão que não está ativada para descarregamento de consulta.

  Consulte Views DBA_PROXY_SQL para obter mais informações.

• Quando você descarrega consultas de uma lista de sessões que você especifica por módulo ou nome da ação, o nome do módulo e o nome da ação definidos com DBMS_APPLICATION_INFO fazem distinção entre maiúsculas e minúsculas. DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD adere a esse comportamento sensível a casos. Por exemplo, quando uma sessão tem um nome de módulo em letras minúsculas ou um nome de módulo em letras maiúsculas e minúsculas, a letra deve corresponder aos valores do parâmetro quando você ativa o descarregamento de consulta com DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD e inclui os parâmetros module_name ou action_name.

  Você pode verificar o nome do módulo e o nome da ação para a sessão atual usando DBMS_APPLICATION_INFO.READ_MODULE:

  set serveroutput on;
  declare
    l_mod varchar2(50);
    l_act varchar2(50);
  BEGIN
  DBMS_APPLICATION_INFO.READ_MODULE(l_mod, l_act);
    DBMS_OUTPUT.PUT_LINE('l_mod: ' || l_mod);
    DBMS_OUTPUT.PUT_LINE('l_act: ' || l_act);
  END;
  /

Exemplos

EXEC DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD;


DECLARE
   mod_values clob := to_clob('["mod1", "mod2"]');
   act_values clob := to_clob('["act1", "act2"]');
BEGIN
   DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD(
      module_name => mod_values,
      action_name => act_values);
END;
/

ENABLE_ROUTING Procedimento

Execute este procedimento em uma instância do Autonomous AI Database para designar a instância como uma instância do roteador e para ativar o roteamento automático de instruções.

Sintaxe

DBMS_PROXY_SQL.ENABLE_ROUTING;

Exemplo

BEGIN
   DBMS_PROXY_SQL.ENABLE_ROUTING;
END;
/

Observações de Uso

• Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE no pacote DBMS_PROXY_SQL.

• Execute este procedimento na instância do Autonomous AI Database do roteador.

REJECT_MAPPING Procedimento

Execute em uma instância de destino do Autonomous AI Database para remover uma entrada de mapeamento existente da tabela de aceitação.

Sintaxe

DBMS_PROXY_SQL.REJECT_MAPPING (
    object_owner         IN VARCHAR2,
    router_database_ocid IN VARCHAR2);

Parâmetros

Exemplo

BEGIN
 DBMS_PROXY_SQL.REJECT_MAPPING (
    object_owner          => 'DW_USER',
    router_database_ocid  => '*TARGET_DATABASE_OCID*');
 END;
/

Observações de Uso

• Execute o procedimento na instância de destino do Autonomous AI Database.

• Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE no pacote DBMS_PROXY_SQL.

REMOVE_MAPPING Procedimento

Execute este procedimento na instância do Autonomous AI Database do roteador para remover uma entrada de mapeamento existente de um objeto da tabela de roteamento.

Sintaxe

DBMS_PROXY_SQL.REMOVE_MAPPING (
    object_owner   IN VARCHAR2,
    object_name    IN VARCHAR2);

Parâmetros

Exemplo

BEGIN
 DBMS_PROXY_SQL.REMOVE_MAPPING (
    object_owner   => 'DW_USER',
    object_name    => 'INVENTORY');
 END;
/

Observações de Uso

• Execute este procedimento na instância do Autonomous AI Database do roteador.

• Para executar este procedimento, você deve estar conectado como usuário ADMIN ou ter o privilégio EXECUTE no pacote DBMS_PROXY_SQL.