Merge pull request #261532 from whhender/2023-data-share-freshness

Data Share Freshness 2023

Author: v-dirichards

articles/data-share/concepts-pricing.md

@@ -5,7 +5,7 @@ author:  sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: conceptual
-ms.date: 11/15/2022
+ms.date: 12/19/2023
 ---
 
 # Understand Azure Data Share pricing

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

@@ -6,18 +6,18 @@ author: sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: troubleshooting
-ms.date: 11/30/2022
+ms.date: 12/19/2023
 ---
 
-# Troubleshoot common problems in Azure Data Share 
+# Troubleshoot common problems in Azure Data Share
 
-This article explains how to troubleshoot common problems in Azure Data Share. 
+This article explains how to troubleshoot common problems in Azure Data Share.
 
-## Azure Data Share invitations 
+## Azure Data Share invitations
 
 In some cases, when new users select **Accept Invitation** in an email invitation, they might see an empty list of invitations. This problem could have one of the following causes:
 
-* **The Azure Data Share service isn't registered as a resource provider of any Azure subscription in the Azure tenant.** This problem happens when your Azure tenant has no Data Share resource. 
+* **The Azure Data Share service isn't registered as a resource provider of any Azure subscription in the Azure tenant.** This problem happens when your Azure tenant has no Data Share resource.
 
     When you create an Azure Data Share resource, it automatically registers the resource provider in your Azure subscription. You can manually register the Data Share service by using the following steps. To complete these steps, you need the [Contributor role](../role-based-access-control/built-in-roles.md#contributor) for the Azure subscription. 
 
@@ -31,7 +31,7 @@ In some cases, when new users select **Accept Invitation** in an email invitatio
 
 * **The invitation is already accepted.** The link in the email takes you to the **Data Share Invitations** page in the Azure portal. This page lists only pending invitations. Accepted invitations don't appear on the page. To view received shares and configure your target Azure Data Explorer cluster setting, go to the Data Share resource you used to accept the invitation.
 
-* **You are guest user of the tenant.** If you're a guest user of the tenant, you'll need to verify your email address for the tenant prior to viewing the invitation. Once verified, it's valid for 12 months. 
+* **You are guest user of the tenant.** If you're a guest user of the tenant, you'll need to verify your email address for the tenant prior to viewing the invitation. Once verified, it's valid for 12 months.
 
 ## Creating and receiving shares
 
@@ -43,18 +43,19 @@ The following errors might appear when you create a new share, add datasets, or
 * You don't have proper permissions to x.
 * We couldn't add write permissions for the Azure Data Share account to one or more of your selected resources.
 
-You might see one of these errors if you have insufficient permissions to the Azure data store. For more information, see [Roles and requirements](concepts-roles-permissions.md). 
+You might see one of these errors if you have insufficient permissions to the Azure data store. For more information, see [Roles and requirements](concepts-roles-permissions.md).
 
-You need the write permission to share or receive data from an Azure data store. This permission is typically part of the Contributor role. 
+You need the write permission to share or receive data from an Azure data store. This permission is typically part of the Contributor role.
 
-If you're sharing data or receiving data from the Azure data store for the first time, you also need the *Microsoft.Authorization/role assignments/write* permission. This permission is typically part of the Owner role. Even if you created the Azure data store resource, you're not necessarily the owner of the resource. 
+If you're sharing data or receiving data from the Azure data store for the first time, you also need the *Microsoft.Authorization/role assignments/write* permission. This permission is typically part of the Owner role. Even if you created the Azure data store resource, you're not necessarily the owner of the resource.
 
 When you have the proper permissions, the Azure Data Share service automatically allows the data share resource's managed identity to access the data store. This process can take a few minutes. If you experience failure because of this delay, try again after a few minutes.
 
 SQL-based sharing requires extra permissions. For information about prerequisites, see [Share from SQL sources](how-to-share-from-sql.md).
 
 ## Snapshots
-A snapshot can fail for various reasons. Open a detailed error message by selecting the start time of the snapshot and then the status of each dataset. 
+
+A snapshot can fail for various reasons. Open a detailed error message by selecting the start time of the snapshot and then the status of each dataset.
 
 Snapshots commonly fail for these reasons:
 
@@ -87,17 +88,19 @@ For SQL sources, a snapshot can fail for these other reasons:
 * A target CSV file is generated, but the data can't be read in Excel. You might see this problem when the source SQL table contains data that includes non-English characters. In Excel, select the **Get Data** tab and choose the CSV file. Select the file origin **65001: Unicode (UTF-8)**, and then load the data.
 
 ## Update snapshot schedule
+
 After the data provider updates the snapshot schedule for the sent share, the data consumer needs to disable the previous snapshot schedule, then enable the updated snapshot schedule for the received share. Snapshot schedule is stored in UTC, and shown in the UI as the computer local time. It doesn't automatically adjust for daylight saving time.  
 
 ## In-place sharing
+
 Dataset mapping can fail for Azure Data Explorer clusters due to the following reasons:
 
-* User doesn't have *write* permission to the Azure Data Explorer cluster. This permission is typically part of the Contributor role. 
+* User doesn't have *write* permission to the Azure Data Explorer cluster. This permission is typically part of the Contributor role.
 * The source or target Azure Data Explorer cluster is paused.
 * Source Azure Data Explorer cluster is EngineV2 and target is EngineV3, or vice versa. Sharing between Azure Data Explorer clusters of different engine versions isn't supported.
 
 ## Next steps
 
-To learn how to start sharing data, continue to the [Share data](share-your-data.md) tutorial. 
+To learn how to start sharing data, continue to the [Share data](share-your-data.md) tutorial.
 
 To learn how to receive data, continue to the [Accept and receive data](subscribe-to-data-share.md) tutorial.

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

@@ -5,21 +5,21 @@ author: sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: how-to
-ms.date: 10/27/2022
+ms.date: 12/19/2023
 ---
 # Disaster recovery for Azure Data Share
 
-This article explains how to configure a disaster recovery environment for Azure Data Share. Azure data center outages are rare, but can last anywhere from a few minutes to hours. Data Center outages can cause disruption to environments that are relying on data being shared by the data provider. By following the steps detailed in this article, data providers can continue to share data with their data consumers in the event of a data center outage for the primary region hosting your data share. 
+This article explains how to configure a disaster recovery environment for Azure Data Share. Azure data center outages are rare, but can last anywhere from a few minutes to hours. Data Center outages can cause disruption to environments that are relying on data being shared by the data provider. By following the steps detailed in this article, data providers can continue to share data with their data consumers if there's a data center outage for the primary region hosting your data share.
 
 ## Achieving business continuity for Azure Data Share
 
-To be prepared for a data center outage, the data provider can have a data share environment provisioned in a secondary region. Measures can be taken to ensure a smooth failover in the event that a data center outage does occur. 
+To be prepared for a data center outage, the data provider can have a data share environment provisioned in a secondary region. Measures can be taken to ensure a smooth failover if a data center outage does occur.
 
-Data providers can provision secondary Azure Data Share resources in an additional region. These Data Share resources can be configured to include shares and datasets that exist in the primary Azure Data Share resource. They can invite data consumers to the secondary shares when configuring the DR environment or at a later time (i.e as part of manual failover steps).
+Data providers can create secondary Azure Data Share resources in another region. These Data Share resources can be configured to include shares and datasets that exist in the primary Azure Data Share resource. They can invite data consumers to the secondary shares when configuring the DR environment or at a later time (i.e as part of manual failover steps).
 
-If the data consumers have active share subscriptions in a secondary environment provisioned for DR purposes, they can enable snapshot schedule as part of failover. If the data consumers do not want to subscribe to a secondary region for DR purposes, they can be invited into the secondary share at a later time. 
+If the data consumers have active share subscriptions in a secondary environment provisioned for DR purposes, they can enable snapshot schedule as part of failover. If the data consumers don't want to subscribe to a secondary region for DR purposes, they can be invited into the secondary share at a later time.
 
-Data consumers can either have an active share subscription that is idle for DR purposes, or data providers can invite them at a later time as part of manual failover procedures. 
+Data consumers can either have an active share subscription that is idle for DR purposes, or data providers can invite them at a later time as part of manual failover procedures.
 
 ## Related information
 

articles/data-share/disaster-recovery.md

@@ -5,7 +5,7 @@ author: sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: how-to
-ms.date: 10/27/2022
+ms.date: 12/19/2023
 ---
 
 # How to add datasets to an existing share in Azure Data Share
@@ -16,18 +16,22 @@ For information on how to add datasets as you create a share, see the [Share dat
 
 ## Navigate to a sent data share
 
-In Azure Data Share, navigate to your sent share and select the **Datasets** tab. Click **+ Add Datasets** button to add more datasets.
+In Azure Data Share, navigate to your sent share and select the **Datasets** tab. Select **+ Add Datasets** button to add more datasets.
 
 ![Screenshot shows Add Datasets selected.](./media/how-to/how-to-add-datasets/add-datasets.png)
 
-In the panel on the right, select the dataset type you would like to add and then click **Next**. Select the subscription and resource group of the data you would like to add. Using the dropdown arrows, find and then check the box next to the data to add.
+In the panel on the right, select the dataset type you would like to add and then select **Next**. Select the subscription and resource group of the data you would like to add. Using the dropdown arrows, find and then check the box next to the data to add.
 
 ![Screenshot shows the Add Blob Storage pane where you can select data.](./media/how-to/how-to-add-datasets/add-datasets-side.png)
 
-Once you click **Add Datasets**, the datasets will be added to your share. 
-Note: A snapshot must be triggered by your consumers in order for them to see the new datasets. If there are snapshot settings configured, consumers will see the new datasets once the next scheduled snapshot completes. 
-Without snapshot settings configured, the consumer must manually trigger a full or incremental copy of the data to receive the updates. 
-For more information on snapshots, see [Snapshots](terminology.md).
+Once you select **Add Datasets**, the datasets are added to your share.
+
+>[!NOTE]
+>A snapshot must be triggered by your consumers in order for them to see the new datasets. If there are snapshot settings configured, consumers will see the new datasets once the next scheduled snapshot completes.
+
+Without snapshot settings configured, the consumer must manually trigger a full or incremental copy of the data to receive the updates.
+For more information on snapshots, see [Snapshots](terminology.md#snapshot).
 
 ## Next steps
+
 Learn more about how to [add recipients to an existing data share](how-to-add-recipients.md).

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

@@ -5,23 +5,24 @@ author: sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: how-to
-ms.date: 10/27/2022
+ms.date: 12/19/2023
 ---
 # How to add a recipient to your share
 
-You can add recipient when you create a new share or to an existing share. From Azure Data Share UI, you can add recipient using the Azure sign-in email of the user.  From API, you can use a combination of user/service principal and tenant ID. When a tenant ID is specified, the invitation can only be accepted into this tenant. Also from API, you can create an invitation without sending an email to the recipient. 
+You can add recipient when you create a new share or to an existing share. From Azure Data Share UI, you can add recipient using the Azure sign-in email of the user.  From API, you can use a combination of user/service principal and tenant ID. When a tenant ID is specified, the invitation can only be accepted into this tenant. Also from API, you can create an invitation without sending an email to the recipient.
 
 ## Add recipient to an existing share
 
 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, select **Add Recipient**.
 
 ![Screenshot shows Add Recipient selected.](./media/how-to/how-to-add-recipients/add-recipient.png)
 
-A panel will pop out on the right side of the page. Select **Add Recipient** and then fill in the email of your new recipient on the blank line. Make sure to use recipient's Azure sign-in email (using their email alias won't work). 
+A panel will pop out on the right side of the page. Select **Add Recipient** and then fill in the email of your new recipient on the blank line. Make sure to use recipient's Azure sign-in email (using their email alias won't work).
 
 ![Screenshot shows the Add Recipient pane where you can Add and send invitation.](./media/how-to/how-to-add-recipients/add-recipient-side.png)
 
 Select **Add and send invitation**. The new recipient(s) will be sent invitation emails to this share.
 
 ## Next steps
+
 Learn more about how to [delete an invitation to a share](how-to-delete-invitation.md).

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

@@ -5,37 +5,34 @@ author: sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: how-to
-ms.date: 10/27/2022
+ms.date: 12/19/2023
 ---
 # How to configure a dataset mapping for a received share in Azure Data Share
 
-This article explains how to configure a dataset mapping for a Received Share using Azure Data Share. You may want to configure a dataset mapping to specify a target data store where you want to receive data, or if you need to change the target data store.
+This article explains how to configure a dataset mapping for a received share using Azure Data Share. You might want to configure a dataset mapping to specify a target data store where you want to receive data, or if you need to change the target data store.
 
 ## Navigate to a received data share
 
-In the Azure Data Share service, navigate to your received share and select the **Datasets** tab. 
+In the Azure Data Share service, navigate to your received share and select the **Datasets** tab.
 
-![Dataset mapping](./media/dataset-mapping.png "Dataset mapping") 
+![Dataset mapping](./media/dataset-mapping.png "Dataset mapping")
 
 Check the box next to the dataset you'd like to assign a destination to. Select **+ Map to target** to choose a new destination store. Select **Unmap** first if the dataset is already mapped and you want to change the target data store.
 
-![Map to target](./media/dataset-map-target.png "Map to target") 
+![Map to target](./media/dataset-map-target.png "Map to target")
 
 ## Select a target store
 
-Select a target data store type that you'd like the data to land in. For snapshot-based sharing, any data that already exists in any previously mapped storage accounts will not be automatically moved to the new target store. For in-place sharing, select a data store in the Location specified. The Location is the Azure data center where data provider's source data store is located at.
+Select a target data store type that you'd like the data to land in. For snapshot-based sharing, any data that already exists in any previously mapped storage accounts won't be automatically moved to the new target store. For in-place sharing, select a data store in the Location specified. The Location is the Azure data center where data provider's source data store is located at.
 
-![Target storage account](./media/dataset-map-target-sql.png "Target storage") 
+![Target storage account](./media/dataset-map-target-sql.png "Target storage")
 
 ## Select a file format (SQL sources only)
 
-If the source data is from a SQL-based source and you want to receive it as a file, you can choose which format it is received in. 
+If the source data is from a SQL-based source and you want to receive it as a file, you can choose which format it's received in.
 
 ![Choose format](./media/sql-file-formats.png "SQL file formats")
 
 ## Next steps
 
 To learn how to start sharing data, continue to the [share your data](share-your-data.md) tutorial.
-
-
-

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

@@ -5,17 +5,19 @@ author: sidontha
 ms.author: sidontha
 ms.service: data-share
 ms.topic: how-to
-ms.date: 10/27/2022
+ms.date: 12/19/2023
 ---
+
 # How to delete an invitation to a recipient in Azure Data Share
 
-This article explains how to delete an invitation to a recipient before they accept it. This will prevent them from creating a share subscription and they will never receive any shared data. If you delete the invitation to a consumer who has already created a share subscription, deleting their invitation won't have any impact.
+This article explains how to delete an invitation to a recipient before they accept it. This prevents them from creating a share subscription and they'll 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. To revoke a share that's already been accepted, you can [revoke a share subscription.](how-to-revoke-share-subscription.md)
 
 ## Navigate to a sent data share
 
-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**.
+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. Select the boxes next to the recipients whose invitations you would like to delete and then select **Delete**.
 
 ![Delete Invitation](./media/how-to/how-to-delete-invitation/delete-invitation.png)
 
 ## Next steps
+
 Learn more about how to [revoke a share subscription](how-to-revoke-share-subscription.md).