Utiliser un partage

Une fois que les fournisseurs ont partagé les objets, les destinataires doivent suivre quelques étapes pour utiliser le partage.

Utilisez la page Consommer le partage pour effectuer les opérations suivantes :
  • Présentation de l'utilisation d'un partage :

    Pour utiliser les partages de données, vous devez vous y abonner et créer des vues des tables incluses dans le partage en direct.

  • Utiliser un partage avec numéro de version :

    En tant que destinataire, vous devrez télécharger votre profil de partage, vous abonner au fournisseur de partage de données, enregistrer les partages et créer des tables externes au-dessus de vos partages. L'outil Partage de données autorise l'accès à l'aide du profil JSON envoyé au destinataire à l'aide du courrier d'activation. Une fois l'accès accordé, l'outil Partage de données lie les objets partagés à l'outil Lien de données, dans lequel le consommateur peut exécuter le travail de liaison de données et accéder aux objets partagés par le fournisseur.

  • Utiliser un partage en direct :

    Cela vous permet, en tant que destinataire, d'utiliser les données en direct de la base de données.

  • Visualiser les détails d'une entité de fournisseur de partage :

    Utilisez l'icône Actions à droite de l'entrée d'entité de fournisseur de partage en direct ou delta pour visualiser les détails de l'entité de fournisseur de partage en direct ou delta que vous créez.

Présentation de l'utilisation d'un partage

L'option Consommer le partage fournit une vue d'ensemble de la liste des fournisseurs de partage, permet de rechercher des fournisseurs de partage et d'ajouter un fournisseur de partage.

Pour accéder à la page Consommer le partage, procédez comme suit :
  • Dans le menu Data Studio, sélectionnez Consommer le partage sous le menu Partage de données.
  • Sur la page Partage de données, cliquez sur le widget Consommer le partage présent dans la section Fournisseur et consommateur.

La page Consommer un partage contient :Description de l'image consumer-share-new.png
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 l'un des champs selon votre souhait. Vous pouvez également vous abonner au partage en direct 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 souscrit. 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 vous abonner à un nouveau fournisseur de partage. Reportez-vous à S'abonner au fournisseur de partage pour explorer cette icône.
  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 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 revenant au contrôle Trier par de la barre d'outils.

  7. Zone d'affichage

    La zone située sous le champ Rechercher les 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, puis en définissant des valeurs de tri.

Utiliser un partage avec numéro de version

Vous devez suivre ces étapes pour mettre à votre disposition des données avec numéro de version partagé 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.

Vous devez effectuer plusieurs étapes de base pour vous abonner aux partages de données fournis et y accéder. Vous devez effectuer les opérations suivantes :
  • Téléchargez le profil JSON.
  • Abonnez-vous au fournisseur de partage de données.
  • Enregistrez les actions mises à votre disposition.
  • Créez des tables externes en plus de vos partages.

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 de partage Delta. Cela vous permet de vous authentifier auprès du serveur de partage delta et de découvrir les partages de données auxquels vous êtes autorisé à 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 un objet intitulé Partage de données Oracle Autonomous Database.



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

Vous pouvez cliquer sur le lien du profil pour télécharger le profil JSON. Lorsque vous cliquez sur le lien de profil, vous accédez à un nouvel écran du navigateur à l'aide du bouton Obtenir les informations de profil, comme indiqué ci-dessous :

Description de l'image json-profile.png
Description de l'image json-profile.png
Sélectionnez Obtenir les informations de profil pour télécharger le profil JSON à connecter au fournisseur de partage.
Remarque

Vous ne pouvez cliquer qu'une seule fois sur le bouton Obtenir les informations de profil et afficher également le lien vers le guide de démarrage rapide. L'outil de partage ne vous permet pas de sélectionner deux fois Obtenir les informations de profil. Cliquez deux fois dessus pour afficher un écran qui affiche la liste des causes de l'échec du téléchargement du profil.
Le profil ci-dessous est un exemple du profil JSON que vous téléchargez.
{  "
        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.."}
Le profil stocke les informations d'identification dans un format chiffré. Les paramètres avec leur description sont les suivants :
  • shareCredentialsVersion : version du partage que vous publiez.
  • adresse : indique l'adresse de partage.
  • tokenEndpoint : indique l'adresse de jeton. Le client de l'outil de partage utilise l'adresse de jeton pour actualiser le délai d'expiration de votre jeton de support si vous utilisez le partage à l'aide d'Oracle.
  • bearerToken : chaîne cryptique générée par le serveur d'authentification en réponse à une demande de connexion.
  • expirationTime : délai d'expiration de l'authentification.
  • ClientID : indique l'identificateur public généré par le serveur d'authentification lorsque vous inscrivez l'instance pour authentification.
  • clientSecret : indique un identificateur secret généré par le serveur d'authentification pour l'autorisation.
Copiez le contenu JSON du profil dans un bloc-notes. Vous aurez besoin de ce JSON ci-dessous pour abonner votre fournisseur de partage.
Remarque

Veillez à copier l'intégralité du profil de contenu JSON, y compris l'accolade gauche et l'accolade droite.

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.

Remarque

Cette opération doit être effectuée avant d'utiliser l'assistant Ajouter un fournisseur de partage pour ajouter une entrée de contrôle d'accès (ACE) à la liste de contrôle d'accès (ACL) de l'hôte (c'est-à-dire le fournisseur de partage). Vous pouvez trouver le nom d'hôte à partir du profil JSON que vous avez téléchargé à l'étape précédente.

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 SQL Worksheet en tant qu'administrateur. Au préalable, extrayez le nom d'hôte de la propriété endpoint 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 :

  • Hôte : spécifie le nom ou l'adresse IP de l'hôte. L'hôte ou le nom de domaine ne respecte pas la casse.
  • Port inférieur : spécifie 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 : spécifie la liste des privilèges réseau à accorder ou à refuser.
  • principal_name : principal (utilisateur ou rôle de base de données) auquel le privilège est accordé ou refusé. Il distingue les majuscules des minuscules.
  • principal_type : spécifie 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 types et packages PL/SQL.

Accordez une ACL à l'utilisateur sur l'adresse ORDS locale. Vous en aurez besoin pour générer des jetons au porteur sur des partages créés localement.
PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

Dans ce processus, vous chargez le profil JSON du fournisseur pour la configuration et les informations d'identification afin de permettre 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 Paramètres du fournisseur de la boîte de dialogue Inscrire le fournisseur de partage, indiquez les détails suivants :La description de l'adresse suivante : subscription-share-provider-version-providersettings.png
    Description de l'illustration subscription-share-provider-version-providersettings.png
    • Nom du fournisseur : Fournisseur.
    • Description : ajoutez une description. Ce champ est facultatif.

    Sous la section Source de partage, choisissez JSON de fournisseur de partage delta.

    Sous le champ JSON Fournisseur de partage, vous pouvez partager le profil JSON des manières suivantes :
    • A partir d'un 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 votre référentiel local et 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 passer à l'onglet Ajouter des partages.
  3. Dans l'onglet Ajouter des partages de la boîte de dialogue, vous pouvez afficher la liste des partages disponibles. Cliquez sur le partage que vous souhaitez utiliser dans les partages disponibles et sélectionnez l'une des options disponibles :La description de l'adresse suivante : subscription-share-provider-version-addshares.png
    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 apparaît lorsque le fournisseur est créé avec succès. Une fois le fournisseur créé, vous pouvez afficher l'écran Lier l'objet cloud de la page Chargement des 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'image link-cloud-object.png
    Description de l'illustration link-cloud-object.png

    Développez le panier du dossier Partager, faites glisser et déposez le fichier que vous partagez de la source vers le panier du lien de données.

    Sélectionnez Démarrer dans le panier de liaison de données pour exécuter le travail de liaison 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 de lancement de Database Actions.
    • Cliquez sur la mosaïque SQL.
    • Sélectionnez la table externe, faites-la glisser dans 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 xt_sql.png
      Description de l'image xt_sql.png

Utiliser un partage en direct

Les données en direct partagées avec vous via le partage de données ne sont pas automatiquement disponibles pour la 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 Paramètres du fournisseur de la boîte de dialogue S'abonner au fournisseur de partage, indiquez les détails suivants :Description de l'image subscription-live-share-provider.png
    Description de l'illustration subscription-live-share-provider.png

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

    Dans le champ Share Provider Details, saisissez les informations suivantes :
    • Nom de fournisseur : indiquez le nom du fournisseur.
    • Description : entrez la 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 pouvez afficher la liste des partages disponibles. Cliquez sur le partage que vous souhaitez utiliser dans les partages disponibles et sélectionnez l'une des options disponibles :Description de l'image add-shares.png
    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 apparaît lorsque le fournisseur est créé avec succès. Une fois le fournisseur créé, vous pouvez afficher l'écran Lier l'objet cloud de la page Chargement des 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'image link-cloud-object.png
    Description de l'illustration link-cloud-object.png

    Développez le panier du dossier Partager, faites glisser et déposez le fichier que vous partagez de la source vers le panier du lien de données.

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

Visualiser les détails de l'entité du fournisseur de partage

Pour afficher les détails de l'entité Fournisseur de partage, cliquez sur l'icône Actions à droite de l'entrée de l'entité Fournisseur de partage, puis cliquez 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.

  • Visualiser les détails : reportez-vous à Visualiser les détails d'une entité de 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 annuler 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 liens : vous êtes redirigé vers la page Données de lien avec l'onglet Partager sélectionné pour afficher 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.