Bereitstellen eines Arbeitsbereichs mit PowerShell

  • Artikel

In diesem Artikel wird erläutert, wie Sie einen Azure Databricks-Arbeitsbereich mithilfe von PowerShell erstellen.

Falls Sie PowerShell lokal verwenden möchten, müssen Sie für diesen Artikel das Az PowerShell-Modul installieren und mit dem Cmdlet Connect-AzAccount eine Verbindung mit Ihrem Azure-Konto herstellen. Weitere Informationen zum Installieren des Az PowerShell-Moduls finden Sie unter Installieren von Azure PowerShell.

Informationen zum Herstellen einer Verbindung zu Ihrem Azure-Konto als Benutzer*in finden Sie unter PowerShell-Anmeldung mit einem Azure Databricks-Benutzerkonto. Informationen zum Herstellen einer Verbindung mit Ihrem Azure-Konto als Dienstprinzipal finden Sie unter PowerShell-Anmeldung mit einem Dienstprinzipal der Microsoft Entra ID (ehemals Azure Active Directory).

Hinweis

Wenn Sie einen Azure Databricks-Arbeitsbereich in der kommerziellen Azure-Cloud erstellen möchten, der Compliancezertifizierungen für US-Behörden wie FedRAMP High enthält, wenden Sie sich an Ihr Microsoft- oder Azure Databricks-Kundenberatungsteam, um Zugriff auf diese Umgebung zu erhalten.

Wenn Sie Azure Databricks zum ersten Mal nutzen, müssen Sie den Ressourcenanbieter Microsoft.Databricks registrieren.

  Register-AzResourceProvider -ProviderNamespace Microsoft.Databricks

Verwenden von Azure Cloud Shell

Azure hostet Azure Cloud Shell, eine interaktive Shell-Umgebung, die Sie über Ihren Browser nutzen können. Sie können entweder Bash oder PowerShell mit Cloud Shell verwenden, um mit Azure-Diensten zu arbeiten. Sie können die vorinstallierten Befehle von Cloud Shell verwenden, um den Code in diesem Artikel auszuführen, ohne etwas in Ihrer lokalen Umgebung installieren zu müssen.

Starten von Azure Cloud Shell:

  • Klicken Sie in der rechten oberen Ecke eines Codeblocks auf Ausprobieren. Durch Auswahl von Ausprobieren wird der Code nicht automatisch in Cloud Shell kopiert.
  • Rufen Sie https://shell.azure.com auf, oder klicken Sie auf die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen.
  • Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus.

Ausführen des Codes in diesem Artikel in Azure Cloud Shell:

  • Starten Sie Cloud Shell.
  • Wählen Sie die Schaltfläche Kopieren für einen Codeblock, um den Code zu kopieren.
  • Fügen Sie den Code mit STRG+UMSCHALT+V unter Windows und Linux oder Cmd+UMSCHALT+V unter macOS in die Cloud Shell-Sitzung ein.
  • Drücken Sie die EINGABETASTE, um den Code auszuführen.

Wenn Sie über mehrere Azure-Abonnements verfügen, müssen Sie das entsprechende Abonnement auswählen, in dem die Ressourcen fakturiert werden sollen. Wählen Sie mit dem Cmdlet Set-AzContext eine bestimmte Abonnement-ID aus.

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

Erstellen einer Ressourcengruppe

Erstellen Sie mit dem Cmdlet New-AzResourceGroup eine Azure-Ressourcengruppe. Eine Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen als Gruppe bereitgestellt und verwaltet werden.

Im folgenden Beispiel wird eine Ressourcengruppe mit dem Namen myresourcegroup in der Region USA, Westen 2 erstellt.

New-AzResourceGroup -Name myresourcegroup -Location westus2

Erstellen eines Azure Databricks-Arbeitsbereichs

In diesem Abschnitt erstellen Sie einen Azure Databricks-Arbeitsbereich mit PowerShell.

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

Geben Sie außerdem die folgenden Werte an:

Eigenschaft Beschreibung
Name Geben Sie einen Namen für Ihren Databricks-Arbeitsbereich an.
ResourceGroupName Geben Sie den Namen einer vorhandenen Ressourcengruppe an.
Standort Wählen Sie USA, Westen 2 aus. Informationen zu weiteren verfügbaren Regionen finden Sie unter Verfügbare Produkte nach Region.
ManagedResourceGroupName Geben Sie an, ob Sie eine neue verwaltete Ressourcengruppe erstellen oder eine vorhandene verwenden möchten.
Sku Wählen Sie zwischen Standard, Premium oder Testversion. Weitere Informationen zu diesen Tarifen finden Sie unter Azure Databricks – Preise.

Die Erstellung des Arbeitsbereichs dauert einige Minuten. Nachdem dieser Prozess abgeschlossen ist, wird Ihr Benutzerkonto automatisch als Administratorbenutzer im Arbeitsbereich hinzugefügt.

Hinweis

Wenn bei der Bereitstellung eines Arbeitsbereichs ein Fehler auftritt, wird der Arbeitsbereich mit dem Fehlerzustand trotzdem erstellt. Löschen Sie den fehlerhaften Arbeitsbereich, und erstellen Sie einen neuen, um die Bereitstellungsfehler zu beheben. Wenn Sie den fehlerhaften Arbeitsbereich löschen, werden auch die verwaltete Ressourcengruppe und alle Ressourcen gelöscht, für die die Bereitstellung erfolgreich war.

Bestimmen des Bereitstellungsstatus eines Databricks-Arbeitsbereichs

Mithilfe des Cmdlets Get-AzDatabricksWorkspace können Sie feststellen, ob ein Databricks-Arbeitsbereich erfolgreich bereitgestellt wurde.

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

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