Events
Take the Microsoft Learn Challenge
19 Nov, 23 - 10 Jan, 23
Ignite Edition - Build skills in Microsoft security products and earn a digital badge by January 10!
Register nowThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Important
This feature is currently being retired, with support provided until September 2025 to allow for migration to Microsoft Fabric external data sharing.
This article provides a quick guide on how to share data and receive shares from Azure Data Lake Storage (ADLS Gen2) or Blob storage accounts.
Important
Data sharing is accessed through the classic Microsoft Purview governance portal: https://web.purview.azure.com
Note
This registration is only needed the first time when sharing or receiving data into a storage account in the Azure subscription.
Here are required roles for sharing data and receiving shares.
Azure Storage account roles | Microsoft Purview collection roles | |
---|---|---|
Data provider | One of the following roles:
|
Data Reader |
Data consumer | One of the following roles:
|
Data Reader |
Note
If you created the Microsoft Purview account, you're automatically assigned all the roles to the root collection. Refer to Microsoft Purview permissions to learn more about the Microsoft Purview collection and roles.
There are two ways you can create a data share:
You can create a share by starting from Data Catalog
Within the classic Microsoft Purview governance portal or the new Microsoft Purview portal, find the Azure Storage or Azure Data Lake Storage (ADLS) Gen 2 data asset you would like to share data from using either the data catalog search or browse.
Once you have found your data asset, select the Data Share button.
Select +New Share.
Follow the rest of the steps to create your data share.
If you're using the new Microsoft Purview experience You can create a share by starting from the Data Catalog.
Open the Microsoft Purview portal. Navigate to the Data Catalog application. Then select Shares from the left navigation. Select +New Share.
If you're using the classing Microsoft Purview experience You can create a share by starting from the Data Map.
Open the Microsoft Purview governance portal. Select the Data Map icon from the left navigation. Then select Shares. Select +New Share.
From either location, select the Storage account type and the Storage account you want to share data from. Then select Continue.
Follow the rest of the steps to create your data share.
Specify a name and a description of share contents (optional). Then select Continue.
Search for and add all the assets you'd like to share out at the container, folder, or file level, and then select Continue.
You can edit the display names the shared data will have, if you like. Then select Continue.
Select Add Recipient and select User or App.
To share data to a user, select User, then enter the Azure sign-in email address of who you want to share data with. By default, the option to enter email address of user is shown.
To to share data with a service principal, select App. Enter the object ID and tenant ID of the recipient you want to share data with.
Select Create and Share. Optionally, you can specify an Expiration date for when to terminate the share. You can share the same data with multiple recipients by selecting Add Recipient multiple times.
You've now created your share. The recipients of your share will receive an invitation and they can view the pending share in their Microsoft Purview account.
You can view your share invitations in any Microsoft Purview account. Open the Microsoft Purview governance portal by browsing directly to the classic portal or the new Microsoft Purview portal and selecting your Microsoft Purview account.
In the classic portal, select the Data Map icon from the left navigation. In the new portal, navigate to the Data Catalog application.
Select Share invites. If you received an email invitation, you can also select the View share invite link in the email to select a Microsoft Purview account.
If you're a guest user of a tenant, you'll be asked to verify your email address for the tenant before viewing share invitation for the first time. You can see our guide for steps. Once verified, it's valid for 12 months.
Alternately, within the Microsoft Purview portal, find the Azure Storage or Azure Data Lake Storage (ADLS) Gen 2 data asset you would like to receive the share into using either the data catalog search or browse. Select the Data Share button. You can see all the invitations in the Share invites tab.
Select name of the share to view or configure.
If you don't want to accept the invitation, select Delete.
Note
If you delete an invitation, if you want to accept the share in future it will need to be resent. To deselect the share without deleting select the Cancel button instead.
You can edit the Received share name if you like. Then select a Storage account name for a target storage account in the same region as the source. You can choose to Register a new storage account to attach the share in the drop-down as well.
Important
The target storage account needs to be in the same Azure region as the source storage account.
Configure the Path (either a new container name, or the name of an existing share container) and, New folder (a new folder name for the share within in your container).
Select Attach to target.
On the Manage data shares page, you'll see the new share with the status of Attaching until it has completed and is attached.
You can access shared data from the target storage account through Azure portal, Azure Storage Explorer, Azure Storage SDK, PowerShell or CLI. You can also analyze the shared data by connecting your storage account to Azure Synapse Analytics Spark or Databricks.
To clean up the resources created for the quick start, follow the steps below:
To troubleshoot issues with sharing data, refer to the troubleshooting section of the how to share data article. To troubleshoot issues with receiving share, refer to the troubleshooting section of the how to receive shared data article.
Events
Take the Microsoft Learn Challenge
19 Nov, 23 - 10 Jan, 23
Ignite Edition - Build skills in Microsoft security products and earn a digital badge by January 10!
Register now