Utiliser un partage

Une fois que les fournisseurs partagent les objets, les destinataires doivent suivre quelques étapes pour consommer le partage.

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

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

  • Consommer le 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 sur vos partages. L'outil Partage de données autorise l'accès à l'aide du profil JSON envoyé au destinataire à l'aide du courriel 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 destinataire peut exécuter le travail de liaison de données et accéder aux objets partagés par le fournisseur.

  • Consommer le partage en direct :

    Vous pouvez ainsi, en tant que destinataire, utiliser les données actives de la base de données.

  • Afficher les détails de l'entité du fournisseur de partage :

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

Présentation de l'utilisation du 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.

Pour accéder à la page Consommer le partage, effectuez l'une des opérations suivantes :
  • Dans le menu Data Studio, sélectionnez Consommer le partage dans 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 le partage contient :Description de l'image consumer-share-new.png ci-après
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.

Consommer le partage avec versions

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.

Vous devez effectuer plusieurs étapes de base pour vous abonner aux partages de données fournis et y accéder. Voici les étapes à suivre :
  • 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 sur 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 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.



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 :

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

Vous pouvez cliquer une seule fois sur le bouton Obtenir des informations de profil et afficher 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. En cliquant deux fois dessus, un écran 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 publié.
  • 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 sur le jeton de support si vous utilisez le partage à l'aide d'Oracle.
  • bearerToken : chaîne cryptée générée par le serveur d'authentification en réponse à une demande de connexion.
  • expirationTime : temps nécessaire à l'expiration de l'authentification.
  • ClientID : indique l'identificateur public généré par le serveur d'authentification lors de l'inscription de l'instance pour authentification.
  • clientSecret : indique l'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 fichier JSON ci-dessous pour souscrire à 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

Cela doit être fait 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 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.

Accordez une liste de contrôle d'accès à 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 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'image souscrire-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.

    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'image souscrire-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 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'image link-cloud-object.png
    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'image xt_sql.png
      Description de l'illustration xt_sql.png

Consommer le partage en direct

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'image souscrire-live-share-provider.png
    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'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 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'image link-cloud-object.png
    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.

Afficher 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 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.