Utilisation de liens cloud pour l'accès aux données en lecture seule sur Autonomous Database

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 pour enregistrer des jeux de données spécifie une portée lorsqu'il enregistre un jeu de données.

• Lorsque vous enregistrez un jeu de données, un utilisateur disposant de privilèges d'autorisation peut éventuellement 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 l'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 inscrits.

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

   Par exemple :

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER('DB_USER1');

   Cela 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'affecte pas 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 aux sections REVOKE_REGISTER Procedure et UNREGISTER Procedure.

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

   Par exemple :

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_READ('LWARD');

   Cela révoque l'accès aux jeux de données Cloud Links pour l'utilisateur LWARD.

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

Vous pouvez enregistrer une table ou une vue dont vous êtes propriétaire en tant qu'ensemble de données enregistré. Lorsque vous voulez 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 des privilèges de registre d'octroi 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. Inscrivez 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 que vous indiquez comme 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, propre à 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 l'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 valeur 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 les informations relatives à la personne responsable de l'ensemble de données ou à un interlocuteur pour toute question sur 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 enregistrés est différente, en fonction du paramètre de portée fourni avec DBMS_CLOUD_LINK.REGISTER :

   • MY$TENANCY : indique la portée de niveau 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 sur l'enregistrement ou la désinscription d'un ensemble de données
  Fournit des notes sur l'enregistrement d'un ensemble de données avec DBMS_CLOUD_LINK.REGISTER et l'annulation de l'enregistrement d'un ensemble de données avec DBMS_CLOUD_LINK.UNREGISTER.

Vous pouvez utiliser des liens cloud dans plusieurs régions, la région source contenant la base de données source de l'ensemble de données et des régions distantes contenant 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 :

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'une location ou d'un clone actualisable inter-région.

2. Dans la base de données source, enregistrez l'ensemble de données.

   Pour plus d'informations, reportez-vous à Inscription ou annulation de l'inscription 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 à l'aide des arguments que vous avez utilisés pour l'enregistrer 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 que vous indiquez comme 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, propre à 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 l'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 valeur 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 les informations relatives à la personne responsable de l'ensemble de données ou à un interlocuteur pour toute question sur 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 sur l'enregistrement ou l'annulation de l'enregistrement d'un ensemble de données dans une région distante
  Fournit des notes sur l'enregistrement d'un ensemble de données dans une région distante.

Lorsque vous enregistrez un ensemble de données (facultatif), 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 et que vous inscrivez l'objet SALES_VIEW_AGG et que vous définissez auth_required sur TRUE, vous devez, en plus de définir la portée, effectuer des étapes supplémentaires pour déterminer le mode d'accès à l'objet.

   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 que vous indiquez comme 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, propre à 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 l'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 valeur 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 les informations relatives à la personne responsable de l'ensemble de données ou à un interlocuteur pour toute question sur 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 souhaitez 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 au jeu 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 spécifié.

   Vous pouvez uniquement accorder une autorisation et exécuter DBMS_CLOUD_LINK.GRANT_AUTHORIZATION, comme indiqué dans cette étape, si vous disposez d'une autorisation. 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 vers 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é vers les clones actualisables. La base de données source de chaque clone actualisable est l'instance Autonomous Database dans laquelle vous enregistrez l'ensemble de données (éditeur de données).

La valeur offload_targets est un document JSON qui définit une ou plusieurs paires clé-valeur CLOUD_LINK_DATABASE_ID et OFFLOAD_TARGET :

• CLOUD_LINK_DATABASE_ID est l'un des 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 la demande du consommateur de l'ensemble 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 consommateurs 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 qui est un clone actualisable.

La figure suivante illustre l'utilisation de 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 que vous inscrivez 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 JSON fourni (sauf pour les demandes des destinataires qui ont une entrée d'ID de base de données correspondante dans le 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 spécifier des cibles de déchargement, procédez comme suit :

1. Obtenez l'OCID des clones actualisables pour lesquels vous souhaitez décharger l'accès aux ensembles 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 au déchargement des liens cloud.
2. Obtenez l'ID de base de données pour les instances Autonomous Database auxquelles vous souhaitez 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 à partir d'un clone actualisable, exécutez la commande suivante :

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

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

   Par exemple, si le schéma CLOUDLINK figure 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 que vous indiquez comme 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, propre à 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 l'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 valeur 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 les informations relatives à la personne responsable de l'ensemble de données ou à un interlocuteur pour toute question 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 où l'accès aux ensembles de données est déchargé, à partir de la base de données Autonomous Database où l'ensemble de données est inscrit.

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

     • Lorsque la valeur de l'élément cloud_link_database_id indiqué correspond, c'est-à-dire que les valeurs correspondent à l'ID de base de données du consommateur, 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é, si la valeur d'un élément cloud_link_database_id indiqué ne correspond pas, 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.

   Remarque
   
   Si votre éditeur de données est un leader de pool élastique ou un membre de pool élastique, au lieu de configurer les détails de la cible de déchargement avec offload_targets, vous pouvez utiliser la fonctionnalité de déchargement de requête unifiée. Dans ce cas, l'éditeur active le déchargement de requête ProxySQL pour décharger les requêtes (lues) vers un nombre quelconque de clones actualisables sans avoir à configurer les cibles. Pour plus d'informations, reportez-vous à Utilisation du déchargement de requête unifié avec des liens cloud.

   Pour plus d'informations, reportez-vous à :

   • Procédure d'enregistrement

   • Procédure UPDATE_REGISTRATION

   • Utilisation de clones actualisables avec Autonomous Database

   • Utiliser le déchargement de requête unifiée avec des liens cloud

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 les attributs de nom de schéma, d'objet de schéma, d'espace de noms ou 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 des 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 jeu 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 obligatoires sont les suivants :

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

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

   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 : 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 l'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 valeur 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 les informations relatives à la personne responsable de l'ensemble de données ou à un interlocuteur pour toute question 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 où l'accès aux ensembles de données est déchargé, à partir de la base de données 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 à un 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 le mappage des noms de service à utiliser lorsque les consommateurs de Cloud Links accèdent aux données d'un propriétaire de jeu de données.

Les liens cloud s'appuient sur les ressources de base de données dans l'instance Autonomous Database qui est l'émetteur d'ensembles 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 le mapping 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 le mapping de service consommateur. Par exemple, la figure suivante illustre un mapping entre le consommateur A et le service HIGH, le consommateur B et le service MEDIUM, le consommateur C et le service LOW, ainsi qu'un mapping 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'illustration 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 Database pour Autonomous Database.

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

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

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

   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 du jeu de données, indiquez une mise en correspondance de service.

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

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

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

   Indiquez la valeur ANY pour database_id afin d'utiliser l'élément service_name indiqué avec toutes les bases de données consommateur auxquelles aucun élément service_name n'est associé à l'élément database_id. Autrement dit, toute valeur database_id dont service_name n'a pas été définie 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 mapping de service en répertoriant les mappings de service Cloud Links.

   Par exemple :

   SELECT * FROM  DBA_CLOUD_LINK_SERVICE_MAPPINGS;

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

• Définition de la mise en correspondance des noms 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 cache sur un consommateur d'ensembles de données pour les résultats d'une requête ou pour un fragment d'interrogation qui accède aux données Cloud Link.

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

   Par exemple :

   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 valeurs SHELFLIFE doit être un entier positif. La valeur maximale de SHELFLIFE est 4294967295.

2. Si le résultat de l'interrogation 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. Passez en Mode Lecture/écriture dans la base de données.
   Pour plus d'informations, reportez-vous à Modification du mode d'opération d'Autonomous Database sur Lecture/Ecriture, Lecture seule 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 ensemble de données
3. Une fois que vous avez inscrit un ou plusieurs ensembles de données, passez en mode lecture seule.
   Pour plus d'informations, reportez-vous à Modification du mode d'opération d'Autonomous Database sur Lecture/Ecriture, Lecture seule ou Restreint.