Tutorial: Uso compartido de datos mediante Azure Data Share

En este tutorial, descubrirá cómo configurar una nueva instancia de Azure Data Share y empezar a compartir sus datos con clientes y asociados externos a la organización de Azure.

En este tutorial, aprenderá a:

• Crear una instancia de Azure Data Share.
• Agregar conjuntos de datos a la instancia de Azure Data Share.
• Habilitar una programación de instantáneas para la instancia de Data Share.
• Agregar destinatarios a una instancia de Azure Data Share.

Prerrequisitos

• Suscripción de Azure: Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
• La dirección de correo electrónico de Azure del destinatario (con el alias de correo electrónico no funcionará).
• Si el almacén de datos de Azure de origen está en una suscripción de Azure diferente a la que usará para crear el recurso de Data Share, registre el proveedor de recursos Microsoft.DataShare en la suscripción en la que se encuentra el almacén de datos de Azure.

Uso compartido desde una cuenta de almacenamiento

• Una cuenta de Azure Storage: si no la tiene, puede crear una cuenta de Azure Storage
• Permisos para escribir en la cuenta de almacenamiento, que se encuentra en Microsoft.Storage/storageAccounts/write. Este permiso existe en el rol de colaborador de cuenta de Storage.
• Permisos para agregar la asignación de roles a la cuenta de almacenamiento, que se encuentra en Microsoft.Authorization/role assignments/write. Este permiso existe en el rol de propietario.

Uso compartido desde un origen basado en SQL

A continuación se muestra la lista de requisitos previos para compartir datos desde el origen de SQL.

Requisitos previos para el uso compartido desde 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) con las tablas y vistas que quiera compartir.
• Permisos para escribir en las bases de datos de SQL Server, que se encuentra en Microsoft.Sql/servers/databases/write. Este permiso existe en el rol de colaborador.
• Administración Microsoft Entra del servidor SQL Server
• Acceso al firewall de SQL Server. Esto se puede hacer mediante los siguientes pasos:
  1. En Azure Portal, vaya a SQL Server. Seleccione Firewalls y redes virtuales en el panel de navegación izquierdo.
  2. Seleccione Sí en Permitir que los servicios y recursos de Azure accedan a este servidor.
  3. Seleccione +Agregar IP de cliente. La dirección IP del cliente está sujeta a cambios. Es posible que se tenga repetir este proceso la próxima vez que comparta datos de SQL desde Azure Portal. También puede agregar un intervalo de direcciones IP.
  4. Seleccione Guardar.

Requisitos previos para el uso compartido desde el grupo de SQL de Azure Synapse Analytics (área de trabajo)

• • Un grupo de SQL dedicado de Azure Synapse Analytics (área de trabajo) con tablas que quiera compartir. Actualmente, no se admite el uso compartido de vistas. Actualmente, no se admite el uso compartido desde el grupo de SQL sin servidor.

• Permiso para escribir en el grupo de SQL en el área de trabajo de Synapse, que se encuentra en Microsoft.Synapse/workspaces/sqlPools/write. Este permiso existe en el rol de colaborador.

• Permiso para que la identidad administrada del recurso de Data Share tenga acceso al grupo de SQL del área de trabajo de Synapse. Esto se puede hacer mediante los siguientes pasos:

  1. En Azure Portal, vaya al área de trabajo de Synapse. Seleccione Administrador de SQL Active Directory 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. En Seguridad, seleccione Control de acceso. 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.

     create user "<share_acct_name>" from external provider;     
     exec sp_addrolemember db_datareader, "<share_acct_name>"; 
     

     <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 mediante los siguientes pasos:

  1. En Azure Portal, vaya al área de trabajo de Synapse. Seleccione Firewalls en el panel de navegación izquierdo.
  2. En Permitir que los servicios y recursos de Azure accedan a esta área de trabajo, seleccione Activado.
  3. Seleccione +Agregar IP de cliente. La dirección IP del cliente está sujeta a cambios. Es posible que se tenga repetir este proceso la próxima vez que comparta datos de SQL desde Azure Portal. También puede agregar un intervalo de direcciones IP.
  4. Seleccione Guardar.

Uso compartido desde Azure Data Explorer

• Un clúster de Azure Data Explorer con las bases de datos que desea compartir.
• Permisos para escribir en el clúster de Azure Data Explorer, que se encuentra en Microsoft.Kusto/clusters/write. Este permiso existe en el rol de colaborador.

Inicio de sesión en Azure Portal

Inicie sesión en Azure Portal.

Creación de una cuenta de Azure Data Share

Portal

Cree un recurso de Azure Data Share en un grupo de recursos de Azure.

1. Seleccione el botón de menú de la esquina superior izquierda del portal y, a continuación, seleccione Crear un recurso.

2. Busque Data Share.

3. Seleccione Data Share y, después, Crear.

4. Rellene los detalles básicos del recurso de Azure Data Share con la siguiente información.

   Configuración	Valor sugerido	Descripción del campo
   Subscription	Su suscripción	Seleccione la suscripción de Azure que desea usar para la cuenta del recurso compartido de datos.
   Grupo de recursos	testresourcegroup	Use un grupo de recursos existente o cree uno.
   Location	Este de EE. UU. 2	Seleccione una región para la cuenta de Azure Data Share.
   Nombre	datashareaccount	Especifique un nombre para la cuenta del recurso compartido de datos.

5. Seleccione Revisar + Crear y, después, Crear para crear la cuenta de recurso compartido de datos. La creación de una cuenta de recurso compartido de datos normalmente tarda aproximadamente 2 minutos o menos.

6. Cuando la implementación se complete, seleccione Ir al grupo de recursos.

CLI de Azure

Cree un recurso de Azure Data Share en un grupo de recursos de Azure.

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 Inicio rápido para Bash en Azure Cloud Shell.

  

• Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante 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 Inicio de sesión con 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 más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Use estos comandos para crear el recurso:

1. Use el comando az account set para establecer que la suscripción sea la suscripción predeterminada actual:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Para registrar el proveedor de recursos, ejecute el comando az provider register.

   az provider register --name "Microsoft.DataShare"
   

3. Ejecute el comando az group create para crear un grupo de recursos o use un grupo de recursos existente:

   az group create --name testresourcegroup --location "East US 2"
   

4. Ejecute el comando az datashare account create para crear una cuenta de Data Share:

   az datashare account create --resource-group testresourcegroup --name datashareaccount --location "East US 2" 
   

   Ejecute el comando az datashare account list para ver las cuentas de Data Share:

   az datashare account list --resource-group testresourcegroup
   

PowerShell

Cree un recurso de Azure Data Share en un grupo de recursos de Azure.

Empiece por preparar el entorno para PowerShell. Puede ejecutar los 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 de PowerShell.
  • Conéctese a su cuenta de Azure mediante el cmdlet Connect-AzAccount.
• Si decide usar Azure Cloud Shell:
  • Para más información, consulte Introducción a Azure Cloud Shell.

Use estos comandos para crear el recurso:

1. Conéctese a la cuenta de Azure mediante el comando Connect-AzAccount.

   Connect-AzAccount
   

2. Ejecute el comando Set-AzContext para establecer la suscripción correcta si tiene varias suscripciones.

   Set-AzContext [SubscriptionID/SubscriptionName]
   

3. Ejecute el comando New-AzResourceGroup para crear un grupo de recursos o use uno existente:

   New-AzResourceGroup -Name <String> -Location <String>
   

4. Ejecute el comando New-AzDataShare para crear una cuenta de Data Share:

    New-AzDataShareAccount -ResourceGroupName <String> -Name <String> -Location <String>
   

   Ejecute el comando Get-AzDataShareAccount para ver las cuentas de Data Share:

   Get-AzDataShareAccount
   

Creación de un recurso compartido

Portal

1. Vaya a la página de información general de Azure Data Share.

   

2. Seleccione Start sharing your data (Empezar a compartir datos).

3. Seleccione Crear.

4. Rellene los detalles del recurso compartido. Especifique un nombre, un tipo de recurso compartido, una descripción del contenido de los recursos compartidos y las condiciones de uso (opcional).

   

5. Seleccione Continuar.

6. Para agregar conjuntos de datos al recurso compartido, seleccione Agregar conjuntos de datos.

   

7. Seleccione el tipo de conjunto de datos que desea agregar. Verá una lista diferente de tipos de conjuntos de datos en función del tipo de recurso compartido (instantánea o en contexto) que haya seleccionado en el paso anterior. Si comparte desde Azure SQL Database o Azure Synapse Analytics (anteriormente conocido como Azure SQL DW), se le pedirá el método de autenticación para mostrar las tablas. Seleccione la autenticación de Microsoft Entra y active la casilla Allow Data Share to run the above 'create user' script on my behalf (Permitir que Data Share se ejecute en el script de "creación de usuario" anterior).

   

8. Vaya hasta el objeto que desea compartir y seleccione "Add Datasets" (Agregar conjuntos de datos).

   

9. En la pestaña Destinatarios, escriba las direcciones de correo electrónico del consumidor de datos, para lo que debe seleccionar "+ Add Recipient" (+ Agregar a destinatario).

   

10. Seleccione Continuar.

11. Si ha seleccionado el tipo de recurso compartido de instantáneas, puede configurar la programación de instantáneas para proporcionar actualizaciones de los datos al consumidor de datos.

    

12. Seleccione una hora de inicio y un intervalo de periodicidad.

13. Seleccione Continuar.

14. En la pestaña Revisar y crear, examine el contenido del paquete, la configuración, los destinatarios y la configuración de la sincronización. Seleccione Crear.

CLI de Azure

1. Ejecute el comando az storage account create para crear una cuenta de almacenamiento para esta instancia de Data Share:

   az storage account create --resource-group testresourcegroup --name ContosoMarketplaceAccount
   

2. Use el comando az storage container create para crear un contenedor en la cuenta de almacenamiento creada en el comando anterior:

   az storage container create --name ContosoMarketplaceContainer --account-name ContosoMarketplaceAccount
   

3. Ejecute el comando az datashare create para crear la instancia de Data Share:

   az datashare create --resource-group testresourcegroup \
     --name ContosoMarketplaceDataShare --account-name ContosoMarketplaceAccount \
     --description "Data Share" --share-kind "CopyBased" --terms "Confidential"
   

4. Use el comando az datashare invitation create para crear la invitación para la dirección especificada:

   az datashare invitation create --resource-group testresourcegroup \
     --name DataShareInvite --share-name ContosoMarketplaceDataShare \
     --account-name ContosoMarketplaceAccount --target-email "jacob@fabrikam.com"
   

PowerShell

1. Si aún no tiene datos que quiera compartir, puede seguir estos pasos para crear una cuenta de almacenamiento. Si ya tiene almacenamiento, puede ir directamente al paso 2.

   1. Ejecute el comando New-AzStorageAccount para crear una cuenta de Azure Storage:

      $storageAccount = New-AzStorageAccount -ResourceGroupName <String> -AccountName <String> -Location <String> -SkuName <String>
      
      $ctx = $storageAccount.Context
      

   2. Ejecute el comando New-AzStorageContainer para crear un contenedor en la nueva cuenta de Azure Storage en la que se contendrán los datos:

      $containerName = <String>
      
      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 de la memoria local, en el contenedor que ha creado.

      Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
      

   Para obtener más información sobre cómo trabajar con Azure Storage en PowerShell, siga esta guía sobre PowerShell para Azure Storage.

2. Ejecute el comando New-AzDataShare para crear una instancia de Data Share:

   New-AzDataShare -ResourceGroupName <String> -AccountName <String> -Name <String> -Description <String> -TermsOfUse <String>
   

3. Use el comando New-AzDataShareInvitation para crear la invitación para la dirección especificada:

   New-AzDataShareInvitation -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -TargetEmail <String>
   

4. Use el comando New-AzDataShareSynchronizationSetting para establecer una periodicidad de sincronización para el recurso compartido. Puede ser diariamente, cada hora o en un momento determinado.

   New-AzDataShareSynchronizationSetting -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -RecurrenceInterval <String> -SynchronizationTime <DateTime>
   

Ya se ha creado Azure Data Share y el destinatario de Data Share ya está listo para aceptar la invitación.

Limpieza de recursos

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

Pasos siguientes

En este tutorial, ha aprendido a crear una instancia de Azure Data Share y a invitar a destinatarios. Para obtener información acerca de la forma en que in consumidor de datos puede aceptar y recibir un recurso compartido de datos, vaya al tutorial para aceptar y recibir datos.

Tutorial: Aceptación y recepción de datos con Azure Data Share