Tutoriel : Partager en dehors de votre organisation - Azure Data Share

Article
12/19/2023

Dans ce tutoriel, vous allez découvrir comment configurer Azure Data Share pour commencer à partager vos données avec des clients et partenaires extérieurs à votre organisation Azure.

Ce didacticiel vous montre comment effectuer les opérations suivantes :

Créer un partage Data Share
Ajouter des jeux de données à votre partage Data Share
Activer une planification d’instantanés pour votre partage Data Share.
Ajouter des destinataires à votre partage Data Share

Prérequis

Abonnement Azure : Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
L’adresse e-mail Azure de vos destinataires (l’utilisation de leur alias de courrier ne fonctionnera pas).
Si le magasin de données Azure source relève d’un autre abonnement Azure que celui que vous allez utiliser pour créer une ressource Data Share, inscrivez le fournisseur de ressources Microsoft.DataShare dans l’abonnement où se trouve le magasin de données Azure.

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.

Vous trouverez ci-dessous la liste des prérequis pour le partage de données à partir d’une source SQL.

Azure SQL Database ou Azure Synapse Analytics (anciennement Azure SQL DW) avec des tables et des vues que vous voulez partager.
Autorisation d’écrire dans les bases de données sur 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 le portail Azure, accédez à SQL Server. Sélectionnez Pare-feu et réseaux virtuels dans le volet de navigation gauche.
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.

- Pool SQL dédié Azure Synapse Analytics (espace de travail) avec les tables que vous souhaitez partager. Le partage de vue n’est actuellement pas pris en charge. Le partage depuis un pool SQL serverless n’est actuellement pas pris 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 SQL Active Directory 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.
```
create user "<share_acct_name>" from external provider;     
exec sp_addrolemember db_datareader, "<share_acct_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 plus tard à 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.

Un cluster Azure Data Explorer avec des bases de données que vous voulez partager.
Autorisation d’écrire sur 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.

Créez une ressource Azure Data Share dans un groupe de ressources Azure.

Sélectionnez le bouton du menu en haut à gauche du portail, puis Créer une ressource (+).
Recherchez Data Share.
Sélectionnez Data Share, puis sélectionnez Créer.

Indiquez les détails de base de votre ressource Azure Data Share à partir des informations suivantes.

Paramètre	Valeur suggérée	Description du champ
Abonnement	Votre abonnement	Sélectionnez l’abonnement Azure à utiliser pour votre compte de partage de données.
Groupe de ressources	testresourcegroup	Utilisez un groupe de ressources existant ou créez-en un.
Emplacement	USA Est 2	Sélectionnez une région pour votre compte de partage de données.
Nom	datashareaccount	Spécifiez un nom pour votre compte de partage de données.

Sélectionnez Vérifier + créer, puis Créer pour créer votre compte de partage de données. En règle générale, la création d’un nouveau compte de partage de données prend environ 2 minutes ou moins.
Une fois le déploiement terminé, sélectionnez Accéder à la ressource.

Créez une ressource Azure Data Share dans un groupe de ressources Azure.

Commencez par préparer votre environnement pour Azure CLI :

Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
- Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
- Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
- Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Utilisez les commandes suivantes pour créer la ressource :

Utilisez la commande az account set pour définir votre abonnement en tant qu’abonnement par défaut actuel :
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
Exécutez la commande az provider register pour inscrire le fournisseur de ressources :
```
az provider register --name "Microsoft.DataShare"
```
Exécutez la commande az group create pour créer un groupe de ressources ou utiliser un groupe de ressources existant :
```
az group create --name testresourcegroup --location "East US 2"
```

Exécutez la commande az datashare account create pour créer un compte Data Share :

az datashare account create --resource-group testresourcegroup --name datashareaccount --location "East US 2"

Exécutez la commande az datashare account list pour afficher vos comptes Data Share :

az datashare account list --resource-group testresourcegroup

Créez une ressource Azure Data Share dans un groupe de ressources Azure.

Commencez par préparer votre environnement pour PowerShell. Vous pouvez exécuter des commandes PowerShell localement ou utiliser l’environnement Bash dans Azure Cloud Shell.

Si vous choisissez d’utiliser Azure PowerShell localement :
- Installez la dernière version du module Az PowerShell.
- Connectez-vous à votre compte Azure à l’aide de la cmdlet Connect-AzAccount.
Si vous choisissez d’utiliser Azure Cloud Shell :
- Pour plus d’informations, consultez Vue d’ensemble d’Azure Cloud Shell.

Utilisez les commandes suivantes pour créer la ressource :

Utilisez la commande Connect-AzAccount pour vous connecter à votre compte Azure.
```
Connect-AzAccount
```
Si vous avez plusieurs abonnements, exécutez la commande Set-AzContext.
```
Set-AzContext [SubscriptionID/SubscriptionName]
```
Exécutez la commande New-AzResourceGroup pour créer un groupe de ressources, ou utilisez un groupe de ressources existant :
```
New-AzResourceGroup -Name <String> -Location <String>
```
Exécutez la commande New-AzDataShare pour créer un compte Data Share :
```
 New-AzDataShareAccount -ResourceGroupName <String> -Name <String> -Location <String>
```
Exécutez la commande Get-AzDataShareAccount pour afficher vos comptes Data Share :
```
Get-AzDataShareAccount
```

Accédez à la page de présentation de votre partage Data Share.
Sélectionnez Start sharing your data (Commencer à partager vos données).
Sélectionnez Create (Créer).
Renseignez les détails de votre partage. Spécifiez un nom, un type de partage, une description du contenu du partage et des conditions d’utilisation (facultatif).
Sélectionnez Continuer.
Pour ajouter des jeux de données à votre partage, sélectionnez Add Datasets (Ajouter des jeux de données).
Sélectionnez le type de jeu de données à ajouter. Vous allez voir apparaître une liste différente de types de jeux de données en fonction du type de partage (instantané ou sur place) que vous avez sélectionné à l’étape précédente. Si vous partagez à partir d’Azure SQL Database ou Azure Synapse Analytics (anciennement Azure SQL DW), vous êtes invité à entrer une méthode d’authentification pour lister les tables. Sélectionnez authentification Microsoft Entra, puis cochez la case Allow Data Share to run the above 'create user' script on my behalf (Autoriser le partage de données à exécuter le script « create user » ci-dessus en mon nom).
Accédez à l’objet à partager, puis sélectionnez Add Datasets (Ajouter des jeux de données).
Sous l’onglet Destinataires, entrez les adresses e-mail de votre consommateur de données en sélectionnant + Add Recipient (Ajouter un destinataire).
Sélectionnez Continuer.
Si vous avez sélectionné le type de partage d’instantané, vous pouvez configurer la planification d’instantanés pour fournir des mises à jour de vos données à votre consommateur de données.
Sélectionnez une heure de début et un intervalle de périodicité.
Sélectionnez Continuer.
Sous l’onglet Review + Create (Revoir + Créer), passez en revue le contenu du package, les paramètres, les destinataires ainsi que les paramètres de synchronisation. Sélectionnez Create (Créer).

Exécutez la commande az storage account create pour créer un compte de stockage pour ce partage Data Share :
```
az storage account create --resource-group testresourcegroup --name ContosoMarketplaceAccount
```
Utilisez la commande az storage container create pour créer un conteneur dans le compte de stockage créé dans la commande précédente :
```
az storage container create --name ContosoMarketplaceContainer --account-name ContosoMarketplaceAccount
```

Exécutez la commande az datashare create pour créer votre partage Data Share :

az datashare create --resource-group testresourcegroup \
  --name ContosoMarketplaceDataShare --account-name ContosoMarketplaceAccount \
  --description "Data Share" --share-kind "CopyBased" --terms "Confidential"

Utilisez la commande az datashare invitation create pour créer l’invitation pour l’adresse spécifiée :

az datashare invitation create --resource-group testresourcegroup \
  --name DataShareInvite --share-name ContosoMarketplaceDataShare \
  --account-name ContosoMarketplaceAccount --target-email "jacob@fabrikam.com"

Si vous n’avez pas encore de données à partager, vous pouvez suivre ces étapes pour créer un compte de stockage. Si vous avez déjà un stockage, vous pouvez passer à l’étape 2.
1. Exécutez la commande New-AzStorageAccount pour créer un compte stockage Azure :
```
$storageAccount = New-AzStorageAccount -ResourceGroupName <String> -AccountName <String> -Location <String> -SkuName <String>

$ctx = $storageAccount.Context
```
2. Exécutez la commande New-AzStorageContainer pour créer un conteneur dans votre nouveau compte de stockage Azure qui contiendra vos données :
```
$containerName = <String>

New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob
```
3. Exécutez la commande Set-AzStorageBlobContent pour charger un fichier. L’exemple suivant charge textfile.csv à partir du dossier D:\testFiles de la mémoire locale vers le conteneur que vous avez créé.
```
Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
```
Pour plus d’informations sur l’utilisation du stockage Azure dans PowerShell, suivez ce guide.

Exécutez la commande New-AzDataShare pour créer votre Data Share :

New-AzDataShare -ResourceGroupName <String> -AccountName <String> -Name <String> -Description <String> -TermsOfUse <String>

Utilisez la commande New-AzDataShareInvitation pour créer l’invitation pour l’adresse spécifiée :

New-AzDataShareInvitation -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -TargetEmail <String>

Utilisez la commande New-AzDataShareSynchronizationSetting pour définir une périodicité de synchronisation pour votre partage. Elle peut être quotidienne, horaire ou à un moment spécifique.
```
New-AzDataShareSynchronizationSetting -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -RecurrenceInterval <String> -SynchronizationTime <DateTime>
```

Votre partage Azure Data Share est désormais créé. Le destinataire de votre partage Data Share est maintenant prêt à accepter votre invitation.

Nettoyer les ressources

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

Étapes suivantes

Dans ce tutoriel, vous avez appris à créer un partage Azure Data Share et à inviter des destinataires. Pour découvrir comment un consommateur de données peut accepter et recevoir un partage de données, passez au tutoriel Accepter et recevoir des données.

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

Partager via

Prérequis

Nettoyer les ressources

Étapes suivantes

Commentaires

Ressources supplémentaires

Partager via

Tutoriel : Partagez des données avec Azure Data Share

Prérequis

Partager à partir d’un compte de stockage

Partager à partir d’une source SQL

Prérequis pour le partage depuis Azure SQL Database ou Azure Synapse Analytics (anciennement Azure SQL DW)

Prérequis pour le partage depuis un pool SQL Azure Synapse Analytics (espace de travail)

Partager depuis Azure Data Explorer

Connectez-vous au portail Azure.

Créer un compte Data Share

Créer un partage

Nettoyer les ressources

Étapes suivantes

Commentaires

Ressources supplémentaires