Documentação do Oracle Cloud Infrastructure

Pacote DBMS_CLOUD_LINK_ADMIN

O pacote DBMS_CLOUD_LINK_ADMIN permite que o 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 do 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 Fornecida 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 para 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 de Subprogramas DBMS_CLOUD_LINK_ADMIN

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

Subprograma Descrição

Procedimento ADD_SERVICE_MAPPING

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

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

Procedimento GRANT_READ

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

Procedimento GRANT_REGISTER

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

Procedimento REMOVE_SERVICE_MAPPING

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

Procedimento REVOKE_AUTHORIZE

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

Procedimento REVOKE_READ

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

Procedimento REVOKE_REGISTER

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.
  • Procedimento ADD_SERVICE_MAPPING
    O procedimento DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING associa um banco de dados consumidor a um serviço de banco de dados.
  • Procedimento GRANT_AUTHORIZE
    O procedimento concede a um usuário permissão para chamar os procedimentos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.
  • Procedimento GRANT_READ
    O procedimento permite que um usuário leia conjuntos de dados registrados, sujeito às restrições de acesso impostas aos conjuntos de dados quando um conjunto de dados é registrado usando DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER.
  • Procedimento GRANT_REGISTER
    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.
  • Procedimento REVOKE_AUTHORIZE
    Este procedimento impede que um usuário chame os procedimentos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.
  • Procedimento REVOKE_READ
    Esse procedimento não permite que um usuário acesse conjuntos de dados registrados na instância do Autonomous Database.
  • Procedimento REVOKE_REGISTER
    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

Procedimento ADD_SERVICE_MAPPING

O procedimento DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING associa um banco de dados 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 de Link de Nuvem. 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 consumidores 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 do 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 DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING na instância do Autonomous Database do proprietário do conjunto de dados.

Procedimento GRANT_AUTHORIZE

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 do usuário.

Observações de Uso

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

Procedimento GRANT_READ

O procedimento permite que um usuário leia conjuntos de dados registrados, sujeito à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 do usuário.

Observações de Uso

  • Para ler conjuntos de dados, você deve ter concedido o privilégio com DBMS_CLOUD_LINK_ADMIN.GRANT_READ. Isso também é válido para o 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 ele está ativado 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'.

Procedimento GRANT_REGISTER

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 sobre Uso

  • Para registrar conjuntos de dados, você deve ter concedido o privilégio com DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Isso também é válido para o 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 o registro de conjuntos de dados.

    Por exemplo, a seguinte consulta:

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

    Retorna 'YES' ou 'NO'.

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.

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 para 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 consumidores que não tenham 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".

Nota de Uso

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

Procedimento REVOKE_AUTHORIZE

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 do usuário.

Procedimento REVOKE_READ

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 do usuário.

Nota de Uso

  • Um usuário pode consultar SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') para verificar se ele está ativado 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'.

Procedimento REVOKE_REGISTER

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 de Uso

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

    Por exemplo, a seguinte consulta:

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

    Retorna 'YES' ou 'NO'.