You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/data-share/how-to-share-from-sql.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -114,7 +114,7 @@ To share data snapshots from your Azure SQL resources, you first need to prepare
114
114
- An Azure subscription: If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
115
115
- An [Azure SQL Database](../azure-sql/database/single-database-create-quickstart.md) or [Azure Synapse Analytics (formerly Azure SQL DW)](../synapse-analytics/get-started-create-workspace.md) with tables and views that you want to share.
116
116
-[An Azure Data Share account](share-your-data-portal.md#create-a-data-share-account).
117
-
- Your data recipient's Azure sign-in e-mail address (using their e-mail alias won't work).
117
+
- Your data recipient's Azure signin e-mail address (using their e-mail alias won't work).
118
118
- If your Azure SQL resource is in a different Azure subscription than your Azure Data Share account, register the [Microsoft.DataShare resource provider](concepts-roles-permissions.md#resource-provider-registration) in the subscription where your source Azure SQL resource is located.
119
119
120
120
### Source-specific prerequisites
@@ -217,13 +217,13 @@ You can follow the [step by step demo video](https://youtu.be/hIE-TjJD8Dc) to co
1. Select your SQL server or Synapse workspace. If you're using Azure Active Directory authentication and the checkbox **Allow Data Share to run the above 'create user' SQL script on my behalf** appears, check the checkbox. If you're using SQL authentication, provide credentials, and be sure you have followed the prerequisites so that you have permissions.
220
+
1. Select your SQL server or Synapse workspace. If you're using Azure Active Directory authentication and the checkbox **Allow Data Share to run the above 'create user' SQL script on my behalf** appears, check the checkbox. If you're using SQL authentication, provide credentials, and be sure you've followed the prerequisites so that you have permissions.
221
221
222
222
Select**Next** to navigate to the object you would like to share andselect'Add Datasets'. You can select tables and views from Azure SQL Database and Azure Synapse Analytics (formerly Azure SQL DW), or tables from Azure Synapse Analytics (workspace) dedicated SQL pool.
1. In the Recipients tab, enter in the email addresses of your Data Consumer by selecting '+ Add Recipient'. The email address needs to be recipient's Azure sign-in email.
226
+
1. In the Recipients tab, enter in the email addresses of your Data Consumer by selecting '+ Add Recipient'. The email address needs to be recipient's Azure signin email.
@@ -249,7 +249,7 @@ Confirm that all pre-requisites are complete before accepting a data share invit
249
249
250
250
- Azure Subscription: If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
251
251
- A Data Share invitation: An invitation from Microsoft Azure with a subject titled "Azure Data Share invitation from **<[email protected]>**".
252
-
- Register the [Microsoft.DataShare resource provider](concepts-roles-permissions.md#resource-provider-registration) in the Azure subscription where you will create a Data Share resource and the Azure subscription where your target Azure data stores are located.
252
+
- Register the [Microsoft.DataShare resource provider](concepts-roles-permissions.md#resource-provider-registration) in the Azure subscription where you'll create a Data Share resource and the Azure subscription where your target Azure data stores are located.
253
253
- You'll need a resource in Azure to store the shared data. You can use these kinds of resources:
### Prerequisites for receiving data into Azure Synapse Analytics (workspace) SQL pool
316
316
317
-
- An Azure Synapse Analytics (workspace) dedicated SQL pool. Receiving data into serverless SQL pool is not currently supported.
317
+
- An Azure Synapse Analytics (workspace) dedicated SQL pool. Receiving data into serverless SQL pool isn't currently supported.
318
318
- Permission to write to the SQL pool in Synapse workspace: *Microsoft.Synapse/workspaces/sqlPools/write*. This permission exists in the Azure RBAC **Contributor** role.
319
319
- Permission for the Data Share resource's managed identity to access the Synapse workspace SQL pool:
320
320
1. In the [Azure portal](https://portal.azure.com/), navigate to Synapse workspace.
@@ -335,7 +335,7 @@ You can follow the [step by step demo video](https://youtu.be/aeGISgK1xro), or t
335
335
- Synapse workspace Firewall access:
336
336
1. In the [Azure portal](https://portal.azure.com/), navigate to Synapse workspace. Select *Firewalls* from left navigation.
337
337
1. Select **ON** for **Allow Azure services and resources to access this workspace**.
338
-
1. Select **+Add client IP**. Client IP address is subject to change. This process might need to be repeated the next time you are sharing SQL data from Azure portal.
338
+
1. Select **+Add client IP**. Client IP address is subject to change. This process might need to be repeated the next time you're sharing SQL data from Azure portal.
339
339
1. Select**Save**.
340
340
341
341
## Receive shared data
@@ -395,7 +395,7 @@ Follow the steps below to configure where you want to receive data.
395
395
396
396
These steps only apply to snapshot-based sharing.
397
397
398
-
1. You can trigger a snapshot by selecting **Details** tab followed by **Trigger snapshot**. Here, you can trigger a full snapshot of your data. If it's your first time receiving data from your data provider, select full copy. When a snapshot is executing, the next snapshots will not start until the previous one is complete.
398
+
1. You can trigger a snapshot by selecting **Details** tab followed by **Trigger snapshot**. Here, you can trigger a full snapshot of your data. If it's your first time receiving data from your data provider, select full copy. When a snapshot is executing, the next snapshots won't start until the previous one is complete.
@@ -409,20 +409,20 @@ This step only applies to snapshot-based sharing. To view history of your snapsh
409
409
410
410
## Snapshot performance
411
411
412
-
SQL snapshot performance is impacted by many factors. It is always recommended to conduct your own performance testing. Below are some example factors impacting performance.
412
+
SQL snapshot performance is impacted by many factors. It's always recommended to conduct your own performance testing. Below are some example factors impacting performance.
413
413
414
414
- Source or destination data store input/output operations per second (IOPS) and bandwidth.
415
415
- Hardware configuration (For example: vCores, memory, DWU) of the source and target SQL data store.
416
-
- Concurrent access to the source and target data stores. If you are sharing multiple tables and views from the same SQL data store, or receive multiple tables and views into the same SQL data store, performance will be impacted.
416
+
- Concurrent access to the source and target data stores. If you're sharing multiple tables and views from the same SQL data store, or receive multiple tables and views into the same SQL data store, performance will be impacted.
417
417
- Network bandwidth between the source and destination data stores, and location of source and target data stores.
418
418
- Size of the tables and views being shared. SQL snapshot sharing does a full copy of the entire table. If the size of the table grows over time, snapshot will take longer.
419
419
420
420
For large tables where incremental updates are desired, you can export updates to storage account and use the storage account’s incremental sharing capability for faster performance.
421
421
422
422
## Troubleshoot snapshot failure
423
423
424
-
The most common cause of snapshot failure is that Data Share does not have permission to the source or target data store. In order to grant Data Share permission to the source or target Azure SQL Database or Azure Synapse Analytics (formerly Azure SQL DW), you must run the provided SQL script when connecting to the SQL database using Azure Active Directory authentication. To troubleshoot other SQL snapshot failures, refer to [Troubleshoot snapshot failure](data-share-troubleshoot.md#snapshots).
424
+
The most common cause of snapshot failure is that Data Share doesn't have permission to the source or target data store. In order to grant Data Share permission to the source or target Azure SQL Database or Azure Synapse Analytics (formerly Azure SQL DW), you must run the provided SQL script when connecting to the SQL database using Azure Active Directory authentication. To troubleshoot other SQL snapshot failures, refer to [Troubleshoot snapshot failure](data-share-troubleshoot.md#snapshots).
425
425
426
426
## Next steps
427
427
428
-
You have learned how to share and receive data from SQL sources using Azure Data Share service. To learn more about sharing from other data sources, continue to [supported data stores](supported-data-stores.md).
428
+
You've learned how to share and receive data from SQL sources using Azure Data Share service. To learn more about sharing from other data sources, continue to [supported data stores](supported-data-stores.md).
Copy file name to clipboardExpand all lines: articles/data-share/how-to-share-from-storage.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -43,7 +43,7 @@ Azure Data Share supports sharing data from Azure Data Lake Gen1, Azure Data Lak
43
43
||Containers|
44
44
45
45
>[!NOTE]
46
-
> Block, append, and page blobs are all supported. However, when they are shared they will be received as **block blobs**.
46
+
> *Block, append, and page blobs are all supported. However, when they are shared they will be received as **block blobs**.
47
47
48
48
Data shared from these sources can be received by Azure Data Lake Gen2 or Azure Blob Storage.
49
49
@@ -61,7 +61,7 @@ Existing files that have the same name are overwritten during a snapshot. A file
61
61
62
62
- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
63
63
-[An Azure Data Share account](share-your-data-portal.md#create-a-data-share-account).
64
-
- Your data recipient's Azure sign-in e-mail address (using their e-mail alias won't work).
64
+
- Your data recipient's Azure signin e-mail address (using their e-mail alias won't work).
65
65
- If your Azure SQL resource is in a different Azure subscription than your Azure Data Share account, register the [Microsoft.DataShare resource provider](concepts-roles-permissions.md#resource-provider-registration) in the subscription where your source Azure SQL resource is located.
66
66
67
67
### Prerequisites for the source storage account
@@ -144,7 +144,7 @@ You can open an invitation from email or directly from the [Azure portal](https:
144
144
145
145
To open an invitation from the Azure portal, search for *Data Share invitations*. You see a list of Data Share invitations.
146
146
147
-
If you are a guest user of a tenant, you will be asked to verify your email address for the tenant prior to viewing Data Share invitation for the first time. Once verified, it is valid for 12 months.
147
+
If you're a guest user of a tenant, you'll be asked to verify your email address for the tenant prior to viewing Data Share invitation for the first time. Once verified, it's valid for 12 months.
148
148
149
149

150
150
@@ -180,15 +180,15 @@ You can open an invitation from email or directly from the [Azure portal](https:
180
180
181
181

182
182
183
-
1. For snapshot-based sharing, if the data provider uses a snapshot schedule to regularly update the data, you can enable the schedule from the **Snapshot Schedule** tab. Select the box next to the snapshot schedule. Then select **Enable**. Note that the first scheduled snapshot will start within one minute of the schedule time and subsequent snapshots will start within seconds of the scheduled time.
183
+
1. For snapshot-based sharing, if the data provider uses a snapshot schedule to regularly update the data, you can enable the schedule from the **Snapshot Schedule** tab. Select the box next to the snapshot schedule. Then select **Enable**. The first scheduled snapshot will start within one minute of the schedule time and subsequent snapshots will start within seconds of the scheduled time.
184
184
185
185

186
186
187
187
### Trigger a snapshot
188
188
189
189
The steps in this section apply only to snapshot-based sharing.
190
190
191
-
1. You can trigger a snapshot from the **Details** tab. On the tab, select **Trigger snapshot**. You can choose to trigger a full snapshot or incremental snapshot of your data. If you're receiving data from your data provider for the first time, select **Full copy**. When a snapshot is executing, subsequent snapshots will not start until the previous one complete.
191
+
1. You can trigger a snapshot from the **Details** tab. On the tab, select **Trigger snapshot**. You can choose to trigger a full snapshot or incremental snapshot of your data. If you're receiving data from your data provider for the first time, select **Full copy**. When a snapshot is executing, subsequent snapshots won't start until the previous one complete.
192
192
193
193

194
194
@@ -202,7 +202,7 @@ You can view the history of your snapshots only in snapshot-based sharing. To vi
202
202
203
203
## Storage snapshot performance
204
204
205
-
Storage snapshot performance is impacted by a number of factors in addition to number of files and size of the shared data. It is always recommended to conduct your own performance testing. Below are some example factors impacting performance.
205
+
Storage snapshot performance is impacted by many factors in addition to number of files and size of the shared data. It's always recommended to conduct your own performance testing. Below are some example factors impacting performance.
206
206
207
207
- Concurrent access to the source and target data stores.
0 commit comments