Een werkruimte implementeren met PowerShell

In dit artikel wordt uitgelegd hoe u een Azure Databricks-werkruimte maakt met behulp van PowerShell.

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.

Als u als gebruiker verbinding wilt maken met uw Azure-account, raadpleegt u PowerShell-aanmelding met een Azure Databricks-gebruikersaccount. Als u verbinding wilt maken met uw Azure-account als een service-principal, raadpleegt u PowerShell-aanmelding met een Service-principal van Microsoft Entra ID.

Notitie

Als u een Azure Databricks-werkruimte wilt maken in de Commerciële Cloud van Azure met nalevingscertificeringen voor de Amerikaanse overheid, zoals FedRAMP High, neemt u contact op met uw Microsoft- of Azure Databricks-accountteam om toegang te krijgen tot deze ervaring.

Als dit de eerste keer is dat u Azure Databricks gebruikt, moet u de resourceprovider van Microsoft.Databricks registreren.

  Register-AzResourceProvider -ProviderNamespace Microsoft.Databricks

Azure Cloud Shell gebruiken

Azure host Azure Cloud Shell, een interactieve shell-omgeving die u via uw browser kunt gebruiken. U kunt Bash of PowerShell gebruiken met Cloud Shell om met Azure-services te werken. U kunt de vooraf geïnstalleerde opdrachten van Cloud Shell gebruiken om de code in dit artikel uit te voeren zonder dat u iets hoeft te installeren in uw lokale omgeving.

Om Azure Cloud Shell op te starten:

• Selecteer Nu proberen in de rechterbovenhoek van een codeblok. Als u Try It selecteert, wordt de code niet automatisch gekopieerd naar Cloud Shell.
• Ga naar https://shell.azure.com, of selecteer de knop Cloud Shell starten om Cloud Shell in uw browser te openen.
• Klik op de knop Cloud Shell in het menu in de balk rechtsboven in de Azure-portal.

Om de code in dit artikel in Azure Cloud Shell uit te voeren:

• Start Cloud Shell.
• Selecteer de knop Kopiëren op een codeblok om de code te kopiëren.
• Plak de code in de Cloud Shell-sessie door CTRL+Shift+V te selecteren in Windows en Linux of door Cmd+Shift+V op macOS te selecteren.
• Selecteer Invoeren om de code uit te voeren.

Als u meerdere Azure-abonnementen hebt, kiest u het juiste abonnement waarin de resource moet worden gefactureerd. Selecteer een specifieke abonnementen-id met behulp van de cmdlet set-AzContext.

Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000

Een brongroep maken

Maak een Azure-resourcegroep met de cmdlet New-AzResourceGroup. Een resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en groepsgewijs worden beheerd.

In het volgende voorbeeld wordt een resourcegroep met de naam myresourcegroup gemaakt in de regio VS - west 2.

New-AzResourceGroup -Name myresourcegroup -Location westus2

Een Azure Databricks-werkruimte maken

In deze sectie gaat u een Azure Databricks-werkruimte maken met behulp van PowerShell.

New-AzDatabricksWorkspace -Name mydatabricksws -ResourceGroupName myresourcegroup -Location westus2 -ManagedResourceGroupName databricks-group -Sku standard

Geef de volgende waarden op:

Eigenschappen	Beschrijving
Naam	Geef een naam op voor uw Databricks-werkruimte.
ResourceGroupName	Geef een bestaande resourcegroepnaam op
Locatie	Selecteer VS - west 2. Zie Producten beschikbaar per regio voor andere beschikbare regio's
ManagedResourceGroupName	Geef aan of u een nieuwe beheerde resourcegroep wilt maken of een bestaande groep wilt gebruiken.
Sku	U kunt kiezen tussen Standard, Premium en Trial. Zie Prijzen voor Databricks voor meer informatie over deze categorieën

Het maken van de werkruimte duurt enkele minuten. Zodra dit proces is voltooid, wordt uw gebruikersaccount automatisch als een gebruiker met beheerdersrechten toegevoegd in de werkruimte.

Notitie

Wanneer de implementatie van een werkruimte mislukt, wordt de werkruimte nog steeds gemaakt, maar krijgt deze de status Mislukt. Verwijder de mislukte werkruimte en maak een nieuwe werkruimte waarin de implementatiefouten zijn opgelost. Wanneer u de mislukte werkruimte verwijdert, worden de beheerde resourcegroep en de resources die wel zijn geïmplementeerd ook verwijderd.

De inrichtingsstatus van een Databricks-werkruimte bepalen

U kunt de cmdlet Get-AzDatabricksWorkspace gebruiken om te bepalen of de inrichting van een Databricks-werkruimte is gelukt.

Get-AzDatabricksWorkspace -Name mydatabricksws -ResourceGroupName myresourcegroup |
  Select-Object -Property Name, SkuName, Location, ProvisioningState

Name            SkuName   Location  ProvisioningState
----            -------   --------  -----------------
mydatabricksws  standard  westus2   Succeeded