Utiliser un partage

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

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

1. Fournisseurs de partage en direct disponibles au titre des 7 derniers jour

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

2. Champ Rechercher un fournisseur de partage abonné

   Vous pouvez rechercher le destinataire de partage que vous créez en saisissant le nom du fournisseur de partage abonné. Entrez le nom du fournisseur de partage 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 + S'abonner au fournisseur de partage pour s'abonner à un nouveau fournisseur de partage. Pour plus d'informations sur cette icône, reportez-vous à S'abonner au fournisseur de partage.
4. Mon ID de partage

   Un ID de partage est un fournisseur unique pour votre instance Autonomous Database. Copiez cet ID dans le presse-papiers et collez-le dans le champ ID de 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 de la commande Trier par dans la barre d'outils, les paramètres s'affichent dans de petits champs 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 revenant à la commande Trier par dans la barre d'outils.

7. Zone d'affichage

   La zone située sous le champ Rechercher des fournisseurs de partage de consommateurs affiche les entités renvoyé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 que les données avec numéro de version partagé soient disponibles dans Oracle Autonomous Database. Les données partagées avec vous via Delta Sharing ne sont pas automatiquement disponibles et repérables dans votre instance Autonomous Database.

A propos du profil JSON

Les fichiers de profil sont des fichiers JSON contenant les informations 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écouvrir les partages de données auxquels vous pouvez accéder. 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 avec l'objet Partage de données Oracle Autonomous Database.

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

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

Cliquez sur le lien de profil pour télécharger le profil JSON. Lorsque vous cliquez sur le lien du profil, vous accédez à un nouvel écran du navigateur à l'aide du bouton Obtenir des 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 de partage, vous devez configurer une liste de contrôle d'accès (ACL) sur l'ordinateur du fournisseur de partage en utilisant la procédure APPEND_HOST_ACE en tant qu'utilisateur ADMIN ou un autre utilisateur privilégié. 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 adresses 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. En tant que prérequis, extrayez le nom d'hôte de la propriété d'adresse 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;        
        /

Les paramètres avec leur description sont les suivants :

• Hôte : indique 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 : indique le port inférieur d'une plage de ports TCP facultative.
• Port supérieur : spécifie le port supérieur d'une plage de ports TCP facultative.
• ace – Entrée de contrôle d'accès.
• Liste de privilèges : indique la liste des privilèges 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é. Il distingue la casse des majuscules.
• principal_type : indique le type de principal que vous utilisez.

Pour plus d'informations sur les sous-programmes de package DBMS_NETWORK_ACL_ADMIN, reportez-vous au document Référence des packages et des types PL/SQL.

PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

Dans ce processus, vous allez charger le profil JSON du fournisseur pour la configuration et les informations d'identification afin d'activer l'accès aux destinataires.

1. Ouvrez la page Consommer le partage et cliquez sur + S'abonner au fournisseur de partage pour sélectionner S'abonner au fournisseur de partage Delta dans la liste déroulante. La boîte de dialogue S'abonner au fournisseur de partage s'ouvre.
2. Dans le volet Provider Settings de la boîte de dialogue Register Share Provider, indiquez 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 de fournisseur de partage Delta.

   Sous le champ JSON du fournisseur de partage, vous pouvez partager le profil JSON de l'une des manières suivantes :

   • Dans le fichier : sélectionnez cette option et cliquez sur la zone de déplacement intitulée "JSON de profil de partage Delta". Cliquez sur la zone pour ouvrir le référentiel local dans lequel 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.

   Téléchargez le fichier de profil JSON et créez un abonnement de fournisseur de partage.

   Cliquez sur Suivant pour accéder à 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 utiliser à 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 enlever 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 enlever tous les partages sélectionnés des partages sélectionnés.

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 pouvez désormais afficher l'écran Lier l'objet cloud de la page Chargement de données.

5. Vous pouvez afficher le nom du fournisseur de partage dans le champ Emplacement de stockage cloud. Le partage apparaît à 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 de partage, faites glisser et déposez le fichier que vous partagez de la source vers le panier de liens de données.

   Sélectionnez Démarrer dans le panier de liens de données pour exécuter le travail 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 revenir à la fenêtre d'accueil Database Actions.
   • Cliquez sur la mosaïque SQL.
   • Sélectionnez la table externe, faites-la glisser vers la feuille de calcul.

     L'instruction SQL Select de la table apparaît. Cette instruction SQL peut être exécutée pour utiliser les données partagées.

     
     Description de l'illustration xt_sql.png

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

Pour utiliser 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 au fournisseur de partage pour sélectionner S'abonner au fournisseur de partage en direct dans la liste déroulante. La boîte de dialogue S'abonner au fournisseur de partage s'ouvre.
2. Dans le volet Provider Settings de la boîte de dialogue Subscribe to Share Provider, indiquez les détails suivants :
   Description de l'illustration subscription-live-share-provider.png

   Dans la section Source de partage, sélectionnez Sélectionner parmi les fournisseurs de partage en direct et sélectionnez le fournisseur dans la liste déroulante.

   Dans le champ Détails du fournisseur de partage, entrez les informations suivantes :

   • Nom du fournisseur : indiquez le nom du fournisseur.
   • Description : entrez la description du fournisseur.

   Cliquez sur Suivant pour accéder à 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 utiliser à 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 enlever 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 enlever tous les partages sélectionnés des partages sélectionnés.

   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 pouvez désormais afficher l'écran Lier l'objet cloud de la page Chargement de données.

4. Vous pouvez afficher le nom du fournisseur de partage dans le champ Emplacement de stockage cloud. Le partage apparaît à 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 de partage, faites glisser et déposez le fichier que vous partagez de la source vers le panier de liens de données.

   Sélectionnez Démarrer dans le panier de liens de données pour exécuter le travail de lien de données.

Pour afficher les détails de l'entité Fournisseur de partage, cliquez sur l'icône Actions à droite de l'entrée d'entité Fournisseur de partage, puis sur Afficher les détails.

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

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

• Afficher les détails : reportez-vous à Afficher 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. 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 ignorer le processus de modification.
• Renommer : renomme le nom du fournisseur. Sélectionnez Oui pour apporter des modifications. Sinon, cliquez sur Non.
• Supprimer : enlève 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é.
• Tables de lien : vous êtes dirigé vers la page Lier les données, l'onglet Partager étant sélectionné pour visualiser et exécuter l'objet de lien associé. Glissez-déplacez les données partagées pour les ajouter au travail de liaison de données.