O Autonomous Database determina a acessibilidade dos conjuntos de dados registrados da seguinte forma:

• O usuário ADMIN especifica um escopo para um usuário que permite ao usuário registrar conjuntos de dados com base no escopo fornecido.

• Um usuário que recebeu privilégios para registrar conjuntos de dados especifica um escopo ao registrar um conjunto de dados.

• Opcionalmente, quando você registra um conjunto de dados, um usuário que recebeu privilégios de autorização pode especificar uma etapa de autorização necessária para acessar um conjunto de dados. Esta etapa de autorização é adicional à autorização de acesso no nível do escopo.

ORA-20001: Share privileges are not enabled for current user or it is enabled but not for scope MY$REGION

O usuário ADMIN pode revogar o registro para impedir que um usuário registre conjuntos de dados para acesso remoto. O usuário ADMIN também pode revogar privilégios ou usuários de banco de dados para acessar conjuntos de dados registrados.

1. Como usuário ADMIN, revogue os privilégios de um usuário para registrar conjuntos de dados.

   Por exemplo:

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER('DB_USER1');

   Isso revoga os privilégios para registrar conjuntos de dados para o usuário, DB_USER1.

   A execução de DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER não afeta os conjuntos de dados que já estão registrados. Use DBMS_CLOUD_LINK.UNREGISTER para remover o acesso de um conjunto de dados registrado.

   Consulte Procedimento REVOKE_REGISTER e Procedimento UNREGISTER para obter mais informações.

2. Como usuário ADMIN, revogue o acesso a conjuntos de dados registrados.

   Por exemplo:

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_READ('LWARD');

   Isso revoga o acesso aos conjuntos de dados de Links da Nuvem para o usuário LWARD.

   Consulte REVOKE_READ Procedimento para obter mais informações.

Você pode registrar uma tabela ou view que possui como um conjunto de dados registrado. Quando você deseja remover ou substituir o conjunto de dados, é necessário cancelar o registro dele. Depois de registrar um conjunto de dados, você poderá alterar os valores dos atributos de um conjunto de dados.

1. Obtenha privilégios de registro de concessão do usuário ADMIN.

   Consulte Conceder Acesso de Links de Nuvem para Usuários do Banco de Dados para obter mais informações.

2. Registre um ou mais conjuntos de dados.

   Por exemplo, supondo que haja um esquema CLOUDLINK na instância do Autonomous Database, você pode registrar dois objetos, SALES_VIEW_AGG e SALES_ALL, além de fornecer diferentes parâmetros scope para determinar como os objetos são acessados.

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_VIEW_AGG',
       namespace      => 'REGIONAL_SALES', 
       name           => 'SALES_AGG',
       description    => 'Aggregated regional sales information.',
       scope          => 'MY$TENANCY',
       auth_required  =>  FALSE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_ALL',
       namespace      => 'TRUSTED_COMPARTMENT', 
       name           => 'SALES',
       description    => 'Trusted Compartment, only accessible within my compartment. Early sales data.',
       scope          => 'MY$COMPARTMENT',
       auth_required  =>  FALSE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   Os parâmetros são:

   • schema_name: é o nome do esquema (o proprietário do objeto).

   • schema_object: é o nome do objeto. Os objetos válidos são:

     • Tabelas (incluindo Heap, Externa ou Híbrida)
     • Views
     • Views Materializadas
     • Tabelas da Nuvem (consulte Usar Tabelas da Nuvem para Armazenar Informações de Log e Diagnóstico para obter mais informações.)
     Observação
     
     Outros objetos, como views analíticas ou sinônimos, não são suportados.

   • namespace: é o namespace que você fornece como nome para acesso com Links da Nuvem (uma parte do FQN do Link da Nuvem).

     Um valor NULL especifica um valor namespace gerado pelo sistema, exclusivo da instância do Autonomous Database.

   • name: é o nome que você fornece para acesso com Links da Nuvem (uma parte do FQN do Link da Nuvem).

   • description: Especifica o texto para descrever os dados.

   • scope: Especifica o escopo. Você pode usar uma das variáveis: MY$REGION, MY$TENANCY ou MY$COMPARTMENT ou especificar um ou mais OCIDs.

     Consulte Escopo do Conjunto de Dados, Controle de Acesso e Autorização para obter mais informações.

   • auth_required: Um valor booliano que especifica se a autorização no nível do banco de dados é necessária para o conjunto de dados, além do controle de acesso do escopo. Quando definido como TRUE, o conjunto de dados impõe uma etapa de autorização adicional. Consulte Registrar um Conjunto de Dados com Autorização Obrigatória para obter mais informações.

   • data_set_owner: O valor de texto especifica informações sobre o indivíduo responsável pelo conjunto de dados ou um contato para perguntas sobre o conjunto de dados. Por exemplo, você pode fornecer um endereço de e-mail para o proprietário do conjunto de dados.

   Consulte Procedimento REGISTER para obter mais informações.

   Para este exemplo, depois que o registro for concluído, o escopo dos dois objetos registrados será diferente, com base no parâmetro de escopo fornecido com DBMS_CLOUD_LINK.REGISTER:

   • MY$TENANCY: Especifica o escopo no nível da tenancy para REGIONAL_SALES.SALES_AGG.

   • MY$COMPARTMENT: Especifica o escopo de nível de compartimento mais restritivo na tenancy para TRUSTED_COMPARTMENT.SALES.

BEGIN
   DBMS_CLOUD_LINK.UNREGISTER(
    namespace      => 'TRUSTED_COMPARTMENT', 
    name           => 'SALES');
END;
/

• Observações sobre Registro ou Cancelamento de Registro de um Conjunto de Dados
  Fornece observações sobre o registro de um conjunto de dados em DBMS_CLOUD_LINK.REGISTER e o cancelamento do registro de um conjunto de dados em DBMS_CLOUD_LINK.UNREGISTER.

Você pode usar Links de Nuvem em várias regiões, em que a região de origem contém o banco de dados de origem do conjunto de dados e uma ou mais regiões remotas contêm clones atualizáveis do banco de dados de origem.

Descrição da ilustração cloud-links-cross-region-refreshable-clone.png

Para usar Links da Nuvem com um conjunto de dados em outra região:

1. Crie um Clone Atualizável entre regiões do banco de dados de origem em uma região remota.

   Consulte Criar uma Tenancy Cruzada ou um Clone Atualizável entre Regiões para obter informações sobre como adicionar um clone atualizável entre regiões.

2. No banco de dados de origem, registre o conjunto de dados.

   Consulte Registrar ou Cancelar o Registro de um Conjunto de Dados para obter mais informações.

3. Atualize o clone atualizável.

   Consulte Atualizar um Clone Atualizável no Autonomous Database para obter mais informações.

4. No Clone Atualizável remoto, registre o conjunto de dados usando os mesmos argumentos que você usou para registrar o conjunto de dados na região de origem.

   Por exemplo, supondo que haja um esquema CLOUDLINK na sua instância do Autonomous Database, depois que você registrar SALES_ALL no banco de dados de origem, registre SALES_ALL no clone atualizável:

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_ALL',
       namespace      => 'TRUSTED_COMPARTMENT', 
       name           => 'SALES',
       description    => 'Trusted Compartment, only accessible within my compartment. Early sales data.',
       scope          => 'MY$COMPARTMENT',
       auth_required  =>  FALSE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   Os parâmetros são:

   • schema_name: é o nome do esquema (o proprietário do objeto).

   • schema_object: é o nome do objeto. Os objetos válidos são:

     • Tabelas (incluindo Heap, Externa ou Híbrida)
     • Views
     • Views Materializadas
     Observação
     
     Outros objetos, como views analíticas ou sinônimos, não são suportados.

   • namespace: é o namespace que você fornece como nome para acesso com Links da Nuvem (uma parte do FQN do Link da Nuvem).

     Um valor NULL especifica um valor namespace gerado pelo sistema, exclusivo da instância do Autonomous Database.

   • name: é o nome que você fornece para acesso com Links da Nuvem (uma parte do FQN do Link da Nuvem).

   • description: Especifica o texto para descrever os dados.

   • scope: Especifica o escopo. Você pode usar uma das variáveis: MY$REGION, MY$TENANCY ou MY$COMPARTMENT ou especificar um ou mais OCIDs.

     Consulte Escopo do Conjunto de Dados, Controle de Acesso e Autorização para obter mais informações.

   • auth_required: Um valor booliano que especifica se a autorização no nível do banco de dados é necessária para o conjunto de dados, além do controle de acesso do escopo. Quando definido como TRUE, o conjunto de dados impõe uma etapa de autorização adicional. Consulte Registrar um Conjunto de Dados com Autorização Obrigatória para obter mais informações.

   • data_set_owner: O valor de texto especifica informações sobre o indivíduo responsável pelo conjunto de dados ou um contato para perguntas sobre o conjunto de dados. Por exemplo, você pode fornecer um endereço de e-mail para o proprietário do conjunto de dados.

   Consulte Procedimento REGISTER para obter mais informações.

   Depois que o registro for concluído no clone atualizável, o escopo do objeto registrado será MY$COMPARTMENT: Especifica o escopo de nível de compartimento mais restritivo para meu compartimento na minha tenancy para TRUSTED_COMPARTMENT.SALES.

• Observações para Registrar ou Cancelar o Registro de um Conjunto de Dados em uma Região Remota
  Fornece observações para registrar um conjunto de dados em uma região remota.

Opcionalmente, ao registrar um conjunto de dados, além do escopo, você pode especificar que a autorização no nível do banco de dados é necessária para acessar um conjunto de dados.

1. Use DBMS_CLOUD_LINK.REGISTER para registrar dados com autorização necessária.

   Supondo que haja um esquema CLOUDLINK em sua instância do Autonomous Database e você registre o objeto SALES_VIEW_AGG e defina auth_required como TRUE; em seguida, além de definir o escopo, execute etapas adicionais para determinar como o objeto é acessado.

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_VIEW_AGG',
       namespace      => 'REGIONAL_SALES', 
       name           => 'SALES_AGG',
       description    => 'Aggregated regional sales information.',
       scope          => 'MY$TENANCY',
       auth_required  =>  TRUE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   Os parâmetros são:

   • schema_name: é o nome do esquema (o proprietário do objeto).

   • schema_object: é o nome do objeto. Os objetos válidos são:

     • Tabelas (incluindo Heap, Externa ou Híbrida)
     • Views
     • Views Materializadas
     Observação
     
     Outros objetos, como views analíticas ou sinônimos, não são suportados.

   • namespace: é o namespace que você fornece como nome para acesso com Links da Nuvem (uma parte do FQN do Link da Nuvem).

     Um valor NULL especifica um valor namespace gerado pelo sistema, exclusivo da instância do Autonomous Database.

   • name: é o nome que você fornece para acesso com Links da Nuvem (uma parte do FQN do Link da Nuvem).

   • scope: Especifica o escopo. Você pode usar uma das variáveis: MY$REGION, MY$TENANCY ou MY$COMPARTMENT ou especificar um ou mais OCIDs.

     Consulte Escopo do Conjunto de Dados, Controle de Acesso e Autorização para obter mais informações.

   • auth_required: Um valor booliano que especifica se a autorização no nível do banco de dados é necessária para o conjunto de dados, além do controle de acesso do escopo. Quando definido como TRUE, o conjunto de dados impõe uma etapa de autorização adicional.

   • data_set_owner: O valor de texto especifica informações sobre o indivíduo responsável pelo conjunto de dados ou um contato para perguntas sobre o conjunto de dados. Por exemplo, você pode fornecer um endereço de e-mail para o proprietário do conjunto de dados.

2. Obtenha o ID do banco de dados ao qual você deseja conceder autorização (para permitir que o banco de dados acesse o conjunto de dados).

   No sistema, você deseja conceder acesso ao conjunto de dados:

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

3. Use o ID do banco de dados obtido para conceder autorização a um conjunto de dados especificado.

   Você só poderá conceder autorização e executar DBMS_CLOUD_LINK.GRANT_AUTHORIZATION, conforme mostrado nesta etapa, se estiver autorizado. O ADMIN concede autorização com DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE.

   BEGIN
      DBMS_CLOUD_LINK.GRANT_AUTHORIZATION(
       database_id    => '120xxxxxxx8506029999',
       namespace      => 'TRUSTED_COMPARTMENT', 
       name           => 'SALES');
   END;
   /

   Execute essas etapas várias vezes se quiser autorizar bancos de dados adicionais.

BEGIN
   DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION(
    database_id    => '120xxxxxxx8506029999',
    namespace      => 'TRUSTED_COMPARTMENT', 
    name           => 'SALES');
END;
/

Opcionalmente, quando você registra um conjunto de dados, pode descarregar o acesso ao conjunto de dados para uma ou mais instâncias do Autonomous Database que são clones atualizáveis.

Use o parâmetro offload_targets opcional com DBMS_CLOUD_LINK.REGISTER para especificar que o acesso seja descarregado para clones atualizáveis. O banco de dados de origem para cada clone atualizável é a instância do Autonomous Database na qual você registra o conjunto de dados (publicador de dados).

O valor offload_targets é um documento JSON que define um ou mais pares de valores de chave CLOUD_LINK_DATABASE_ID e OFFLOAD_TARGET:

• CLOUD_LINK_DATABASE_ID é um destes:

  • Um ID de banco de dados: especifica um ID de banco de dados para o consumidor do conjunto de dados cuja solicitação é descarregada para o clone atualizável correspondente especificado com o valor OFFLOAD_TARGET.

    Obtenha o ID do banco de dados executando DBMS_CLOUD_LINK.GET_DATABASE_ID. Consulte Função GET_DATABASE_ID para obter mais informações.

  • ANY: Especifica que qualquer solicitação do consumidor do conjunto de dados é descarregada para o destino de descarregamento correspondente. A solicitação do conjunto de dados de um consumidor será roteada para o destino de descarregamento correspondente.

    Se você especificar ANY sem especificar IDs de banco de dados, todas as solicitações de conjunto de dados dos consumidores serão descarregadas para o clone atualizável especificado com o valor OFFLOAD_TARGET.

    Se você especificar IDs de banco de dados e ANY, as solicitações de conjunto de dados dos consumidores que não corresponderem a um ID de banco de dados serão descarregadas para o clone atualizável especificado com o valor OFFLOAD_TARGET.

• OFFLOAD_TARGET é o OCID de uma instância do Autonomous Database que é um clone atualizável.

A figura a seguir ilustra o uso de destinos de offload.

Descrição da ilustração cloud-links-offload-targets-any-keyword.eps

Quando um consumidor de conjunto de dados solicita acesso a um conjunto de dados registrado com offload_targets e o ID do banco de dados da instância do Autonomous Database corresponde ao valor especificado em CLOUD_LINK_DATABASE_ID, o acesso é descarregado para o clone atualizável identificado com OFFLOAD_TARGET no JSON fornecido.

Por exemplo, o seguinte mostra uma amostra JSON com três pares de valores OFFLOAD_TARGET/CLOUD_LINK_DATABASE_ID:

{
  "OFFLOAD_TARGETS": [
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx69708978",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfabc"
    },
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx89898978",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfdef"
    },
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx4755680",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfghi"
    }
  ]
}

Quando um consumidor do conjunto de dados solicita acesso a um conjunto de dados que você registra em offload_targets que inclui a palavra-chave ANY, o acesso é descarregado para o clone atualizável identificado com OFFLOAD_TARGET no JSON fornecido (exceto para solicitações de consumidores que têm uma entrada de ID de banco de dados correspondente no JSON fornecido).

Por exemplo, o seguinte mostra uma amostra JSON com um par de valores OFFLOAD_TARGET/CLOUD_LINK_DATABASE_ID explícito e um valor ANY com um OFFLOAD_TARGET correspondente:

{
  "OFFLOAD_TARGETS": [
    {
      "CLOUD_LINK_DATABASE_ID": "ANY",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfdef"
    },
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx4755680",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfghi"
    }
  ]
}

Para registrar um conjunto de dados e especificar destinos de offload, faça o seguinte:

1. Obtenha o OCID de um ou mais clones atualizáveis nos quais você deseja descarregar o acesso ao conjunto de dados. OCIDs de clone atualizáveis estão disponíveis na Console do Oracle Cloud Infrastructure em um clone atualizável.
   Observação
   
   Pode levar até 10 minutos após a criação de um clone atualizável para que o clone atualizável fique visível como um destino de descarregamento. Isso significa que talvez você precise aguardar até 10 minutos depois de criar um clone atualizável para que o clone atualizável fique disponível para o registro de descarregamento dos Links da Nuvem.
2. Obtenha o ID do banco de dados para uma ou mais instâncias do Autonomous Database que você deseja acessar o conjunto de dados usando os dados fornecidos pelo clone atualizável.

   No sistema, você deseja acessar o conjunto de dados com base em um clone atualizável, execute o comando:

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

3. Registre um conjunto de dados e especifique o parâmetro offload_targets.

   Por exemplo, supondo que haja um esquema CLOUDLINK na sua instância do Autonomous Database, você pode registrar SALES_VIEW_AGG e especificar os clones atualizáveis que fornecem acesso ao conjunto de dados:

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name     => 'CLOUDLINK',
       schema_object   => 'SALES_VIEW_AGG',
       namespace       => 'REGIONAL_SALES', 
       name            => 'SALES_AGG',
       description     => 'Aggregated regional sales information.',
       scope           => 'MY$TENANCY',
       auth_required   =>  FALSE,
       data_set_owner  =>  'amit@example.com',
       offload_targets => '{
     "OFFLOAD_TARGETS": [
       {
         "CLOUD_LINK_DATABASE_ID": "34xxxx754755680",
         "OFFLOAD_TARGET":
   "ocid1.autonomousdatabase.oc1..xxxxxaaba3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfghi"
       }
     ]
   }');
   END;
   /

   Os parâmetros são:

   • schema_name: é o nome do esquema (o proprietário do objeto).

   • schema_object: é o nome do objeto. Os objetos válidos são:

     • Tabelas (incluindo Heap, Externa ou Híbrida)
     • Views
     • Views Materializadas
     Observação
     
     Outros objetos, como views analíticas ou sinônimos, não são suportados.

   • namespace: é o namespace que você fornece como nome para acesso com Links da Nuvem (uma parte do FQN do Link da Nuvem).

     Um valor NULL especifica um valor namespace gerado pelo sistema, exclusivo da instância do Autonomous Database.

   • name: é o nome que você fornece para acesso com Links da Nuvem (uma parte do FQN do Link da Nuvem).

   • scope: Especifica o escopo. Você pode usar uma das variáveis: MY$REGION, MY$TENANCY ou MY$COMPARTMENT ou especificar um ou mais OCIDs.

     Consulte Escopo do Conjunto de Dados, Controle de Acesso e Autorização para obter mais informações.

   • auth_required: Um valor booliano que especifica se a autorização no nível do banco de dados é necessária para o conjunto de dados, além do controle de acesso do escopo. Quando definido como TRUE, o conjunto de dados impõe uma etapa de autorização adicional. Consulte Registrar um Conjunto de Dados com Autorização Obrigatória para obter mais informações.

   • data_set_owner: O valor de texto especifica informações sobre o indivíduo responsável pelo conjunto de dados ou um contato para perguntas sobre o conjunto de dados. Por exemplo, você pode fornecer um endereço de e-mail para o proprietário do conjunto de dados.

   • offload_targets: Especifica um ou mais OCIDs do Autonomous Database de clones atualizáveis nos quais o acesso aos conjuntos de dados é descarregado do Autonomous Database no qual o conjunto de dados é registrado.

     Para cada consumidor de conjunto de dados, uma das opções a seguir pode corresponder para descarregar a solicitação para um clone atualizável:

     • Quando há correspondência com o valor do cloud_link_database_id especificado, ou seja, os valores correspondem ao ID do banco de dados do consumidor, o acesso é descarregado para o clone atualizável identificado pelo OCID especificado em offload_target.

     • Quando a palavra-chave ANY for especificada, se não houver uma correspondência com o valor de um cloud_link_database_id especificado, o acesso será descarregado para o clone atualizável identificado com a entrada ANY pelo OCID especificado no offload_target correspondente.

   Para obter mais informações, consulte:

   • Procedimento REGISTER

   • Procedimento UPDATE_REGISTRATION

   • Usar Clones Atualizáveis com o Autonomous Database

Depois de registrar um conjunto de dados, você poderá atualizar alguns atributos do conjunto de dados. Você não pode atualizar o nome do esquema, o objeto do esquema, o namespace ou os atributos de nome.

1. O usuário que registrou um conjunto de dados pode atualizar seus atributos com DBMS_CLOUD_LINK.UPDATE_REGISTRATION.

   Se você não tiver privilégios para atualizar os atributos do conjunto de dados, será necessário obter privilégios de registro de concessão do usuário ADMIN.

   Consulte Conceder Acesso a Links de Nuvem para Usuários do Banco de Dados para obter mais informações.

2. Atualize um ou mais atributos para um conjunto de dados.

   Por exemplo, use DBMS_CLOUD_LINK.UPDATE_REGISTRATION para atualizar os atributos description, scope e auth_required do conjunto de dados no namespace REGIONAL_SALES com o nome SALES_AGG:

   BEGIN
      DBMS_CLOUD_LINK.UPDATE_REGISTRATION(
       namespace      => 'REGIONAL_SALES', 
       name           => 'SALES_AGG',
       description    => 'Updated description for aggregated regional sales information.',
       scope          => 'MY$COMPARTMENT',
       auth_required  =>  TRUE );
   END;
   /

   Os parâmetros obrigatórios são:

   • namespace: é o namespace do conjunto de dados fornecido quando você registrou o conjunto de dados.

   • name: é o nome do conjunto de dados fornecido quando você registrou o conjunto de dados.

   Veja a seguir uma lista dos parâmetros opcionais. Se NULL for informado para um valor de parâmetro opcional, o atributo não será modificado.

   • description: Especifica o texto atualizado para descrever os dados.

   • scope: Especifica o escopo. Você pode usar uma das variáveis: MY$REGION, MY$TENANCY ou MY$COMPARTMENT ou especificar um ou mais OCIDs.

     Consulte Escopo do Conjunto de Dados, Controle de Acesso e Autorização para obter mais informações.

   • auth_required: Um valor booliano que especifica se a autorização no nível do banco de dados é necessária para o conjunto de dados, além do controle de acesso do escopo. Quando definido como TRUE, o conjunto de dados impõe uma etapa de autorização adicional. Consulte Registrar um Conjunto de Dados com Autorização Obrigatória para obter mais informações.

   • data_set_owner: O valor do texto especifica informações sobre o indivíduo responsável pelo conjunto de dados ou um contato para perguntas sobre o conjunto de dados. Por exemplo, você pode fornecer um endereço de e-mail para o proprietário do conjunto de dados.

   • offload_targets: Especifica um ou mais OCIDs do Autonomous Database de clones atualizáveis nos quais o acesso aos conjuntos de dados é descarregado, do Autonomous Database no qual o conjunto de dados é registrado. Consulte Registrar um Conjunto de Dados com Destinos de Offload para Acesso ao Conjunto de Dados para obter mais informações.

   Não é possível atualizar os atributos schema_name ou schema_object.

   Consulte Procedimento UPDATE_REGISTRATION para obter mais informações.

Você pode definir o mapeamento de nome de serviço a ser usado quando os consumidores dos Links da Nuvem acessarem dados de um proprietário de conjunto de dados.

Os Links de Nuvem contam com recursos de banco de dados na instância do Autonomous Database que é o produtor do conjunto de dados ou os recursos de um clone atualizável para acessar dados compartilhados. Por padrão, a conectividade remota para que os consumidores acessem os dados do Cloud Links usa o serviço de banco de dados MEDIUM.

Use DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING para definir o mapeamento do serviço de banco de dados para um consumidor. Nesse procedimento, você fornece um ID de banco de dados ou a palavra-chave ANY para especificar o mapeamento de atendimento ao consumidor. Por exemplo, a figura a seguir mostra um mapeamento para o Consumidor A para o serviço HIGH, o Consumidor B para o serviço MEDIUM, o Consumidor C para o serviço LOW e um mapeamento para ANY para o serviço TP, o que significa que todos os outros consumidores acessam os Links da Nuvem usando o serviço TP.

Descrição da ilustração autonomous-cloud-links-service-mapping.png

Consulte Nomes de Serviço de Banco de Dados para o Autonomous Database para obter mais informações sobre as características dos serviços de banco de dados.

Execute as seguintes etapas para definir o serviço de banco de dados a ser usado para um consumidor de Links de Nuvem:

1. Obtenha o ID do banco de dados para o qual você deseja definir um mapeamento de serviço.

   No banco de dados do consumidor, execute GET_DATABASE_ID para obter o ID do banco de dados do consumidor. Por exemplo:

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

   Consulte Função GET_DATABASE_ID para obter mais informações.

2. Na instância do Autonomous Database do proprietário do conjunto de dados, especifique um mapeamento de serviço.

   Execute esta etapa na instância do Autonomous Database do proprietário do conjunto de dados (ou seja, no banco de dados produtor).

   BEGIN
      DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING(
       database_id      => 'database_id', 
       service_name     => 'HIGH');
   END;
   /

   Em que o valor do parâmetro database_id é o ID do banco de dados obtido na etapa 1.

   Especifique o valor ANY para database_id a fim de usar o service_name especificado com todos os bancos de dados consumidores que não tenham um service_name associado ao database_id. Ou seja, qualquer database_id cujo service_name não tenha sido definido com DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

   Consulte ADD_SERVICE_MAPPING Procedimento para obter mais informações.

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

3. Verifique os IDs de banco de dados e o mapeamento de serviço listando os mapeamentos de serviço de Links de Nuvem.

   Por exemplo:

   SELECT * FROM  DBA_CLOUD_LINK_SERVICE_MAPPINGS;

   Consulte DBA_CLOUD_LINK_SERVICE_MAPPINGS View para obter mais informações.

• Definir Mapeamento de Nome do Serviço de Banco de Dados para Consumidores de Links da Nuvem na Região Remota
  Um conjunto de dados registrado em uma região de origem pode ser acessado com Links da Nuvem de uma região remota quando você cria um Clone Atualizável entre regiões na região remota.

Você pode ativar o armazenamento em cache em um consumidor de conjunto de dados para os resultados de uma consulta ou para um fragmento de consulta que acessa dados do Link da Nuvem.

1. Em uma consulta, especifique a dica RESULT_CACHE com a opção SHELFLIFE.

   Por exemplo:

   SELECT /*+ RESULT_CACHE (SHELFLIFE=120) */ * FROM FOREST.TREE_DATA@cloud$link;

   Esse RESULT_CACHE especifica um valor SHELFLIFE de 120. Isso indica que o resultado deve ser armazenado em cache na memória por 120 segundos. Após 120 segundos, o resultado armazenado em cache é marcado como inválido.

   O valor SHELFLIFE deve ser positivo. O valor máximo de SHELFLIFE é 4294967295.

2. Se o resultado da consulta for grande e não couber na memória, use as opções SHELFLIFE e TEMP para indicar que o resultado deve ser gravado em disco no tablespace temporário.

   SELECT /*+ RESULT_CACHE (TEMP=true SHELFLIFE=360) */ * FROM FOREST.TREE_DATA@cloud$link;

Você pode compartilhar Links da Nuvem quando um conjunto de dados reside em uma instância do Autonomous Database Somente Leitura.

1. Altere o modo do banco de dados para o modo Leitura/Gravação.
   Consulte Alterar o Modo de Operação do Autonomous Database para Leitura/Gravação, Somente Leitura ou Restrito para obter mais informações.
2. Com o banco de dados no modo Leitura/Gravação, execute as etapas para registrar um conjunto de dados.
   1. Conceder Acesso a Links de Nuvem para Usuários do Banco de Dados
   2. Registrar ou Cancelar o Registro de um Conjunto de Dados
3. Depois de registrar um ou mais conjuntos de dados, altere o banco de dados para o modo somente leitura.
   Consulte Alterar o Modo de Operação do Autonomous Database para Leitura/Gravação, Somente Leitura ou Restrito para obter mais informações.