Tutoriel : Accepter et recevoir des données avec Azure Data Share

  • Article

Dans ce tutoriel, vous apprenez à accepter une invitation de partage de données en utilisant Azure Data Share. Vous apprenez à recevoir les données qui ont été partagées avec vous et à activer un intervalle d’actualisation régulier pour avoir toujours le dernier instantané des données partagées.

  • Guide pratique pour accepter une invitation Azure Data Share
  • Créer un compte Azure Data Share
  • Spécifier une destination pour vos données
  • Créer un abonnement à votre partage de données pour l’actualisation planifiée

Prérequis

Avant de pouvoir accepter une invitation de partage de données, vous devez créer des ressources Azure, listées ci-dessous.

Vérifiez que tous les prérequis sont remplis avant d’accepter une invitation de partage de données.

  • Abonnement Azure : Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
  • Invitation Data Share : Invitation de Microsoft Azure dont l’objet est « Invitation Azure Data Share de yourdataprovider@domain.com ».
  • Inscrivez le fournisseur de ressources Microsoft.DataShare dans l’abonnement Azure où vous allez créer une ressource de partage de données et dans l’abonnement Azure où se trouvent vos magasins de données Azure cibles.

Recevoir des données dans un compte de stockage

  • Compte Stockage Azure : Si vous n’en avez pas déjà, vous pouvez créer un compte Stockage Azure.
  • Autorisation d’écrire dans le compte de stockage, qui est présent dans Microsoft.Storage/storageAccounts/write. Cette autorisation existe dans le rôle Contributeur de compte de stockage.
  • Autorisation d’ajouter l’attribution de rôle au compte de stockage, qui est présente dans Microsoft.Authorization/role assignments/write. Cette autorisation existe dans le rôle Propriétaire.

Recevoir des données dans une cible basée sur SQL

Si vous choisissez de recevoir des données dans Azure SQL Database, Azure Synapse Analytics, vous trouverez ci-dessous la liste des conditions préalables.

Prérequis pour la réception de données dans Azure SQL Database ou Azure Synapse Analytics (anciennement Azure SQL DW)

  • Azure SQL Database ou Azure Synapse Analytics (anciennement Azure SQL DW).
  • Autorisation d’écrire dans les bases de données sur le serveur SQL Server, qui est présente dans Microsoft.Sql/servers/databases/write. Cette autorisation existe dans le rôle Contributeur.
  • Administrateur Microsoft Entra du serveur SQL
  • Accès au pare-feu SQL Server. Pour ce faire, procédez comme suit :
    1. Dans SQL Server, dans le portail Azure, accédez à Pare-feux et réseaux virtuels
    2. Sélectionnez Oui pour Autoriser les services et les ressources Azure à accéder à ce serveur.
    3. Sélectionnez +Ajouter une adresse IP cliente. Cette adresse IP est susceptible d’être modifiée. Il peut être nécessaire de répéter ce processus la prochaine fois que vous partagerez des données SQL à partir du portail Azure. Vous pouvez également ajouter une plage d’adresses IP.
    4. Sélectionnez Enregistrer.

Prérequis pour la réception de données dans un pool SQL Azure Synapse Analytics (espace de travail)

  • Pool SQL dédié Azure Synapse Analytics (espace de travail). La réception de données dans un pool SQL serverless n’est actuellement pas prise en charge.

  • Autorisation d’écrire dans le pool SQL de l’espace de travail Synapse, qui est présent dans Microsoft.Synapse/workspaces/sqlPools/write. Cette autorisation existe dans le rôle Contributeur.

  • Autorisation permettant à l’identité managée de la ressource Data Share d’accéder au pool SQL de l’espace de travail Synapse. Pour ce faire, procédez comme suit :

    1. Dans le portail Azure, accédez à l’espace de travail Synapse. Sélectionnez Administrateur Microsoft Entra dans le volet de navigation gauche et attribuez-vous le rôle Administrateur Microsoft Entra.

    2. Ouvrez Synapse Studio et sélectionnez Gérer dans le volet de navigation gauche. Sélectionnez Contrôle d’accès sous Sécurité. Attribuez-vous le rôle Administrateur SQL ou Administrateur d’espace de travail.

    3. Dans Synapse Studio, sélectionnez Développer dans le volet de navigation gauche. Exécutez le script suivant dans le pool SQL pour ajouter l’identité managée de la ressource Data Share en tant que « db_datareader, db_datawriter, db_ddladmin ».

      create user "<share_acc_name>" from external provider; 
exec sp_addrolemember db_datareader, "<share_acc_name>"; 
exec sp_addrolemember db_datawriter, "<share_acc_name>"; 
exec sp_addrolemember db_ddladmin, "<share_acc_name>";

      <share_acc_name> est le nom de votre ressource Data Share. Si vous n’avez pas encore créé de ressource Data Share, vous pouvez revenir à cette condition requise.

  • Accès au pare-feu de l’espace de travail Synapse. Pour ce faire, procédez comme suit :

    1. Dans le portail Azure, accédez à l’espace de travail Synapse. Sélectionnez Pare-feu dans le volet de navigation gauche.
    2. Sélectionnez ON pour Autoriser les services et ressources Azure à accéder à cet espace de travail.
    3. Sélectionnez +Ajouter une adresse IP cliente. Cette adresse IP est susceptible d’être modifiée. Il peut être nécessaire de répéter ce processus la prochaine fois que vous partagerez des données SQL à partir du portail Azure. Vous pouvez également ajouter une plage d’adresses IP.
    4. Sélectionnez Enregistrer.

Recevez des données dans un cluster Azure Data Explorer :

  • Un cluster Azure Data Explorer dans le même centre de données Azure que le cluster Data Explorer du fournisseur de données : Si vous n’en avez pas déjà un, vous pouvez créer un cluster Azure Data Explorer. Si vous ne connaissez pas le centre de données Azure du cluster du fournisseur de données, vous pouvez créer le cluster plus tard dans le processus.
  • Autorisation d’écrire dans le cluster Azure Data Explorer, qui est présente dans Microsoft.Kusto/clusters/write. Cette autorisation existe dans le rôle Contributeur.

Connectez-vous au portail Azure.

Connectez-vous au portail Azure.

Ouvrir l’invitation

  1. Vous pouvez ouvrir une invitation à partir d’un e-mail, ou directement à partir du portail Azure.

    Pour ouvrir une invitation à partir d’un e-mail, recherchez dans votre boîte de réception une invitation émanant de votre fournisseur de données. L’invitation provient de Microsoft Azure et s’intitule Invitation Azure Data Share de yourdataprovider@domain.com . Sélectionnez Afficher l’invitation pour voir votre invitation dans Azure.

    Pour ouvrir l’invitation directement à partir du portail Azure, recherchez Invitations Azure Data Share dans le portail Azure. Cette action vous dirige vers la liste des invitations Data Share.

    Si vous êtes utilisateur invité d’un locataire, il vous est demandé de vérifier votre adresse e-mail pour le locataire avant d’afficher l’invitation Data Share pour la première fois. Une fois la vérification effectuée, elle est valide pendant 12 mois.

    Liste d’invitations

  2. Sélectionnez l’invitation que vous souhaitez afficher.

Accepter l’invitation

  1. Veillez à passer en revue tous les champs, notamment les Conditions d’utilisation. Si vous acceptez les conditions d’utilisation, vous devez cocher la case indiquant que vous donnez votre accord.

    Conditions d’utilisation

  2. Sous Target Data Share Account (Compte Data Share cible), sélectionnez l’abonnement et le groupe de ressources à utiliser pour le déploiement de votre partage de données.

    Pour le champ Data Share Account (Compte Data Share), sélectionnez Create new (Créer) si vous n’avez pas de compte Data Share existant. Sinon, sélectionnez un compte Data Share existant dans lequel vous souhaitez accepter votre partage de données.

    Pour le champ Nom de partage reçu, vous pouvez conserver la valeur par défaut spécifiée par le fournisseur de données ou en spécifier un nouveau.

    Une fois que vous avez accepté les conditions d’utilisation et spécifié un compte Data Share pour gérer votre partage reçu, sélectionnez Accepter et configurer. Un abonnement de partage est créé.

    Options d’acceptation

    Cette action vous dirige vers le partage reçu dans votre compte Data Share.

    Si vous ne souhaitez pas accepter l’invitation, sélectionnez Reject (Rejeter).

Configurer un partage reçu

Suivez les étapes ci-dessous pour configurer l’emplacement où vous souhaitez recevoir les données.

  1. Sélectionnez l’onglet Jeux de données. Cochez la case en regard du jeu de données auquel vous souhaitez affecter une destination. Sélectionnez + Mapper à la cible pour choisir un magasin de données cible.

    Mapper à la cible

  2. Sélectionnez un type de magasin de données cible dans lequel vous souhaitez que les données arrivent. Tous les fichiers de données ou les tables dans le magasin de données cible ayant le même chemin et le même nom seront remplacés. Si vous recevez des données dans Azure SQL Database ou Azure Synapse Analytics (anciennement Azure SQL DW), cochez la case Autoriser Data Share à exécuter le script « Créer un utilisateur » ci-dessus en mon nom.

    Pour les partages sur place, sélectionnez un magasin de données à l’emplacement spécifié. L’emplacement est le centre de données Azure où se trouve le magasin de données source du fournisseur de données. Une fois le jeu de données mappé, vous pouvez suivre le lien dans le chemin cible pour accéder aux données.

    Compte de stockage cible

  3. Pour le partage basé sur un instantané, si le fournisseur de données a créé une planification d’instantané pour fournir une mise à jour régulière des données, vous pouvez également activer la planification des instantanés en sélectionnant l’onglet Planification d’instantanés. Cochez la case en regard de la planification d’instantané et sélectionnez + Activer. Le premier instantané planifié démarre dans un délai d’une minute après l’heure planifiée et que les instantanés suivants démarrent quelques secondes après l’heure planifiée.

    Activer la planification d’instantanés

    Les métadonnées des fichiers copiés ne sont pas conservées après chaque exécution. C'est la procédure normale.

Déclencher une capture instantanée

Ces étapes s’appliquent seulement au partage basé sur des instantanés.

  1. Vous pouvez déclencher un instantané en sélectionnant l’onglet Détails puis Déclencher un instantané. Ici, vous pouvez déclencher une capture instantanée complète ou incrémentielle de vos données. Si vous recevez des données de votre fournisseur de données pour la première fois, sélectionnez l’option de copie complète.

    Déclencher un instantané

  2. Une fois que le dernier état d’exécution est Réussi, accédez au magasin de données cible pour voir les données reçues. Sélectionnez Jeux de données, puis sélectionnez le lien dans le chemin cible.

    Jeux de données consommateur

Afficher l’historique

Cette étape s’applique uniquement au partage basé sur un instantané. Pour afficher l’historique de vos instantanés, sélectionnez l’onglet Historique. Vous trouverez ici un historique de tous les instantanés générés au cours des 30 derniers jours.

Nettoyer les ressources

Quand la ressource n’est plus nécessaire, accédez à la page Vue d’ensemble du partage de données, puis sélectionnez Supprimer pour le supprimer.

Étapes suivantes

Dans ce tutoriel, vous avez découvert comment accepter et recevoir un partage Azure Data Share. Pour en savoir plus sur les concepts liés à Azure Data Share, consultez la terminologie Azure Data Share.

Concepts d’Azure Data Share