Mover contas do Azure Data Share para outra região do Azure usando o portal do Azure

Artigo
12/20/2023

As contas do Azure Data Share não podem ser movidas de uma região para outra. No entanto, você pode usar um modelo do Azure Resource Manager para exportar a conta do Data Share existente, modificar os parâmetros para corresponder à região de destino e, em seguida, implantar o modelo na nova região. Para obter mais informações sobre o Resource Manager e modelos, consulte Início Rápido: Crie e implante modelos do Azure Resource Manager usando o portal do Azure.

Este artigo irá guiá-lo pelo processo de uso de um modelo para exportar, modificar e implantar uma conta de Compartilhamento de Dados existente.

Pré-requisitos

Verifique se a conta do Azure Data Share está na região do Azure da qual você deseja mover.
As contas do Azure Data Share não podem ser movidas entre regiões. Você precisará adicionar novamente conjuntos de dados para enviar compartilhamentos e reenviar convites para destinatários do Data Share. Para quaisquer compartilhamentos recebidos, você precisará solicitar que o provedor de dados envie um novo convite.

Preparar e mover

As etapas a seguir mostram como implantar uma nova conta do Data Share usando um modelo do Resource Manager por meio do portal.

Exportar o modelo e implantar do portal

Faça logon no Portal do Azure.
Selecione Todos os recursos e, em seguida, selecione sua conta do Data Share
Selecione Automação>Exportar modelo
Escolha Implantar na janela Exportar modelo .
Selecione Editar parâmetros para abrir o arquivo parameters.json no editor online.
Para editar o parâmetro do nome da conta do Data Share, altere a propriedade em parâmetros>valor do nome da conta de origem do Data Share para o nome da conta do Data Share que você deseja criar em uma nova região; o nome tem que estar entre aspas:
```
{
"$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>"
    }
   }
}
```
Selecione Salvar no editor.
Selecione Editar modelo para abrir o arquivo template.json no editor online.

Para editar a região de destino para a qual a conta do Data Share será movida, altere a propriedade localização em recursos:

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

Para obter os códigos de localização de região, confira Locais do Azure. O código de uma região é o nome da região em inglês sem espaços, por exemplo, EUA Central = centralus.

Você também pode alterar outros parâmetros no modelo se quiser. Isso é opcional, dependendo de seus requisitos:

Compartilhamentos Enviados - Você pode editar quais Compartilhamentos Enviados são implantados na Conta de Compartilhamento de Dados de destino adicionando ou removendo Compartilhamentos da seção de recursos no arquivo template.json :

"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"
    }
    },
]

Convites de Compartilhamento Enviados – Você pode editar quais Convites são implantados na conta de destino do Data Share adicionando ou removendo Convites da seção de recursos no arquivo template.json.

"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"
    }
    }
]

Conjuntos de dados – Você pode editar quais conjuntos de dados são implantados na conta de destino do Data Share adicionando ou removendo conjuntos de dados da seção de recursos no arquivo template.json. Abaixo está um exemplo de um conjunto de dados BlobFolder.
Se você também estiver movendo os recursos contidos nos conjuntos de dados para uma nova região, será necessário remover os conjuntos de dados do arquivo template.json e adicioná-los manualmente depois que a conta de Compartilhamento de Dados e os recursos referenciados nos conjuntos de dados forem movidos para a nova região.

Importante

Os conjuntos de dados falharão ao implantar se a nova conta do Data Share que você está implantando não herdar automaticamente as permissões necessárias para acessar os conjuntos de dados. As permissões necessárias dependem do tipo de conjunto de dados. Confira aqui as permissões necessárias para conjuntos de dados do Azure Synapse Analytics e do Banco de Dados SQL do Azure. Confira aqui as permissões necessárias para conjuntos de dados do Armazenamento do Azure e do Azure Data Lake Gen 1 e 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>"
        }
    }
]

Selecione Salvar no editor online.
Na seção Detalhes do projeto, selecione a lista suspensa Assinatura para escolher a assinatura na qual a conta do Data Share de destino será implantada.
Selecione a lista suspensa Grupo de recursos para escolher o grupo de recursos no qual a conta do Data Share de destino será implantada. Você pode selecionar Criar a fim de criar um grupo de recursos para a conta do Data Share de destino.
Verifique se o campo Local está definido como o local de destino no qual você deseja que a conta do Data Share seja implantada.
Em Detalhes da instância, verifique se o nome corresponde àquele que você inseriu anteriormente no editor de parâmetros.
Selecione Examinar + Criar para avançar para a próxima página.
Examine os termos e selecione Criar para iniciar a implantação.
Depois que a implantação for concluída, acesse a conta do Data Share recém-criada.
Se você não conseguiu transferir conjuntos de dados usando o modelo, precisará adicionar novamente conjuntos de dados a todos os seus Compartilhamentos Enviados.
Reenvie convites para todos os destinatários de seus compartilhamentos enviados e alerte os consumidores de seus compartilhamentos de que eles precisarão reaceitar e remapear os dados que você está compartilhando com eles.

Verificar

Compartilhamentos enviados

Confirme se todos os compartilhamentos enviados em sua conta do Data Share de origem agora estão presentes na conta do Data Share de destino.
Para cada compartilhamento enviado, confirme se todos os conjuntos de dados do compartilhamento de origem já estão presentes no compartilhamento de destino. Se não estiverem, você precisará adicioná-los manualmente.
Para todas as assinaturas de compartilhamento em cada compartilhamento enviado em sua conta de origem, confirme se você enviou convites a todos os destinatários dos compartilhamentos para que eles possam acessar os dados novamente.

Compartilhamentos recebidos

Confirme se você solicitou novos convites dos provedores de dados para todos os compartilhamentos recebidos de sua conta de compartilhamento de dados de origem.
Depois de receber esses convites, você precisará remapear os conjuntos de dados e executar instantâneos para acessar os dados novamente.

Limpar recursos de origem

Para concluir a mudança da conta do Data Share, exclua a conta do Data Share de origem. Para fazer isso, selecione o grupo de recursos no painel do portal do Azure, navegue até a conta do Data Share que você deseja excluir e selecione Excluir na parte superior da página.

Próximas etapas

Neste tutorial, você moveu uma conta do Azure Data Share de uma região para outra e limpou os recursos de origem. Para saber mais sobre como mover recursos entre regiões e recuperação de desastres no Azure, confira:

Mover uma conta de Compartilhamento de Dados do Azure para outra região usando o portal do Azure