Tutorial: Aceptar y recibir datos: Azure Data Share

En este tutorial, aprenderá a aceptar una invitación de recurso compartido de datos mediante Azure Data Share. Aprenderá a recibir datos que se comparten con usted y a habilitar un intervalo de actualización normal para asegurarse de que siempre tiene la instantánea más reciente de los datos que se comparten con usted.

Aceptación de una invitación de Azure Data Share
Creación de una cuenta de Azure Data Share
Especificar un destino para los datos
Crea una suscripción a tu compartición de datos para la actualización programada

Prerrequisitos

Para poder aceptar una invitación a un recurso compartido de datos, debe crear algunos recursos de Azure, que se enumeran a continuación.

Asegúrese de que se completen todos los requisitos previos antes de aceptar una invitación a un recurso compartido de datos.

Suscripción de Azure: si no tiene una suscripción de Azure, cree una cuenta gratuita antes de empezar.
Una invitación a Data Share: una invitación de Microsoft Azure con un asunto titulado "Invitación de Azure Data Share desde yourdataprovider@domain.com".
Registre el proveedor de recursos Microsoft.DataShare en la suscripción de Azure donde creará un recurso de Data Share y la suscripción de Azure donde se encuentran los almacenes de datos de Azure de destino.

Recepción de datos en una cuenta de almacenamiento

Una cuenta de Azure Storage: si aún no tiene una, puede crear una cuenta de Azure Storage.
Permiso para escribir en la cuenta de almacenamiento, que está presente en Microsoft.Storage/storageAccounts/write. Este permiso existe en el rol Colaborador de la cuenta de almacenamiento .
Permiso para agregar la asignación de roles a la cuenta de almacenamiento, que está presente en Microsoft.Authorization/role assignments/write. Este permiso existe en el rol Propietario.

Recepción de datos en un destino basado en SQL

Si decide recibir datos en Azure SQL Database, Azure Synapse Analytics, a continuación se muestra la lista de requisitos previos.

Requisitos previos para recibir datos en Azure SQL Database o Azure Synapse Analytics (anteriormente Azure SQL DW)

Una instancia de Azure SQL Database o Azure Synapse Analytics (anteriormente Azure SQL DW).
Permiso para escribir en bases de datos en el servidor SQL Server, que está presente en Microsoft.Sql/servers/databases/write. Este permiso existe en el rol Colaborador .
Administración Microsoft Entra del servidor SQL Server
Acceso al firewall de SQL Server. Esto se puede hacer a través de los pasos siguientes:
1. En SQL Server en Azure Portal, vaya a Firewalls y redes virtuales.
2. Seleccione Sí para Permitir que los servicios y recursos de Azure accedan a este servidor.
3. Seleccione +Agregar dirección IP de cliente. La dirección IP del cliente está sujeta a cambios. Es posible que este proceso deba repetirse la próxima vez que comparta datos SQL desde Azure Portal. También puede agregar un intervalo IP.
4. Haga clic en Guardar.

Requisitos previos para recibir datos en el grupo de SQL de Azure Synapse Analytics (área de trabajo)

Un pool de SQL dedicado de Azure Synapse Analytics (espacio de trabajo). Actualmente, no se admite la recepción de datos en un grupo de SQL sin servidor.
Permiso para escribir en el grupo de SQL en el área de trabajo de Synapse, ubicado en Microsoft.Synapse/workspaces/sqlPools/write. Este permiso existe en el rol Colaborador .
Permiso para que la identidad administrada del recurso de Data Share acceda al grupo de SQL del área de trabajo de Synapse. Esto se puede hacer a través de los pasos siguientes:
1. En Azure Portal, vaya al área de trabajo de Synapse. Seleccione Administrador de Microsoft Entra en el panel de navegación izquierdo y establézcalo como administrador de Microsoft Entra.
2. Abra Synapse Studio y seleccione Administrar en el panel de navegación izquierdo. Seleccione Control de acceso en Seguridad. Debe asignarse el rol administrador de SQL o administrador del área de trabajo.
3. En Synapse Studio, seleccione Desarrollar en el panel de navegación izquierdo. Ejecute el siguiente script en el grupo de SQL para agregar la identidad administrada del recurso de Data Share como "db_datareader, db_datawriter, db_ddladmin".
```
create user "<share_acc_name>" from external provider; 
exec sp_addrolemember db_datareader, "<share_acc_name>"; 
exec sp_addrolemember db_datawriter, "<share_acc_name>"; 
exec sp_addrolemember db_ddladmin, "<share_acc_name>";
```
  El <share_acc_name> es el nombre del recurso de Data Share. Si aún no ha creado un recurso de Data Share, puede volver a este requisito previo más adelante.
Acceso al firewall del área de trabajo de Synapse. Esto se puede hacer a través de los pasos siguientes:
1. En Azure Portal, vaya al área de trabajo de Synapse. Seleccione Firewalls en el panel de navegación izquierdo.
2. Seleccione ACTIVADO para Permitir que los servicios y recursos de Azure accedan a esta área de trabajo.
3. Seleccione +Agregar dirección IP de cliente. La dirección IP del cliente está sujeta a cambios. Es posible que este proceso deba repetirse la próxima vez que comparta datos SQL desde Azure Portal. También puede agregar un intervalo IP.
4. Haga clic en Guardar.

Recepción de datos en un clúster de Azure Data Explorer:

Un clúster de Azure Data Explorer en el mismo centro de datos de Azure que el clúster de Data Explorer del proveedor de datos: si aún no tiene uno, puede crear un clúster de Azure Data Explorer. Si no conoce el centro de datos de Azure del clúster del proveedor de datos, puede crear el clúster más adelante en el proceso.
Permiso para escribir en el clúster de Azure Data Explorer, que está presente en Microsoft.Kusto/clusters/write. Este permiso existe en el rol Colaborador.

Inicie sesión en Azure Portal.

Invitación abierta

Puede abrir la invitación desde el correo electrónico o directamente desde Azure Portal.

Para abrir la invitación desde el correo electrónico, active la bandeja de entrada para obtener una invitación del proveedor de datos. La invitación procede de Microsoft Azure, titulada Invitación de Azure Data Share desde yourdataprovider@domain.com. Seleccione Ver invitación para ver la invitación en Azure.

Para abrir la invitación directamente desde Azure Portal, busque Invitaciones de Data Share en Azure Portal. Esta acción le lleva a la lista de invitaciones de Data Share.

Si es un usuario invitado de un inquilino, se le pedirá que compruebe la dirección de correo electrónico del inquilino antes de ver la invitación de Data Share por primera vez. Una vez comprobado, será válido durante 12 meses.
Seleccione la invitación que desea ver.

Prepare el entorno de la CLI de Azure y, a continuación, vea las invitaciones.

Empiece por preparar el entorno para la CLI de Azure:

Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.
Si prefieres ejecutar comandos de referencia CLI localmente, instala la CLI de Azure. Si estás utilizando Windows o macOS, considera ejecutar Azure CLI en un contenedor Docker. Para obtener más información, consulte Cómo ejecutar el Azure CLI en un contenedor de Docker.
- Si estás utilizando una instalación local, inicia sesión en Azure CLI utilizando el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.
- En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.
- Ejecute az version para ver la versión y las bibliotecas dependientes que están instaladas. Para actualizar a la versión más reciente, ejecute az upgrade.

Ejecute el comando az datashare consumer-invitation list-invitation para ver las invitaciones actuales:

az datashare consumer-invitation list-invitation

Copie el identificador de invitación para usarlo en la sección siguiente.

Empiece por preparar el entorno para PowerShell. Puede ejecutar comandos de PowerShell localmente o mediante el entorno de Bash en Azure Cloud Shell.

Si opta por usar Azure PowerShell en un entorno local:
- Instale la versión más reciente del módulo Az PowerShell.
- Conéctese a su cuenta de Azure mediante el cmdlet Connect-AzAccount.
Si decide usar Azure Cloud Shell:
- Consulte Introducción a Azure Cloud Shell para más información.

Use el comando Connect-AzAccount para conectarse a su cuenta de Azure.
```
Connect-AzAccount
```
Ejecute el comando Set-AzContext para establecer la suscripción correcta, si tiene varias suscripciones.
```
Set-AzContext [SubscriptionID/SubscriptionName]
```
Ejecute el comando Get-AzDataShareReceivedInvitation para ver las invitaciones actuales:
```
Get-AzDataShareReceivedInvitation
```

Copie el identificador de invitación para usarlo en la sección siguiente.

Aceptar invitación

Asegúrese de que se revisan todos los campos, incluidos los Términos de uso. Si acepta los términos de uso, se le pedirá que active la casilla para indicar que está de acuerdo.
En Cuenta de compartición de datos de destino, seleccione la suscripción y el grupo de recursos en los que va a desplegar su recurso compartido de datos.

En el campo Cuenta de Data Share , seleccione Crear nuevo si no tiene una cuenta de Data Share existente. En caso contrario, seleccione la cuenta de Azure Data Share existente en la que desea aceptar los datos compartidos.

Para el campo Nombre del recurso compartido recibido , puede dejar el valor predeterminado especificado por los datos proporcionados o especificar un nuevo nombre para el recurso compartido recibido.

Una vez que haya aceptado los términos de uso y haya especificado una cuenta de Data Share para administrar el recurso compartido recibido, seleccione Aceptar y configurar. Se creará una suscripción al recurso compartido.

Esta acción le lleva al recurso compartido recibido en la cuenta de Data Share.

Si no desea aceptar la invitación, seleccione Rechazar.

Use el comando az datashare share-subscription create para crear la instancia de Data Share.

az datashare share-subscription create --resource-group share-rg \
  --name "fabrikamsolutions" --account-name FabrikamDataShareAccount \
  --invitation-id 89abcdef-0123-4567-89ab-cdef01234567 \
  --source-share-location "East US 2"

Usa el comando New-AzDataShareSubscription para crear el recurso compartido de datos. InvitationId será el identificador que recopiló del paso anterior.

New-AzDataShareSubscription -ResourceGroupName share-rg -AccountName FabrikamDataShareAccount -Name "Fabrikam Solutions" -InvitationId "89abcdef-0123-4567-89ab-cdef01234567"

Siga los pasos siguientes para configurar dónde desea recibir datos.

Seleccione la pestaña Conjuntos de datos . Active la casilla situada junto al conjunto de datos al que desea asignar un destino. Seleccione + Mapear al destino para elegir un destino de datos.
Seleccione un tipo de almacén de datos de destino en el que desea que se coloquen los datos. Los archivos de datos o tablas del almacén de datos de destino con la misma ruta de acceso y nombre se sobrescribirán. Si va a recibir datos en Azure SQL Database o Azure Synapse Analytics (anteriormente Azure SQL DW), active la casilla Permitir que Data Share ejecute el script "crear usuario" anterior en mi nombre.

Para compartir en el lugar, seleccione un almacén de datos en la ubicación especificada. La ubicación es el centro de datos de Azure en el que se encuentra el almacén de datos de origen del proveedor de datos. Una vez que se asigna un conjunto de datos, puede seguir el vínculo de la ruta de acceso de destino para acceder a los datos.
Para el uso compartido basado en instantáneas, si el proveedor de datos ha creado una programación de instantáneas para proporcionar una actualización periódica de los datos, también puede habilitar la programación de instantáneas seleccionando la pestaña Programación de instantáneas . Active la casilla situada junto a la programación de instantáneas y seleccione + Habilitar. La primera instantánea programada se iniciará en un minuto desde el tiempo de programación y las instantáneas posteriores comenzarán en cuestión de segundos desde la hora programada.

Los metadatos de los archivos copiados no se conservan después de cada ejecución. es así por diseño.

Use estos comandos para configurar dónde desea recibir datos.

Ejecute el comando az datashare consumer-source-data-set list para obtener el identificador del conjunto de datos:

az datashare consumer-source-data-set list --resource-group "share-rg" \
 --account-name "FabrikamDataShareAccount" \
   --share-subscription-name "fabrikamsolutions" \

Si necesita una cuenta de almacenamiento, ejecute el comando az storage account create para crear una cuenta de almacenamiento para este recurso compartido de datos:
```
az storage account create --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
```

Use el comando az storage account show para obtener el identificador de la cuenta de almacenamiento:

az storage account show --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
 --query "id"

Utilice el siguiente comando para obtener el ID de entidad principal de la cuenta:

az datashare account show --resource-group "share-rg" --name "FabrikamDataShareAccount" \
  --query "identity.principalId"

Use el comando az role assignment create para crear una asignación de roles para la entidad de seguridad de cuenta mediante el identificador de la entidad de seguridad de cuenta y el identificador de la cuenta de almacenamiento:
```
az role assignment create --role "Contributor" \
  --assignee-object-id aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 
  --assignee-principal-type ServicePrincipal --scope "your\storage\account\id\path"
```

Cree una variable para el mapeo a partir del identificador del conjunto de datos del paso 1:

$mapping='{\"data_set_id\":\"' + $dataset_id + '\",\"container_name\":\"newcontainer\",
  \"storage_account_name\":\"datashareconsumersa\",\"kind\":\"BlobFolder\",\"prefix\":\"consumer\"}'

Use el comando az datashare data-set-mapping create para crear la asignación del conjunto de datos:

az datashare data-set-mapping create --account-name "FabrikamDataShareAccount" \
 --data-set-mapping-name "datasetmapping" --resource-group "share-rg" \
 --share-subscription-name "fabrikamsolutions" --blob-folder-data-set-mapping $mapping

Ejecute el comando az datashare share-subscription synchronize para iniciar la sincronización del conjunto de datos.

az datashare share-subscription synchronize \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount"  \
  --name "Fabrikam Solutions" --synchronization-mode "Incremental" \

Ejecute el comando az datashare share-subscription list-synchronization para ver una lista de las sincronizaciones:

az datashare share-subscription list-synchronization \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount" \
  --share-subscription-name "Fabrikam Solutions" \

Use el comando az datashare share-subscription list-source-share-synchronization-setting para ver la configuración de sincronización establecida en el recurso compartido.

az datashare share-subscription list-source-share-synchronization-setting \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount" \
  --share-subscription-name "Fabrikam Solutions"

Use estos comandos para configurar dónde desea recibir datos.

Ejecute el comando Get-AzDataShareSourceDataSet para obtener el identificador del conjunto de datos:

Get-AzDataShareSourceDataSet -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"

Si aún no tiene una ubicación en la que desea almacenar los datos compartidos, puede seguir estos pasos para crear una cuenta de almacenamiento. Si ya tiene almacenamiento, puede ir directamente a los pasos siguientes.
1. Ejecute el comando New-AzStorageAccount para crear una cuenta de Azure Storage:
```
$storageAccount = New-AzStorageAccount -ResourceGroupName "share-rg" -AccountName FabrikamStorageAccount -Location "East US 2" -SkuName Standard_GRS

$ctx = $storageAccount.Context
```
2. Ejecute el comando New-AzStorageContainer para crear un contenedor en la nueva cuenta de Azure Storage que contendrá los datos:
```
$containerName = "StorageContainer"

New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob
```
3. Ejecute el comando Set-AzStorageBlobContent para cargar un archivo. En el ejemplo siguiente se carga textfile.csv desde la carpeta D:\testFiles en la memoria local, en el contenedor que creó.
```
Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
```
Para más información sobre cómo trabajar con Azure Storage en PowerShell, siga esta guía de PowerShell de Azure Storage.
Use el comando Get-AzStorageAccount para obtener el identificador de la cuenta de almacenamiento:
```
Get-AzStorageAccount -ResourceGroupName "share-rg" -Name FabrikamStorageAccount
```

Use el identificador del conjunto de datos del primer paso y ejecute el comando New-AzDataShareDataSetMapping para crear la asignación del conjunto de datos:

New-AzDataShareDataSetMapping -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -Name "Fabrikam Solutions" -StorageAccountResourceId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"  -DataSetId "0123abcd-ef01-2345-6789-abcdef012345"  -Container "StorageContainer"

Ejecute el comando Start-AzDataShareSubscriptionSynchronization para iniciar la sincronización del conjunto de datos.

Start-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationMode "Incremental"

Ejecute el comando Get-AzDataShareSubscriptionSynchronization para ver una lista de las sincronizaciones:

Get-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"

Use el comando Get-AzDataShareSubscriptionSynchronizationDetail para ver la configuración de sincronización establecida en el recurso compartido.

Get-AzDataShareSubscriptionSynchronizationDetail -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationId "a6ee5c8d-0ce0-485e-b2f2-966b187dc6c7"

Desencadenamiento de una instantánea

Estos pasos solo se aplican al uso compartido basado en capturas.

Para desencadenar una instantánea, seleccione la pestaña Detalles seguida de Activar instantánea. Aquí puede iniciar una instantánea completa o incremental de sus datos. Si es la primera vez que recibe datos del proveedor de datos, seleccione copia completa.
Si el estado de la última ejecución es exitoso, dirígete al almacén de datos de destino para ver los datos recibidos. Seleccione Conjuntos de datos y seleccione el vínculo en la ruta de acceso de destino.

Ejecute el comando az datashare trigger create para iniciar una instantánea:

az datashare trigger create --account-name "FabrikamDataShareAccount" --resource-group "share-rg" --share-subscription-name "Fabrikam Solutions" --scheduled-trigger recurrence-interval="Day" synchronization-mode="Incremental" synchronization-time="2018-11-14T04:47:52.9614956Z" --name "Trigger1"

Estos pasos solo se aplican al uso compartido basado en capturas.

Ejecute el comando New-AzDataShareTrigger para desencadenar una instantánea:

New-AzDataShareTrigger -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -Name "Fabrikam Solutions" -RecurrenceInterval "Day" -SynchronizationTime "2018-11-14T04:47:52.9614956Z"

Visualización del historial

Este paso solo se aplica al uso compartido basado en instantáneas. Para ver el historial de las instantáneas, seleccione la pestaña Historial . Aquí encontrará el historial de todas las instantáneas generadas durante los últimos 30 días.

Limpieza de recursos

Cuando el recurso ya no sea necesario, vaya a la página Información general de Data Share y seleccione Eliminar para quitarlo.

Pasos siguientes

En este tutorial, aprendiste a aceptar y recibir un Azure Data Share. Para más información sobre los conceptos de Azure Data Share, continúe con la terminología de Azure Data Share.

Conceptos de Azure Data Share

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-10-08