Avvio rapido: Creare un'area di lavoro di Azure Synapse con Azure PowerShell

Azure PowerShell è costituito da un set di cmdlet per la gestione delle risorse di Azure direttamente da PowerShell. È possibile usarla nel browser con Azure Cloud Shell. È anche possibile installarlo in macOS, Linux o Windows.

Questa guida di avvio rapido illustra come creare un'area di lavoro di Synapse con Azure PowerShell.

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

Prerequisiti

• 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. Per qualsiasi account di archiviazione collegato come primario, è necessario abilitare lo spazio dei nomi gerarchico al momento della creazione, come descritto nella pagina Creare un account di archiviazione.

Se si sceglie di usare Cloud Shell, vedere Panoramica di Azure Cloud Shell per altre informazioni.

Installare il modulo di Azure PowerShell in locale

Se si sceglie di usare PowerShell in locale, per questo articolo è necessario installare il modulo Az PowerShell e connettersi all'account di Azure usando il cmdlet Connect-AzAccount. Per altre informazioni sull'installazione del modulo Az PowerShell, vedere Installare Azure PowerShell.

Per altre informazioni sull'autenticazione con Azure PowerShell, vedere Accedere con Azure PowerShell.

Installare il modulo Azure Synapse di PowerShell

Importante

Durante la fase di anteprima del modulo Az.Synapse di PowerShell, è necessario installarlo separatamente usando il cmdlet Install-Module. Quando il modulo di PowerShell diventerà disponibile a livello generale, entrerà a far parte delle future versioni del modulo Az di PowerShell e sarà disponibile per impostazione predefinita all'interno di Azure Cloud Shell.

Install-Module -Name Az.Synapse

Creare un'area di lavoro di Azure Synapse con Azure PowerShell

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

   Nome variabile	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.
   ClientIP	L'indirizzo IP pubblico del sistema in cui si esegue PowerShell.

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

   New-AzResourceGroup -Name $SynapseResourceGroup -Location $Region
   

3. Creare un'area di lavoro di Azure Synapse:

   $Cred = New-Object -TypeName System.Management.Automation.PSCredential ($SqlUser, (ConvertTo-SecureString $SqlPassword -AsPlainText -Force))
   
   $WorkspaceParams = @{
     Name = $SynapseWorkspaceName
     ResourceGroupName = $SynapseResourceGroup
     DefaultDataLakeStorageAccountName = $StorageAccountName
     DefaultDataLakeStorageFilesystem = $FileShareName
     SqlAdministratorLoginCredential = $Cred
     Location = $Region
   }
   New-AzSynapseWorkspace @WorkspaceParams
   

4. Ottenere l'URL di sviluppo e Web per l'area di lavoro di Azure Synapse:

   $WorkspaceWeb = (Get-AzSynapseWorkspace -Name $SynapseWorkspaceName -ResourceGroupName $StorageAccountResourceGroup).ConnectivityEndpoints.web
   $WorkspaceDev = (Get-AzSynapseWorkspace -Name $SynapseWorkspaceName -ResourceGroupName $StorageAccountResourceGroup).ConnectivityEndpoints.dev
   

5. Creare una regola del firewall per consentire l'accesso all'area di lavoro di Azure Synapse dal computer in uso:

   $FirewallParams = @{
     WorkspaceName = $SynapseWorkspaceName
     Name = 'Allow Client IP'
     ResourceGroupName = $StorageAccountResourceGroup
     StartIpAddress = $ClientIP
     EndIpAddress = $ClientIP
   }
   New-AzSynapseFirewallRule @FirewallParams
   

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:

   Start-Process $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 controllo degli accessi in base al ruolo di Synapse appropriati usando Synapse Studio.
• Un membro del ruolo Proprietario dell'account di archiviazione di Azure deve assegnare il ruolo Collaboratore ai dati del BLOB di archiviazione all'identità del servizio gestito dell'area di lavoro 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.

Se l'area di lavoro di Azure Synapse creata in questo articolo non è necessaria, è possibile eliminarla eseguendo l'esempio seguente.

Remove-AzSynapseWorkspace -Name $SynapseWorkspaceNam -ResourceGroupName $SynapseResourceGroup

Passaggi successivi

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