Skip to content

Commit 095f9a2

Browse files
Merge pull request #310691 from chvukosw/chvukosw-datashare2
Chvukosw datashare2
2 parents 6e45f6f + ddb28e6 commit 095f9a2

5 files changed

Lines changed: 41 additions & 41 deletions

File tree

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

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: Share and receive data from Azure SQL Database and Azure Synapse Analytics
33
description: Learn how to share and receive data from Azure SQL Database and Azure Synapse Analytics
4-
author: sidontha
5-
ms.author: sidontha
4+
author: chvukosw
5+
ms.author: chvukosw
66
ms.service: azure-data-share
77
ms.topic: how-to
8-
ms.date: 02/12/2025
8+
ms.date: 01/20/2026
99
ms.custom: sfi-image-nochange
1010
---
1111

@@ -17,7 +17,7 @@ ms.custom: sfi-image-nochange
1717

1818
This article describes sharing data from **Azure SQL Database** and **Azure Synapse Analytics**.
1919

20-
This article will guide you through:
20+
This article guides you through:
2121

2222
- [What kinds of data can be shared](#whats-supported)
2323
- [How to prepare your environment](#prerequisites-to-share-data)
@@ -57,10 +57,10 @@ Data consumers can choose to accept shared data into several Azure resources:
5757

5858
Shared data in **Azure Data Lake Storage Gen 2** or **Azure Blob Storage** can be stored as a csv or parquet file. Full data snapshots overwrite the contents of the target file if already exists.
5959

60-
Shared data in **Azure SQL Database** and **Azure Synapse Analytics** is stored in tables. If the target table doesn't already exist, Azure Data Share creates the SQL table with the source schema. If a target table with the same name already exists, it will be dropped and overwritten with the latest full snapshot.
60+
Shared data in **Azure SQL Database** and **Azure Synapse Analytics** is stored in tables. If the target table doesn't already exist, Azure Data Share creates the SQL table with the source schema. If a target table with the same name already exists, it is dropped and overwritten with the latest full snapshot.
6161

6262
>[!NOTE]
63-
> For source SQL tables with dynamic data masking, data will appear masked on the recipient side.
63+
> For source SQL tables with dynamic data masking, data appear masked on the recipient side.
6464
6565
### Supported data types
6666

@@ -108,7 +108,7 @@ When you share data from a SQL source, the following mappings are used from SQL
108108

109109
## Prerequisites to share data
110110

111-
To share data snapshots from your Azure SQL resources, you first need to prepare your environment. You'll need:
111+
To share data snapshots from your Azure SQL resources, you first need to prepare your environment. You need:
112112

113113
- An Azure subscription: If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn) before you begin.
114114
- An [Azure SQL Database](/azure/azure-sql/database/single-database-create-quickstart) or [Azure Synapse Analytics (formerly Azure SQL DW)](../synapse-analytics/get-started-create-workspace.md) with tables and views that you want to share.
@@ -135,9 +135,9 @@ You can use one of these methods to authenticate with Azure SQL Database or Azur
135135

136136
#### Microsoft Entra authentication
137137

138-
These prerequisites cover the authentication you'll need so Azure Data Share can connect with your Azure SQL Database:
138+
These prerequisites cover the authentication you need so Azure Data Share can connect with your Azure SQL Database:
139139

140-
- You'll need permission to write to the databases on SQL server: *Microsoft.Sql/servers/databases/write*. This permission exists in the **Contributor** role.
140+
- You need permission to write to the databases on SQL server: *Microsoft.Sql/servers/databases/write*. This permission exists in the **Contributor** role.
141141
- SQL Server **Microsoft Entra Admin** permissions.
142142
- SQL Server Firewall access:
143143
1. In the [Azure portal](https://portal.azure.com/), navigate to your SQL server. Select *Firewalls and virtual networks* from left navigation.
@@ -251,7 +251,7 @@ Confirm that all prerequisites are complete before accepting a data share invita
251251
- Azure Subscription: If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn) before you begin.
252252
- A Data Share invitation: An invitation from Microsoft Azure with a subject titled "Azure Data Share invitation from **<[email protected]>**".
253253
- 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.
254-
- You'll need a resource in Azure to store the shared data. You can use these kinds of resources:
254+
- You need a resource in Azure to store the shared data. You can use these kinds of resources:
255255
- [Azure Storage](../storage/common/storage-account-create.md)
256256
- [Azure SQL Database](/azure/azure-sql/database/single-database-create-quickstart)
257257
- [Azure Synapse Analytics (formerly Azure SQL DW)](../synapse-analytics/get-started-create-workspace.md)
@@ -349,25 +349,25 @@ To open an invitation from email, check your inbox for an invitation from your d
349349
350350
To open an invitation from Azure portal directly, search for **Data Share Invitations** in the Azure portal, which takes you to the list of Data Share invitations.
351351
352-
If you're a guest user on a tenant, you'll need to verify your email address for the tenant before viewing a Data Share invitation for the first time. Once verified, your email is valid for 12 months.
352+
If you're a guest user on a tenant, you need to verify your email address for the tenant before viewing a Data Share invitation for the first time. Once verified, your email is valid for 12 months.
353353

354354
:::image type="content" source="./media/invitations.png" alt-text="Screenshot of the invitations page, showing a pending invitation.":::
355355

356356
Then, select the share you would like to view.
357357

358358
### Accept invitation
359359

360-
1. 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.
360+
1. Make sure all fields are reviewed, including the **Terms of Use**. If you agree to the terms of use, you are required to check the box to indicate you agree.
361361

362362
:::image type="content" source="./media/terms-of-use.png" alt-text="Screenshot of the invitation acceptance page, showing the terms of use highlighted and the agreement selected.":::
363363

364-
1. Under *Target Data Share Account*, select the Subscription and Resource Group that you'll be deploying your Data Share into.
364+
1. Under *Target Data Share Account*, select the Subscription and Resource Group that you are deploying your Data Share into.
365365

366366
1. 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.
367367

368368
1. For the **Received Share Name** field, you might leave the default specified by the data provide, or specify a new name for the received share.
369369

370-
1. Once you've agreed to the terms of use and specified a Data Share account to manage your received share, Select **Accept and configure**. A share subscription will be created.
370+
1. Once you've agreed to the terms of use and specified a Data Share account to manage your received share, Select **Accept and configure**. A share subscription is created.
371371
372372
:::image type="content" source="./media/accept-options.png" alt-text="Screenshot of the acceptance page, showing the target data share account information filled out.":::
373373
@@ -381,7 +381,7 @@ Follow the steps below to configure where you want to receive data.
381381
382382
:::image type="content" source="./media/dataset-map-target.png" alt-text="Screenshot of the received shares page with the map to target button highlighted.":::
383383
384-
1. Select the target resource to store the shared data. Any data files or tables in the target data store with the same path and name will be overwritten. If you're receiving data into a SQL store and the **Allow Data Share to run the above 'create user' SQL script on my behalf** checkbox appears, check the checkbox. Otherwise, follow the instruction in prerequisites to run the script appear on the screen. This will give Data Share resource write permission to your target SQL DB.
384+
1. Select the target resource to store the shared data. Any data files or tables in the target data store with the same path and name will be overwritten. If you're receiving data into a SQL store and the **Allow Data Share to run the above 'create user' SQL script on my behalf** checkbox appears, check the checkbox. Otherwise, follow the instruction in prerequisites to run the script appear on the screen. This gives Data Share resource write permission to your target SQL DB.
385385

386386
:::image type="content" source="./media/dataset-map-target-sql.png" alt-text="Screenshot of the map datasets to target window, showing available targets in the dropdown.":::
387387

@@ -406,15 +406,15 @@ These steps only apply to snapshot-based sharing.
406406

407407
### View history
408408

409-
This step only applies to snapshot-based sharing. To view history of your snapshots, select **History** tab. Here you'll find history of all snapshots that were generated for the past 30 days.
409+
This step only applies to snapshot-based sharing. To view history of your snapshots, select **History** tab. Here you find history of all snapshots that were generated for the past 30 days.
410410

411411
## Snapshot performance
412412

413413
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.
414414
415415
- Source or destination data store input/output operations per second (IOPS) and bandwidth.
416416
- Hardware configuration (For example: vCores, memory, DWU) of the source and target SQL data store.
417-
- 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+
- 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 is impacted.
418418
- Network bandwidth between the source and destination data stores, and location of source and target data stores.
419419
- 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.
420420

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

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: Share and receive data from Azure Blob Storage and Azure Data Lake Storage
33
description: Learn how to share and receive data from Azure Blob Storage and Azure Data Lake Storage.
4-
author: sidontha
5-
ms.author: sidontha
4+
author: chvukosw
5+
ms.author: chvukosw
66
ms.service: azure-data-share
77
ms.topic: how-to
8-
ms.date: 02/12/2025
8+
ms.date: 01/20/2026
99
---
1010

1111
# Share and receive data from Azure Blob Storage and Azure Data Lake Storage
@@ -16,7 +16,7 @@ ms.date: 02/12/2025
1616

1717
This article describes sharing data from **Azure Blob Storage**, **Azure Data Lake Storage Gen1**, and **Azure Data Lake Storage Gen2**.
1818

19-
This article will guide you through:
19+
This article guides you through:
2020

2121
- [What kinds of data can be shared](#whats-supported)
2222
- [How to prepare your environment](#prerequisites-to-share-data)
@@ -121,7 +121,7 @@ Before you accept a data share invitation, make sure you have the following prer
121121
- An Azure subscription. If you don't have a subscription, create a [free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn).
122122
- An invitation from Azure. The email subject should be "Azure Data Share invitation from *\<yourdataprovider\@domain.com>*".
123123
- A registered [Microsoft.DataShare resource provider](concepts-roles-permissions.md#resource-provider-registration) in:
124-
- The Azure subscription where you'll create a Data Share resource.
124+
- The Azure subscription where you create a Data Share resource.
125125
- The Azure subscription where your target Azure data stores are located.
126126

127127
### Prerequisites for a target storage account
@@ -140,7 +140,7 @@ You can open an invitation from email or directly from the [Azure portal](https:
140140

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

143-
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.
143+
If you're a guest user of a tenant, you are 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.
144144

145145
:::image type="content" source="./media/invitations.png" alt-text="Screenshot of the invitations page, showing a pending invitation.":::
146146

@@ -172,11 +172,11 @@ You can open an invitation from email or directly from the [Azure portal](https:
172172

173173
:::image type="content" source="./media/dataset-map-target.png" alt-text="Screenshot of the received shares page with the map to target button highlighted.":::
174174

175-
1. Select a target data store for the data. Files in the target data store that have the same path and name as files in the received data will be overwritten.
175+
1. Select a target data store for the data. Files in the target data store that have the same path and name as files in the received data are overwritten.
176176

177177
:::image type="content" source="./media/map-target.png" alt-text="Screenshot of the map datasets to target window, showing a filesystem name given.":::
178178

179-
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.
179+
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 starts within one minute of the schedule time and subsequent snapshots start within seconds of the scheduled time.
180180

181181
:::image type="content" source="./media/enable-snapshot-schedule.png" alt-text="Screenshot showing the snapshot schedule tab with the enable button selected.":::
182182

articles/data-share/monitor-data-share-reference.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: Monitoring data reference for Azure Data Share
33
description: This article contains important reference material you need when you monitor Azure Data Share.
4-
ms.date: 02/12/2025
4+
ms.date: 01/20/2026
55
ms.custom: horz-monitor
66
ms.topic: reference
7-
author: sidontha
8-
ms.author: sidontha
7+
author: chvukosw
8+
ms.author: chvukosw
99
ms.service: azure-data-share
1010
---
1111

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: Monitor Azure Data Share
33
description: Start here to learn how to monitor Azure Data Share.
4-
ms.date: 02/12/2025
4+
ms.date: 01/20/2026
55
ms.custom: horz-monitor
66
ms.topic: concept-article
7-
author: sidontha
8-
ms.author: sidontha
7+
author: chvukosw
8+
ms.author: chvukosw
99
ms.service: azure-data-share
1010
---
1111

0 commit comments

Comments
 (0)