Quickstart: Een Azure Synapse-werkruimte maken met Azure CLI

Azure CLI is de nieuwe opdrachtregel van Azure voor het beheren van Azure-resources. U kunt deze gebruiken in uw browser met Azure Cloud Shell. U kunt deze ook installeren op Mac OS, Linux of Windows en uitvoeren vanaf de opdrachtregel.

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

Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.

Vereisten

• Download en installeer jq, een lichtgewicht en flexibele opdrachtregel-JSON-processor

• Azure Data Lake Storage Gen2-opslagaccount

  Belangrijk

  De Azure Synapse-werkruimte moet kunnen lezen uit en schrijven naar het geselecteerde ADLS Gen2-account. Bovendien moet u voor elk opslagaccount dat u als primair opslagaccount koppelt, hiërarchische naamruimte hebben ingeschakeld bij het maken van het opslagaccount, zoals beschreven op de pagina Een opslagaccount maken.

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

Een Azure Synapse-werkruimte maken met behulp van Azure CLI

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

   Naam van omgevingsvariabele	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.

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

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

3. Maak een Azure Synapse-werkruimte:

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

   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. Maak een firewallregel om vanaf uw computer toegang te krijgen tot de Azure Synapse-werkruimte:

   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. Open de Web-URL van de Azure Synapse-werkruimte, die in de omgevingsvariabele WorkspaceWeb is opgeslagen, om toegang te krijgen tot uw werkruimte:

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

   

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

• Wijs in Azure Portal andere gebruikers van de werkruimte toe aan de rol Inzender in de werkruimte. Raadpleeg Azure-rollen toewijzen met Azure Portal voor informatie over het toewijzen van rollen.
• 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 u de Azure Synapse-werkruimte wilt verwijderen, voert u de volgende opdracht uit:

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

Volgende stappen

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