environments skupina příkazů

Note

Použití rozhraní příkazového řádku Databricks podléhá licenci Databricks a oznámení o ochraně osobních údajů Databricks, včetně všech ustanovení o využití.

Skupina environments příkazů v rozhraní příkazového řádku Databricks umožňuje spravovat prostředky prostředí. Rozhraní Api pro prostředí poskytuje možnosti správy pro různé typy prostředí, včetně základních prostředí na úrovni pracovního prostoru, která definují verzi prostředí a závislosti, které se mají použít v bezserverových poznámkových blocích a úlohách.

Prostředí Databricks vytvářejí pracovní prostor– základní prostředí

Vytvořte nové základní prostředí pracovního prostoru. Jedná se o dlouhotrvající operaci, která asynchronně generuje materializované prostředí pro optimalizaci řešení závislostí.

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

Arguments

DISPLAY_NAME

    Zobrazovaný název pro základní prostředí pracovního prostoru čitelný pro člověka.

Možnosti

--base-environment-type BaseEnvironmentType

    Typ základního prostředí (CPU nebo GPU). Podporované hodnoty: CPU, GPU

--filepath string

    Soubory pracovního prostoru nebo svazky katalogu Unity cesta k souboru YAML prostředí.

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

--name string

    Název prostředku základního prostředí pracovního prostoru.

--no-wait

    Nečekejte na dosažení DONE stavu.

--request-id string

    Jedinečný identifikátor pro tento požadavek.

--timeout duration

    Maximální doba, po kterou se dostanete DONE do stavu.

--workspace-base-environment-id string

    ID, které se použije pro základní prostředí pracovního prostoru, se stane konečnou součástí názvu prostředku.

Globální příznaky

Examples

Následující příklad vytvoří základní prostředí pracovního prostoru procesoru:

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

Prostředí Databricks delete-workspace-base-environment

Odstraňte základní prostředí pracovního prostoru. Odstranění základního prostředí může mít vliv na propojené poznámkové bloky a úlohy. Tato operace je nevratná.

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

Arguments

NAME

    Povinné. Název prostředku základního prostředí pracovního prostoru, který chcete odstranit. Formát: workspace-base-environments/{workspace_base_environment}.

Možnosti

Globální příznaky

Examples

Následující příklad odstraní základní prostředí pracovního prostoru:

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

Prostředí databricks get-default-workspace-base-environment

Získejte výchozí konfiguraci základního prostředí pracovního prostoru. Vrátí aktuální výchozí nastavení základního prostředí pro výpočetní výkon procesoru i GPU.

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

Arguments

NAME

    Název statického prostředku výchozího základního prostředí pracovního prostoru. Formát: default-workspace-base-environment.

Možnosti

Globální příznaky

Examples

Následující příklad získá výchozí základní prostředí pracovního prostoru:

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

Operace get-operation prostředí databricks

Získejte stav dlouhotrvající operace. Klienti mohou tuto metodu použít k dotazování výsledku operace.

databricks environments get-operation NAME [flags]

Arguments

NAME

    Název prostředku operace.

Možnosti

Globální příznaky

Examples

Následující příklad získá stav dlouhotrvající operace:

databricks environments get-operation operations/1234567890

Prostředí databricks get-workspace-base-environment

Získejte základní prostředí pracovního prostoru podle názvu.

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

Arguments

NAME

    Povinné. Název prostředku základního prostředí pracovního prostoru, který se má načíst. Formát: workspace-base-environments/{workspace_base_environment}.

Možnosti

Globální příznaky

Examples

Následující příklad získá základní prostředí pracovního prostoru:

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

Databricks environment list-workspace-base-environment

Zobrazí seznam všech základních prostředí pracovního prostoru v pracovním prostoru.

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

Arguments

None

Možnosti

--page-size int

    Maximální počet prostředí, která se mají vrátit na stránku.

--page-token string

    Token stránky pro stránkování

Globální příznaky

Examples

Následující příklad obsahuje seznam všech základních prostředí pracovního prostoru:

databricks environments list-workspace-base-environments

Prostředí Databricks refresh-workspace-base-environment

Aktualizujte materializované prostředí pro základní prostředí pracovního prostoru. Jedná se o dlouhotrvající operaci, která asynchronně znovu vygeneruje materializované prostředí. Stávající materializované prostředí zůstane dostupné, dokud nevyprší platnost.

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

Arguments

NAME

    Povinné. Název prostředku základního prostředí pracovního prostoru, který se má aktualizovat. Formát: workspace-base-environments/{workspace_base_environment}.

Možnosti

--no-wait

    Nečekejte na dosažení DONE stavu.

--timeout duration

    Maximální doba, po kterou se dostanete DONE do stavu.

Globální příznaky

Examples

Následující příklad aktualizuje základní prostředí pracovního prostoru:

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

Databricks prostředí pro nastavení lokálně

Nastavte lokální Python prostředí, které odpovídá clusteru Azure Databricks nebo serverless verzi, aby kód, který spouštěte na svém stroji, fungoval stejně jako na Azure Databricks. Tím se nainstaluje odpovídající verze Python a kompatibilní databricks-connect a vaše závislosti se připojí k verzím, o kterých je známo, že fungují s vaším zvoleným výpočtem. Vytváří nebo aktualizuje ( .venv spravované uv) v aktuálním adresáři a zaznamenává nastavení v pyproject.toml. Zbytek vašeho projektu zůstává nezměněn.

databricks environments setup-local [flags]

Arguments

None

Možnosti

--cluster-id string

    Cluster ID pro použití jako cílové výpočetní zařízení.

--cluster-name string

    Název clusteru pro použití jako cílový výpočetní bod (vyřešen na ID přes Clusters API).

--serverless-version string

    Serverless verze pro použití jako cíl výpočetního výkonu (například 5).

--job-task string

    Úkol pro použití jako výpočetní cíl ve tvaru <job-id>.<task-key>. Je vyžadován klíč úlohy.

--constraints-only

    Aplikujte Python verzi a omezení závislostí bez přidání databricks-connect.

--dry-run

    Spočítejte plán a ukažte, co by se změnilo, aniž byste psali soubory nebo provisionovali.

Globální příznaky

Examples

Přiřaďte serverless verzi:

databricks environments setup-local --serverless-version 5

Spojte existující cluster podle jména:

databricks environments setup-local --cluster-name my-cluster

Podívejte se, co by se změnilo, kdybyste nic nenapsal:

databricks environments setup-local --serverless-version 5 --dry-run

Prostředí Databricks update-default-workspace-base-environment

Aktualizujte výchozí konfiguraci základního prostředí pracovního prostoru. Nastaví zadaná základní prostředí jako výchozí pracovní prostor pro výpočetní výkon procesoru nebo GPU.

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

Arguments

NAME

    Název prostředku tohoto jednoúčelového prostředku. Formát: default-workspace-base-environment.

UPDATE_MASK

    Maska pole určující pole, která se mají aktualizovat. Platné cesty k polím: cpu_workspace_base_environment, gpu_workspace_base_environment. Slouží * k aktualizaci všech polí.

Možnosti

--cpu-workspace-base-environment string

    Výchozí základní prostředí pracovního prostoru pro výpočetní prostředky procesoru.

--gpu-workspace-base-environment string

    Výchozí základní prostředí pracovního prostoru pro výpočetní prostředky GPU.

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

--name string

    Název prostředku tohoto jednoúčelového prostředku.

Globální příznaky

Examples

Následující příklad nastaví výchozí základní prostředí pracovního prostoru procesoru:

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

Prostředí databricks update-workspace-base-environment

Aktualizace existujícího základního prostředí pracovního prostoru Jedná se o dlouhotrvající operaci, která asynchronně znovu vygeneruje materializované prostředí. Stávající materializované prostředí zůstane dostupné, dokud nevyprší platnost.

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

Arguments

NAME

    Název prostředku základního prostředí pracovního prostoru. Formát: workspace-base-environments/{workspace_base_environment}.

DISPLAY_NAME

    Zobrazovaný název pro základní prostředí pracovního prostoru čitelný pro člověka.

Možnosti

--base-environment-type BaseEnvironmentType

    Typ základního prostředí (CPU nebo GPU). Podporované hodnoty: CPU, GPU

--filepath string

    Soubory pracovního prostoru nebo svazky katalogu Unity cesta k souboru YAML prostředí.

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

--name string

    Název prostředku základního prostředí pracovního prostoru.

--no-wait

    Nečekejte na dosažení DONE stavu.

--timeout duration

    Maximální doba, po kterou se dostanete DONE do stavu.

Globální příznaky

Examples

Následující příklad aktualizuje základní prostředí pracovního prostoru:

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

Globální příznaky

--debug

  Zda povolit protokolování ladění.

-h nebo --help

    Zobrazení nápovědy k rozhraní příkazového řádku Databricks nebo související skupině příkazů nebo souvisejícímu příkazu

--log-file řetězec

    Řetězec představující soubor, do kterého se zapisují výstupní protokoly. Pokud tento příznak není zadaný, výchozí hodnota je zápis výstupních protokolů do stderru.

--log-format formát

    Typ formátu protokolu, text nebo json. Výchozí hodnota je text.

--log-level řetězec

    Řetězec představující úroveň formátu protokolu. Pokud není zadána, je úroveň formátu protokolu zakázaná.

-o, --output typ

    Typ výstupu příkazu, text nebo json. Výchozí hodnota je text.

-p, --profile řetězec

    Název profilu v ~/.databrickscfg souboru, který se má použít ke spuštění příkazu. Pokud tento příznak není zadán, použije se profil s názvem DEFAULT, pokud existuje.

--progress-format formát

    Formát pro zobrazení protokolů průběhu: default, append, inplacenebo json

-t, --target řetězec

    Pokud je to relevantní, cílový balíček, který se má použít