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
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. Maak een resourcegroep als container voor uw Azure Synapse-werkruimte:
New-AzResourceGroup -Name $SynapseResourceGroup -Location $Region
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
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
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
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
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.