Autonomous Database détermine l'accessibilité des ensembles de données inscrits comme suit :

• L'utilisateur ADMIN spécifie une portée pour un utilisateur qui lui permet d'enregistrer des jeux de données en fonction de la portée fournie.

• Un utilisateur disposant de privilèges permettant d'enregistrer des jeux de données spécifie une portée lors de l'enregistrement d'un jeu de données.

• Lorsque vous enregistrez un jeu de données, un utilisateur disposant de privilèges d'autorisation peut indiquer qu'une étape d'autorisation est requise pour accéder à un jeu de données. Cette étape d'autorisation s'ajoute à l'autorisation d'accès au niveau du périmètre.

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

L'utilisateur ADMIN peut révoquer l'inscription pour interdire à un utilisateur d'inscrire des jeux de données pour un accès distant. L'utilisateur ADMIN peut également révoquer des privilèges ou des utilisateurs de base de données pour accéder aux jeux de données enregistrés.

1. En tant qu'utilisateur ADMIN, révoquez les privilèges d'un utilisateur pour inscrire des jeux de données.

   Exemple :

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER('DB_USER1');

   Cette action révoque les privilèges permettant d'inscrire des jeux de données pour l'utilisateur, DB_USER1.

   L'exécution de DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER n'a aucune incidence sur les ensembles de données déjà inscrits. Utilisez DBMS_CLOUD_LINK.UNREGISTER pour enlever l'accès à un ensemble de données inscrit.

   Pour plus d'informations, reportez-vous à Procédure REVOKE_REGISTER et à Procédure UNREGISTER.

2. En tant qu'utilisateur ADMIN, révoquez l'accès aux ensembles de données inscrits.

   Exemple :

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_READ('LWARD');

   Cette action révoque l'accès aux ensembles de données de liens cloud pour l'utilisateur LWARD.

   Pour plus d'informations, reportez-vous à REVOKE_READ Procédure.

Vous pouvez enregistrer une table ou une vue dont vous êtes propriétaire en tant qu'ensemble de données enregistré. Lorsque vous souhaitez supprimer ou remplacer le jeu de données, vous devez le désinscrire. Après avoir enregistré un jeu de données, vous pouvez modifier les valeurs des attributs d'un jeu de données.

1. Obtenez les privilèges d'octroi d'inscription auprès de l'utilisateur ADMIN.

   Pour plus d'informations, reportez-vous à Octroi de l'accès aux liens cloud aux utilisateurs de base de données.

2. Enregistrez un ou plusieurs jeux de données.

   Par exemple, en supposant qu'il existe un schéma CLOUDLINK sur votre instance Autonomous Database, vous pouvez inscrire deux objets, SALES_VIEW_AGG et SALES_ALL, et fournir des paramètres scope différents pour déterminer le mode d'accès aux objets.

   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;
   /

   Les paramètres sont les suivants :

   • schema_name : nom du schéma (propriétaire de l'objet).

   • schema_object : nom de l'objet. Les objets valides sont :

     • Tables (y compris la portion de mémoire, externe ou hybride)
     • vues
     • Vues matérialisées
     • Tables cloud (pour plus d'informations, reportez-vous à Utilisation de tables cloud pour stocker les informations de journalisation et de diagnostic).
     Remarque
     
     Les autres objets tels que les vues analytiques ou les synonymes ne sont pas pris en charge.

   • namespace : espace de noms fourni en tant que nom d'accès avec les liens cloud (une partie du nom qualifié complet de lien cloud).

     Une valeur NULL indique une valeur namespace générée par le système, unique pour l'instance Autonomous Database.

   • name : nom que vous indiquez pour l'accès avec les liens cloud (une partie du nom qualifié complet de lien cloud).

   • description : indique le texte décrivant les données.

   • scope : indique la portée. Vous pouvez utiliser l'une des variables : MY$REGION, MY$TENANCY ou MY$COMPARTMENT, ou indiquer des OCID.

     Pour plus d'informations, reportez-vous à Portée de l'ensemble de données, contrôle d'accès et autorisation.

   • auth_required : valeur booléenne indiquant si une autorisation au niveau de la base de données est requise pour l'ensemble de données, en plus du contrôle d'accès de portée. Lorsque cette option est définie sur TRUE, le jeu de données applique une étape d'autorisation supplémentaire. Pour plus d'informations, reportez-vous à Inscription d'un ensemble de données avec autorisation requise.

   • data_set_owner : la valeur de texte indique des informations sur la personne responsable de l'ensemble de données ou un contact pour les questions relatives à l'ensemble de données. Par exemple, vous pouvez indiquer une adresse électronique pour le propriétaire du jeu de données.

   Pour plus d'informations, reportez-vous à Procédure REGISTER.

   Dans cet exemple, une fois l'inscription terminée, la portée des deux objets inscrits est différente, en fonction du paramètre de portée que vous avez fourni avec DBMS_CLOUD_LINK.REGISTER :

   • MY$TENANCY : indique la portée au niveau de la location pour REGIONAL_SALES.SALES_AGG.

   • MY$COMPARTMENT : indique la portée de niveau de compartiment la plus restrictive dans la location pour TRUSTED_COMPARTMENT.SALES.

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

• Remarques relatives à l'inscription ou à la désinscription d'un ensemble de données
  Fournit des remarques relatives à l'inscription d'un ensemble de données auprès de DBMS_CLOUD_LINK.REGISTER et à l'annulation de l'inscription d'un ensemble de données auprès de DBMS_CLOUD_LINK.UNREGISTER.

Vous pouvez utiliser des liens cloud dans plusieurs régions, où la région source contient la base de données source de l'ensemble de données et où des régions distantes contiennent des clones actualisables de la base de données source.

Description de l'image cloud-links-cross-region-refreshable-clone.png

Pour utiliser des liens cloud avec un ensemble de données dans une autre région, procédez comme suit :

1. Créez un clone actualisable inter-région de la base de données source dans une région distante.

   Pour plus d'informations sur l'ajout d'un clone actualisable inter-région, reportez-vous à Création d'un clone actualisable inter-locations ou inter-région.

2. Sur la base de données source, enregistrez le jeu de données.

   Pour plus d'informations, reportez-vous à Inscription ou désinscription d'un ensemble de données.

3. Actualisez le clone actualisable.

   Pour plus d'informations, reportez-vous à Actualisation d'un clone actualisable sur Autonomous Database.

4. Sur le clone actualisable distant, enregistrez le jeu de données en utilisant les mêmes arguments que ceux utilisés pour inscrire le jeu de données dans la région source.

   Par exemple, en supposant qu'il existe un schéma CLOUDLINK sur votre instance Autonomous Database, une fois que vous avez inscrit SALES_ALL sur la base de données source, inscrivez SALES_ALL sur le clone actualisable :

   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;
   /

   Les paramètres sont les suivants :

   • schema_name : nom du schéma (propriétaire de l'objet).

   • schema_object : nom de l'objet. Les objets valides sont :

     • Tables (y compris la portion de mémoire, externe ou hybride)
     • vues
     • Vues matérialisées
     Remarque
     
     Les autres objets tels que les vues analytiques ou les synonymes ne sont pas pris en charge.

   • namespace : espace de noms fourni en tant que nom d'accès avec les liens cloud (une partie du nom qualifié complet de lien cloud).

     Une valeur NULL indique une valeur namespace générée par le système, unique pour l'instance Autonomous Database.

   • name : nom que vous indiquez pour l'accès avec les liens cloud (une partie du nom qualifié complet de lien cloud).

   • description : indique le texte décrivant les données.

   • scope : indique la portée. Vous pouvez utiliser l'une des variables : MY$REGION, MY$TENANCY ou MY$COMPARTMENT, ou indiquer des OCID.

     Pour plus d'informations, reportez-vous à Portée de l'ensemble de données, contrôle d'accès et autorisation.

   • auth_required : valeur booléenne indiquant si une autorisation au niveau de la base de données est requise pour l'ensemble de données, en plus du contrôle d'accès de portée. Lorsque cette option est définie sur TRUE, le jeu de données applique une étape d'autorisation supplémentaire. Pour plus d'informations, reportez-vous à Inscription d'un ensemble de données avec autorisation requise.

   • data_set_owner : la valeur de texte indique des informations sur la personne responsable de l'ensemble de données ou un contact pour les questions relatives à l'ensemble de données. Par exemple, vous pouvez indiquer une adresse électronique pour le propriétaire du jeu de données.

   Pour plus d'informations, reportez-vous à Procédure REGISTER.

   Une fois l'inscription terminée sur le clone actualisable, la portée de l'objet inscrit est MY$COMPARTMENT : indique la portée de niveau de compartiment la plus restrictive pour mon compartiment dans ma location pour TRUSTED_COMPARTMENT.SALES.

• Remarques relatives à l'inscription ou à l'annulation de l'inscription d'un ensemble de données dans une région distante
  Fournit des remarques relatives à l'inscription d'un ensemble de données dans une région distante.

Lorsque vous inscrivez un ensemble de données, en plus de la portée, vous pouvez indiquer que l'autorisation au niveau de la base de données est requise pour accéder à un ensemble de données.

1. Utilisez DBMS_CLOUD_LINK.REGISTER pour inscrire des données avec l'autorisation requise.

   En supposant qu'il existe un schéma CLOUDLINK sur votre instance Autonomous Database, que vous inscrivez l'objet SALES_VIEW_AGG et que vous définissez auth_required sur TRUE, vous devez effectuer des étapes supplémentaires pour déterminer le mode d'accès à l'objet, en plus de définir la portée.

   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;
   /

   Les paramètres sont les suivants :

   • schema_name : nom du schéma (propriétaire de l'objet).

   • schema_object : nom de l'objet. Les objets valides sont :

     • Tables (y compris la portion de mémoire, externe ou hybride)
     • vues
     • Vues matérialisées
     Remarque
     
     Les autres objets tels que les vues analytiques ou les synonymes ne sont pas pris en charge.

   • namespace : espace de noms fourni en tant que nom d'accès avec les liens cloud (une partie du nom qualifié complet de lien cloud).

     Une valeur NULL indique une valeur namespace générée par le système, unique pour l'instance Autonomous Database.

   • name : nom que vous indiquez pour l'accès avec les liens cloud (une partie du nom qualifié complet de lien cloud).

   • scope : indique la portée. Vous pouvez utiliser l'une des variables : MY$REGION, MY$TENANCY ou MY$COMPARTMENT, ou indiquer des OCID.

     Pour plus d'informations, reportez-vous à Portée de l'ensemble de données, contrôle d'accès et autorisation.

   • auth_required : valeur booléenne indiquant si une autorisation au niveau de la base de données est requise pour l'ensemble de données, en plus du contrôle d'accès de portée. Lorsque cette option est définie sur TRUE, le jeu de données applique une étape d'autorisation supplémentaire.

   • data_set_owner : la valeur de texte indique des informations sur la personne responsable de l'ensemble de données ou un contact pour les questions relatives à l'ensemble de données. Par exemple, vous pouvez indiquer une adresse électronique pour le propriétaire du jeu de données.

2. Obtenez l'ID de la base de données à laquelle vous voulez accorder l'autorisation (pour permettre à la base de données d'accéder à l'ensemble de données).

   Sur le système, vous souhaitez accorder l'accès à l'ensemble de données :

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

3. Utilisez l'ID de base de données obtenu pour accorder l'autorisation à un ensemble de données donné.

   Vous pouvez uniquement accorder l'autorisation et exécuter DBMS_CLOUD_LINK.GRANT_AUTHORIZATION, comme indiqué dans cette étape, si vous y êtes autorisé. L'administrateur accorde l'autorisation avec DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE.

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

   Effectuez ces étapes plusieurs fois si vous souhaitez autoriser des bases de données supplémentaires.

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

Lorsque vous inscrivez un ensemble de données, vous pouvez éventuellement décharger l'accès à l'ensemble de données sur des instances Autonomous Database qui sont des clones actualisables.

Utilisez le paramètre facultatif offload_targets avec DBMS_CLOUD_LINK.REGISTER pour indiquer que l'accès est déchargé pour les clones actualisables. La base de données source de chaque clone actualisable est l'instance Autonomous Database dans laquelle vous inscrivez l'ensemble de données (éditeur de données).

La valeur offload_targets est un document JSON qui définit des paires de valeurs de clé CLOUD_LINK_DATABASE_ID et OFFLOAD_TARGET :

• CLOUD_LINK_DATABASE_ID est l'un des éléments suivants :

  • ID de base de données : indique un ID de base de données pour le consommateur de jeu de données dont la demande est déchargée vers le clone actualisable correspondant indiqué avec la valeur OFFLOAD_TARGET.

    Obtenez l'ID de base de données en exécutant DBMS_CLOUD_LINK.GET_DATABASE_ID. Pour plus d'informations, reportez-vous à Fonction GET_DATABASE_ID.

  • ANY : indique que toute demande du consommateur de jeu de données est déchargée vers la cible de déchargement correspondante. La demande d'ensemble de données d'un consommateur est acheminée vers la cible de déchargement correspondante.

    Si vous indiquez ANY sans indiquer d'ID de base de données, toutes les demandes d'ensemble de données des destinataires sont déchargées vers le clone actualisable indiqué avec la valeur OFFLOAD_TARGET.

    Si vous indiquez à la fois des ID de base de données et ANY, les demandes d'ensemble de données provenant de destinataires qui ne correspondent pas à un ID de base de données sont déchargées vers le clone actualisable indiqué avec la valeur OFFLOAD_TARGET.

• OFFLOAD_TARGET est l'OCID d'une instance Autonomous Database en tant que clone actualisable.

La figure suivante illustre l'utilisation des cibles de déchargement.

Description de l'image cloud-links-offload-targets-any-keyword.eps

Lorsqu'un destinataire d'ensemble de données demande l'accès à un ensemble de données que vous inscrivez auprès de offload_targets et que l'ID de base de données de l'instance Autonomous Database correspond à la valeur indiquée dans CLOUD_LINK_DATABASE_ID, l'accès est déchargé vers le clone actualisable identifié par OFFLOAD_TARGET dans le fichier JSON fourni.

Par exemple, l'exemple suivant présente un échantillon JSON avec trois paires de valeurs 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"
    }
  ]
}

Lorsqu'un destinataire d'ensemble de données demande l'accès à un ensemble de données inscrit auprès de offload_targets qui inclut le mot-clé ANY, l'accès est déchargé vers le clone actualisable identifié par OFFLOAD_TARGET dans le fichier JSON fourni (à l'exception des demandes des destinataires qui ont une entrée d'ID de base de données correspondante dans le fichier JSON fourni).

Par exemple, l'exemple suivant présente un échantillon JSON avec une paire de valeurs OFFLOAD_TARGET/CLOUD_LINK_DATABASE_ID explicite et une valeur ANY avec une valeur OFFLOAD_TARGET correspondante :

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

Pour enregistrer un ensemble de données et indiquer des cibles de déchargement, procédez comme suit :

1. Obtenez l'OCID de clones actualisables pour lesquels vous voulez décharger l'accès au jeu de données. Les OCID de clone actualisable sont disponibles sur la console Oracle Cloud Infrastructure sur un clone actualisable.
   Remarque
   
   La création d'un clone actualisable peut prendre jusqu'à 10 minutes pour que le clone actualisable soit visible en tant que cible de déchargement. Cela signifie que vous devrez peut-être attendre jusqu'à 10 minutes après avoir créé un clone actualisable pour que le clone actualisable soit disponible pour l'inscription de déchargement de Cloud Links.
2. Obtenez l'ID de base de données pour les instances Autonomous Database auxquelles accéder à l'ensemble de données à l'aide des données fournies par le clone actualisable.

   Sur le système auquel vous souhaitez accéder à l'ensemble de données à partir d'un clone actualisable, exécutez la commande suivante :

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

3. Inscrivez un ensemble de données et indiquez le paramètre offload_targets.

   Par exemple, en supposant qu'il existe un schéma CLOUDLINK sur votre instance Autonomous Database, vous pouvez inscrire SALES_VIEW_AGG et indiquer les clones actualisables qui fournissent l'accès à l'ensemble de données :

   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;
   /

   Les paramètres sont les suivants :

   • schema_name : nom du schéma (propriétaire de l'objet).

   • schema_object : nom de l'objet. Les objets valides sont :

     • Tables (y compris la portion de mémoire, externe ou hybride)
     • vues
     • Vues matérialisées
     Remarque
     
     Les autres objets tels que les vues analytiques ou les synonymes ne sont pas pris en charge.

   • namespace : espace de noms fourni en tant que nom d'accès avec les liens cloud (une partie du nom qualifié complet de lien cloud).

     Une valeur NULL indique une valeur namespace générée par le système, unique pour l'instance Autonomous Database.

   • name : nom que vous indiquez pour l'accès avec les liens cloud (une partie du nom qualifié complet de lien cloud).

   • scope : indique la portée. Vous pouvez utiliser l'une des variables : MY$REGION, MY$TENANCY ou MY$COMPARTMENT, ou indiquer des OCID.

     Pour plus d'informations, reportez-vous à Portée de l'ensemble de données, contrôle d'accès et autorisation.

   • auth_required : valeur booléenne indiquant si une autorisation au niveau de la base de données est requise pour l'ensemble de données, en plus du contrôle d'accès de portée. Lorsque cette option est définie sur TRUE, le jeu de données applique une étape d'autorisation supplémentaire. Pour plus d'informations, reportez-vous à Inscription d'un ensemble de données avec autorisation requise.

   • data_set_owner : la valeur de texte indique des informations sur la personne responsable de l'ensemble de données ou un contact pour les questions relatives à l'ensemble de données. Par exemple, vous pouvez indiquer une adresse électronique pour le propriétaire du jeu de données.

   • offload_targets : indique des OCID Autonomous Database de clones actualisables où l'accès aux ensembles de données est déchargé, à partir de l'instance Autonomous Database où l'ensemble de données est inscrit.

     Pour chaque consommateur de jeu de données, l'un des éléments suivants peut correspondre pour décharger la demande vers un clone actualisable :

     • Lorsqu'il existe une correspondance avec la valeur de cloud_link_database_id indiquée, c'est-à-dire que les valeurs correspondent à l'ID de base de données du destinataire, l'accès est déchargé vers le clone actualisable identifié par l'OCID indiqué dans offload_target.

     • Lorsque le mot-clé ANY est indiqué, s'il n'y a pas de correspondance avec la valeur d'un élément cloud_link_database_id indiqué, l'accès est déchargé vers le clone actualisable identifié par l'entrée ANY par l'OCID indiqué dans l'élément offload_target correspondant.

   Pour plus d'informations, reportez-vous à :

   • Procédure d'enregistrement

   • UPDATE_REGISTRATION Procédure

   • Utilisation des clonages actualisables avec Autonomous Database

Après avoir enregistré un jeu de données, vous pouvez mettre à jour certains attributs de jeu de données. Vous ne pouvez pas mettre à jour le nom de schéma, l'objet de schéma, l'espace de noms ou les attributs de nom.

1. L'utilisateur qui a inscrit un ensemble de données peut mettre à jour ses attributs avec DBMS_CLOUD_LINK.UPDATE_REGISTRATION.

   Si vous ne disposez pas des privilèges requis pour mettre à jour les attributs de jeu de données, vous devez obtenir les privilèges d'octroi de registre auprès de l'utilisateur ADMIN.

   Pour plus d'informations, reportez-vous à Octroi de l'accès aux liens cloud aux utilisateurs de base de données.

2. Mettez à jour un ou plusieurs attributs pour un ensemble de données.

   Par exemple, utilisez DBMS_CLOUD_LINK.UPDATE_REGISTRATION pour mettre à jour les attributs description, scope et auth_required de l'ensemble de données dans l'espace de noms REGIONAL_SALES avec le nom 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;
   /

   Les paramètres requis sont les suivants :

   • namespace : espace de noms de l'ensemble de données que vous avez fourni lors de l'inscription de l'ensemble de données.

   • name : nom de l'ensemble de données que vous avez fourni lors de l'inscription de l'ensemble de données.

   Vous trouverez ci-dessous la liste des paramètres facultatifs. Si NULL est transmis pour une valeur de paramètre facultative, l'attribut n'est pas modifié.

   • description : indique le texte mis à jour pour décrire les données.

   • scope : indique la portée. Vous pouvez utiliser l'une des variables suivantes : MY$REGION, MY$TENANCY ou MY$COMPARTMENT, ou indiquer des OCID.

     Pour plus d'informations, reportez-vous à Portée de l'ensemble de données, contrôle d'accès et autorisation.

   • auth_required : valeur booléenne qui indique si une autorisation de niveau base de données est requise pour l'ensemble de données, en plus du contrôle d'accès de portée. Lorsque cette valeur est définie sur TRUE, l'ensemble de données applique une étape d'autorisation supplémentaire. Pour plus d'informations, reportez-vous à Inscription d'un ensemble de données avec autorisation requise.

   • data_set_owner : la valeur de texte indique des informations sur la personne responsable de l'ensemble de données ou un contact pour les questions sur l'ensemble de données. Par exemple, vous pouvez indiquer une adresse électronique pour le propriétaire du jeu de données.

   • offload_targets : indique des OCID Autonomous Database de clones actualisables dans lesquels l'accès aux ensembles de données est déchargé, à partir de l'instance Autonomous Database où l'ensemble de données est inscrit. Pour plus d'informations, reportez-vous à Inscription d'un ensemble de données avec des cibles de déchargement pour l'accès à l'ensemble de données.

   Vous ne pouvez pas mettre à jour les attributs schema_name ou schema_object.

   Pour plus d'informations, reportez-vous à Procédure UPDATE_REGISTRATION.

Vous pouvez définir la correspondance de nom de service à utiliser lorsque les destinataires de liens cloud accèdent aux données à partir d'un propriétaire d'ensemble de données.

Les liens cloud s'appuient sur les ressources de base de données de l'instance Autonomous Database qui est le producteur de l'ensemble de données, ou sur les ressources d'un clone actualisable, pour accéder aux données partagées. Par défaut, la connectivité distante permettant aux destinataires d'accéder aux données Cloud Links utilise le service de base de données MEDIUM.

Utilisez DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING pour définir la correspondance de service de base de données pour un destinataire. Dans cette procédure, vous indiquez un ID de base de données ou le mot-clé ANY pour indiquer la correspondance de service consommateur. Par exemple, la figure suivante illustre une mise en correspondance entre le consommateur A et le service HIGH, le consommateur B et le service MEDIUM, le consommateur C et le service LOW et une mise en correspondance entre ANY et le service TP, ce qui signifie que tous les autres consommateurs accèdent aux liens cloud à l'aide du service TP.

Description de l'image autonomous-cloud-links-service-mapping.png

Pour plus d'informations sur les caractéristiques des services de base de données, reportez-vous à Noms de service de base de données pour Autonomous Database.

Pour définir le service de base de données à utiliser pour un destinataire Cloud Links, procédez comme suit :

1. Obtenez l'ID de la base de données pour laquelle vous voulez définir un mappage de service.

   Sur la base de données consommateur, exécutez GET_DATABASE_ID pour obtenir l'ID de base de données du consommateur. Exemples :

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

   Pour plus d'informations, reportez-vous à Fonction GET_DATABASE_ID.

2. Sur l'instance Autonomous Database du propriétaire de l'ensemble de données, indiquez une correspondance de service.

   Effectuez cette étape sur l'instance Autonomous Database du propriétaire de l'ensemble de données (c'est-à-dire sur la base de données du fournisseur).

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

   Où la valeur du paramètre database_id correspond à l'ID de base de données obtenu à l'étape 1.

   Indiquez la valeur ANY pour database_id afin d'utiliser la valeur service_name indiquée avec toutes les bases de données de destinataire qui n'ont pas de valeur service_name associée à leur valeur database_id. Autrement dit, tout élément database_id dont service_name n'a pas été défini avec DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

   Pour plus d'informations, reportez-vous à Procédure ADD_SERVICE_MAPPING.

   Seuls l'utilisateur ADMIN et les schémas dotés du rôle PDB_DBA peuvent exécuter DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

3. Vérifiez les ID de base de données et le mappage de service en répertoriant les mappages de service Cloud Links.

   Exemple :

   SELECT * FROM  DBA_CLOUD_LINK_SERVICE_MAPPINGS;

   Pour plus d'informations, reportez-vous à DBA_CLOUD_LINK_SERVICE_MAPPINGS View.

• Définition de la correspondance de nom de service de base de données pour les destinataires de liens cloud dans une région distante
  Vous pouvez accéder à un ensemble de données inscrit dans une région source à l'aide de liens cloud à partir d'une région distante lorsque vous créez un clone actualisable inter-région dans la région distante.

Vous pouvez activer la mise en mémoire cache sur un consommateur d'ensemble de données pour les résultats d'une requête ou pour un fragment de requête qui accède aux données de Cloud Link.

1. Dans une requête, indiquez le conseil RESULT_CACHE avec l'option SHELFLIFE.

   Exemples :

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

   Cette valeur RESULT_CACHE indique une valeur SHELFLIFE de 120. Cela indique que le résultat doit être mis en mémoire cache pendant 120 secondes. Au bout de 120 secondes, le résultat mis en cache est marqué comme non valide.

   La valeur SHELFLIFE doit être un entier positif. La valeur maximale de SHELFLIFE est 4294967295.

2. Si le résultat de la requête est volumineux et ne tient pas dans la mémoire, utilisez les options SHELFLIFE et TEMP pour indiquer que le résultat doit être écrit sur le disque dans le tablespace temporaire.

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

Vous pouvez partager des liens cloud lorsqu'un ensemble de données réside sur une instance Autonomous Database en lecture seule.

1. Modifiez le mode de base de données en lecture/écriture.
   Pour plus d'informations, reportez-vous à Modification du mode de fonctionnement d'Autonomous Database sur Lecture/écriture ou Restreint.
2. Lorsque la base de données est en mode lecture/écriture, procédez comme suit pour enregistrer un ensemble de données.
   1. Accorder l'accès aux liens cloud aux utilisateurs de base de données
   2. Inscrire ou désinscrire un jeu de données
3. Une fois que vous avez inscrit des jeux de données, faites passer la base de données en mode lecture seule.
   Pour plus d'informations, reportez-vous à Modification du mode de fonctionnement d'Autonomous Database sur Lecture/écriture ou Restreint.