Traslado de cuentas de Azure Data Share a otra región de Azure mediante Azure Portal

Artículo
12/20/2023

Las cuentas de Azure Data Share no se pueden trasladar de una región a otra. Sin embargo, puede usar una plantilla de Azure Resource Manager para exportar la cuenta de Data Share existente, modificar los parámetros para que coincidan con la región de destino e implementar la plantilla en la nueva región. Para más información sobre Resource Manager y las plantillas, consulte Inicio rápido: Creación e implementación de plantillas de Azure Resource Manager mediante Azure Portal.

Este artículo le guiará a través del proceso de uso de una plantilla para exportar, modificar e implementar una cuenta de Data Share existente.

Requisitos previos

Asegúrese de que la cuenta de Azure Data Share esté en la región de Azure desde la que va a trasladarla.
Las cuentas de Azure Data Share no se pueden trasladar entre regiones. Tendrá que volver a agregar conjuntos de datos a recursos compartidos enviados y volver a enviar las invitaciones a los destinatarios de Data Share. Para los recursos compartidos recibidos, deberá solicitar que el proveedor de datos le envíe una nueva invitación.

Preparación y traslado

En los pasos siguientes se muestra cómo implementar una nueva cuenta de Data Share mediante una plantilla de Resource Manager a través del portal.

Exportación de la plantilla e implementación desde el portal

Inicie sesión en Azure Portal.
Seleccione Todos los recursos y la cuenta de Data Share.
Seleccione Automation>Exportar plantilla.
Elija Implementar en la ventana Exportar plantilla .
Seleccione Editar parámetros para abrir el archivo parameters.json en el editor en línea.
Para editar el parámetro del nombre de la cuenta de Data Share, cambie la propiedad en parámetros>valor del nombre de la cuenta de Data Share de origen al nombre de la cuenta de Data Share que desea crear en una nueva región, y asegúrese de que el nombre está entre comillas:
```
{
"$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>"
    }
   }
}
```
Seleccione Guardar en el editor.
Seleccione Editar plantilla para abrir el archivo template.json en el editor en línea.

Para editar la región de destino a la que se va a trasladar la cuenta de Data Share, cambie la propiedad location en resources en el editor en línea:

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

Para obtener los códigos de ubicación de la región, consulte Ubicaciones de Azure. El código de una región es el nombre de la región sin espacios, Centro de EE. UU. = centralus.

También puede cambiar otros parámetros en la plantilla si lo desea. Esto es opcional según sus requisitos:

Recursos compartidos enviados: puede editar qué recursos compartidos enviados se implementan en la cuenta de recurso compartido de datos de destino agregando o quitando recursos compartidos de la sección resources del archivo 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"
    }
    },
]

Invitaciones de recursos compartidos enviadas: para editar qué invitaciones se implementan en la cuenta de destino de Data Share, agregue o elimine las invitaciones en la sección resources del archivo 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"
    }
    }
]

Conjunto de datos: para editar qué conjuntos de datos se implementan en la cuenta de destino de Data Share, agregue o elimine los conjuntos de datos en la sección resources del archivo template.json. A continuación se muestra un ejemplo de un conjunto de datos BlobFolder.
Si también va a mover los recursos contenidos en los conjuntos de datos a una nueva región, tendrá que quitar los conjuntos de datos del archivo template.json y leerlos manualmente una vez que la cuenta de Data Share y los recursos a los que se hace referencia en los conjuntos de datos se mueven a la nueva región.

Importante

Los conjuntos de datos no se implementarán si la nueva cuenta de Data Share que va a implementar no hereda automáticamente los permisos necesarios para acceder a los conjuntos de datos. Los permisos necesarios dependen del tipo de conjunto de datos. Consulte aquí los permisos necesarios para los conjuntos de datos de Azure Synapse Analytics y Azure SQL Database. Consulte aquí los permisos necesarios para los conjuntos de datos de Azure Storage y Azure Data Lake Gen 1 y Gen 2.

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

Seleccione Guardar en el editor en línea.
En la sección Detalles del proyecto, seleccione la lista desplegable Suscripción para elegir la suscripción en la que se implementará la cuenta de destino de Data Share.
Seleccione la lista desplegable Grupo de recursos para elegir el grupo de recursos donde se implementará la cuenta de Data Share de destino. Puede seleccionar Crear nuevo para crear un grupo de recursos para la cuenta de Data Share de destino.
Compruebe que el campo Ubicación está establecido en la ubicación de destino en la que desea que se implemente la cuenta de Data Share.
En Detalles de la instancia, compruebe que el nombre coincide con el nombre que especificó en el editor de parámetros anterior.
Seleccione Revisar y crear para avanzar a la página siguiente.
Revise los términos y seleccione Crear para empezar la implementación.
Una vez finalizada la implementación, vaya a la cuenta de Data Share recién creada.
Si no pudo transferir conjuntos de datos mediante la plantilla, deberá leer los conjuntos de datos a todos los recursos compartidos enviados.
Vuelva a enviar invitaciones a todos los destinatarios de los recursos compartidos enviados y avise a los consumidores de los recursos compartidos que tendrán que volver a aceptar y reasignar los datos que comparte con ellos.

Comprobar

Recursos compartidos enviados

Confirme que todos los recursos compartidos enviados de la cuenta de Data Share de origen están ahora presentes en la cuenta de destino.
Para cada recurso compartido enviado, confirme que todos los conjuntos de datos del recurso compartido de origen están ahora presentes en el recurso compartido de destino. Si no lo son, deberá leerlos manualmente.
Para todas las suscripciones de recursos compartidos de cada recurso compartido enviado en la cuenta de origen, confirme que ha enviado invitaciones a todos los destinatarios de los recursos compartidos para que puedan acceder a los datos de nuevo.

Recursos compartidos recibidos

Confirme que ha solicitado nuevas invitaciones de proveedores de datos para todos los recursos compartidos recibidos de la cuenta de Data Share de origen.
Una vez que reciba estas invitaciones, deberá volver a asignar los conjuntos de datos y ejecutar instantáneas para acceder a los datos de nuevo.

Limpieza de los recursos de origen

Para completar el traslado de la cuenta de Data Share, elimine la cuenta de Data Share de origen. Para ello, seleccione el grupo de recursos del panel de Azure Portal, vaya a la cuenta de Data Share que desea eliminar y seleccione Eliminar en la parte superior de la página.

Pasos siguientes

En este tutorial, ha trasladado una cuenta de Azure Data Share de una región a otra y ha eliminado los recursos de origen. Para obtener más información sobre cómo trasladar recursos entre regiones y la recuperación ante desastres en Azure, consulte:

Traslado de una cuenta de Azure Data Share a otra región mediante Azure Portal