Skip to content

Commit 4afd18d

Browse files
committed
Acrolinx sweep
1 parent 15bc721 commit 4afd18d

File tree

2 files changed

+17
-17
lines changed

2 files changed

+17
-17
lines changed

articles/data-share/how-to-share-from-sql.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ To share data snapshots from your Azure SQL resources, you first need to prepare
114114
- An Azure subscription: If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
115115
- 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.
116116
- [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 sign in e-mail address (using their e-mail alias won't work).
118118
- 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.
119119

120120
### Source-specific prerequisites
@@ -217,13 +217,13 @@ You can follow the [step by step demo video](https://youtu.be/hIE-TjJD8Dc) to co
217217
218218
![AddDatasets](./media/add-datasets.png "Add Datasets")
219219
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 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.
221221

222222
Select **Next** to navigate to the object you would like to share and select '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.
223223

224224
![SelectDatasets](./media/select-datasets-sql.png "Select Datasets")
225225

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 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 sign in email.
227227
228228
![AddRecipients](./media/add-recipient.png "Add recipients")
229229
@@ -249,7 +249,7 @@ Confirm that all pre-requisites are complete before accepting a data share invit
249249
250250
- Azure Subscription: If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
251251
- 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.
253253
- You'll need a resource in Azure to store the shared data. You can use these kinds of resources:
254254
- [Azure Storage](../storage/common/storage-account-create.md)
255255
- [Azure SQL Database](../azure-sql/database/single-database-create-quickstart.md)
@@ -314,7 +314,7 @@ You can follow the [step by step demo video](https://youtu.be/aeGISgK1xro), or t
314314
<a id="prerequisitesforreceivingtoazuresynapseworkspacepool"></a>
315315
### Prerequisites for receiving data into Azure Synapse Analytics (workspace) SQL pool
316316
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.
318318
- Permission to write to the SQL pool in Synapse workspace: *Microsoft.Synapse/workspaces/sqlPools/write*. This permission exists in the Azure RBAC **Contributor** role.
319319
- Permission for the Data Share resource's managed identity to access the Synapse workspace SQL pool:
320320
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
335335
- Synapse workspace Firewall access:
336336
1. In the [Azure portal](https://portal.azure.com/), navigate to Synapse workspace. Select *Firewalls* from left navigation.
337337
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.
339339
1. Select **Save**.
340340

341341
## Receive shared data
@@ -395,7 +395,7 @@ Follow the steps below to configure where you want to receive data.
395395

396396
These steps only apply to snapshot-based sharing.
397397

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.
399399

400400
![Trigger snapshot](./media/trigger-snapshot.png "Trigger snapshot")
401401

@@ -409,20 +409,20 @@ This step only applies to snapshot-based sharing. To view history of your snapsh
409409
410410
## Snapshot performance
411411
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.
413413

414414
- Source or destination data store input/output operations per second (IOPS) and bandwidth.
415415
- 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.
417417
- Network bandwidth between the source and destination data stores, and location of source and target data stores.
418418
- 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.
419419
420420
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.
421421
422422
## Troubleshoot snapshot failure
423423
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).
425425

426426
## Next steps
427427

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).

articles/data-share/how-to-share-from-storage.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Azure Data Share supports sharing data from Azure Data Lake Gen1, Azure Data Lak
4343
||Containers|
4444

4545
>[!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**.
4747
4848
Data shared from these sources can be received by Azure Data Lake Gen2 or Azure Blob Storage.
4949

@@ -61,7 +61,7 @@ Existing files that have the same name are overwritten during a snapshot. A file
6161

6262
- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
6363
- [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 sign in e-mail address (using their e-mail alias won't work).
6565
- 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.
6666

6767
### Prerequisites for the source storage account
@@ -144,7 +144,7 @@ You can open an invitation from email or directly from the [Azure portal](https:
144144

145145
To open an invitation from the Azure portal, search for *Data Share invitations*. You see a list of Data Share invitations.
146146

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.
148148

149149
![Screenshot showing the list of invitations in the Azure portal.](./media/invitations.png "List of invitations.")
150150

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

181181
![Screenshot showing where to select a target storage account.](./media/map-target.png "Target storage.")
182182

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.
184184

185185
![Screenshot showing how to enable a snapshot schedule.](./media/enable-snapshot-schedule.png "Enable snapshot schedule.")
186186

187187
### Trigger a snapshot
188188

189189
The steps in this section apply only to snapshot-based sharing.
190190

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.
192192

193193
![Screenshot showing the Trigger snapshot selection.](./media/trigger-snapshot.png "Trigger snapshot.")
194194

@@ -202,7 +202,7 @@ You can view the history of your snapshots only in snapshot-based sharing. To vi
202202

203203
## Storage snapshot performance
204204

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.
206206

207207
- Concurrent access to the source and target data stores.
208208
- Location of source and target data stores.

0 commit comments

Comments
 (0)