Avvio rapido: Creare un'area di lavoro di Azure Synapse con l'interfaccia della riga di comando di Azure

L'interfaccia della riga di comando di Azure è l'esperienza della riga di comando di Azure per gestire le risorse di Azure. È possibile usarla nel browser con Azure Cloud Shell. È anche possibile installarla in macOS, Linux o Windows ed eseguirla dalla riga di comando.

Questa guida di avvio rapido illustra come creare un'area di lavoro di Synapse con l'interfaccia della riga di comando di Azure.

Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

Prerequisiti

• Scaricare e installare jq, un processore JSON da riga di comando leggero e flessibile

• Account di archiviazione di Azure Data Lake Storage Gen2

  Importante

  L'area di lavoro di Azure Synapse deve essere in grado di leggere e scrivere nell'account di ADLS Gen2 selezionato. Inoltre, per qualsiasi account di archiviazione collegato come account di archiviazione primario, è necessario aver abilitato lo spazio dei nomi gerarchico al momento della creazione dell'account di archiviazione, come descritto nella pagina Creare un account Archiviazione.

• Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.

  

• Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.

  • Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere con l'interfaccia della riga di comando di Azure.

  • Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo uso. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.

  • Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

Creare un'area di lavoro di Azure Synapse con l'interfaccia della riga di comando di Azure

1. Definire le variabili di ambiente necessarie per creare le risorse per l'area di lavoro di Azure Synapse.

   Nome di variabile di ambiente	Descrizione
   StorageAccountName	Nome dell'account di archiviazione di ADLS Gen2 esistente.
   StorageAccountResourceGroup	Nome del gruppo di risorse dell'account di archiviazione di ADLS Gen2 esistente.
   FileShareName	Nome del file system di archiviazione esistente.
   SynapseResourceGroup	Scegliere un nuovo nome per il gruppo di risorse di Azure Synapse.
   Area	Scegliere una delle aree di Azure.
   SynapseWorkspaceName	Scegliere un nome univoco per la nuova area di lavoro di Azure Synapse.
   SqlUser	Scegliere un valore per un nuovo nome utente.
   SqlPassword	Scegliere una password sicura.

2. Creare un gruppo di risorse come contenitore per l'area di lavoro di Azure Synapse:

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

3. Creare un'area di lavoro di 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. Ottenere l'URL di sviluppo e Web per l'area di lavoro di 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. Creare una regola del firewall per consentire l'accesso all'area di lavoro di Azure Synapse dal computer in uso:

   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. Aprire l'indirizzo URL Web dell'area di lavoro di Azure Synapse archiviato nella variabile di ambiente WorkspaceWeb per accedere all'area di lavoro:

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

   

7. Dopo la distribuzione, sono necessarie autorizzazioni aggiuntive.

• Nella portale di Azure assegnare altri utenti dell'area di lavoro al ruolo Collaboratore nell'area di lavoro. Per la procedura dettagliata, vedere Assegnare ruoli di Azure usando il portale di Azure.
• Assegnare ad altri utenti i ruoli appropriati del controllo degli accessi in base al ruolo di Synapse usando Synapse Studio.
• Un membro del ruolo Proprietario dell'account Archiviazione di Azure deve assegnare il ruolo Collaboratore dati BLOB Archiviazione all'identità del servizio gestito dell'area di lavoro di Azure Synapse e ad altri utenti.

Pulire le risorse

Per eliminare l'area di lavoro di Azure Synapse, seguire questa procedura.

Avviso

Con l'eliminazione di un'area di lavoro di Azure Synapse verranno rimossi anche i motori di analisi e i dati archiviati nel database dei pool SQL contenuti e dei metadati dell'area di lavoro. Non sarà più possibile connettersi agli endpoint SQL o Apache Spark. Tutti gli artefatti del codice verranno eliminati (query, notebook, definizioni di processi e pipeline).

L'eliminazione dell'area di lavoro non influisce sui dati dell'istanza di Data Lake Store Gen2 collegata all'area di lavoro.

Per eliminare l'area di lavoro di Azure Synapse, eseguire questo comando:

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

Passaggi successivi

Successivamente, è possibile creare pool SQL o pool di Apache Spark per iniziare ad analizzare ed esplorare i dati.