Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit d5aaa60

Browse files
joannapeajoannapea
committedOct 22, 2019
sql updates
1 parent 916c2fa commit d5aaa60

21 files changed

+398
-76
lines changed
 

‎articles/data-share/TOC.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
- name: Azure Data Share Preview Documentation
1+
- name: Azure Data Share Documentation
22
href: index.yml
33
- name: Overview
44
items:
5-
- name: What is Azure Data Share Preview?
5+
- name: What is Azure Data Share?
66
href: overview.md
77
- name: Tutorials
88
expanded: true

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

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,17 @@
11
---
2-
title: Roles and requirements for Azure Data Share Preview
3-
description: Learn about the access control roles and requirements for data providers and data consumers to share data in Azure Data Share Preview.
2+
title: Roles and requirements for Azure Data Share
3+
description: Roles and requirements for Azure Data Share
44
author: joannapea
5-
ms.author: joanpo
5+
66
ms.service: data-share
77
ms.topic: conceptual
88
ms.date: 07/10/2019
9+
ms.author: joanpo
910
---
1011

11-
# Roles and requirements for Azure Data Share Preview
12+
# Roles and requirements for Azure Data Share
1213

13-
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.
14+
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.
1415

1516
## Roles and requirements
1617

‎articles/data-share/concepts-sql-sharing.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
title: SQL-based sharing for Azure Data Share
3+
description: SQL-based sharing for Azure Data Share
4+
author: joannapea
5+
6+
ms.service: data-share
7+
ms.topic: conceptual
8+
ms.date: 07/10/2019
9+
ms.author: joanpo
10+
---
11+
12+
# Snapshot-based sharing from SQL-based sources
13+
14+
This article describes how snapshot-based sharing works for SQL-based sources such as Azure SQL Database and Azure SQL Data Warehouse.
15+
16+
## Data Sharing from SQL-based sources
17+
Azure Data Share supports the ability to share tables and views from Azure SQL Database and Azure SQL Data Warehouse. Data providers can add tables and views from existing SQL Servers to a data share. Data consumers can receive data in a variety of data sources including Azure Data Lake Store Gen2, Azure Storage, Azure SQL Database or Azure SQL Data Warehouse.
18+
19+
Data shared from SQL-based sources contains schema and data only. Azure Data Share does not preserve any pre-existing constraints defined on a table or view. Data is shared as a snapshot of the table or view at the time that a trigger is generated. Azure Data Share does not support incremental copy.
20+
21+
Scheduled incremental copies are not supported for SQL-based sharing. If a snapshot is scheduled, a snapshot of the table as it exists on the originators SQL Server is generated at each scheduled or manual trigger.
22+
23+
### Receiving SQL-based data in Azure Data Lake Store Gen2 or Azure Storage
24+
Data consumers are able to receive SQL-based data into Azure Data Lake Store Gen2 or Azure Storage. By default, Azure Data Share enables customers to specify a storage location into which they will receive data into. Data is copied into a storage location specified by the data consumer when configuring the data share. The contents of the origin table are copied into a format chosen by the data consumer. Azure Data Share currently supports receiving data in CSV or Parquet format.
25+
26+
Detailed instructions on how to share and receive data into Azure Data Lake Store Gen2 or Azure Storage can be found here.
27+
28+
### Receiving SQL-based data in Azure SQL Database or Azure SQL Data Warehouse
29+
Data consumers can choose to receive data shared with them from the data provider directly into an Azure SQL Server table or view. When a data consumer triggers a snapshot to receive data shared with them, the table or view is created into the database that was selected at the time of configuration. If the table does not already exist, it will be created with the original schema (no constraints). If the table already exists, and the schema is consistent with the original schema of the table being shared, data will be appended to the existing table. If the table already exists with a different schema, the table will not be overwritten and the trigger will fail.
30+
31+
The table generated on the data consumers SQL Server will have the same name as the original table name.
32+
33+
Detailed instructions on how to share and receive data into Azure SQL Database or Azure SQL Data Warehouse can be found here.
34+
35+
## Next steps
36+
37+
- Learn how to share data from Azure SQL Database or Azure SQL Data Warehouse - [SQL-based sharing](share-your-sql-data.md)
38+

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

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Troubleshoot Azure Data Share Preview
3-
description: Learn how to troubleshoot issues with invitations and errors when creating or receiving data shares with Azure Data Share Preview.
2+
title: Troubleshoot Azure Data Share
3+
description: Learn how to troubleshoot issues with Azure Data Share
44
services: data-share
55
author: joannapea
66
ms.author: joanpo
@@ -9,9 +9,9 @@ ms.topic: troubleshooting
99
ms.date: 07/10/2019
1010
---
1111

12-
# Troubleshoot common issues in Azure Data Share Preview
12+
# Troubleshoot common issues in Azure Data Share
1313

14-
This article shows how to troubleshoot common issues for Azure Data Share Preview.
14+
This article shows how to troubleshoot common issues for Azure Data Share.
1515

1616
## Azure Data Share invitations
1717

@@ -51,6 +51,19 @@ If you receive any of the above errors when creating a new data share or receivi
5151
1. Click **Add**
5252
1. Add yourself in as owner.
5353

54+
## Troubleshooting SQL-based sharing
55+
56+
"Error: x datasets were not added because you do not have the required permissions to share."
57+
58+
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:
59+
60+
* create user [datashareaccountname] from external provider;
61+
* exec sp_addrolemember db_owner, [datashareaccountname];
62+
63+
Note that the [datashareaccountname] must be the same name as your Data Share resource.
64+
65+
Ensure that you have followed all prerequisites listed in [Share your SQL data](share-your-sqldata.md) tutorial.
66+
5467
## Next steps
5568

5669
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

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
11
---
2-
title: Add datasets to an existing Azure Data Share Preview
3-
description: Learn how to add datasets to an existing data share in Azure Data Share and share with the same recipients.
2+
title: Add datasets to an existing Azure Data Share
3+
description: Add datasets to an existing data share
44
author: joannapea
55
ms.author: joanpo
66
ms.service: data-share
77
ms.topic: conceptual
88
ms.date: 07/10/2019
99
---
1010

11-
# How to add datasets to an existing share in Azure Data Share Preview
11+
# How to add datasets to an existing share in Azure Data Share
1212

13-
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.
13+
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.
1414

1515
For information on how to add datasets as you create a share, see the [Share data](share-your-data.md) tutorial.
1616

1717
## Navigate to a sent data share
1818

19-
In Azure Data Share Preview, navigate to your sent share and select the **Datasets** tab. Click **+ Add Datasets** button to add more datasets.
19+
In Azure Data Share, navigate to your sent share and select the **Datasets** tab. Click **+ Add Datasets** button to add more datasets.
2020

2121
![Add Datasets](./media/how-to/how-to-add-datasets/add-datasets.png)
2222

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
---
2-
title: Add recipients in Azure Data Share Preview
3-
description: Learn how to add recipients to an existing data share in Azure Data Share preview.
2+
title: Add recipients in Azure Data Share
3+
description: Add recipients to an existing data share
44
author: joannapea
55
ms.author: joanpo
66
ms.service: data-share
77
ms.topic: conceptual
88
ms.date: 07/10/2019
99
---
10-
# How to add a recipient to an existing data share in Azure Data Share Preview
10+
# How to add a recipient to an existing data share in Azure Data Share
1111

1212
This article will show you how to add recipients to a pre-existing data share.
1313

1414
For information on how to add recipients as you create a share, see the [Share data](share-your-data.md) tutorial.
1515

1616
## Navigate to a sent data share
1717

18-
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**.
18+
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**.
1919

2020
![Add Recipient](./media/how-to/how-to-add-recipients/add-recipient.png)
2121

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

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,16 @@
11
---
2-
title: Configure a dataset mapping in Azure Data Share Preview
3-
description: Learn how to configure a dataset mapping for a received share using Azure Data Share Preview.
2+
title: Configure a dataset mapping
3+
description: Configure a dataset mapping
44
author: joannapea
5-
ms.author: joanpo
5+
66
ms.service: data-share
77
ms.topic: conceptual
88
ms.date: 07/10/2019
9+
ms.author: joanpo
910
---
10-
# How to configure a dataset mapping for a received share in Azure Data Share Preview
11+
# How to configure a dataset mapping for a received share in Azure Data Share
1112

12-
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.
13+
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". Otherwise, you may simply want to change the destination storage account for your received data.
1314

1415
## Navigate to a received data share
1516

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
---
2-
title: Delete an invitation in Azure Data Share Preview
3-
description: Learn how to delete an invitation to a data share recipient in Azure Data Share Preview.
2+
title: Delete an invitation in Azure Data Share
3+
description: Delete an invitation
44
author: joannapea
55
ms.author: joanpo
66
ms.service: data-share
77
ms.topic: conceptual
88
ms.date: 07/10/2019
99
---
10-
# How to delete an invitation to a recipient in Azure Data Share Preview
10+
# How to delete an invitation to a recipient in Azure Data Share
1111

1212
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.
1313

1414
## Navigate to a sent data share
1515

16-
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**.
16+
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**.
1717

1818
![Delete Invitation](./media/how-to/how-to-delete-invitation/delete-invitation.png)
1919

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

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,16 @@
11
---
2-
title: How to monitor Azure Data Share Preview
3-
description: Learn how to monitor invitation status, share subscriptions, and snapshot history in Azure Data Share Preview.
2+
title: How to monitor Azure Data Share
3+
description: How to monitor Azure Data Share
44
author: joannapea
5-
ms.author: joanpo
5+
66
ms.service: data-share
77
ms.topic: conceptual
88
ms.date: 07/10/2019
9+
ms.author: joanpo
910
---
10-
# Monitor Azure Data Share Preview
11+
# Monitor Azure Data Share
1112

12-
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.
13+
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.
1314

1415
As a data consumer, you can monitor the snapshots that have been triggered into your Azure subscription.
1516

‎articles/data-share/how-to-revoke-share-subscription.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
---
2-
title: Revoke a share subscription in Azure Data Share Preview
3-
description: Learn how to revoke a share subscription from a recipient using Azure Data Share Preview.
2+
title: Revoke a share subscription in Azure Data Share
3+
description: Revoke a share subscription
44
author: joannapea
55
ms.author: joanpo
66
ms.service: data-share
77
ms.topic: conceptual
88
ms.date: 07/10/2019
99
---
10-
# How to revoke a consumer's share subscription in Azure Data Share Preview
10+
# How to revoke a consumer's share subscription in Azure Data Share
1111

12-
This article explains how to revoke a share subscription from one or more of your consumers using Azure Data Share Preview. This prevents a consumer from triggering any more snapshots. If the consumer has not yet triggered a snapshot, they will never receive the data once the share subscription is revoked. If they have previously triggered a snapshot, the latest data that they have will stay in their account.
12+
This article explains how to revoke a share subscription from one or more of your consumers using Azure Data Share. This prevents a consumer from triggering any more snapshots. If the consumer has not yet triggered a snapshot, they will never receive the data once the share subscription is revoked. If they have previously triggered a snapshot, the latest data that they have will stay in their account.
1313

1414
## Navigate to a sent data share
1515

16-
In Azure Data Share Preview, navigate to your sent share and select the **Share Subscriptions** tab.
16+
In Azure Data Share, navigate to your sent share and select the **Share Subscriptions** tab.
1717

1818
![Revoke Share Subscription](./media/how-to/how-to-revoke-share-subscription/revoke-share-subscription.png)
1919

‎articles/data-share/index.yml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
### YamlMime:Landing
22

3-
title: Azure Data Share (preview) documentation # < 60 chars
4-
summary: Azure Data Share Preview is a safe and secure service for sharing data with third-party organizations. # < 160 chars
3+
title: Azure Data Share documentation # < 60 chars
4+
summary: Azure Data Share is a safe and secure service for sharing data with third-party organizations. # < 160 chars
55

66
metadata:
7-
title: Azure Data Share (preview) # Required; page title displayed in search results. Include the brand. < 60 chars.
8-
description: Azure Data Share (preview) is a safe and secure service for sharing data with third-party organizations. # Required; article description that is displayed in search results. < 160 chars.
7+
title: Azure Data Share # Required; page title displayed in search results. Include the brand. < 60 chars.
8+
description: Azure Data Share is a safe and secure service for sharing data with third-party organizations. # Required; article description that is displayed in search results. < 160 chars.
99
services: data-share
1010
ms.service: data-share #Required; service per approved list. service slug assigned to your service by ACOM.
1111
ms.subservice: subservice
1212
ms.topic: landing-page # Required
1313
ms.collection: collection
14-
author: joannapea #Required; your GitHub user alias, with correct capitalization.
15-
ms.author: joanpo #Required; microsoft alias of author; optional team alias.
14+
author: hrasheed-msft #Required; your GitHub user alias, with correct capitalization.
15+
ms.author: hrasheed #Required; microsoft alias of author; optional team alias.
1616
ms.date: 09/13/2019 #Required; mm/dd/yyyy format.
1717

1818
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new

‎articles/data-share/media/sql-map-to-target.png

38.3 KB
Loading

‎articles/data-share/media/sql-mapping.png

88.6 KB
Loading

‎articles/data-share/overview.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
---
2-
title: What is Azure Data Share Preview
3-
description: Learn about simply and securely share data with multiple customers and partners using Azure Data Share Preview.
2+
title: What is Azure Data Share
3+
description: An overview of Azure Data Share
44
author: joannapea
5-
ms.author: joanpo
5+
66
ms.service: data-share
77
ms.topic: overview
88
ms.date: 07/10/2019
9+
ms.author: joanpo
910
---
10-
11-
# What is Azure Data Share Preview?
11+
# What is Azure Data Share ?
1212

1313
In today's world, data is viewed as a key strategic asset that many organizations need to simply and securely share with their customers and partners. There are many ways that customers do this today, including through FTP, e-mail, APIs to name a few. Organizations can easily lose track of who they've shared their data with. Sharing data through FTP or through standing up their own API infrastructure is often expensive to provision and administer. There's management overhead associated with using these methods of sharing on a large scale.
1414

1515
Many organizations need to be accountable for the data that they have shared. In addition to accountability, many organizations would like to be able to control, manage, and monitor all of their data sharing in a simple way. In today world, where data is expected to continue to grow at an exponential pace, organizations need a simple way to share big data. Customers demand the most up-to-date data to ensure that they are able to derive timely insights.
1616

17-
Azure Data Share Preview enables organizations to simply and securely share data with multiple customers and partners. In just a few clicks, you can provision a new data share account, add datasets, and invite your customers and partners to your data share. Data providers are always in control of the data that they have shared. Azure Data Share makes it simple to manage and monitor what data was shared, when and by whom.
17+
Azure Data Share enables organizations to simply and securely share data with multiple customers and partners. In just a few clicks, you can provision a new data share account, add datasets, and invite your customers and partners to your data share. Data providers are always in control of the data that they have shared. Azure Data Share makes it simple to manage and monitor what data was shared, when and by whom.
1818

1919
A data provider can stay in control of how their data is handled by specifying terms of use for their data share. The data consumer must accept these terms before being able to receive the data. Data providers can specify the frequency at which their data consumers receive updates. Access to new updates can be revoked at any time by the data provider.
2020

@@ -32,7 +32,7 @@ Another use case for Azure Data Share is establishing a data consortium. For exa
3232

3333
## How it works
3434

35-
Azure Data Share uses a snapshot-based sharing approach, where data moves from the data provider's Azure subscription and lands in the data consumer's Azure subscription. As a data provider, you provision a data share and invite recipients to the data share. Data consumers receive an invitation to your data share via e-mail. Once a data consumer accepts the invitation, they can trigger a full snapshot of the data shared you shared them. This data is received into the data consumers storage account. Data consumers can receive regular, incremental updates to the data shared with them so that they always have the latest version of the data.
35+
Azure Data Share uses a snapshot-based sharing approach, where data moves from the data provider's Azure subscription and lands in the data consumer's Azure subscription. As a data provider, you provision a data share and invite recipients to the data share. Data consumers receive an invitation to your data share via e-mail. Once a data consumer accepts the invitation, they can trigger a full snapshot of the data shared with them. This data is received into the data consumers storage account. Data consumers can receive regular, incremental updates to the data shared with them so that they always have the latest version of the data.
3636

3737
Data providers can offer their data consumers incremental updates to the data shared with them through a snapshot schedule. Snapshot schedules are offered on an hourly or a daily basis. When a data consumer accepts and configures their data share, they can subscribe to a snapshot schedule. This is beneficial in scenarios where the shared data is updated on a regular basis, and the data consumer needs the most up-to-date data.
3838

@@ -44,7 +44,7 @@ When a data consumer accepts a data share, they are able to receive the data in
4444

4545
Azure Data Share enables data providers to:
4646

47-
* Share data from Azure Storage and Azure Data Lake Store with customers and partners outside of your organization
47+
* Share data from the list of [supported data stores](supported-data-stores.md) with customers and partners outside of your organization
4848

4949
* Keep track of who you have shared your data with
5050

@@ -64,7 +64,7 @@ Azure Data Share enables data consumers to:
6464

6565
* Subscribe to a Data Share to receive the latest copy of the data through incremental snapshot copy
6666

67-
* Accept data shared with you into an Azure Blob Storage or Azure Data Lake Gen2 account
67+
* Accept data shared with you into a [supported data store](supported-data-stores.md).
6868

6969
All key capabilities listed above are supported through the Azure or via REST APIs. For more details on using Azure Data Share through REST APIs, check out our reference documentation.
7070

‎articles/data-share/receive-sql-data.md

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
---
2+
title: 'Tutorial: Receive data from Azure SQL Database or Azure SQL Data Warehouse'
3+
description: Tutorial - Receive data from Azure SQL Database or Azure SQL Data Warehouse
4+
author: joannapea
5+
ms.author: joanpo
6+
ms.service: data-share
7+
ms.topic: tutorial
8+
ms.date: 07/10/2019
9+
---
10+
# Tutorial: Receive data from/to an Azure SQL-based sources
11+
12+
In this tutorial you will learn how to receive data shared from SQL-based data sources into an Azure SQL Database or Azure SQL Data Warehouse. To learn how to receive data into a Storage account, visit [Accept and receive data](https://docs.microsoft.com/en-us/azure/data-share/subscribe-to-data-share).
13+
14+
In this tutorial, you'll learn how to:
15+
16+
> [!div class="checklist"]
17+
> * Accept a data share invitation
18+
> * Receive data into a SQL-based data source such as Azure SQL Database or Azure SQL Data Warehouse.
19+
20+
## Prerequisites
21+
22+
* Azure Subscription: If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
23+
* An Azure SQL Database or Azure SQL Data Warehouse to receive data into.
24+
* A Data Share Invitation from your Data Provider.
25+
* Permission for the data share to access the Azure SQL Database or Data Warehouse. This can be done through the following steps:
26+
1. Set yourself as the Azure Active Directory Admin for the server.
27+
1. Connect to the Azure SQL Database/Data Warehouse using Azure Active Directory.
28+
1. Use Query Editor (preview) to execute the following script to add the Data Share MSI as a db_owner. You must connect using Active Directory and not SQL Server authentication.
29+
30+
```sql
31+
create user <share_acct_name> from external provider;
32+
33+
exec sp_addrolemember db_owner, <share_acct_name>;
34+
```
35+
36+
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.
37+
38+
* Client IP SQL Server Firewall access: This can be done through the following steps:
39+
1. Navigate to *Firewalls and Virtual Networks*
40+
1. Click the **on** toggle to allow access to Azure Services.
41+
42+
Once these pre-requisites are complete, you are ready to receive data into your SQL Server.
43+
44+
## Sign in to the Azure portal
45+
46+
Sign in to the [Azure portal](https://portal.azure.com/).
47+
48+
## Open invitation
49+
50+
Check your inbox for an invitation from your data provider. The invitation is from Microsoft Azure, titled **Azure Data Share invitation from <yourdataprovider@domain.com>**. Take note of the share name to ensure you're accepting the correct share if there are multiple invitations.
51+
52+
Select on **View invitation** to see your invitation in Azure. This takes you to your Received Shares view.
53+
54+
![Invitations](./media/invitations.png "List of invitations")
55+
56+
Select the share you would like to view.
57+
58+
## Accept and configure later
59+
To receive data directly into a SQL table or view, you will need to accept the invitation and select the option to *Accept and configure later*. Make sure all fields are reviewed, including the **Terms of Use**. If you agree to the terms of use, you'll be required to check the box to indicate you agree.
60+
61+
![Terms of use](./media/terms-of-use.png "Terms of use")
62+
63+
Under *Target Data Share Account*, select the Subscription and Resource Group that you'll be deploying your Data Share into.
64+
65+
For the **Data Share Account** field, select **Create new** if you don't have an existing Data Share account. Otherwise, select an existing Data Share account that you'd like to accept your data share into.
66+
67+
For the *Received Share Name* field, you may leave the default specified by the Data Provide, or specify a new name for the received share.
68+
69+
![Target data share account](./media/target-data-share.png "Target data share account")
70+
71+
Once you've agreed to the terms of use and specified a location for your share, Select on *Accept and Configure later*. Only choose this option if you would like to receive data directly into a SQL Server. If you prefer to receive data into a storage account, select *Accept and Configure* and designated a storage account to receive data into.
72+
73+
![Accept options](./media/accept-options.png "Accept options")
74+
75+
If you don't want to accept the invitation, Select *Reject*.
76+
77+
## Map datasets to an Azure SQL Database or Data Warehouse
78+
Navigate to Data Share -> Received Shares on the left side panel and select the share that you accepted.
79+
80+
![SQL Map](./media/sql-mapping.png)
81+
82+
You will need to specify a destination for each dataset, which represents a table or a view that has been shared with you by the data provider. This can be done by selecting the dataset and selecting "+ Map to target".
83+
84+
On the right hand side, a new pane will be displayed. Select the Target data type you'd like to map to, and fill out all corresponding fields to designate a database or data warehouse to receive data into.
85+
86+
![SQL Map](./media/sql-map-to-target.png)
87+
88+
You are now ready to receive data into your SQL Server.
89+
90+
## Trigger a snapshot
91+
92+
You can trigger a snapshot in the Received Shares -> Details tab by selecting **Trigger snapshot**. Here, you can trigger a full snapshot only. Note that we do not support incremental copy for SQL-based data sources. Each time a snapshot is triggered, it will be the full copy of the originators table or view.
93+
94+
![Trigger snapshot](./media/trigger-snapshot.png "Trigger snapshot")
95+
96+
When the last run status is *successful*, check your SQL Server to ensure that the table(s) and/or view(s) appear in your database.
97+
98+
## Next steps
99+
Check out our Troubleshooting guide.
100+

‎articles/data-share/samples-powershell.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
11
---
2-
title: Azure PowerShell Samples for Azure Data Share
3-
description: Learn about Azure PowerShell Sample scripts to help you create and manage data shares in Azure Data Share Preview.
2+
title: Azure PowerShell Samples for Azure Data Share | Microsoft Docs
3+
description: Azure PowerShell Samples - Scripts to help you create and manage data shares.
4+
services: data-share
45
ms.service: data-share
56
ms.workload: data-services
7+
ms.tgt_pltfrm: na
68
ms.topic: conceptual
7-
ms.devlang: powershell
9+
ms.date: 07/6/2019
810
author: joannapea
911
ms.author: joanpo
10-
ms.date: 07/6/2019
1112
---
1213

1314
# Azure PowerShell samples for Azure Data Share
@@ -27,3 +28,9 @@ The following table includes links to sample Azure PowerShell scripts for Azure
2728
|[View details of a data shares](scripts/powershell/view-share-details-powershell.md)| This sample PowerShell script lists and retrieves details of data shares. |
2829
|[Monitor usage of shared data](scripts/powershell/monitor-usage-powershell.md)| This sample PowerShell script monitors the usage of sent shared data. |
2930
|[Create and view snapshot triggers](scripts/powershell/create-view-trigger-powershell.md)| This sample PowerShell script creates snapshot triggers of a share.
31+
32+
33+
34+
35+
36+

‎articles/data-share/share-your-data.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: 'Tutorial: Share outside your org - Azure Data Share Preview'
3-
description: Tutorial - Share data with customers and partners using Azure Data Share Preview
2+
title: 'Tutorial: Share outside your org - Azure Data Share'
3+
description: Tutorial - Share data with customers and partners using Azure Data Share
44
author: joannapea
55
ms.author: joanpo
66
ms.service: data-share
77
ms.topic: tutorial
88
ms.date: 07/10/2019
99
---
10-
# Tutorial: Share your data using Azure Data Share Preview
10+
# Tutorial: Share your data using Azure Data Share
1111

1212
In this tutorial, you will learn how to set up a new Azure Data Share and start sharing your data with customers and partners outside of your Azure organization.
1313

@@ -38,7 +38,7 @@ Create an Azure Data Share resource in an Azure resource group.
3838

3939
1. Search for *Data Share*.
4040

41-
1. Select Data Share (preview) and Select **Create**.
41+
1. Select Data Share and Select **Create**.
4242

4343
1. Fill out the basic details of your Azure Data Share resource with the following information.
4444

‎articles/data-share/share-your-sql-data.md

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,119 @@
1+
---
2+
title: 'Tutorial: Share data from Azure SQL Database or Azure SQL Data Warehouse'
3+
description: Tutorial - Share data from Azure SQL Database or Azure SQL Data Warehouse
4+
author: joannapea
5+
ms.author: joanpo
6+
ms.service: data-share
7+
ms.topic: tutorial
8+
ms.date: 07/10/2019
9+
---
10+
# Tutorial: Share data from Azure SQL-based sources
11+
12+
In this tutorial you will learn how to set up a new Azure Data Share and start sharing SQL-based data with customers and partners outside of your Azure organization.
13+
14+
In this tutorial, you'll learn how to:
15+
16+
> [!div class="checklist"]
17+
> * Create a Data Share.
18+
> * Add tables and views to your Data Share.
19+
> * Add recipients to your Data Share.
20+
21+
## Prerequisites
22+
23+
* Azure Subscription: If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
24+
* An Azure SQL Database or Azure SQL Data Warehouse with tables and views that you want to share.
25+
* Your data consumer's Azure login e-mail address (using their e-mail alias will not work).
26+
* Permission for the data share to access the data warehouse. This can be done through the following steps:
27+
1. Set yourself as the Azure Active Directory Admin for the server.
28+
1. Connect to the Azure SQL Database/Data Warehouse using Azure Active Directory.
29+
1. Use Query Editor ( ) to execute the following script to add the Data Share MSI as a db_owner. You must connect using Active Directory and not SQL Server authentication.
30+
31+
create user <share_acct_name> from external provider;
32+
33+
exec sp_addrolemember db_owner, <share_acct_name>;
34+
35+
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.
36+
37+
* Client IP SQL Server Firewall access: This can be done through the following steps:
38+
1. Navigate to *Firewalls and Virtual Networks*
39+
1. Click the **on** toggle to allow access to Azure Services.
40+
41+
Once these pre-requisites are complete, you are ready for sharing data from SQL-based sources.
42+
43+
## Sign in to the Azure portal
44+
45+
Sign in to the [Azure portal](https://portal.azure.com/).
46+
47+
## Create a Data Share Account
48+
49+
Create an Azure Data Share resource in an Azure resource group.
50+
51+
1. Select the **Create a resource** button (+) in the upper-left corner of the portal.
52+
53+
1. Search for *Data Share*.
54+
55+
1. Select Data Share and Select **Create**.
56+
57+
1. Fill out the basic details of your Azure Data Share resource with the following information.
58+
59+
**Setting** | **Suggested value** | **Field description**
60+
|---|---|---|
61+
| Name | *datashareacount* | Specify a name for your data share account. |
62+
| Subscription | Your subscription | Select the Azure subscription that you want to use for your data share account.|
63+
| Resource group | *test-resource-group* | Use an existing resource group or create a new resource group. |
64+
| Location | *East US 2* | Select a region for your data share account.
65+
| | |
66+
67+
1. Select **Create** to provision your data share account. Provisioning a new data share account typically takes about 2 minutes or less.
68+
69+
1. When the deployment is complete, select **Go to resource**.
70+
71+
## Create a Data Share
72+
73+
1. Navigate to your Data Share Overview page.
74+
75+
![Share your data](./media/share-receive-data.png "Share your data")
76+
77+
1. Select **Start sharing your data**.
78+
79+
1. Select **Create**.
80+
81+
1. Fill out the details for your Data Share. Specify a name, description of share contents, and terms of use (optional).
82+
83+
![EnterShareDetails](./media/enter-share-details.png "Enter Share details")
84+
85+
1. Select **Continue**
86+
87+
1. To add Datasets to your Data Share, select **Add Datasets**.
88+
89+
![Datasets](./media/datasets.png "Datasets")
90+
91+
1. Select the dataset type that you would like to add.
92+
93+
![AddDatasets](./media/add-datasets.png "Add Datasets")
94+
95+
1. Navigate to the object you would like to share and select 'Add Datasets'.
96+
97+
![SelectDatasets](./media/select-datasets.png "Select Datasets")
98+
99+
1. In the Recipients tab, enter in the email addresses of your Data Consumer by selecting '+ Add Recipient'.
100+
101+
![AddRecipients](./media/add-recipient.png "Add recipients")
102+
103+
1. Select **Continue**
104+
105+
1. If you'd like your data consumer to be able to get incremental updates of your data, enable the snapshot schedule.
106+
107+
![EnableSnapshots](./media/enable-snapshots.png "Enable snapshots")
108+
109+
1. Select a start time and recurrence interval.
110+
111+
1. Select **Continue**
112+
113+
1. In the Review + Create tab, review your Package Contents, Settings, Recipients, and Synchronization Settings. Select **Create**
114+
115+
Your Azure Data Share has now been created and the recipient of your Data Share is now ready to accept your invitation.
116+
117+
## Next steps
118+
119+
In this tutorial, you learnt how to create an Azure Data Share and invite recipients. To learn about how a Data Consumer can accept and receive a data share, continue to the [accept and receive data](subscribe-to-data-share.md) tutorial.

‎articles/data-share/subscribe-to-data-share.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
---
2-
title: 'Tutorial: Accept & receive data - Azure Data Share Preview'
3-
description: Tutorial - Accept and receive data using Azure Data Share Preview
2+
title: 'Tutorial: Accept & receive data - Azure Data Share'
3+
description: Tutorial - Accept and receive data using Azure Data Share
44
author: joannapea
55
ms.author: joanpo
66
ms.service: data-share
77
ms.topic: tutorial
88
ms.date: 07/10/2019
99
---
10-
# Tutorial: Accept and receive data using Azure Data Share Preview
10+
# Tutorial: Accept and receive data using Azure Data Share
1111

12-
In this tutorial, you will learn how to accept a data share invitation using Azure Data Share Preview. You will learn how to receive data being shared with you, as well as how to enable a regular refresh interval to ensure that you always have the most recent snapshot of the data being shared with you.
12+
In this tutorial, you will learn how to accept a data share invitation using Azure Data Share. You will learn how to receive data being shared with you, as well as how to enable a regular refresh interval to ensure that you always have the most recent snapshot of the data being shared with you.
1313

1414
> [!div class="checklist"]
15-
> * How to accept an Azure Data Share Preview invitation
16-
> * Create an Azure Data Share Preview account
15+
> * How to accept an Azure Data Share invitation
16+
> * Create an Azure Data Share account
1717
> * Specify a destination for your data
1818
> * Create a subscription to your data share for scheduled refresh
1919
@@ -29,7 +29,7 @@ Ensure that all pre-requisites are complete before accepting a data share invita
2929
* Resource Provider registration for Microsoft.DataShare. See the [Azure Resource Providers](https://docs.microsoft.com/azure/azure-resource-manager/resource-manager-supported-services) documentation for information on how to do this.
3030

3131
> [!IMPORTANT]
32-
> To accept and receive an Azure Data Share, you must first register the Microsoft.DataShare resource provider and you must be an owner of the storage account that you accept data into. Follow the instructions documented in [Troubleshoot Azure Data Share Preview](data-share-troubleshoot.md) to register the data share resource provider as well as add yourself as an owner of the storage account.
32+
> To accept and receive an Azure Data Share, you must first register the Microsoft.DataShare resource provider and you must be an owner of the storage account that you accept data into. Follow the instructions documented in [Troubleshoot Azure Data Share](data-share-troubleshoot.md) to register the data share resource provider as well as add yourself as an owner of the storage account.
3333
3434
## Sign in to the Azure portal
3535

‎articles/data-share/supported-data-stores.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
title: Supported data stores in Azure Data Share
3+
description: Supported data stores in Azure Data Share
4+
author: joannapea
5+
6+
ms.service: data-share
7+
ms.topic: overview
8+
ms.date: 10/30/2019
9+
ms.author: joanpo
10+
---
11+
# Supported data stores in Azure Data Share
12+
13+
Azure Data Share provides open and flexible data sharing, including the ability to share from and to different data stores. Data providers can share data from one type of data store, and their data consumers have flexibility of choice when it comes to the data source that they receive that data in.
14+
15+
The below table details the supported data sources for Azure Data Share.
16+
17+
| Data store | Snapshot-based sharing | In-place sharing
18+
|:--- |:--- |:--- |:--- |:--- |:--- |
19+
| Azure Blob storage |✓ | |
20+
| Azure Data Lake Storage Gen1 |✓ | |
21+
| Azure Data Lake Storage Gen2 |✓ ||
22+
| Azure SQL Database |✓ | |
23+
| Azure SQL Data Warehouse |✓ | |
24+
| Azure Data Explorer | |✓ |
25+
26+
Azure Data Share offers data consumers flexibility when deciding on a data store to accept data in to. For example, data being shared from Azure SQL Database can be received into Azure Data Lake Store Gen2, Azure SQL Database or Azure SQL Data Warehouse. Customers can choose which format to receive data in when configuring a received data share.
27+
28+
The below table details different combinations and choices that data consumers have when accepting and configuring their data share. For more information on configuring datasets for different data stores, see [???].
29+
30+
| | Azure Blob Storage | Azure SQL Data Lake Gen1 | Azure SQL Data Lake Gen2 | Azure SQL Database | Azure SQL Data Warehouse
31+
|:--- |:--- |:--- |:--- |:--- |:--- |
32+
| <b>Azure Blob storage |✓ ||✓|
33+
| <b>Azure Data Lake Storage Gen1 |✓ | |✓|
34+
| <b>Azure Data Lake Storage Gen2 |✓ | |✓|
35+
| <b>Azure SQL Database |✓ | |✓|✓|✓|
36+
| <b>Azure SQL Data Warehouse |✓ | |✓|✓|✓|
37+
38+
39+
## Next steps
40+
41+
To learn how to start sharing data, continue to the [share your data](share-your-data.md) tutorial.

‎articles/data-share/terminology.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,16 @@
11
---
2-
title: Azure Data Share Preview terminology
3-
description: Learn about common terms used to describe resources used in Azure Data Share Preview (data provider, data consumer, data share, share subscription, snapshot, invitation, recipient.)
2+
title: Azure Data Share terminology
3+
description: Azure Data Share terminology
44
author: joannapea
5-
ms.author: joanpo
5+
66
ms.service: data-share
77
ms.topic: conceptual
88
ms.date: 07/10/2019
9+
ms.author: joanpo
910
---
10-
# Azure Data Share Preview Concepts
11+
# Azure Data Share Concepts
1112

12-
Azure Data Share Preview introduces some new terminology related to data sharing. This article explains some frequently used terms that you may see used throughout the service.
13+
Azure Data Share introduces some new terminology related to data sharing. This article explains some frequently used terms that you may see used throughout the service.
1314

1415
## Data provider
1516

@@ -41,15 +42,15 @@ A data provider can enable a snapshot setting for a data share. This setting ena
4142

4243
If a data provider enables this setting, a recurrence interval can be selected. The recurrence interval can be hourly or daily.
4344

44-
A data consumer has the option to opt in to this snapshot schedule to receive incremental updates, which include any data that has changed since they first generated a new snapshot.
45+
A data consumer has the option to opt-in to this snapshot schedule to receive incremental updates, which includes any data that has changed since they first generated a new snapshot.
4546

4647
## Invitation
4748

4849
A data provider can invite multiple recipients to their data share. They can do so by adding recipients to the data share. Invitations can also be added after a data share has been created.
4950

5051
A data provider can delete an invitation after it has been sent if it has not been accepted. If the data provider deletes an invitation and it has not yet been accepted, the data consumer will not be able to accept it.
5152

52-
Invitations can be resent up to five times a day.
53+
Invitations can be resent up to 5 times a day.
5354

5455
## Recipient
5556

0 commit comments

Comments
 (0)
Please sign in to comment.