Usar Links da Nuvem para Acesso a Dados Somente para Leitura no Autonomous Database

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 quando registra um conjunto de dados.

• Opcionalmente, quando você registra um conjunto de dados, um usuário que recebeu privilégios de autorização pode especificar que uma etapa de autorização é necessária para acessar um conjunto de dados. Esta etapa de autorização é adicional à autorização de acesso em nível de 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 não permitir 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 REVOKE_REGISTER Procedures e UNREGISTER Procedure para obter mais informações.

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

   Por exemplo:

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_READ('LWARD');

   Isso revoga o acesso aos conjuntos de dados do Cloud Links para o usuário LWARD.

   Consulte REVOKE_READ Procedures para obter mais informações.

Você pode registrar uma tabela ou view de sua propriedade como um conjunto de dados registrado. Quando quiser remover ou substituir o conjunto de dados, será necessário cancelá-lo. 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 sua instância do Autonomous Database, você pode registrar dois objetos, SALES_VIEW_AGG e SALES_ALL, e 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 objecto. Os objetos válidos são:

     • Tabelas (incluindo Heap, Externa ou Híbrida)
     • Exibições
     • Views Materializadas
     • Tabelas de Nuvem (consulte Usar Tabelas de 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 fornecido 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 para a 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, após a conclusão do registro, o escopo dos dois objetos registrados é diferente, com base no parâmetro de escopo fornecido com DBMS_CLOUD_LINK.REGISTER:

   • MY$TENANCY: Especifica o escopo do 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 para Registrar ou Cancelar o Registro de um Conjunto de Dados
  Fornece observações para registrar um conjunto de dados com DBMS_CLOUD_LINK.REGISTER e cancelar o registro de um conjunto de dados com DBMS_CLOUD_LINK.UNREGISTER.

Você pode usar os Links da Nuvem em várias regiões, nas quais 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 usados 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, após 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 objecto. Os objetos válidos são:

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

   • namespace: é o namespace fornecido 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 para a 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.

   Após a conclusão do registro no clone atualizável, o escopo do objeto registrado é MY$COMPARTMENT: Especifica o escopo mais restritivo no nível do compartimento do 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, você deverá executar 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 objecto. Os objetos válidos são:

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

   • namespace: é o namespace fornecido 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 para a 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 para o qual 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 o 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 sejam clones atualizáveis.

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

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

• CLOUD_LINK_DATABASE_ID é uma das seguintes:

  • 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. Uma solicitação de conjunto de dados do 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 alvos 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 que você registra no 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 de conjunto de dados solicita acesso a um conjunto de dados que você registra no offload_targets que inclui a palavra-chave ANY, o acesso é descarregado no 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 descarregamento, 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. Os 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 offload. Isso significa que talvez você precise aguardar até 10 minutos depois de criar um clone atualizável para que o clone atualizável esteja disponível para o registro de descarregamento do Cloud Links.
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 que você deseja acessar o conjunto de dados de 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 objecto. Os objetos válidos são:

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

   • namespace: é o namespace fornecido 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 para a 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, no Autonomous Database no qual o conjunto de dados é registrado.

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

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

     • Quando a palavra-chave ANY é especificada, se não houver um valor correspondente ao 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.

   Observação
   
   Se o seu editor de dados for um líder de pool elástico ou um membro de pool elástico, como alternativa à configuração dos detalhes do destino de offload com offload_targets, você poderá usar o recurso de offload de consulta unificada. Nesse caso, o editor permite que o descarregamento de consultas ProxySQL descarregue consultas (leituras) para qualquer número de clones atualizáveis sem a necessidade de configurar os destinos. Consulte Usar Offload de Consulta Unificada com Links da Nuvem para obter mais informações.

   Para obter mais informações, consulte:

   • Procedimento REGISTER

   • UPDATE_REGISTRATION Procedimento

   • Usando Clones Atualizáveis com Autonomous Database

   • Usar Offload de Consulta Unificada com Links da Nuvem

Depois de registrar um conjunto de dados, você poderá atualizar alguns atributos do conjunto de dados. Não é possível 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 o DBMS_CLOUD_LINK.UPDATE_REGISTRATION.

   Se você não tiver privilégios para atualizar atributos do conjunto de dados, será necessário obter 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. 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 necessá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 que você forneceu quando 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 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, no 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 UPDATE_REGISTRATION Procedures para obter mais informações.

Você pode definir o mapeamento de nome do serviço para usar quando os consumidores do Cloud Links acessarem dados de um proprietário de conjunto de dados.

Os Links da Nuvem dependem dos recursos do 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 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. Neste procedimento, você fornece um ID de banco de dados ou a palavra-chave ANY para especificar o mapeamento de serviço ao consumidor. Por exemplo, a figura a seguir mostra um mapeamento para o Consumidor A para o serviço ALTO, o Consumidor B para o serviço MÉDIO, o Consumidor C para o serviço BAIXO e um mapeamento para QUALQUER 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 do Cloud Links:

1. Obtenha o ID do banco de dados para o qual 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 do produtor).

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

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

   Especifique o valor ANY para o database_id para usar o service_name especificado com todos os bancos de dados do consumidor que não têm um service_name associado ao seu 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 Procedures 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 do Cloud Links.

   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 Cloud Link.

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 um número inteiro positivo. O valor máximo de SHELFLIFE é 4294967295.

2. Se o resultado da consulta for grande e não caber na memória, use as opções SHELFLIFE e TEMP para indicar que o resultado deve ser gravado no disco do 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 para Leitura.

1. Altere o modo de banco de dados para o modo Leitura/Gravação.
   Consulte Alterar o Modo de Operação Autonomous Database para Somente Leitura/Gravação 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 de Links de Nuvem para Usuários do Banco de Dados
   2. Registrar ou Cancelar 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 Autonomous Database para Somente Leitura/Gravação ou Restrito para obter mais informações.