Freigeben über


account workspaces Befehlsgruppe

Hinweis

Diese Informationen gelten für Databricks CLI-Versionen 0.205 und höher. Die Databricks CLI befindet sich in der öffentlichen Vorschau.

Die Verwendung von Databricks CLI unterliegt der Datenbricks-Lizenz - und Databricks-Datenschutzerklärung, einschließlich der Bestimmungen zu Nutzungsdaten.

Die account workspaces Befehlsgruppe in der Databricks CLI enthält Befehle zum Verwalten von Arbeitsbereichen für Ihr Konto. Ein Databricks-Arbeitsbereich ist eine Umgebung für den Zugriff auf alle Ihre Databricks-Ressourcen. Der Arbeitsbereich organisiert Objekte (Notizbücher, Bibliotheken und Experimente) in Ordnern und bietet Zugriff auf Daten und Rechenressourcen wie Cluster und Aufträge. Siehe Erstellen eines Arbeitsbereichs.

Hinweis

Diese Befehle sind verfügbar, wenn Sich Ihr Konto auf der E2-Version der Plattform oder in einem ausgewählten benutzerdefinierten Plan befindet, der mehrere Arbeitsbereiche pro Konto zulässt.

Databricks-Kontoarbeitsbereiche erstellen

Erstellen Sie einen neuen Arbeitsbereich mit einer Anmeldeinformationskonfiguration und einer Speicherkonfiguration, einer optionalen Netzwerkkonfiguration (bei Verwendung einer vom Kunden verwalteten ASSEMBLY), einer optionalen Konfiguration für verwaltete Dienste (bei Verwendung von vom Kunden verwalteten Schlüsseln für verwaltete Dienste) und einer optionalen Speicherschlüsselkonfiguration (bei Verwendung von vom Kunden verwalteten Schlüsseln für den Speicher).

Von Bedeutung

Dieser Vorgang ist asynchron. Eine Antwort mit HTTP-Statuscode 200 bedeutet, dass die Anforderung angenommen wurde und ausgeführt wird, bedeutet jedoch nicht, dass der Arbeitsbereich erfolgreich bereitgestellt und ausgeführt wird. Der anfängliche Arbeitsbereichsstatus ist in der Regel BEREITSTELLUNG. Verwenden Sie das Feld arbeitsbereichs-ID (workspace_id) in der Antwort, um den neuen Arbeitsbereich zu identifizieren und wiederholte GET Anforderungen mit der Arbeitsbereichs-ID zu stellen und den Status zu überprüfen. Der Arbeitsbereich wird verfügbar, wenn sich der Status in "RUNNING" ändert.

databricks account workspaces create [flags]

Options

--workspace-name string

    Der lesbare Name des Arbeitsbereichs.

--deployment-name string

    Der Bereitstellungsname definiert einen Teil der Unterdomäne für den Arbeitsbereich.

--aws-region string

    Die AWS-Region für den Arbeitsbereich.

--cloud string

    Der Cloudname.

--location string

    Die Google Cloud-Region der Arbeitsbereichsdatenebene in Ihrem Google-Konto (z. B us-east4. ).

--credentials-id string

    ID des Konfigurationsobjekts für Anmeldeinformationen des Arbeitsbereichs.

--storage-configuration-id string

    ID des Speicherkonfigurationsobjekts des Arbeitsbereichs.

--network-id string

    Die ID des Netzwerkkonfigurationsobjekts des Arbeitsbereichs.

--managed-services-customer-managed-key-id string

    Die ID des Konfigurationsobjekts für verwaltete Dienste des Arbeitsbereichs mit Verschlüsselungsschlüsseln.

--storage-customer-managed-key-id string

    Die ID des Speicherverschlüsselungsschlüsselkonfigurationsobjekts des Arbeitsbereichs.

--private-access-settings-id string

    ID des Private Access Settings-Objekts des Arbeitsbereichs.

--network-connectivity-config-id string

    Die Objekt-ID der Netzwerkkonnektivitätskonfiguration.

--compute-mode CustomerFacingComputeMode

    Wenn der Berechnungsmodus SERVERLESS ist, wird ein serverloser Arbeitsbereich erstellt. Unterstützte Werte: HYBRID, SERVERLESS.

--pricing-tier PricingTier

    Die Preisstufe für den Arbeitsbereich. Unterstützte Werte: COMMUNITY_EDITION, , DEDICATED, PREMIUMENTERPRISE, , STANDARD. UNKNOWN

--no-wait

    Warten Sie nicht, bis der Zustand "RUNNING" erreicht ist.

--timeout duration

    Maximale Zeitspanne bis zum Erreichen des RUNNING-Zustands (Standard 20m0s).

--json JSON

    Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext

Globale Kennzeichnungen

Beispiele

Im folgenden Beispiel wird ein Arbeitsbereich mit JSON erstellt:

databricks account workspaces create --json '{"workspace_name": "my-workspace", "deployment_name": "my-workspace-deployment", "aws_region": "us-west-2", "credentials_id": "cred-abc123", "storage_configuration_id": "storage-xyz789"}'

Im folgenden Beispiel wird ein Arbeitsbereich mithilfe einer JSON-Datei erstellt:

databricks account workspaces create --json @workspace.json

Im folgenden Beispiel wird ein Arbeitsbereich mit Befehlszeilenkennzeichnungen erstellt:

databricks account workspaces create --workspace-name "my-workspace" --deployment-name "my-workspace-deployment" --aws-region "us-west-2" --credentials-id "cred-abc123" --storage-configuration-id "storage-xyz789"

Databricks-Kontoarbeitsbereiche löschen

Löschen Sie einen Databricks-Arbeitsbereich, der durch DIE ID angegeben wird.

databricks account workspaces delete WORKSPACE_ID [flags]

Argumente

WORKSPACE_ID

    Eine eindeutige ganzzahlige ID für den Arbeitsbereich.

Options

Globale Kennzeichnungen

Beispiele

Im folgenden Beispiel wird ein Arbeitsbereich nach ID gelöscht:

databricks account workspaces delete 123456789

Databricks-Kontoarbeitsbereiche erhalten

Rufen Sie Informationen einschließlich des Status für einen Databricks-Arbeitsbereich ab, der durch die ID angegeben wird. In der Antwort gibt das workspace_status Feld den aktuellen Status an. Führen Sie nach der anfänglichen Arbeitsbereichserstellung (asynchron) wiederholte GET Anforderungen mit der Arbeitsbereichs-ID aus, und überprüfen Sie den Status. Der Arbeitsbereich wird verfügbar, wenn sich der Status in "RUNNING" ändert.

databricks account workspaces get WORKSPACE_ID [flags]

Argumente

WORKSPACE_ID

    Eine eindeutige ganzzahlige ID für den Arbeitsbereich.

Options

Globale Kennzeichnungen

Beispiele

Das folgende Beispiel ruft einen Arbeitsbereich nach ID ab:

databricks account workspaces get 123456789

Databricks-Kontoarbeitsbereichsliste

Auflisten von Databricks-Arbeitsbereichen für ein Konto.

databricks account workspaces list [flags]

Options

Globale Kennzeichnungen

Beispiele

Im folgenden Beispiel werden alle Arbeitsbereiche aufgelistet:

databricks account workspaces list

Databricks-Kontoarbeitsbereiche werden aktualisiert

Aktualisieren einer Arbeitsbereichskonfiguration.

databricks account workspaces update WORKSPACE_ID [flags]

Argumente

WORKSPACE_ID

    Eine eindeutige ganzzahlige ID für den Arbeitsbereich.

Options

--workspace-name string

    Der lesbare Name des Arbeitsbereichs.

--deployment-name string

    Der Bereitstellungsname für den Arbeitsbereich.

--aws-region string

    Die AWS-Region für den Arbeitsbereich.

--cloud string

    Der Cloudname.

--location string

    Die Google Cloud-Region der Arbeitsbereichsdatenebene in Ihrem Google-Konto (z. B us-east4. ).

--credentials-id string

    ID des Konfigurationsobjekts für Anmeldeinformationen des Arbeitsbereichs.

--storage-configuration-id string

    ID des Speicherkonfigurationsobjekts des Arbeitsbereichs.

--network-id string

    Wenn dieser Arbeitsbereich BYO EINGABETASTE ist, wird die network_id aufgefüllt.

--managed-services-customer-managed-key-id string

    ID der Schlüsselkonfiguration zum Verschlüsseln von verwalteten Diensten.

--storage-customer-managed-key-id string

    ID der Schlüsselkonfiguration zum Verschlüsseln des Arbeitsbereichspeichers.

--private-access-settings-id string

    ID des Private Access Settings-Objekts des Arbeitsbereichs.

--network-connectivity-config-id string

    Die Objekt-ID der Netzwerkkonnektivitätskonfiguration.

--expected-workspace-status WorkspaceStatus

    Ein clienteigenes Feld, das verwendet wird, um den Arbeitsbereichsstatus anzugeben, in dem der Client erwartet, dass er sich befindet. Unterstützte Werte: BANNED, , CANCELLING, NOT_PROVISIONEDFAILED, , PROVISIONING. RUNNING

--update-mask string

    Das Feldformat muss eine einzelne Zeichenfolge sein, wobei mehrere Felder durch Kommas getrennt sind (keine Leerzeichen).

--no-wait

    Warten Sie nicht, bis der Zustand "RUNNING" erreicht ist.

--timeout duration

    Maximale Zeitspanne bis zum Erreichen des RUNNING-Zustands (Standard 20m0s).

--json JSON

    Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext

Globale Kennzeichnungen

Beispiele

Im folgenden Beispiel wird ein Arbeitsbereichsname aktualisiert:

databricks account workspaces update 123456789 --workspace-name "updated-workspace-name"

Im folgenden Beispiel wird ein Arbeitsbereich mithilfe von JSON aktualisiert:

databricks account workspaces update 123456789 --json '{"workspace_name": "updated-workspace-name", "credentials_id": "cred-new123"}'

Im folgenden Beispiel wird ein Arbeitsbereich mithilfe einer JSON-Datei aktualisiert:

databricks account workspaces update 123456789 --json @update-workspace.json

Globale Kennzeichnungen

--debug

  Gibt an, ob die Debugprotokollierung aktiviert werden soll.

-h oder --help

    Hilfe für die Databricks CLI oder die zugehörige Befehlsgruppe oder den zugehörigen Befehl anzeigen.

--log-file Schnur

    Eine Zeichenfolge, die die Datei darstellt, in die Ausgabeprotokolle geschrieben werden sollen. Wenn dieses Flag nicht angegeben ist, werden Ausgabeprotokolle standardmäßig in stderr geschrieben.

--log-format Format

    Der Protokollformattyp text oder json. Der Standardwert ist text.

--log-level Schnur

    Eine Zeichenfolge, die die Protokollformatebene darstellt. Wenn nicht angegeben, ist die Protokollformatebene deaktiviert.

-o, --output Typ

    Der Befehlsausgabetyp text oder json. Der Standardwert ist text.

-p, --profile Schnur

    Der Name des Profils in der ~/.databrickscfg Datei, das zum Ausführen des Befehls verwendet werden soll. Wenn dieses Flag nicht angegeben wird, wird, falls vorhanden, das Profil mit dem Namen DEFAULT verwendet.

--progress-format Format

    Das Format zum Anzeigen von Statusprotokollen: default, , append, inplaceoder json

-t, --target Schnur

    Falls zutreffend, das zu verwendende Bündelziel