Consommer le partage

La section Consommer le partage fournit un aperçu de la liste des fournisseurs de partage, recherche de fournisseurs de partage et ajout d'un fournisseur de partage.

La page Consommer le partage contient :
Description de l'illustration consumer-share-new.png

1. Fournisseurs de partage en direct disponibles au cours des 7 derniers jours

   Cette zone affiche la liste des fournisseurs de partage en direct disponibles que vous avez créés au cours des 7 derniers jours. Vous pouvez mettre à jour n'importe lequel des champs selon votre souhait. Vous pouvez également vous abonner à Live Share en utilisant le signe + à droite des actions répertoriées dans Partages disponibles au cours des 7 derniers jours.

2. Champ Rechercher un fournisseur de partages avec abonnement

   Vous pouvez rechercher le destinataire du partage que vous créez en entrant le nom du fournisseur de partage auquel vous êtes abonné. Entrez le nom du fournisseur de partage auquel vous êtes abonné, par exemple REVIEW_PROVIDER, puis cliquez sur l'icône Loupe pour terminer la recherche. L'outil Partager affiche les résultats de la recherche dans la zone d'affichage.

3. Sélectionnez + Subscribe to Share Provider (S'abonner au fournisseur de partage) pour s'abonner à un nouveau fournisseur de partage. Pour explorer cette icône, voir S'abonner à un fournisseur de partage.
4. Mon ID partage

   Un ID de partage est un fournisseur unique pour votre base de données Autonomous AI Database. Copiez cet ID dans le presse-papiers et collez-le dans le champ ID partage de l'Assistant Créer un destinataire de partage. Cela permet de partager un partage en direct avec un fournisseur de partage.

5. Barre d'outils

   La barre d'outils comprend les options de tri, de taille de page, d'actualisation et de vue d'entité.

6. Trier par paramètres

   Lorsque vous définissez des valeurs de tri à l'aide du contrôle Trier par dans la barre d'outils, les paramètres sont affichés dans de petites zones sous la barre d'outils. Vous pouvez supprimer un paramètre en cliquant sur l'icône X dans la zone. Vous pouvez également modifier les paramètres en retournant au contrôle Trier par dans la barre d'outils.

7. Zone d'affichage

   La zone sous le champ Rechercher les fournisseurs de partage avec les consommateurs affiche les entités retournées par une recherche et qui correspondent aux critères de filtre définis dans le panneau Filtres. Vous pouvez trier les entités en cliquant sur le bouton Trier par, puis en définissant des valeurs de tri.

Vous devez suivre ces étapes pour mettre à votre disposition des données avec contrôle des versions partagées dans Oracle Autonomous AI Database. Les données partagées avec vous au moyen de Delta Sharing ne sont pas automatiquement disponibles et détectables dans votre base de données d'IA autonome.

À propos du profil JSON

Les fichiers de profil sont des fichiers JSON contenant les données d'identification d'un utilisateur pour accéder à un serveur Delta Sharing. Cela vous permet de vous authentifier auprès du serveur de partage delta et de détecter les partages de données auxquels vous êtes admissible. Téléchargez le profil à l'aide de l'URL incluse dans le courriel d'invitation envoyé par le fournisseur de partage de données.

Une fois que l'outil de partage a créé un objet de partage, le destinataire reçoit un courriel d'activation intitulé Partage de données Oracle Autonomous AI Database.

Description de l'illustration activation-mail-new.png

Pour accéder au partage, vous devez enregistrer les objets partagés à l'aide du profil JSON d'autorisation personnelle.

Vous pouvez cliquer sur le lien du profil pour télécharger le profil JSON. En cliquant sur le lien du profil, vous accédez à un nouvel écran dans le navigateur avec le bouton Obtenir les informations sur le profil comme indiqué ci-dessous :

{  "
        shareCredentialsVersion ": 1, 
        "endpoint": "https://myhost.us.example.com/ords/prov/_delta_sharing/", 
        "tokenEndpoint": "http://myhost.us.example.com:1234/ords/pdbdba/oauth/token", 
        "bearerToken": "-xxxxxxxxxxxxxxxxxxxxx", 
        "expirationTime": "2023-01-13T07:53:11.073Z", 
        "clientID": "xxxxxxxxxxxxxxxxxxxxxx..", 
        "clientSecret": "xxxxxxxxxxxxxxxxxxxx.."}

Améliorations apportées à la sécurité

En tant que destinataire du partage, vous devez configurer une liste de contrôle d'accès (LCA) à l'ordinateur du fournisseur de partage en utilisant la procédure APPEND_HOST_ACE en tant qu'utilisateur ADMIN ou un autre utilisateur doté de privilèges. Cela vous permet d'accéder au partage via Internet.

Par exemple, si vous souhaitez autoriser un utilisateur de base de données, A_SHARE_USER à accéder aux points d'extrémité d'un hôte (fournisseur de partage) nommé, voici un exemple de procédure PL/SQL que vous devrez exécuter dans l'éditeur de feuille de calcul SQL en tant qu'administrateur. Comme préalable, extrayez le nom d'hôte de la propriété de point d'extrémité dans le profil JSON de partage delta, comme indiqué dans l'exemple ci-dessus. Le nom d'hôte de l'exemple est myhost.us.example.com.

BEGIN 
        dbms_network_acl_admin.append_host_ace(    
        host =>'myhost.us.example.com', 
        lower_port=>443,    
        upper_port=>443,
        ace => xs$ace_type(      
        privilege_list => xs$name_list('http', 'http_proxy'),      
        principal_name =>'A_SHARE_USER',
        principal_type => xs_acl.ptype_db)); 
        COMMIT;
        END;        
        /

Voici les paramètres avec leur description :

• host - Spécifie le nom ou l'adresse IP de l'hôte. L'hôte ou le nom de domaine n'est pas sensible à la casse.
• Port inférieur - Spécifie le port inférieur d'un intervalle de ports TCP facultatif.
• Port supérieur - Spécifie le port supérieur d'un intervalle de ports TCP facultatif.
• ace – Entrée de contrôle d'accès.
• Liste de privilèges - Spécifie la liste des privilèges de réseau à accorder ou à refuser.
• principal_name - Il s'agit du principal (utilisateur ou rôle de base de données) auquel le privilège est accordé ou refusé. Elle est sensible à la casse.
• principal_type - Spécifie le type de principal que vous utilisez.

Consultez le document Informations de référence sur les ensembles et les types PL/SQL pour plus de détails sur les sous-programmes d'ensemble DBMS_NETWORK_ACL_ADMIN.

PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

Au cours de ce processus, vous chargerez le profil JSON du fournisseur pour la configuration et les données d'identification afin de permettre l'accès aux destinataires.

1. Ouvrez la page Consommer le partage et cliquez sur + S'abonner à un fournisseur de partage pour sélectionner S'abonner à un fournisseur de partage Delta dans la liste déroulante. La boîte de dialogue Subscribe to Share Provider apparaît.
2. Dans le volet Provider Settings (Paramètres du fournisseur) de la boîte de dialogue Register Share Provider (Enregistrer le fournisseur de partage), spécifiez les détails suivants :
   Description de l'illustration subscription-share-provider-version-providersettings.png
   • Nom du fournisseur : Fournisseur.
   • Description : Ajoutez une description. Ce champ est facultatif.

   Dans la section Partager la source, sélectionnez JSON du fournisseur de partage Delta.

   Sous le champ JSON Partager le fournisseur, vous pouvez partager le profil JSON de l'une des façons suivantes :

   • À partir du fichier : Sélectionnez cette option et cliquez sur la zone de dépôt intitulée "Delta Share Profile JSON". Cliquer sur la zone ouvre votre référentiel local où vous pouvez sélectionner le profil JSON que vous avez téléchargé.
   • JSON : Vous pouvez sélectionner cette option et coller le contenu JSON du profil que vous copiez dans le bloc-notes.

   Chargez le fichier de profil JSON et créez un abonnement de fournisseur de partages.

   Cliquez sur Suivant pour passer à l'onglet Ajouter des partages.
3. Dans l'onglet Ajouter des partages de la boîte de dialogue, vous verrez la liste des partages disponibles. Cliquez sur le partage que vous souhaitez consommer à partir des partages disponibles et sélectionnez l'une des options disponibles :
   Description de l'illustration subscription-share-provider-version-addshares.png
   • > : Cette option vous permet de déplacer le partage disponible vers les partages sélectionnés.
   • < : Sélectionnez cette option pour supprimer le partage sélectionné des partages sélectionnés.
   • >> : Cette option vous permet de déplacer tous les partages vers l'écran Partages sélectionnés.
   • << : Sélectionnez cette option pour supprimer tous les partages sélectionnés des actions sélectionnées.

4. Cliquez sur S'abonner pour ajouter le partage. Une invite de confirmation s'affiche lorsque le fournisseur a été créé. Une fois le fournisseur créé, vous verrez maintenant l'écran Link Cloud Object de la page Data Load.

5. Vous pouvez voir le nom du fournisseur de partage dans le champ d'emplacement de stockage en nuage. Le partage apparaît dans l'emplacement du fichier source avec les fichiers que vous ajoutez au partage.
   Description de l'illustration link-cloud-object.png

   Développez le panier de dossiers Share, glissez-déposez le fichier que vous partagez de la source vers le panier Data Link.

   Sélectionnez Démarrer dans le panier de liens Données pour exécuter la tâche de lien de données.

6. Affichez les tables créées à partir de Database Actions.
   • Cliquez sur Database Actions, dans le chemin de navigation, pour retourner au panneau de lancement de Database Actions.
   • Cliquez sur la vignette SQL.
   • Sélectionnez la table externe, glissez-déposez-la dans la feuille de calcul.

     L'instruction SQL Select associée à la table s'affiche. Cette instruction SQL peut être exécutée pour consommer les données partagées.

     
     Description de l'illustration xt_sql.png

Les données en direct partagées avec vous par le biais du partage de données ne sont pas automatiquement disponibles pour la consommation.

Pour consommer des partages de données en direct, vous devez vous y abonner et créer des vues des tables incluses dans le partage en direct. Les vues peuvent être interrogées à l'aide de scripts SQL.

1. Ouvrez la page Consommer le partage et cliquez sur + S'abonner à un fournisseur de partage pour sélectionner S'abonner à un fournisseur de partage en direct dans la liste déroulante. La boîte de dialogue Subscribe to Share Provider apparaît.
2. Dans le volet Provider Settings (Paramètres du fournisseur) de la boîte de dialogue Subscribe to Share Provider (S'abonner au fournisseur de partage), spécifiez les détails suivants :
   Description de l'illustration subscription-live-share-provider.png

   Sous la section Partager la source, sélectionnez Sélectionner dans les fournisseurs de partage en direct et sélectionnez le fournisseur dans la liste déroulante.

   Dans le champ Share Provider Details, entrez les informations suivantes :

   • Nom du fournisseur : Spécifiez le nom du fournisseur.
   • Description : Entrez une description du fournisseur.

   Cliquez sur Suivant pour passer à l'onglet Ajouter des partages.

3. Dans l'onglet Ajouter des partages de la boîte de dialogue, vous verrez la liste des partages disponibles. Cliquez sur le partage que vous souhaitez consommer à partir des partages disponibles et sélectionnez l'une des options disponibles :
   Description de l'illustration add-shares.png
   • > : Cette option vous permet de déplacer le partage disponible vers les partages sélectionnés.
   • < : Sélectionnez cette option pour supprimer le partage sélectionné des partages sélectionnés.
   • >> : Cette option vous permet de déplacer tous les partages vers l'écran Partages sélectionnés.
   • << : Sélectionnez cette option pour supprimer tous les partages sélectionnés des actions sélectionnées.

   Cliquez sur S'abonner pour ajouter le partage. Une invite de confirmation s'affiche lorsque le fournisseur a été créé. Une fois le fournisseur créé, vous verrez maintenant l'écran Link Cloud Object de la page Data Load.

4. Vous pouvez voir le nom du fournisseur de partage dans le champ d'emplacement de stockage en nuage. Le partage apparaît dans l'emplacement du fichier source avec les fichiers que vous ajoutez au partage.
   Description de l'illustration link-cloud-object.png

   Développez le panier de dossiers Share, glissez-déposez le fichier que vous partagez de la source vers le panier Data Link.

   Sélectionnez Démarrer dans le panier de liens Données pour exécuter la tâche de lien de données.

Pour voir les détails de l'entité Partager le fournisseur, cliquez sur l'icône Actions à droite de l'entrée d'entité Partager le fournisseur, puis cliquez sur Voir les détails.

Pour toutes les entités, les détails incluent les sections Lignage et Incidence.

Pour une entité de fournisseur de partage spécifique, vous pouvez effectuer les actions suivantes à l'aide du menu contextuel Actions.

• Voir les détails : Voir Voir les détails de l'entité du fournisseur de partage.
• Gérer les partages : Ouvre une boîte de dialogue Gérer les partages pour le fournisseur de partage. Cette liste répertorie les partages que vous choisissez de partager avec le destinataire. Vous pouvez modifier la liste des partages que vous souhaitez partager avec le destinataire. Cliquez sur OK pour enregistrer les modifications ou sélectionnez Annuler pour abandonner le processus de modification.
• Renommer : Renomme le nom du fournisseur. Sélectionnez Oui pour apporter des modifications. Sinon, cliquez sur Non.
• Supprimer : Supprime l'entité de fournisseur de partage.
• Charger les tables : Vous êtes dirigé vers la page Charger les données avec l'onglet Partager sélectionné.
• Link Tables (Lier les tables) : Vous êtes dirigé vers la page Link Data (Lier les données) avec l'onglet Share (Partager) sélectionné pour voir et exécuter l'objet de lien associé. Glissez-déposez les données partagées pour les ajouter à la tâche de lien de données.

Décrit comment partager les tables Delta des liens de données lorsque la base de données IA autonome est un consommateur de partage Delta.

ORA-29913: error while processing ODCIEXTTABLEFETCH routine

ALTER TABLE table_name 
SET TBLPROPERTIES ('delta.enableDeletionVectors' = FALSE);

SHOW TBLPROPERTIES table_name ('delta.enableDeletionVectors');