Documentação do Oracle Cloud Infrastructure

Pacote DBMS_CLOUD_LINK_ADMIN

O pacote DBMS_CLOUD_LINK_ADMIN permite que um usuário ADMIN permita que um usuário do banco de Dados registre conjuntos de Dados ou acesse conjuntos de Dados registrados para uma determinada instância de Autonomous Database, sujeito às restrições de acesso conforme definido com o escopo concedido.

Os privilégios também podem ser desativados para um usuário que tenha os privilégios definidos para registrar conjuntos de dados ou acessar conjuntos de dados registrados.

Tópico principal: Referência de Pacote Fornecido pelo Autonomous Database

DBMS_CLOUD_LINK_ADMIN Visão Geral

Descreve o uso do pacote DBMS_CLOUD_LINK_ADMIN.

Os Links da Nuvem fornecem um método baseado na nuvem para acessar remotamente dados somente leitura em uma instância do Autonomous Database. O pacote DBMS_CLOUD_LINK_ADMIN aproveita os mecanismos de acesso do Oracle Cloud Infrastructure para tornar os conjuntos de dados acessíveis dentro de um escopo específico e, além disso, há uma etapa de autorização opcional.

Tópico principal: Pacote DBMS_CLOUD_LINK_ADMIN

Resumo dos Subprogramas DBMS_CLOUD_LINK_ADMIN

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

Subprograma Descrição

ADD_SERVICE_MAPPING Procedimento

O procedimento associa um banco de dados do consumidor do Cloud Links a um serviço de banco de dados.
GRANT_AUTHORIZE Procedimento

Concede a um usuário a permissão para chamar os procedimentos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

GRANT_READ Procedimento

Permite que um usuário leia conjuntos de dados registrados, sujeitos a restrições de acesso impostas aos conjuntos de dados no registro.

GRANT_REGISTER Procedimento

Permite que um usuário registre um conjunto de dados para acesso remoto.

REMOVE_SERVICE_MAPPING Procedimento

Remova um mapeamento de serviço para um banco de dados especificado.

REVOKE_AUTHORIZE Procedimento

Revoga a permissão de um usuário para chamar os procedimentos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

REVOKE_READ Procedimento

Não permite que um usuário acesse conjuntos de dados registrados da instância do Autonomous Database.

REVOKE_REGISTER Procedimento

Não permite que um usuário registre conjuntos de dados para acesso remoto. Os conjuntos de dados que já foram registrados pelo usuário não são afetados.
  • ADD_SERVICE_MAPPING Procedimento
    O procedimento DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING associa um banco de dados consumidor a um serviço de banco de dados.
  • GRANT_AUTHORIZE Procedimento
    O procedimento concede a um usuário permissão para chamar os procedimentos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.
  • GRANT_READ Procedimento
    O procedimento permite que um usuário leia conjuntos de dados registrados, sujeitos às restrições de acesso impostas aos conjuntos de dados quando um conjunto de dados é registrado usando DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER.
  • GRANT_REGISTER Procedimento
    O procedimento permite que um usuário registre um conjunto de dados para acesso remoto.
  • Procedimento REMOVE_SERVICE_MAPPING
    O procedimento DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING remove um mapeamento de serviço para um banco de dados especificado.
  • REVOKE_AUTHORIZE Procedimento
    Este procedimento não permite que um usuário chame os procedimentos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.
  • REVOKE_READ Procedimento
    Este procedimento não permite que um usuário acesse conjuntos de dados registrados na instância do Autonomous Database.
  • REVOKE_REGISTER Procedimento
    O procedimento não permite que um usuário registre conjuntos de dados para acesso remoto. Os conjuntos de dados que já foram registrados pelo usuário não são afetados.

Tópico principal: Pacote DBMS_CLOUD_LINK_ADMIN

ADD_SERVICE_MAPPING Procedimento

O procedimento DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING associa um banco de dados do consumidor a um serviço de banco de dados.

Sintaxe

DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING(
      database_id        IN   VARCHAR2,
      service_name       IN   VARCHAR2
);

Parâmetros

Parâmetro Descrição

database_id

Especifica o ID do banco de dados de uma instância do Autonomous Database que é um consumidor do Cloud Link. Use DBMS_CLOUD_LINK.GET_DATABASE_ID para obter o ID do banco de dados.

O valor "ANY" associa o valor service_name especificado a todos os bancos de dados do consumidor que não têm uma entrada que corresponda ao identificador do banco de dados. Ou seja, qualquer database_id cujo service_name não tenha sido definido com DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

Valores válidos: um ID de banco de dados ou "ANY".

service_name

Especifica o nome de serviço do banco de dados. Os valores válidos dependem do tipo de carga de trabalho:

  • Data Warehouse: Os valores válidos são: HIGH, MEDIUM, LOW

  • Processamento de Transações, JSON Database ou APEX: Os valores válidos são: TP, TPURGENT, HIGH, MEDIUM, LOW

Observações de Uso

  • Somente o usuário ADMIN e os esquemas com a atribuição PDB_DBA podem executar DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

  • Execute o comando DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING na instância do Autonomous Database do proprietário do conjunto de dados.

GRANT_AUTHORIZE Procedimento

O procedimento concede a um usuário permissão para chamar os procedimentos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Sintaxe

DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE(
      username        IN   VARCHAR2
);

Parâmetros

Parâmetro Descrição

username

Especifica um nome de usuário.

Observações de Uso

  • Para ativar a autorização de um conjunto de dados com DBMS_CLOUD_LINK.GRANT_AUTHORIZATION, você precisa ter concedido o privilégio com DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE. Isso também se aplica ao usuário ADMIN; no entanto, o usuário ADMIN pode conceder esse privilégio a ele mesmo.

GRANT_READ Procedimento

O procedimento permite que um usuário leia conjuntos de dados registrados, sujeitos às restrições de acesso impostas aos conjuntos de dados quando um conjunto de dados é registrado usando DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER.

Sintaxe

DBMS_CLOUD_LINK_ADMIN.GRANT_READ(
      username        IN   VARCHAR2
);

Parâmetros

Parâmetro Descrição

username

Especifica um nome de usuário.

Observações de Uso

  • Para ler conjuntos de dados, você precisa ter concedido o privilégio com DBMS_CLOUD_LINK_ADMIN.GRANT_READ. Isso também se aplica ao usuário ADMIN; no entanto, o usuário ADMIN pode conceder esse privilégio a ele mesmo.

  • Um usuário pode consultar SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') para verificar se eles estão ativados para acesso READ a um conjunto de dados.

    Por exemplo, a seguinte consulta:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') FROM DUAL;

    Retorna 'YES' ou 'NO'.

GRANT_REGISTER Procedimento

O procedimento permite que um usuário registre um conjunto de dados para acesso remoto.

Sintaxe

DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER(
      username        IN   VARCHAR2,
      scope           IN   CLOB
);

Parâmetros

Parâmetro Descrição

username

Especifica um nome de usuário.

scope

Especifica o escopo no qual as permissões para publicação devem ser concedidas ao usuário especificado.

Os valores válidos são:

  • 'MY$REGION'
  • 'MY$TENANCY'
  • 'MY$COMPARTMENT'

Observações de Uso

  • Para registrar conjuntos de dados, você precisa ter concedido o privilégio com DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Isso também se aplica ao usuário ADMIN; no entanto, o usuário ADMIN pode conceder esse privilégio a ele mesmo.

  • Um usuário pode consultar SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') para verificar se eles estão ativados para registrar conjuntos de dados.

    Por exemplo, a seguinte consulta:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') FROM DUAL;

    Retorna 'YES' ou 'NO'.

REMOVE_SERVICE_MAPPING Procedimento

O procedimento DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING remove um mapeamento de serviço para um banco de dados especificado.

Sintaxe

DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING(
      database_id        IN   VARCHAR2
);

Parâmetros

Parâmetro Descrição

database_id

Especifica o ID do banco de dados de uma instância do Autonomous Database. Use DBMS_CLOUD_LINK.GET_DATABASE_ID para obter o ID do banco de dados.

O valor "ANY" remove qualquer valor service_name especificado com todos os bancos de dados do consumidor que não têm uma entrada que corresponda ao identificador do banco de dados. Ou seja, qualquer database_id cujo service_name não tenha sido definido com DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

Valores válidos: um ID de banco de dados ou "ANY".

Observação do Uso

Somente o usuário ADMIN e os esquemas com a atribuição PDB_DBA podem executar DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING.

REVOKE_AUTHORIZE Procedimento

Este procedimento não permite que um usuário chame os procedimentos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Sintaxe

DBMS_CLOUD_LINK_ADMIN.REVOKE_AUTHORIZE(
      username        IN   VARCHAR2
);

Parâmetros

Parâmetro Descrição

username

Especifica um nome de usuário.

REVOKE_READ Procedimento

Este procedimento não permite que um usuário acesse conjuntos de dados registrados na instância do Autonomous Database.

Sintaxe

DBMS_CLOUD_LINK_ADMIN.REVOKE_READ(
      username        IN   VARCHAR2
);

Parâmetros

Parâmetro Descrição

username

Especifica um nome de usuário.

Observação do Uso

  • Um usuário pode consultar SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') para verificar se eles estão ativados para acesso READ a um conjunto de dados.

    Por exemplo, a seguinte consulta:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') FROM DUAL;

    Retorna 'YES' ou 'NO'.

REVOKE_REGISTER Procedimento

O procedimento não permite que um usuário registre conjuntos de dados para acesso remoto. Os conjuntos de dados que já foram registrados pelo usuário não são afetados.

Sintaxe

DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER(
      username        IN   VARCHAR2
);

Parâmetros

Parâmetro Descrição

username

Especifica um nome de usuário.

Observação do Uso

  • Um usuário pode consultar SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') para verificar se eles estão ativados para registrar conjuntos de dados.

    Por exemplo, a seguinte consulta:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') FROM DUAL;

    Retorna 'YES' ou 'NO'.