Utiliser des liens en nuage pour l'accès aux données en lecture seule dans une base de données d'IA autonome

La base de données autonome d'IA détermine l'accessibilité des jeux de données enregistrés comme suit :

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

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

• Facultativement, lorsque vous enregistrez un jeu de données, un utilisateur disposant de privilèges d'autorisation peut spécifier une étape d'autorisation requise pour accéder à un jeu de données. Cette étape d'autorisation s'ajoute à l'autorisation d'accès au niveau de la portée.

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'enregistrement pour interdire à un utilisateur d'enregistrer 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 enregistrer des jeux de données.

   Exemple :

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER('DB_USER1');

   Cela révoque les privilèges d'enregistrement 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 jeux de données déjà enregistrés. Utilisez DBMS_CLOUD_LINK.UNREGISTER pour supprimer l'accès à un jeu de données enregistré.

   Pour plus d'informations, voir Procédure REVOKE_REGISTER et Procédure UNREGISTER.

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

   Exemple :

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_READ('LWARD');

   L'accès aux jeux de données Cloud Links est révoqué pour l'utilisateur LWARD.

   Pour plus d'informations, voir ProcédureREVOKE_READ.

Vous pouvez enregistrer une table ou afficher votre propre jeu de données enregistré. Lorsque vous voulez supprimer ou remplacer le jeu de données, vous devez annuler son enregistrement. Après avoir enregistré un jeu de données, vous pouvez modifier les valeurs des attributs d'un jeu de données.

1. Obtenir les privilèges d'accès au registre de l'utilisateur ADMIN.

   Pour plus d'informations, voir Accorder l'accès aux liens vers le nuage 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 de base de données d'intelligence artificielle autonome, vous pouvez enregistrer deux objets, SALES_VIEW_AGG et SALES_ALL, et fournir des paramètres scope différents pour déterminer comment les objets sont accessibles.

   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 (responsable de l'objet).

   • schema_object : Nom de l'objet. Les objets valides sont les suivants :

     • Tables (y compris le tas, externe ou hybride)
     • Vues
     • Vues matérialisées
     • Tables en nuage (voir Utiliser des tables en nuage pour stocker les informations de journalisation et de diagnostic pour plus d'informations.)
     Note
     
     Les autres objets tels que les vues analytiques ou les synonymes ne sont pas pris en charge.

   • namespace : Espace de noms que vous fournissez en tant que nom pour l'accès aux liens en nuage (une partie du nom complet des liens en nuage).

     Une valeur NULL spécifie une valeur namespace générée par le système, unique à l'instance de base de données du service d'intelligence artificielle autonome.

   • name : Nom que vous fournissez pour l'accès aux liens en nuage (une partie du nom complet du lien en nuage).

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

   • scope : Spécifie la portée. Vous pouvez utiliser l'une des variables : MY$REGION, MY$TENANCY ou MY$COMPARTMENT ou spécifier un ou plusieurs OCID.

     Pour plus d'informations, voir Portée du jeu de données, contrôle d'accès et autorisation.

   • auth_required : Valeur booléenne qui spécifie si une autorisation au niveau de la base de données est requise pour le jeu de données, en plus du contrôle d'accès à la portée. Lorsque cette valeur est réglée à TRUE, le jeu de données applique une étape d'autorisation supplémentaire. Pour plus d'informations, voir Enregistrer un jeu de données avec autorisation requise.

   • data_set_owner : La valeur de texte spécifie les informations sur la personne responsable du jeu de données ou sur un contact pour les questions concernant le jeu de données. Par exemple, vous pouvez fournir une adresse de courriel au responsable du jeu de données.

   Pour plus d'informations, voir Procédure REGISTER.

   Dans cet exemple, une fois l'enregistrement terminé, 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 : Spécifie la portée au niveau de la location pour REGIONAL_SALES.SALES_AGG.

   • MY$COMPARTMENT : Spécifie la portée au niveau du compartiment la plus restrictive dans la location pour TRUSTED_COMPARTMENT.SALES.

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

• Notes pour l'enregistrement ou l'annulation de l'enregistrement d'un jeu de données
  Fournit des notes pour l'enregistrement d'un jeu de données avec DBMS_CLOUD_LINK.REGISTER et l'annulation de l'enregistrement d'un jeu de données avec DBMS_CLOUD_LINK.UNREGISTER.

Vous pouvez utiliser des liens en nuage dans plusieurs régions, où la région source contient la base de données source du jeu de données et une ou plusieurs régions distantes contiennent des clones actualisables de la base de données source.

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

Pour utiliser des liens en nuage avec un jeu 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.

   Voir Créer un clone actualisable inter-location ou inter-région pour plus d'informations sur l'ajout d'un clone actualisable inter-région.

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

   Pour plus d'informations, voir Enregistrer ou annuler l'enregistrement d'un jeu de données.

3. Actualisez le clone actualisable.

   Pour plus d'informations, voir Actualiser un clone actualisable sur une base de données d'IA autonome.

4. Sur le clone actualisable distant, enregistrez le jeu de données à l'aide des mêmes arguments que ceux utilisés pour enregistrer le jeu de données dans la région source.

   Par exemple, en supposant qu'il existe un schéma CLOUDLINK sur votre instance de base de données d'intelligence artificielle autonome, après avoir enregistré SALES_ALL sur la base de données source, enregistrez 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 (responsable de l'objet).

   • schema_object : Nom de l'objet. Les objets valides sont les suivants :

     • Tables (y compris le tas, externe ou hybride)
     • Vues
     • Vues matérialisées
     Note
     
     Les autres objets tels que les vues analytiques ou les synonymes ne sont pas pris en charge.

   • namespace : Espace de noms que vous fournissez en tant que nom pour l'accès aux liens en nuage (une partie du nom complet des liens en nuage).

     Une valeur NULL spécifie une valeur namespace générée par le système, unique à l'instance de base de données du service d'intelligence artificielle autonome.

   • name : Nom que vous fournissez pour l'accès aux liens en nuage (une partie du nom complet du lien en nuage).

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

   • scope : Spécifie la portée. Vous pouvez utiliser l'une des variables : MY$REGION, MY$TENANCY ou MY$COMPARTMENT ou spécifier un ou plusieurs OCID.

     Pour plus d'informations, voir Portée du jeu de données, contrôle d'accès et autorisation.

   • auth_required : Valeur booléenne qui spécifie si une autorisation au niveau de la base de données est requise pour le jeu de données, en plus du contrôle d'accès à la portée. Lorsque cette valeur est réglée à TRUE, le jeu de données applique une étape d'autorisation supplémentaire. Pour plus d'informations, voir Enregistrer un jeu de données avec autorisation requise.

   • data_set_owner : La valeur de texte spécifie les informations sur la personne responsable du jeu de données ou sur un contact pour les questions concernant le jeu de données. Par exemple, vous pouvez fournir une adresse de courriel au responsable du jeu de données.

   Pour plus d'informations, voir Procédure REGISTER.

   Une fois l'enregistrement terminé sur le clone actualisable, la portée de l'objet enregistré est MY$COMPARTMENT : Spécifie la portée au niveau du compartiment la plus restrictive pour mon compartiment dans ma location pour TRUSTED_COMPARTMENT.SALES.

• Notes pour l'enregistrement ou l'annulation de l'enregistrement d'un jeu de données dans une région distante
  Fournit des notes pour l'enregistrement d'un jeu de données dans une région distante.

Facultativement, lorsque vous enregistrez un jeu de données, en plus de la portée, vous pouvez spécifier que l'autorisation au niveau de la base de données est requise pour accéder à un jeu de données.

1. Utilisez DBMS_CLOUD_LINK.REGISTER pour enregistrer des données avec autorisation requise.

   En supposant qu'il existe un schéma CLOUDLINK sur votre instance de base de données d'intelligence artificielle autonome et que vous enregistrez l'objet SALES_VIEW_AGG et réglez auth_required à TRUE, en plus de définir la portée, vous devez effectuer des étapes supplémentaires pour déterminer comment accéder à 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 (responsable de l'objet).

   • schema_object : Nom de l'objet. Les objets valides sont les suivants :

     • Tables (y compris le tas, externe ou hybride)
     • Vues
     • Vues matérialisées
     Note
     
     Les autres objets tels que les vues analytiques ou les synonymes ne sont pas pris en charge.

   • namespace : Espace de noms que vous fournissez en tant que nom pour l'accès aux liens en nuage (une partie du nom complet des liens en nuage).

     Une valeur NULL spécifie une valeur namespace générée par le système, unique à l'instance de base de données du service d'intelligence artificielle autonome.

   • name : Nom que vous fournissez pour l'accès aux liens en nuage (une partie du nom complet du lien en nuage).

   • scope : Spécifie la portée. Vous pouvez utiliser l'une des variables : MY$REGION, MY$TENANCY ou MY$COMPARTMENT ou spécifier un ou plusieurs OCID.

     Pour plus d'informations, voir Portée du jeu de données, contrôle d'accès et autorisation.

   • auth_required : Valeur booléenne qui spécifie si une autorisation au niveau de la base de données est requise pour le jeu de données, en plus du contrôle d'accès à la portée. Lorsque cette valeur est réglée à TRUE, le jeu de données applique une étape d'autorisation supplémentaire.

   • data_set_owner : La valeur de texte spécifie les informations sur la personne responsable du jeu de données ou sur un contact pour les questions concernant le jeu de données. Par exemple, vous pouvez fournir une adresse de courriel au responsable du jeu de données.

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

   Sur le système, vous voulez accorder l'accès au jeu de données :

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

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

   Vous ne pouvez accorder l'autorisation et exécuter DBMS_CLOUD_LINK.GRANT_AUTHORIZATION, comme indiqué à cette étape, que si vous ê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;
/

Facultativement, lorsque vous enregistrez un jeu de données, vous pouvez décharger l'accès au jeu de données sur une ou plusieurs instances de base de données d'IA autonome qui sont des clones actualisables.

Utilisez le paramètre facultatif offload_targets avec DBMS_CLOUD_LINK.REGISTER pour spécifier que l'accès est déchargé pour les clones actualisables. La base de données source pour chaque clone actualisable est l'instance de base de données de l'IA autonome où vous enregistrez le jeu de données (éditeur de données).

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

• CLOUD_LINK_DATABASE_ID est l'un des suivants :

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

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

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

    Si vous spécifiez ANY sans spécifier d'ID base de données, toutes les demandes de jeu de données des consommateurs sont déchargées vers le clone actualisable spécifié avec la valeur OFFLOAD_TARGET.

    Si vous spécifiez à la fois des ID base de données et ANY, les demandes de jeu de données provenant de consommateurs qui ne correspondent pas à un ID base de données sont déchargées vers le clone actualisable spécifié avec la valeur OFFLOAD_TARGET.

• OFFLOAD_TARGET est l'OCID d'une instance de base de données du service d'intelligence artificielle autonome qui est un clone actualisable.

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

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

Lorsqu'un consommateur de jeu de données demande l'accès à un jeu de données que vous enregistrez auprès de offload_targets et que l'ID base de données de l'instance Autonomous AI Database correspond à la valeur spécifié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 consommateur de jeu de données demande l'accès à un jeu de données que vous enregistrez 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 de consommateurs qui ont une entrée d'ID 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 jeu de données et spécifier des cibles de déchargement, procédez de la façon suivante :

1. Obtenez l'OCID d'un ou de plusieurs clones actualisables pour lesquels vous voulez décharger l'accès au jeu de données. Des OCID de clone actualisable sont disponibles dans la console Oracle Cloud Infrastructure sur un clone actualisable.
   Note
   
   La création d'un clone actualisable peut prendre jusqu'à 10 minutes pour qu'il soit visible en tant que cible du 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'enregistrement du déchargement des liens vers le nuage.
2. Obtenez l'ID base de données pour une ou plusieurs instances de base de données d'intelligence artificielle autonome auxquelles vous voulez accéder à l'aide des données fournies par le clone actualisable.

   Sur le système où vous voulez accéder au jeu de données à partir d'un clone actualisable, exécutez la commande suivante :

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

3. Enregistrez un jeu de données et spécifiez le paramètre offload_targets.

   Par exemple, en supposant qu'il existe un schéma CLOUDLINK sur votre instance de base de données d'intelligence artificielle autonome, vous pouvez enregistrer SALES_VIEW_AGG et spécifier les clones actualisables qui fournissent l'accès au jeu 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 (responsable de l'objet).

   • schema_object : Nom de l'objet. Les objets valides sont les suivants :

     • Tables (y compris le tas, externe ou hybride)
     • Vues
     • Vues matérialisées
     Note
     
     Les autres objets tels que les vues analytiques ou les synonymes ne sont pas pris en charge.

   • namespace : Espace de noms que vous fournissez en tant que nom pour l'accès aux liens en nuage (une partie du nom complet des liens en nuage).

     Une valeur NULL spécifie une valeur namespace générée par le système, unique à l'instance de base de données du service d'intelligence artificielle autonome.

   • name : Nom que vous fournissez pour l'accès aux liens en nuage (une partie du nom complet du lien en nuage).

   • scope : Spécifie la portée. Vous pouvez utiliser l'une des variables : MY$REGION, MY$TENANCY ou MY$COMPARTMENT ou spécifier un ou plusieurs OCID.

     Pour plus d'informations, voir Portée du jeu de données, contrôle d'accès et autorisation.

   • auth_required : Valeur booléenne qui spécifie si une autorisation au niveau de la base de données est requise pour le jeu de données, en plus du contrôle d'accès à la portée. Lorsque cette valeur est réglée à TRUE, le jeu de données applique une étape d'autorisation supplémentaire. Pour plus d'informations, voir Enregistrer un jeu de données avec autorisation requise.

   • data_set_owner : La valeur de texte spécifie les informations sur la personne responsable du jeu de données ou sur un contact pour les questions concernant le jeu de données. Par exemple, vous pouvez fournir une adresse de courriel au responsable du jeu de données.

   • offload_targets : Spécifie un ou plusieurs OCID de base de données d'IA autonome des clones actualisables où l'accès aux jeux de données est déchargé, à partir de la base de données d'IA autonome où le jeu de données est enregistré.

     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 spécifiée, c'est-à-dire que les valeurs correspondent à l'ID base de données du consommateur, l'accès est déchargé vers le clone actualisable identifié par l'OCID spécifié dans offload_target.

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

   Note
   
   Si votre éditeur de données est un chef de groupe élastique ou un membre du groupe élastique, au lieu de configurer les détails de la cible de déchargement avec offload_targets, vous pouvez utiliser la fonction de déchargement d'interrogation unifiée. Dans ce cas, l'éditeur permet au déchargement des interrogations ProxySQL de décharger les interrogations (lectures) sur un nombre illimité de clones actualisables sans avoir à configurer les cibles. Pour plus d'informations, voir Utiliser le déchargement d'interrogation unifiée avec des liens vers le nuage.

   Pour plus d'informations, voir :

   • Procédure d'enregistrement

   • UPDATE_REGISTRATION Procédure

   • Utiliser des clones actualisables avec une base de données autonome avec l'IA

   • Utiliser le déchargement d'interrogation unifié avec des liens en nuage

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 du schéma, l'objet de schéma, l'espace de noms ou les attributs de nom.

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

   Si vous ne disposez pas des privilèges nécessaires pour mettre à jour les attributs de jeu de données, vous devez obtenir les privilèges d'enregistrement d'autorisation de l'utilisateur ADMIN.

   Pour plus d'informations, voir Accorder l'accès aux liens vers le nuage 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 pour le jeu 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 du jeu de données que vous avez fourni lors de l'enregistrement du jeu de données.

   • name : Nom du jeu de données que vous avez fourni lors de l'enregistrement du jeu de données.

   Voici une liste des paramètres facultatifs. Si NULL est transmis pour une valeur de paramètre facultative, l'attribut n'est pas modifié.

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

   • scope : Spécifie la portée. Vous pouvez utiliser l'une des variables : MY$REGION, MY$TENANCY ou MY$COMPARTMENT ou spécifier un ou plusieurs OCID.

     Pour plus d'informations, voir Portée du jeu de données, contrôle d'accès et autorisation.

   • auth_required : Valeur booléenne qui spécifie si une autorisation au niveau de la base de données est requise pour le jeu de données, en plus du contrôle d'accès à la portée. Lorsque cette valeur est réglée à TRUE, le jeu de données applique une étape d'autorisation supplémentaire. Pour plus d'informations, voir Enregistrer un jeu de données avec autorisation requise.

   • data_set_owner : La valeur de texte spécifie les informations sur la personne responsable du jeu de données ou sur un contact pour les questions concernant le jeu de données. Par exemple, vous pouvez fournir une adresse de courriel au responsable du jeu de données.

   • offload_targets : Spécifie un ou plusieurs OCID Autonomous Database de clones actualisables où l'accès aux jeux de données est déchargé, à partir de la base de données Autonomous Database où le jeu de données est enregistré. Pour plus d'informations, voir Enregistrer un jeu de données avec des cibles de déchargement pour l'accès au jeu de données.

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

   Pour plus d'informations, voir ProcédureUPDATE_REGISTRATION.

Vous pouvez définir le mappage de nom de service à utiliser lorsque les consommateurs de liens vers le nuage accèdent aux données d'un responsable de jeu de données.

Les liens vers le nuage s'appuient sur les ressources de base de données de l'instance de base de données d'intelligence artificielle autonome qui fournit le jeu 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 consommateurs d'accéder aux données de Cloud Links utilise le service de base de données MEDIUM.

Utilisez DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING pour définir le mappage du service de base de données pour un consommateur. Dans cette procédure, vous indiquez un ID base de données ou le mot clé ANY pour spécifier le mappage du service client. Par exemple, la figure suivante présente un mappage du consommateur A au service HIGH, du consommateur B au service MEDIUM, du consommateur C au service LOW et un mappage du service ANY au 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

Voir Noms de service de base de données pour Autonomous AI Database pour plus d'informations sur les caractéristiques des services de base de données.

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 de consommateur, exécutez GET_DATABASE_ID pour obtenir l'ID base de données du consommateur. Exemple :

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

   Pour plus d'informations, voir Fonction GET_DATABASE_ID.

2. Dans l'instance de base de données d'intelligence artificielle autonome du responsable du jeu de données, spécifiez un mappage de service.

   Effectuez cette étape sur l'instance Autonomous AI Database du responsable du jeu 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 est l'ID base de données que vous avez obtenu à l'étape 1.

   Spécifiez la valeur ANY pour que database_id utilise la valeur service_name spécifiée avec toutes les bases de données de consommateurs qui n'ont pas de valeur service_name associée à leur valeur database_id. Autrement dit, tout database_id dont service_name n'a pas été défini avec DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

   Pour plus d'informations, voir ProcédureADD_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 base de données et le mappage de service en listant les mappages de service Cloud Links.

   Exemple :

   SELECT * FROM  DBA_CLOUD_LINK_SERVICE_MAPPINGS;

   Pour plus d'informations, voir Vue DBA_CLOUD_LINK_SERVICE_MAPPINGS.

• Définir le mappage de nom de service de base de données pour les consommateurs de liens en nuage dans la région distante
  Un jeu de données enregistré dans une région source est accessible avec des liens en nuage à 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 de jeu de données pour les résultats d'une interrogation ou pour un fragment d'interrogation qui accède aux données Cloud Link.

1. Dans une interrogation, spécifiez le conseil RESULT_CACHE avec l'option SHELFLIFE.

   Exemple :

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

   Cette valeur RESULT_CACHE spécifie une valeur SHELFLIFE de 120. Cela indique que le résultat doit être mis en mémoire cache pendant 120 secondes. Après 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 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 en nuage lorsqu'un jeu de données réside sur une instance de base de données d'IA autonome en lecture seule.

1. Remplacez le mode de base de données par Read/Write.
   Pour plus d'informations, voir Modifier le mode d'exploitation d'une base de données autonome avec lecture/écriture en lecture seule ou restreinte.
2. Avec la base de données en mode lecture/écriture, effectuez les étapes d'enregistrement d'un jeu de données.
   1. Accorder l'accès aux liens en nuage aux utilisateurs de base de données
   2. Enregistrer ou annuler l'enregistrement d'un jeu de données
3. Après avoir enregistré un ou plusieurs jeux de données, changez la base de données en mode lecture seule.
   Pour plus d'informations, voir Modifier le mode d'exploitation d'une base de données autonome avec lecture/écriture en lecture seule ou restreinte.