Compartir a través de


Inicio rápido: Creación de un área de trabajo de Azure Synapse Analytics 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 Azure Synapse Analytics mediante la CLI de Azure.

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

Requisitos previos

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

  • Cuenta de almacenamiento de Azure Data Lake Storage Gen2.

    Importante

    Un área de trabajo de Azure Synapse Analytics debe poder leer y escribir en la cuenta de Data Lake Storage 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 Creación de una cuenta de almacenamiento.

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

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

    Nombre de la variable de entorno Descripción
    StorageAccountName Nombre de la cuenta de almacenamiento de Data Lake Storage Gen2 existente.
    StorageAccountResourceGroup Nombre del grupo de recursos de la cuenta de almacenamiento de Data Lake Storage Gen2 existente.
    FileShareName Nombre del sistema de archivos de almacenamiento existente.
    SynapseResourceGroup Elija un nuevo nombre para el grupo de recursos de Azure Synapse Analytics.
    Region Elija una de las regiones de Azure.
    SynapseWorkspaceName Elija un nombre único para la nueva área de trabajo de Azure Synapse Analytics.
    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 Analytics:

    az group create --name $SynapseResourceGroup --location $Region
    
  3. Cree un área de trabajo de Azure Synapse Analytics:

    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 las direcciones URL web y de desarrollo del área de trabajo de Azure Synapse Analytics:

    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 para permitir el acceso al área de trabajo de Azure Synapse Analytics desde la 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 Analytics 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"
    

    Captura de pantalla que muestra la web del área de trabajo de Azure Synapse Analytics.

  7. Una vez implementado, se requieren más permisos:

Limpieza de recursos

Siga estos pasos para eliminar el área de trabajo de Azure Synapse Analytics.

Advertencia

Al eliminar un área de trabajo de Azure Synapse Analytics, 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 la cuenta de Data Lake Storage Gen2 vinculada al área de trabajo.

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

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

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