Quickstart: Een Azure Synapse-werkruimte maken met Azure PowerShell

Azure PowerShell is een set cmdlets om Azure-resources rechtstreeks vanuit PowerShell te beheren. U kunt deze gebruiken in uw browser met Azure Cloud Shell. U kunt deze ook installeren op macOS, Linux of Windows.

In deze quickstart leert u hoe u een Synapse-werkruimte maakt met behulp van Azure PowerShell.

Als u nog geen abonnement op Azure hebt, maak dan een gratis Azure-account aan voordat u begint.

Vereisten

• Azure Data Lake Storage Gen2-opslagaccount

  Belangrijk

  De Azure Synapse-werkruimte moet kunnen lezen uit en schrijven naar het geselecteerde ADLS Gen2-account. Voor elk opslagaccount dat u als primair opslagaccount koppelt moet u hiërarchische naamruimte inschakelen bij het maken van het opslagaccount, zoals beschreven in Een opslagaccount maken.

Als u Cloud Shell gebruikt, raadpleegt u Overzicht van Azure Cloud Shell voor meer informatie.

Installeer de Azure PowerShell-module lokaal

Als u PowerShell lokaal wilt gebruiken, moet u voor dit artikel de Az-module van PowerShell installeren en verbinding maken met uw Azure-account met behulp van de cmdlet Connect-AzAccount. Zie Azure PowerShell installeren voor meer informatie over het installeren van de Az-module van PowerShell.

Zie Aanmelden met Azure PowerShell voor meer informatie over verificatie met Azure PowerShell.

De Azure Synapse PowerShell-module installeren

Belangrijk

Zolang de PowerShell-module Az.Synapse in de preview-fase is, moet u deze afzonderlijk installeren met behulp van de cmdlet Install-Module. Nadat de PowerShell-module algemeen beschikbaar is geworden, wordt deze onderdeel van toekomstige releases van de Az PowerShell-module en is deze standaard beschikbaar vanuit Azure Cloud Shell.

Install-Module -Name Az.Synapse

Een Azure Synapse-werkruimte maken met behulp van Azure PowerShell

1. Definieer de benodigde omgevingsvariabelen om resources voor de Azure Synapse-ruimte te maken.

   Naam van de variabele	Beschrijving
   StorageAccountName	Naam van uw bestaande ADLS Gen2-opslagaccount.
   StorageAccountResourceGroup	Naam van de resourcegroep van uw bestaande ADLS Gen2-opslagaccount.
   FileShareName	Naam van uw bestaande opslagbestandssysteem.
   SynapseResourceGroup	Kies een nieuwe naam voor uw Azure Synapse-resourcegroep.
   Region	Kies een van de Azure-regio’s.
   SynapseWorkspaceName	Kies een unieke naam voor uw nieuwe Azure Synapse-werkruimte.
   SqlUser	Kies een waarde voor een nieuwe gebruikersnaam.
   SqlPassword	Kies een veilig wachtwoord.
   ClientIP	Het openbare IP-adres van het systeem waarop PowerShell wordt uitgevoerd.

2. Maak een resourcegroep als container voor uw Azure Synapse-werkruimte:

   New-AzResourceGroup -Name $SynapseResourceGroup -Location $Region
   

3. Maak een Azure Synapse-werkruimte:

   $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. Haal de Web-URL en Dev-URL van de Azure Synapse-werkruimte op:

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

5. Maak een firewallregel om vanaf uw computer toegang te krijgen tot de Azure Synapse-werkruimte:

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

6. Open de Web-URL van de Azure Synapse-werkruimte, die in de omgevingsvariabele WorkspaceWeb is opgeslagen, om toegang te krijgen tot uw werkruimte:

   Start-Process $WorkspaceWeb
   

   

7. Zodra de implementatie is uitgevoerd, zijn aanvullende machtigingen vereist.

• Wijs in de Azure Portal andere gebruikers van de werkruimte toe aan de rol Inzender in de werkruimte. Raadpleeg Azure-rollen toewijzen met de Azure Portal voor meer details.
• Wijs andere gebruikers de juiste Synapse RBAC-rollen toe met behulp van Synapse Studio.
• Een lid van de rol Eigenaar van het Azure Storage-account moet de rol Inzender voor opslagblobgegevens toewijzen aan de MSI van de Azure Synapse-werkruimte en andere gebruikers.

Resources opschonen

Voer de onderstaande stappen uit om de Azure Synapse-werkruimte te verwijderen.

Waarschuwing

Als u een Azure Synapse-werkruimte verwijdert, worden de analyse-engines en de gegevens die zijn opgeslagen in de database van de SQL-pools die het bevat en de metagegevens van de werkruimte verwijderd. Er kan geen verbinding meer worden gemaakt met het SQL- of Apache Spark-eindpunt. Alle codeartefacten worden verwijderd (query's, notebooks, taakdefinities en pijplijnen). Als u de werkruimte verwijdert, heeft dit geen invloed op de gegevens in het Data Lake Storage Gen2-account dat aan de werkruimte is gekoppeld.

Als de Azure Synapse-werkruimte die u in dit artikel hebt gemaakt, niet nodig is, kunt u deze verwijderen door het volgende voorbeeld uit te voeren.

Remove-AzSynapseWorkspace -Name $SynapseWorkspaceNam -ResourceGroupName $SynapseResourceGroup

Volgende stappen

Vervolgens kunt u SQL-pools maken of Apache Spark-pools maken zodat u uw gegevens kunt gaan analyseren en verkennen.