environments kommandogrupp

Note

Den här informationen gäller för Databricks CLI-versionerna 0.205 och senare. Databricks CLI finns i offentlig förhandsversion.

Databricks CLI-användning omfattas av Databricks-licensen och Databricks sekretessmeddelande, inklusive eventuella användningsdatabestämmelser.

Med environments kommandogruppen i Databricks CLI kan du hantera miljöresurser. Miljö-API:et tillhandahåller hanteringsfunktioner för olika typer av miljöer, inklusive basmiljöer på arbetsytenivå som definierar den miljöversion och de beroenden som ska användas i serverlösa notebook-filer och jobb.

databricks-miljöer create-workspace-base-environment

Skapa en ny basmiljö för arbetsytan. Det här är en tidskrävande åtgärd som asynkront genererar en materialiserad miljö för att optimera beroendematchning.

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

Arguments

DISPLAY_NAME

    Visningsnamn som kan läsas av människor för arbetsytans basmiljö.

Options

--base-environment-type BaseEnvironmentType

    Typ av basmiljö (CPU eller GPU). Värden som stöds: CPU, GPU

--filepath string

    Arbetsytefilerna eller Unity Catalog-volymsökvägen till miljö-YAML-filen.

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

--name string

    Resursnamnet för arbetsytans basmiljö.

--no-wait

    Vänta inte med att nå DONE tillståndet.

--request-id string

    En unik identifierare för den här begäran.

--timeout duration

    Maximal tid för att nå DONE tillstånd.

--workspace-base-environment-id string

    Det ID som ska användas för arbetsytans basmiljö, som blir den sista komponenten i resursnamnet.

Globala flaggor

Examples

I följande exempel skapas en basmiljö för PROCESSOR-arbetsytan:

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

databricks-miljöer delete-workspace-base-environment

Ta bort en basmiljö för arbetsytan. Om du tar bort en basmiljö kan det påverka länkade notebook-filer och jobb. Den här åtgärden kan inte ångras.

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

Arguments

NAME

    Obligatoriskt. Resursnamnet för den arbetsytebasmiljö som ska tas bort. Format: workspace-base-environments/{workspace_base_environment}.

Options

Globala flaggor

Examples

I följande exempel tas en basmiljö för arbetsytan bort:

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

databricks-miljöer get-default-workspace-base-environment

Hämta standardkonfigurationen för arbetsytans basmiljö. Returnerar de aktuella standardinställningarna för basmiljön för både CPU- och GPU-beräkning.

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

Arguments

NAME

    Ett statiskt resursnamn för standardarbetsytans basmiljö. Format: default-workspace-base-environment.

Options

Globala flaggor

Examples

I följande exempel hämtas standardarbetsytans basmiljö:

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

get-operation för databricks-miljöer

Hämta status för en tidskrävande åtgärd. Klienter kan använda den här metoden för att avsöka åtgärdsresultatet.

databricks environments get-operation NAME [flags]

Arguments

NAME

    Namnet på åtgärdsresursen.

Options

Globala flaggor

Examples

I följande exempel hämtas status för en tidskrävande åtgärd:

databricks environments get-operation operations/1234567890

databricks-miljöer get-workspace-base-environment

Hämta en basmiljö för arbetsytan med dess namn.

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

Arguments

NAME

    Obligatoriskt. Resursnamnet för den arbetsytebasmiljö som ska hämtas. Format: workspace-base-environments/{workspace_base_environment}.

Options

Globala flaggor

Examples

I följande exempel hämtas en basmiljö för arbetsytan:

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

databricks-miljöer list-workspace-base-environments

Visa en lista över alla arbetsytebasmiljöer i arbetsytan.

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

Arguments

Ingen

Options

--page-size int

    Det maximala antalet miljöer som ska returneras per sida.

--page-token string

    Sidtoken för sidnumrering.

Globala flaggor

Examples

I följande exempel visas alla arbetsytebasmiljöer:

databricks environments list-workspace-base-environments

databricks-miljöer refresh-workspace-base-environment

Uppdatera den materialiserade miljön för en arbetsytebasmiljö. Det här är en tidskrävande åtgärd som asynkront återskapar den materialiserade miljön. Den befintliga materialiserade miljön förblir tillgänglig tills den upphör att gälla.

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

Arguments

NAME

    Obligatoriskt. Resursnamnet för den arbetsytebasmiljö som ska uppdateras. Format: workspace-base-environments/{workspace_base_environment}.

Options

--no-wait

    Vänta inte med att nå DONE tillståndet.

--timeout duration

    Maximal tid för att nå DONE tillstånd.

Globala flaggor

Examples

I följande exempel uppdateras en basmiljö för arbetsytan:

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

databricks-miljöer update-default-workspace-base-environment

Uppdatera standardkonfigurationen för arbetsytans basmiljö. Anger de angivna basmiljöerna som standard för arbetsytan för CPU- och/eller GPU-beräkning.

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

Arguments

NAME

    Resursnamnet för den här singleton-resursen. Format: default-workspace-base-environment.

UPDATE_MASK

    Fältmask som anger vilka fält som ska uppdateras. Giltiga fältsökvägar: cpu_workspace_base_environment, gpu_workspace_base_environment. Använd * för att uppdatera alla fält.

Options

--cpu-workspace-base-environment string

    Standardarbetsytans basmiljö för CPU-beräkning.

--gpu-workspace-base-environment string

    Standardarbetsytans basmiljö för GPU-beräkning.

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

--name string

    Resursnamnet för den här singleton-resursen.

Globala flaggor

Examples

I följande exempel anges standardbasmiljön för CPU-arbetsytan:

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-miljöer update-workspace-base-environment

Uppdatera en befintlig basmiljö för arbetsytan. Det här är en tidskrävande åtgärd som asynkront återskapar den materialiserade miljön. Den befintliga materialiserade miljön förblir tillgänglig tills den upphör att gälla.

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

Arguments

NAME

    Resursnamnet för arbetsytans basmiljö. Format: workspace-base-environments/{workspace_base_environment}.

DISPLAY_NAME

    Visningsnamn som kan läsas av människor för arbetsytans basmiljö.

Options

--base-environment-type BaseEnvironmentType

    Typ av basmiljö (CPU eller GPU). Värden som stöds: CPU, GPU

--filepath string

    Arbetsytefilerna eller sökvägen för Unity-katalogvolymer till YAML-miljöns fil.

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

--name string

    Resursnamnet för arbetsytans basmiljö.

--no-wait

    Vänta inte med att nå DONE tillståndet.

--timeout duration

    Maximal tid för att nå DONE tillstånd.

Globala flaggor

Examples

I följande exempel uppdateras en basmiljö för arbetsytan:

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

Globala flaggor

--debug

  Om felsökningsloggning ska aktiveras.

-h eller --help

    Visa hjälp för Databricks CLI eller den relaterade kommandogruppen eller det relaterade kommandot.

--log-file sträng

    En sträng som representerar filen som utdataloggarna ska skrivas till. Om den här flaggan inte anges är standardvärdet att skriva utdataloggar till stderr.

--log-format Format

    Loggformattypen, text eller json. Standardvärdet är text.

--log-level sträng

    En sträng som representerar loggformatnivån. Om det inte anges inaktiveras loggformatnivån.

-o, --output typ

    Kommandots utdatatyp, text eller json. Standardvärdet är text.

-p, --profile sträng

    Namnet på profilen i ~/.databrickscfg-filen som ska användas för att köra kommandot. Om den här flaggan inte anges används den namngivna DEFAULT profilen om den finns.

--progress-format Format

    Formatet för att visa förloppsloggar: default, append, inplaceeller json

-t, --target sträng

    Om tillämpligt, paketmålet som ska användas