使用 Azure 门户将 Azure Data Share 帐户移到另一个 Azure 区域

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

项目
12/20/2023

Azure Data Share 帐户无法从一个区域移到另一个区域。但是，可以使用一个 Azure 资源管理器模板导出现有 Data Share 帐户，修改参数以便与目标区域匹配，然后将该模板部署到新区域。有关资源管理器和模板的详细信息，请参阅快速入门：使用 Azure 门户创建和部署 Azure 资源管理器模板。

本文将指导你完成使用模板导出、修改和部署现有 Data Share 帐户的过程。

先决条件

请确保 Azure Data Share 帐户位于要从中移动的 Azure 区域。
Azure Data Share 帐户无法在区域之间移动。必须将数据集重新添加到已发送的共享，并向 Data Share 接收方重新发送邀请。对于任何收到的共享，需要请求数据提供程序向你发送新的邀请。

准备并移动

以下步骤说明如何通过门户使用资源管理器模板部署新的 Data Share 帐户。

通过门户导出模板并进行部署

登录到 Azure 门户。
选择“所有资源”，然后选择你的 Data Share 帐户
选择“自动化”>“导出模板”
在“导出模板”窗口中选择“部署”。
选择“编辑参数”，在联机编辑器中打开 parameters.json 文件。

若要编辑 Data Share 帐户名称的参数，请将 parameters>value 下的属性从源 Data Share 帐户的名称更改为你要在新区域中创建的 Data Share 帐户的名称，并确保将名称括在引号中：

{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"accounts_my_datashare_account_name": {
   "value": "<target-datashare-account-name>"
    }
   }
}

在编辑器中选择“保存”。
选择“编辑模板”，在联机编辑器中打开 template.json 文件。

若要编辑 Data Share 帐户将要移到的目标区域，请在联机编辑器中更改 resources 下的 location 属性：

"resources": [
    {
    "type": "Microsoft.DataShare/accounts",
    "apiVersion": "2021-08-01",
    "name": "[parameters('accounts_my_datashare_account_name')]",
    "location": "<target-region>",
    "identity": {
        "type": "SystemAssigned"
    }
    "properties": {}
    }
]

若要获取区域位置代码，请参阅 Azure 位置。区域的代码是不带空格的区域名称，“美国中部” = “centralus”。

如果需要，你还可以更改模板中的其他参数。这种更改是可选的，具体取决于你的要求：

已发送共享 - 可以通过在 template.json 文件中的资源部分添加或删除共享来编辑将哪些已发送共享部署到目标 Data Share 帐户：

"resources": [
    {
    "type": "Microsoft.DataShare/accounts/shares",
    "apiVersion": "2021-08-01",
    "name": "[concat(parameters('accounts_my_datashare_account_name'), '/test_sent_share')]",
    "dependsOn": [
        "[resourceId('Microsoft.DataShare/accounts', parameters('accounts_my_datashare_account_name'))]"
    ],
    "properties": {
        "shareKind": "CopyBased"
    }
    },
]

已发送的共享邀请 - 可以通过在 template.json 文件的 resources 节中添加或删除邀请，来编辑要将哪些邀请部署到目标 Data Share 帐户。

"resources": [
    {
     "type": "Microsoft.DataShare/accounts/shares/invitations",
     "apiVersion": "2021-08-01",
     "name": "[concat(parameters('accounts_my_datashare_account_name'), '/test_sent_share/blob_snapshot_jsmith_microsoft_com')]",
     "dependsOn": [
         "[resourceId('Microsoft.DataShare/accounts/shares', parameters('accounts_my_datashare_account_name'), 'test_sent_share')]",
         "[resourceId('Microsoft.DataShare/accounts', parameters('accounts_my_datashare_account_name'))]"
     ],
    "properties": {
        "targetEmail": "jsmith@microsoft.com"
    }
    }
]

数据集 - 可以通过在 template.json 文件的 resources 节中添加或删除数据集，来编辑要将哪些数据集部署到目标 Data Share 帐户。下面是 BlobFolder 数据集的示例。
如果还要将数据集中包含的资源移到新区域，则必须从 template.json 文件中删除数据集，并在数据集中引用的资源移动到新区域后手动读取这些数据集。

重要

如果正在部署的新 Data Share 帐户不自动继承访问数据集所需的权限，则数据集无法部署。所需的权限取决于数据集类型。请参阅访问 Azure Synapse Analytics 和 Azure SQL 数据库数据集所需的权限。请参阅访问 Azure 存储和 Azure Data Lake Gen1 和 Gen2 数据集所需的权限。

"resources": [
    {
    "type": "Microsoft.DataShare/accounts/shares/dataSets",
    "apiVersion": "2021-08-01",
    "name": "[concat(parameters('accounts_my_datashare_account_name'), '/blobpath/directory')]",
    "dependsOn": [
        "[resourceId('Microsoft.DataShare/accounts/shares', parameters('accounts_my_datashare_account_name'), 'blobpath')]",
        "[resourceId('Microsoft.DataShare/accounts', parameters('accounts_my_datashare_account_name'))]"
         ],
        "kind": "BlobFolder",
        "properties": {
            "containerName": "<container-name>",
            "prefix": "<prefix>"
            "subscriptionId": "<subscription-id>",
            "resourceGroup": "<resource-group-name>",
            "storageAccountName": "<storage-account-name>"
        }
    }
]

在在线编辑器中选择“保存”。
在“项目详细信息”部分下，选择“订阅”下拉菜单以选择要将目标 Data Share 帐户部署到的订阅。
选择“资源组”下拉菜单以选择要将目标 Data Share 帐户部署到的资源组。可以选择“新建”，为目标 Data Share 帐户创建新资源组。
验证“位置”字段是否设置为你要将 Data Share 帐户部署到的目标位置。
在“实例详细信息”下，验证名称是否与先前在参数编辑器中输入的名称匹配。
选择“查看 + 创建”转到下一页。
查看条款并选择“创建”以开始部署。
部署完成后，转到新建的 Data Share 帐户。
如果无法使用模板传输数据集，则需要将数据集读取到所有已发送共享。
向已发送共享的所有收件人重新发送邀请，并提醒共享使用者，他们需要重新接受并重新映射与共享的数据。

验证

已发送的共享

确认源 Data Share 帐户中所有已发送的共享现在都存在于目标 Data Share 帐户中。
对于每个已发送的共享，确认源共享中的所有数据集现在都存在于目标共享中。如果没有，则需要手动读取它们。
对于源帐户中每个已发送共享中的所有共享订阅，请确认已向共享的所有收件人发送邀请，以便他们能够再次访问数据。

已接收的共享

对于从源 Data Share 帐户接收的所有共享，确认已向数据提供者请求新的邀请。
收到这些邀请后，需要重新映射数据集并运行快照以再次访问数据。

清理源资源

若要完成 Data Share 帐户的移动，请删除源 Data Share 帐户。为此，请从 Azure 门户的仪表板中选择资源组，导航到要删除的 Data Share 帐户，然后选择页面顶部的“删除”。

后续步骤

在本教程中，你已将 Azure Data Share 帐户从一个区域移到了另一个区域，并清理了源资源。若要详细了解如何在区域之间移动资源，以及如何在 Azure 中进行灾难恢复，请参阅：

使用 Azure 门户 将 Azure Data Share 帐户移到另一个区域