Inicio rápido: Creación de un área de trabajo de Azure Synapse con la CLI de Azure

La CLI de Azure es la forma de usar la línea de comandos de Azure para administrar los recursos de Azure. Puede utilizarlo en el explorador con Azure Cloud Shell. También puede instalarla en macOS, Linux o Windows y ejecutarla desde la línea de comandos.

En este inicio rápido aprenderá a crear un área de trabajo de Synapse mediante la CLI de Azure.

Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.

Requisitos previos

• Descargar e instalar jq, un procesador JSON de línea de comandos ligero y flexible.

• Una cuenta de almacenamiento de Azure Data Lake Storage Gen2.

  Importante

  El área de trabajo de Azure Synapse debe poder leer y escribir en la cuenta de ADLS Gen2 seleccionada. Además, para cualquier cuenta de almacenamiento que vincule como cuenta de almacenamiento principal, debe haber habilitado el espacio de nombres jerárquico al crearla, como se describe en la página Creación de una cuenta de almacenamiento.

• 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.

Creación de un área de trabajo de Azure Synapse mediante la CLI de Azure

1. Defina las variables de entorno necesarias para crear recursos para el área de trabajo de Azure Synapse.

   Nombre de la variable de entorno	Descripción
   StorageAccountName	Asigne un nombre a la cuenta de almacenamiento de ADLS Gen2 existente.
   StorageAccountResourceGroup	Nombre del grupo de recursos de la cuenta de almacenamiento de ADLS Gen2 existente.
   FileShareName	Nombre del sistema de archivos de almacenamiento existente.
   SynapseResourceGroup	Elija un nuevo nombre para el grupo de recursos de Azure Synapse.
   Región	Elija una de las regiones de Azure.
   SynapseWorkspaceName	Elija un nombre único para la nueva área de trabajo de Azure Synapse.
   SqlUser	Elija un valor para un nombre de usuario nuevo.
   SqlPassword	Elija una contraseña segura.

2. Cree un grupo de recursos como contenedor para el área de trabajo de Azure Synapse:

   az group create --name $SynapseResourceGroup --location $Region
   

3. Cree un área de trabajo de Azure Synapse:

   az synapse workspace create \
     --name $SynapseWorkspaceName \
     --resource-group $SynapseResourceGroup \
     --storage-account $StorageAccountName \
     --file-system $FileShareName \
     --sql-admin-login-user $SqlUser \
     --sql-admin-login-password $SqlPassword \
     --location $Region
   

4. Obtenga la dirección URL web y de desarrollo del área de trabajo de Azure Synapse:

   WorkspaceWeb=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .web')
   
   WorkspaceDev=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .dev')
   

5. Cree una regla de firewall que le permita acceder al área de trabajo de Azure Synapse desde su máquina:

   ClientIP=$(curl -sb -H "Accept: application/json" "$WorkspaceDev" | jq -r '.message')
   ClientIP=${ClientIP##'Client Ip address : '}
   echo "Creating a firewall rule to enable access for IP address: $ClientIP"
   
   az synapse workspace firewall-rule create --end-ip-address $ClientIP --start-ip-address $ClientIP --name "Allow Client IP" --resource-group $SynapseResourceGroup --workspace-name $SynapseWorkspaceName
   

6. Abra la dirección URL web del área de trabajo de Azure Synapse almacenada en la variable de entorno WorkspaceWeb para acceder al área de trabajo:

   echo "Open your Azure Synapse Workspace Web URL in the browser: $WorkspaceWeb"
   

   

7. Una vez implementado, se requieren otros permisos.

• En Azure Portal, asigne otros usuarios del área de trabajo al rol de Colaborador del área de trabajo. Para asignar roles, consulte Asignación de roles de Azure mediante Azure Portal.
• Asigne a otros usuarios los roles de Synapse RBAC adecuados mediante Synapse Studio.
• Un miembro del rol Propietario de la cuenta de Azure Storage debe asignar el rol Colaborador de datos de Storage Blob al MSI del área de trabajo de Azure Synapse y a otros usuarios.

Limpieza de recursos

Siga los pasos que se indican a continuación para eliminar el área de trabajo de Azure Synapse.

Advertencia

Al eliminar un área de trabajo de Azure Synapse, se quitarán también los motores de análisis y los datos almacenados en la base de datos de los grupos de SQL y metadatos de área de trabajo incluidos. Ya no será posible conectarse a los puntos de conexión de SQL o de Apache Spark. Se eliminarán todos los artefactos de código (consultas, cuadernos, definiciones de trabajos y canalizaciones).

La eliminación del área de trabajo no afectará a los datos de Data Lake Store Gen2 vinculados al área de trabajo.

Si desea eliminar el área de trabajo de Azure Synapse, siga estos pasos:

az synapse workspace delete --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup

Pasos siguientes

A continuación, puede crear grupos de SQL o crear grupos de Apache Spark para empezar a analizar y explorar los datos.