environments Befehlsgruppe

Note

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.

Mit environments der Befehlsgruppe in der Databricks CLI können Sie Umgebungsressourcen verwalten. Die Umgebungen-API bietet Verwaltungsfunktionen für verschiedene Typen von Umgebungen, einschließlich Basisumgebungen auf Arbeitsbereichsebene, die die Umgebungsversion und Abhängigkeiten definieren, die in serverlosen Notizbüchern und Aufträgen verwendet werden sollen.

databricks-Umgebungen create-workspace-base-environment

Erstellen Sie eine neue Arbeitsbereichsbasisumgebung. Dies ist ein lang ausgeführter Vorgang, der asynchron eine materialisierte Umgebung generiert, um die Abhängigkeitsauflösung zu optimieren.

databricks environments create-workspace-base-environment DISPLAY_NAME [flags]

Argumente

DISPLAY_NAME

    Lesbarer Anzeigename für die Arbeitsbereichsbasisumgebung.

Options

--base-environment-type BaseEnvironmentType

    Der Typ der Basisumgebung (CPU oder GPU). Unterstützte Werte: CPU, GPU

--filepath string

    Die Arbeitsbereichsdateien oder Unity Catalog-Volumespfad zur YAML-Umgebungsdatei.

--json JSON

    Die Inline-JSON-Zeichenfolge oder die JSON-Datei mit dem @path Anforderungstext.

--name string

    Der Ressourcenname der Arbeitsbereichsbasisumgebung.

--no-wait

    Warten Sie nicht, bis der Zustand erreicht DONE wird.

--request-id string

    Ein eindeutiger Bezeichner für diese Anforderung.

--timeout duration

    Maximale Zeitdauer, um den Zustand zu erreichen DONE .

--workspace-base-environment-id string

    Die FÜR die Arbeitsbereichsbasisumgebung zu verwendende ID, die zur endgültigen Komponente des Ressourcennamens wird.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird eine CPU-Arbeitsbereichsbasisumgebung erstellt:

databricks environments create-workspace-base-environment "My Python Env" --base-environment-type CPU --filepath /Workspace/environments/env.yaml

databricks-Umgebungen delete-workspace-base-environment

Löschen sie eine Arbeitsbereichsbasisumgebung. Das Löschen einer Basisumgebung kann sich auf verknüpfte Notizbücher und Aufträge auswirken. Dieser Vorgang kann nicht rückgängig gemacht werden.

databricks environments delete-workspace-base-environment NAME [flags]

Argumente

NAME

    Erforderlich. Der Ressourcenname der zu löschenden Arbeitsbereichsbasisumgebung. Format: workspace-base-environments/{workspace_base_environment}.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird eine Arbeitsbereichsbasisumgebung gelöscht:

databricks environments delete-workspace-base-environment workspace-base-environments/my-env-id

databricks-Umgebungen get-default-workspace-base-environment

Rufen Sie die Standardkonfiguration der Arbeitsbereichsbasisumgebung ab. Gibt die aktuellen Standardeinstellungen für die Basisumgebung für CPU- und GPU-Compute zurück.

databricks environments get-default-workspace-base-environment NAME [flags]

Argumente

NAME

    Ein statischer Ressourcenname der Standardarbeitsbereich-Basisumgebung. Format: default-workspace-base-environment.

Options

Globale Kennzeichnungen

Examples

Das folgende Beispiel ruft die Standardarbeitsbereich-Basisumgebung ab:

databricks environments get-default-workspace-base-environment default-workspace-base-environment

get-operation für databricks-Umgebungen

Rufen Sie den Status eines lange ausgeführten Vorgangs ab. Clients können diese Methode verwenden, um das Vorgangsergebnis abzufragen.

databricks environments get-operation NAME [flags]

Argumente

NAME

    Der Name der Vorgangsressource.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird der Status eines lange ausgeführten Vorgangs abgerufen:

databricks environments get-operation operations/1234567890

databricks-Umgebungen get-workspace-base-environment

Rufen Sie eine Arbeitsbereichsbasisumgebung anhand ihres Namens ab.

databricks environments get-workspace-base-environment NAME [flags]

Argumente

NAME

    Erforderlich. Der Ressourcenname der abzurufenden Arbeitsbereichsbasisumgebung. Format: workspace-base-environments/{workspace_base_environment}.

Options

Globale Kennzeichnungen

Examples

Das folgende Beispiel ruft eine Arbeitsbereichsbasisumgebung ab:

databricks environments get-workspace-base-environment workspace-base-environments/my-env-id

databricks environments list-workspace-base-environments

Listet alle Arbeitsbereichsbasisumgebungen im Arbeitsbereich auf.

databricks environments list-workspace-base-environments [flags]

Argumente

Nichts

Options

--page-size int

    Die maximale Anzahl von Umgebungen, die pro Seite zurückgegeben werden sollen.

--page-token string

    Seitentoken für Paginierung.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden alle Arbeitsbereichsbasisumgebungen aufgelistet:

databricks environments list-workspace-base-environments

databricks-Umgebungen refresh-workspace-base-environment

Aktualisieren Sie die materialisierte Umgebung für eine Arbeitsbereichsbasisumgebung. Dies ist ein lang ausgeführter Vorgang, der die materialisierte Umgebung asynchron neu generiert. Die vorhandene materialisierte Umgebung bleibt bis zum Ablauf verfügbar.

databricks environments refresh-workspace-base-environment NAME [flags]

Argumente

NAME

    Erforderlich. Der Ressourcenname der zu aktualisierenden Arbeitsbereichsbasisumgebung. Format: workspace-base-environments/{workspace_base_environment}.

Options

--no-wait

    Warten Sie nicht, bis der Zustand erreicht DONE wird.

--timeout duration

    Maximale Zeitdauer, um den Zustand zu erreichen DONE .

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird eine Arbeitsbereichsbasisumgebung aktualisiert:

databricks environments refresh-workspace-base-environment workspace-base-environments/my-env-id

databricks-Umgebungen aktualisieren-default-workspace-base-environment

Aktualisieren Sie die Standardkonfiguration der Arbeitsbereichsbasisumgebung. Legt die angegebenen Basisumgebungen als Standardarbeitsbereich für cpu- und/oder GPU-Compute fest.

databricks environments update-default-workspace-base-environment NAME UPDATE_MASK [flags]

Argumente

NAME

    Der Ressourcenname dieser Singletonressource. Format: default-workspace-base-environment.

UPDATE_MASK

    Feldformat, das angibt, welche Felder aktualisiert werden sollen. Gültige Feldpfade: cpu_workspace_base_environment, gpu_workspace_base_environment. Wird verwendet * , um alle Felder zu aktualisieren.

Options

--cpu-workspace-base-environment string

    Die Standardarbeitsbereich-Basisumgebung für die CPU-Berechnung.

--gpu-workspace-base-environment string

    Die Standardarbeitsbereich-Basisumgebung für die GPU-Berechnung.

--json JSON

    Die Inline-JSON-Zeichenfolge oder die JSON-Datei mit dem @path Anforderungstext.

--name string

    Der Ressourcenname dieser Singletonressource.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird die Standardbasisumgebung des CPU-Arbeitsbereichs festgelegt:

databricks environments update-default-workspace-base-environment default-workspace-base-environment cpu_workspace_base_environment --cpu-workspace-base-environment workspace-base-environments/my-cpu-env

databricks-Umgebungen update-workspace-base-environment

Aktualisieren sie eine vorhandene Arbeitsbereichsbasisumgebung. Dies ist ein lang ausgeführter Vorgang, der die materialisierte Umgebung asynchron neu generiert. Die vorhandene materialisierte Umgebung bleibt bis zum Ablauf verfügbar.

databricks environments update-workspace-base-environment NAME DISPLAY_NAME [flags]

Argumente

NAME

    Der Ressourcenname der Arbeitsbereichsbasisumgebung. Format: workspace-base-environments/{workspace_base_environment}.

DISPLAY_NAME

    Lesbarer Anzeigename für die Arbeitsbereichsbasisumgebung.

Options

--base-environment-type BaseEnvironmentType

    Der Typ der Basisumgebung (CPU oder GPU). Unterstützte Werte: CPU, GPU

--filepath string

    Die Arbeitsbereichsdateien oder Unity Catalog Volumes-Pfad zur YAML-Umgebungsdatei.

--json JSON

    Die Inline-JSON-Zeichenfolge oder die JSON-Datei mit dem @path Anforderungstext.

--name string

    Der Ressourcenname der Arbeitsbereichsbasisumgebung.

--no-wait

    Warten Sie nicht, bis der Zustand erreicht DONE wird.

--timeout duration

    Maximale Zeitdauer, um den Zustand zu erreichen DONE .

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird eine Arbeitsbereichsbasisumgebung aktualisiert:

databricks environments update-workspace-base-environment workspace-base-environments/my-env-id "Updated Python Env" --filepath /Workspace/environments/updated-env.yaml

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