Merge pull request #94285 from MicrosoftDocs/release-ignite-azure-data-share

Ignite

Author: SyntaxC4

articles/data-share/TOC.yml

@@ -1,9 +1,11 @@
-- name: Azure Data Share Preview Documentation
+- name: Azure Data Share Documentation
   href: index.yml
 - name: Overview
   items:
-  - name: What is Azure Data Share Preview?
+  - name: What is Azure Data Share?
     href: overview.md
+  - name: Supported data stores 
+    href: supported-data-stores.md
 - name: Tutorials
   expanded: true
   items:
@@ -19,6 +21,8 @@
     href: concepts-roles-permissions.md
 - name: Samples
   items:
+  - name: Code samples
+    href: https://docs.microsoft.com/samples/browse/?service=data-share/
   - name: Azure Powershell
     href: samples-powershell.md
 - name: How-to guides
@@ -52,7 +56,7 @@
   - name: Stack Overflow 
     href: https://stackoverflow.com/questions/tagged/azure-data-share
   - name: Blog
-    href: https://azure.microsoft.com/blog/announcing-preview-of-azure-data-share/
+    href: https://techcommunity.microsoft.com/t5/Azure-Data-Share/bg-p/AzureDataShareBlog
   - name: Microsoft Tech Community
     href: https://techcommunity.microsoft.com/
   - name: Product feedback

articles/data-share/concepts-roles-permissions.md

@@ -1,35 +1,39 @@
 ---
-title: Roles and requirements for Azure Data Share Preview  
-description: Learn about the access control roles and requirements for data providers and data consumers to share data in Azure Data Share Preview.
+title: Roles and requirements for Azure Data Share   
+description: Learn about the access control roles and requirements for data providers and data consumers to share data in Azure Data Share.
 author: joannapea
 ms.author: joanpo
 ms.service: data-share
 ms.topic: conceptual
 ms.date: 07/10/2019
 ---
 
-# Roles and requirements for Azure Data Share Preview
+# Roles and requirements for Azure Data Share 
 
-This article describes the roles required to share data using Azure Data Share Preview, as well as to accept and receive data using Azure Data Share Preview. 
+This article describes the roles required to share data using Azure Data Share, as well as to accept and receive data using Azure Data Share. 
 
 ## Roles and requirements
 
 Azure Data Share uses Managed Identities for Azure Services (previously known as MSIs) to authenticate to underlying storage accounts in order to be able to read data to be shared by a data provider, as well as receive data shared as a data consumer. As a result, there is no exchange of credentials between the data provider and the data consumer. 
 
-The Managed Service Identity needs to be granted access to the underlying storage accounts. The Azure Data Share service uses the Azure Data Share resource's Managed Service Identity to read and write data. The user of Azure Data Share needs the ability to create a role assignment for the Managed Service Identity to the storage account that they are sharing data from/to. Permission to create role assignments exists in the **owner** role, User Access Administrator role, or a custom role with Microsoft.Authorization/role assignments/write permission assigned. 
+The Managed Service Identity needs to be granted access to the underlying storage account or SQL database. The Azure Data Share service uses the Azure Data Share resource's Managed Service Identity to read and write data. The user of Azure Data Share needs the ability to create a role assignment for the Managed Service Identity to the storage account or SQL database that they are sharing data from/to. 
+
+In the case of storage, Permission to create role assignments exists in the **owner** role, User Access Administrator role, or a custom role with Microsoft.Authorization/role assignments/write permission assigned. 
 
 If you are not an owner of the storage account in question, and you are unable to create a role assignment for the Azure Data Share resource's Managed Identity yourself, you can request an Azure Administrator to create a role assignment on your behalf. 
 
 Below is a summary of the roles assigned to Data Share resource-Managed Identity:
 
 | |  |  |
 |---|---|---|
-|**Storage Type**|**Data Provider Source Storage Account**|**Data Consumer Target Storage Account**|
+|**Storage Type**|**Data Provider Store**|**Data Consumer Target Store**|
 |Azure Blob Storage| Storage Blob Data Reader | Storage Blob Data Contributor
 |Azure Data Lake Gen1 | Owner | Not Supported
 |Azure Data Lake Gen2 | Storage Blob Data Reader | Storage Blob Data Contributor
+|Azure SQL | dbo | dbo 
 |
-### Data Providers 
+
+### Data providers 
 To add a dataset to an Azure Data Share, the data providers data share resource-managed identity needs to be added to the Storage Blob Data Reader role. This is done automatically by the Azure Data Share service if the user is adding datasets via Azure and is an owner of the storage account, or is a member of a custom role that has the Microsoft.Authorization/role assignments/write permission assigned. 
 
 Alternatively, the user can have an Azure Administrator add the data share resource-managed identity to the Storage Blob Data Reader role manually. Creating this role assignment manually by the Administrator will void having to be an owner of the Storage account or have a custom role assignment. This applies to data being shared from Azure Storage or Azure Data Lake Gen2. 
@@ -45,8 +49,12 @@ To create a role assignment for the Data Share resource's Managed Identity, foll
 1. Under *Select*, type in the name of your Azure Data Share account.
 1. Click *Save*.
 
-### Data Consumers
-To receive data, the data consumers data share resource-managed identity needs to be added to the Storage Blob Data Contributor role. This role is required to enable the Azure Data Share service to be able to write to the storage account. This is done automatically by the Azure Data Share service if the user is adding datasets via Azure and is an owner of the storage account, or is a member of a custom role which has the Microsoft.Authorization/role assignments/write permission assigned. 
+For SQL-based sources, a user needs to be created from an external provider in the SQL database that data is being shared from with the same name as the Azure Data Share account. A sample script along with other prerequisites for SQL-based sharing can be found in the [share your data](share-your-data.md) tutorial. 
+
+### Data consumers
+To receive data, the data consumers data share resource-managed identity needs to be added to the Storage Blob Data Contributor role and/or dbo role of a SQL database if receiving data into a SQL database. 
+
+In the case of storage, this is done automatically by the Azure Data Share service if the user is adding datasets via Azure and is an owner of the storage account, or is a member of a custom role which has the Microsoft.Authorization/role assignments/write permission assigned. 
 
 Alternatively, the user can have an Azure Administrator add the data share resource-managed identity to the Storage Blob Data Contributor role manually. Creating this role assignment manually by the Administrator will void having to be an owner of the Storage account or have a custom role assignment. Note that this applies to data being shared to Azure Storage or Azure Data Lake Gen2. Receiving data to Azure Data Lake Gen1 is not supported. 
 
@@ -61,9 +69,11 @@ To create a role assignment for the Data Share resource's Managed Identity manua
 
 If you are sharing data using our REST APIs, you will need to create these role assignments manually by adding the data share account in to the appropriate roles. 
 
+If you are receiving data into a SQL-based source, ensure that a new user is created from an external provider with the same name as your Azure Data Share account. See prerequisites in [accept and receive data](subscribe-to-data-share.md) tutorial. 
+
 To learn more about how to add a role assignment, refer to [this documentation,](https://docs.microsoft.com/azure/role-based-access-control/role-assignments-portal#add-a-role-assignment) which outlines how to add a role assignment to an Azure resource. 
 
-## Resource Provider registration 
+## Resource provider registration 
 
 When accepting an Azure Data Share invitation, you will need to manually register the Microsoft.DataShare resource provider in to your subscription. Follow these steps to register the Microsoft.DataShare resource provider into your Azure Subscription. 
 

articles/data-share/data-share-troubleshoot.md

@@ -1,6 +1,6 @@
 ---
-title: Troubleshoot Azure Data Share Preview
-description: Learn how to troubleshoot issues with invitations and errors when creating or receiving data shares with Azure Data Share Preview.
+title: Troubleshoot Azure Data Share 
+description: Learn how to troubleshoot issues with invitations and errors when creating or receiving data shares with Azure Data Share.
 services: data-share
 author: joannapea
 ms.author: joanpo
@@ -9,9 +9,9 @@ ms.topic: troubleshooting
 ms.date: 07/10/2019
 ---
 
-# Troubleshoot common issues in Azure Data Share Preview
+# Troubleshoot common issues in Azure Data Share 
 
-This article shows how to troubleshoot common issues for Azure Data Share Preview. 
+This article shows how to troubleshoot common issues for Azure Data Share. 
 
 ## Azure Data Share invitations 
 
@@ -51,6 +51,20 @@ If you receive any of the above errors when creating a new data share or receivi
 1. Click **Add**
 1. Add yourself in as owner.
 
+## Troubleshooting SQL-based sharing
+
+"Error: x datasets were not added because you do not have the required permissions to share."
+
+If you receive this error when adding a dataset from a SQL-based source, it may be because you did not create a user for the Azure Data Share MSI on your SQL Server.  To resolve this issue, run the following script:
+
+```sql
+    create user <share_acct_name> from external provider;     
+    exec sp_addrolemember db_owner, <share_acct_name>; 
+```      
+Note that the *<share_acc_name>* is the name of your Data Share Account. If you have not created a Data Share account as yet, you can come back to this pre-requisite later.         
+
+Ensure that you have followed all prerequisites listed in [Share your data](share-your-data.md) tutorial.
+
 ## Next steps
 
 To learn how to start sharing data, continue to the [share your data](share-your-data.md) tutorial.

articles/data-share/how-to-add-datasets.md

@@ -1,22 +1,22 @@
 ---
-title: Add datasets to an existing Azure Data Share Preview
-description: Learn how to add datasets to an existing data share in Azure Data Share and share with the same recipients. 
+title: Add datasets to an existing Azure Data Share 
+description: Learn how to add datasets to an existing data share in Azure Data Share and share with the same recipients.
 author: joannapea
 ms.author: joanpo
 ms.service: data-share
 ms.topic: conceptual
 ms.date: 07/10/2019
 ---
 
-# How to add datasets to an existing share in Azure Data Share Preview
+# How to add datasets to an existing share in Azure Data Share
 
-This article explains how to add datasets to a pre-existing data share using Azure Data Share Preview. This allows you to share more data with the same recipients without having to create a new share.
+This article explains how to add datasets to a pre-existing data share using Azure Data Share. This allows you to share more data with the same recipients without having to create a new share.
 
 For information on how to add datasets as you create a share, see the [Share data](share-your-data.md) tutorial.
 
 ## Navigate to a sent data share
 
-In Azure Data Share Preview, navigate to your sent share and select the **Datasets** tab. Click **+ Add Datasets** button to add more datasets.
+In Azure Data Share, navigate to your sent share and select the **Datasets** tab. Click **+ Add Datasets** button to add more datasets.
 
 ![Add Datasets](./media/how-to/how-to-add-datasets/add-datasets.png)
 

articles/data-share/how-to-add-recipients.md

@@ -1,21 +1,21 @@
 ---
-title: Add recipients in Azure Data Share Preview
-description: Learn how to add recipients to an existing data share in Azure Data Share preview.
+title: Add recipients in Azure Data Share 
+description: Learn how to add recipients to an existing data share in Azure Data Share.
 author: joannapea
 ms.author: joanpo
 ms.service: data-share
 ms.topic: conceptual
 ms.date: 07/10/2019
 ---
-# How to add a recipient to an existing data share in Azure Data Share Preview
+# How to add a recipient to an existing data share in Azure Data Share
 
-This article will show you how to add recipients to a pre-existing data share. 
+This article will show you how to add recipients to a pre-existing data share.
 
 For information on how to add recipients as you create a share, see the [Share data](share-your-data.md) tutorial.
 
 ## Navigate to a sent data share
 
-In Azure Data Share Preview, navigate to your sent share and select the **Invitations** tab. Listed here are all of the recipients of invitations to this data share. To add a new one, click **Add Recipient**.
+In Azure Data Share, navigate to your sent share and select the **Invitations** tab. Listed here are all of the recipients of invitations to this data share. To add a new one, click **Add Recipient**.
 
 ![Add Recipient](./media/how-to/how-to-add-recipients/add-recipient.png)
 

articles/data-share/how-to-configure-mapping.md

@@ -1,31 +1,37 @@
 ---
-title: Configure a dataset mapping in Azure Data Share Preview
-description: Learn how to configure a dataset mapping for a received share using Azure Data Share Preview.
+title: Configure a dataset mapping in Azure Data Share
+description: Learn how to configure a dataset mapping for a received share using Azure Data Share.
 author: joannapea
 ms.author: joanpo
 ms.service: data-share
 ms.topic: conceptual
 ms.date: 07/10/2019
 ---
-# How to configure a dataset mapping for a received share in Azure Data Share Preview
+# How to configure a dataset mapping for a received share in Azure Data Share
 
-This article explains how to configure a dataset mapping for a Received Share using Azure Data Share Preview. You'll want to do this if you accepted a data share invitation but opted to "Accept and configure later". Otherwise, you may simply want to change the destination storage account for your received data. 
+This article explains how to configure a dataset mapping for a Received Share using Azure Data Share. You'll want to do this if you accepted a data share invitation but opted to "Accept and configure later". You may want to configure a dataset mapping if you need to change the destination for data being shared with you, or if you want to receive data into a SQL Server. 
 
 ## Navigate to a received data share
 
 In the Azure Data Share service, navigate to your received share and select the **Details** tab. 
 
 ![Dataset mapping](./media/dataset-mapping.png "Dataset mapping") 
 
-Check the box next to the dataset you'd like to assign a destination to, and click **+ Map to target**. You may need to unmap first if you had already configured a destination storage account and you want to change the mapping to a different storage account. 
+Check the box next to the dataset you'd like to assign a destination to. Select **Unmap** to unmap the existing mapping. Select **+ Map to target** to choose a new destination store. 
 
 ![Map to target](./media/dataset-map-target.png "Map to target") 
 
-## Select a new storage account 
+## Select a new destination store
 
-Select a storage account that you'd like the data to land in. Note that any data that already exists in any previously mapped storage accounts will not be automatically moved to the new storage account.
+Select a target data type that you'd like the data to land in. Note that any data that already exists in any previously mapped storage accounts will not be automatically moved to the new destination.
 
-![Target storage account](./media/map-target.png "Target storage") 
+![Target storage account](./media/dataset-map-target-sql.png "Target storage") 
+
+## Select a file format (SQL sources only)
+
+If the source data is from a SQL-based source, you can choose which format it is received in. 
+
+![Choose format](./media/sql-file-formats.png "SQL file formats")
 
 ## Next steps
 

articles/data-share/how-to-delete-invitation.md

@@ -1,19 +1,19 @@
 ---
-title: Delete an invitation in Azure Data Share Preview
-description: Learn how to delete an invitation to a data share recipient in Azure Data Share Preview.
+title: Delete an invitation in Azure Data Share 
+description: Learn how to delete an invitation to a data share recipient in Azure Data Share.
 author: joannapea
 ms.author: joanpo
 ms.service: data-share
 ms.topic: conceptual
 ms.date: 07/10/2019
 ---
-# How to delete an invitation to a recipient in Azure Data Share Preview
+# How to delete an invitation to a recipient in Azure Data Share
 
 This article explains how to delete an invitation to a recipient before they accept it. This will prevent them from creating a share subscription and they will never receive any shared data. If you delete the invitation to a consumer who has already created a share subscription, deleting their invitation won't have any impact.
 
 ## Navigate to a sent data share
 
-In Azure Data Share Preview, navigate to your sent share and select the **Invitations** tab. Listed here are all of the recipients of invitations to this data share. Click the boxes next to the recipients whose invitations you would like to delete and then click **Delete**.
+In Azure Data Share, navigate to your sent share and select the **Invitations** tab. Listed here are all of the recipients of invitations to this data share. Click the boxes next to the recipients whose invitations you would like to delete and then click **Delete**.
 
 ![Delete Invitation](./media/how-to/how-to-delete-invitation/delete-invitation.png)
 

articles/data-share/how-to-monitor.md

@@ -1,15 +1,16 @@
 ---
-title: How to monitor Azure Data Share Preview
-description: Learn how to monitor invitation status, share subscriptions, and snapshot history in Azure Data Share Preview.
+title: How to monitor Azure Data Share 
+description: Learn how to monitor invitation status, share subscriptions, and snapshot history in Azure Data Share 
 author: joannapea
 ms.author: joanpo
 ms.service: data-share
 ms.topic: conceptual
 ms.date: 07/10/2019
 ---
-# Monitor Azure Data Share Preview 
 
-This article explains how you can monitor your data shares using Azure Data Share Preview. As a data provider, you are able to monitor various aspects of your data sharing relationships. Details such as whether your data consumers have accepted your invitation to the data share, as well as whether they have created a share subscription and started to use your data are all available to monitor. 
+# Monitor Azure Data Share  
+
+This article explains how you can monitor your data shares using Azure Data Share. As a data provider, you are able to monitor various aspects of your data sharing relationships. Details such as whether your data consumers have accepted your invitation to the data share, as well as whether they have created a share subscription and started to use your data are all available to monitor. 
 
 As a data consumer, you can monitor the snapshots that have been triggered into your Azure subscription.