experiments kommandogrupp

The experiments command group within the Databricks CLI allows you to create, edit, delete, and manage experiments in MLflow. Se Ordna träningskörningar med MLflow-experiment.

databricks experiment create-experiment

Skapa ett experiment med ett namn. Returnerar ID:t för det nyligen skapade experimentet. Verifierar att ett annat experiment med samma namn inte redan finns och misslyckas om det redan finns ett annat experiment med samma namn.

Genererar RESOURCE_ALREADY_EXISTS om det finns ett experiment med det angivna namnet.

databricks experiments create-experiment NAME [flags]

Arguments

NAME

    Experiment name.

Options

--artifact-location string

    Plats där alla artefakter för experimentet lagras.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks experiment create-run

Skapa en ny körning i ett experiment. En körning är vanligtvis en enda körning av en maskininlärnings- eller data-ETL-pipeline. MLflow använder körningar för att spåra mlflowParam, mlflowMetric och mlflowRunTag som är associerade med en enda körning.

databricks experiments create-run [flags]

Arguments

None

Options

--experiment-id string

    ID för det associerade experimentet.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten

--run-name string

    Namnet på körningen.

--start-time int

    Unix-tidsstämpel i millisekunder av när körningen startade.

--user-id string

    ID för användaren som kör körningen.

Global flags

databricks experiment delete-experiment

Markera ett experiment och tillhörande metadata, körningar, mått, params och taggar för borttagning. Om experimentet använder FileStore tas även artefakter som är associerade med experimentet bort.

databricks experiments delete-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID för det associerade experimentet.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten

Global flags

databricks experiment delete-run

Markera en körning för borttagning.

databricks experiments delete-run RUN_ID [flags]

Arguments

RUN_ID

    ID för körningen som ska tas bort.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten

Global flags

databricks-experiment– borttagningskörningar

Massborttagning körs i ett experiment som skapades före eller vid den angivna tidsstämpeln. Tar bort högst max_runs per begäran. Om du vill anropa det här API:et från en Databricks Notebook i Python kan du använda kodfragmentet för klienten på

databricks experiments delete-runs EXPERIMENT_ID MAX_TIMESTAMP_MILLIS [flags]

Arguments

EXPERIMENT_ID

    ID:t för experimentet som innehåller de körningar som ska tas bort.

MAX_TIMESTAMP_MILLIS

    Den maximala tidsstämpeln för skapande i millisekunder sedan UNIX-epoken för att ta bort körningar. Endast körningar som skapats före eller vid den här tidsstämpeln tas bort.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten

--max-runs int

    Ett valfritt positivt heltal som anger det maximala antalet körningar som ska tas bort.

Global flags

delete-tag för databricks-experiment

Ta bort en tagg vid en körning. Taggar körs metadata som kan uppdateras under en körning och när en körning har slutförts.

databricks experiments delete-tag RUN_ID KEY [flags]

Arguments

RUN_ID

    ID för körningen som taggen loggades under. Required.

KEY

    Namnet på taggen. Maximal storlek är 255 byte. Required.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten

Global flags

databricks-experiment get-by-name

Hämta metadata för ett experiment med det angivna namnet.

Det här kommandot returnerar borttagna experiment, men föredrar det aktiva experimentet om ett aktivt och borttaget experiment delar samma namn. Om flera borttagna experiment har samma namn returnerar API:et en av dem.

Genererar RESOURCE_DOES_NOT_EXIST om det inte finns något experiment med det angivna namnet.

databricks experiments get-by-name EXPERIMENT_NAME [flags]

Arguments

EXPERIMENT_NAME

    Namnet på det associerade experimentet.

Options

Global flags

databricks experiment get-experiment

Hämta metadata för ett experiment med det angivna ID:t. Det här kommandot fungerar på borttagna experiment.

databricks experiments get-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID för det associerade experimentet.

Options

Global flags

databricks-experiment – get-history

Hämta en lista över alla värden för det angivna måttet för en viss körning.

databricks experiments get-history METRIC_KEY [flags]

Arguments

METRIC_KEY

    Måttets namn.

Options

--max-results int

    Maximalt antal måttposter som ska returneras per sidnumrerad begäran.

--page-token string

    Token som anger sidan med måtthistorik som ska hämtas.

--run-id string

    ID för körningen som måttvärden ska hämtas från.

--run-uuid string

    Inaktuell, använd --run_id i stället. ID för körningen som måttvärden ska hämtas från.

Global flags

get-run för databricks-experiment

Hämta metadata, mått, params och taggar för en körning. Om flera mått med samma nyckel loggas för en körning returnerar du endast värdet med den senaste tidsstämpeln.

Om det finns flera värden med den senaste tidsstämpeln returnerar du maxvärdet för dessa värden.

databricks experiments get-run RUN_ID [flags]

Arguments

RUN_ID

    ID för körningen som ska hämtas. Måste anges.

Options

--run-uuid string

    Inaktuell, använd --run_id i stället. ID för körningen som ska hämtas.

Global flags

databricks experiment list-artifacts

Lista artefakter för en körning. Tar ett valfritt artifact_path prefix som om det anges innehåller svaret endast artefakter med det angivna prefixet. Högst 1 000 artefakter hämtas för Unity Catalog-volymer. Använd databricks fs ls för att lista artefakter i Unity Catalog-volymer, som stöder sidnumrering.

databricks experiments list-artifacts [flags]

Arguments

None

Options

--page-token string

    Token som anger sidan med artefaktresultat som ska hämtas.

--path string

    Filtrera artefakter som matchar den här sökvägen (en relativ sökväg från rotartefaktkatalogen).

--run-id string

    ID för körningen vars artefakter ska listas.

--run-uuid string

    Inaktuell, använd --run_id i stället. ID för körningen vars artefakter ska listas.

Global flags

databricks experiment list-experiment

Hämta en lista över alla experiment.

databricks experiments list-experiments [flags]

Arguments

None

Options

--max-results int

    Maximalt antal önskade experiment.

--page-token string

    Token som anger sidan för experiment som ska hämtas.

--view-type ViewType

    Kvalificera för typ av experiment som ska returneras. Värden som stöds: ACTIVE_ONLY, ALL, DELETED_ONLY

Global flags

databricks experiment log-batch

Logga en batch med mått, params och taggar för en körning. Om några data inte kunde sparas svarar servern med ett fel (statuskod som inte är 200). For overwrite behavior and request limits, see Experiments.

databricks experiments log-batch [flags]

Arguments

None

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--run-id string

    ID för körningen som ska loggas under.

Global flags

databricks-experiment med loggindata

Loggar indata, till exempel datauppsättningar och modeller, till en MLflow-körning.

databricks experiments log-inputs RUN_ID [flags]

Arguments

RUN_ID

    ID för körningen som ska loggas under

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks-experiment med loggmått

Logga ett mått för en körning. Ett mått är ett nyckel/värde-par (strängnyckel, flyttalvärde) med en associerad tidsstämpel. Exempel är de olika mått som representerar ML-modellens noggrannhet. Ett mått kan loggas flera gånger.

databricks experiments log-metric KEY VALUE TIMESTAMP [flags]

Arguments

KEY

    Måttets namn.

VALUE

    Dubbelt värde för måttet som loggas.

TIMESTAMP

    Unix-tidsstämpel i millisekunder när måttet loggades.

Options

--dataset-digest string

    Datamängdens sammandrag av den datamängd som är associerad med måttet, t.ex.

--dataset-name string

    Namnet på den datamängd som är associerad med måttet.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--model-id string

    ID för den loggade modellen som är associerad med måttet, om tillämpligt.

--run-id string

    ID för körningen under vilken måttet ska loggas.

--run-uuid string

    Inaktuell, använd --run_id i stället. ID för körningen under vilken måttet ska loggas.

--step int

    Steg där måttet ska loggas.

Global flags

databricks experiment log-model

Logga en modell.

databricks experiments log-model [flags]

Arguments

None

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--model-json string

    MLmodel-fil i json-format.

--run-id string

    ID för körningen som ska loggas under.

Global flags

databricks experiment log-param

Logga en param som används för en körning. En param är ett nyckel/värde-par (strängnyckel, strängvärde). Exempel är hyperparametrar som används för ML-modellträning och konstanta datum och värden som används i en ETL-pipeline. En param kan bara loggas en gång för en körning.

databricks experiments log-param KEY VALUE [flags]

Arguments

KEY

    Namnet på param. Maximal storlek är 255 byte.

VALUE

    Strängvärde för den param som loggas. Maximal storlek är 500 byte.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--run-id string

    ID för körningen under vilken param ska loggas.

--run-uuid string

    [Inaktuell, använd run_id i stället] ID för körningen under vilken param ska loggas.

Global flags

återställningsexperiment för databricks-experiment

Återställ ett experiment som markerats för borttagning. Detta återställer även associerade metadata, körningar, mått, params och taggar. Om experimentet använder FileStore återställs även underliggande artefakter som är associerade med experimentet.

Genererar RESOURCE_DOES_NOT_EXIST om experimentet aldrig skapades eller togs bort permanent.

databricks experiments restore-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID för det associerade experimentet.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

återställningskörning av databricks-experiment

Återställ en borttagen körning. Detta återställer även associerade metadata, körningar, mått, params och taggar.

Genererar RESOURCE_DOES_NOT_EXIST om körningen aldrig skapades eller togs bort permanent.

databricks experiments restore-run RUN_ID [flags]

Arguments

RUN_ID

    ID för körningen som ska återställas.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

återställningskörningar för databricks-experiment

Massåterställning körs i ett experiment som inte togs bort tidigare än den angivna tidsstämpeln. Återställs som mest max_runs per begäran.

databricks experiments restore-runs EXPERIMENT_ID MIN_TIMESTAMP_MILLIS [flags]

Arguments

EXPERIMENT_ID

    ID:t för experimentet som innehåller körningarna som ska återställas.

MIN_TIMESTAMP_MILLIS

    Den minsta tidsstämpeln för borttagning i millisekunder sedan UNIX-epoken för återställning av körningar. Endast körningar som tagits bort tidigare än den här tidsstämpeln återställs.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--max-runs int

    Ett valfritt positivt heltal som anger det maximala antalet körningar som ska återställas.

Global flags

databricks-experiment sökexperiment

Söker efter experiment som uppfyller angivna sökvillkor.

databricks experiments search-experiments [flags]

Arguments

None

Options

--filter string

    Sträng som representerar ett SQL-filtervillkor

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--max-results int

    Maximalt antal önskade experiment.

--page-token string

    Token som anger sidan för experiment som ska hämtas.

--view-type ViewType

    Kvalificera för typ av experiment som ska returneras. Värden som stöds: ACTIVE_ONLY, ALL, DELETED_ONLY

Global flags

sökkörningar för databricks-experiment

Söker efter körningar som uppfyller uttryck. Sökuttryck kan använda mlflowMetric- och mlflowParam-nycklar.

databricks experiments search-runs [flags]

Arguments

None

Options

--filter string

    Ett filteruttryck över params, mått och taggar, som gör det möjligt att returnera en delmängd av körningar.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--max-results int

    Maximalt antal körningar som önskas.

--page-token string

    Token för den aktuella sidan med körningar.

--run-view-type ViewType

    Om endast aktiva, borttagna eller alla körningar ska visas. Värden som stöds: ACTIVE_ONLY, ALL, DELETED_ONLY

Global flags

databricks experiment set-experiment-tag

Anger en tagg i ett experiment. Experimenttaggar är metadata som kan uppdateras.

databricks experiments set-experiment-tag EXPERIMENT_ID KEY VALUE [flags]

Arguments

EXPERIMENT_ID

    ID för experimentet som taggen ska loggas under. Måste anges.

KEY

    Namnet på taggen. Nycklar upp till 250 byte i storlek stöds.

VALUE

    Strängvärde för taggen som loggas. Värden upp till 64 KB i storlek stöds.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

set-tag för databricks-experiment

Anger en tagg på en körning. Taggar körs metadata som kan uppdateras under en körning och när en körning har slutförts.

databricks experiments set-tag KEY VALUE [flags]

Arguments

KEY

    Namnet på taggen. Nycklar upp till 250 byte i storlek stöds.

VALUE

    Strängvärde för taggen som loggas. Värden upp till 64 KB i storlek stöds.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--run-id string

    ID för körningen under vilken taggen ska loggas.

--run-uuid string

    Inaktuell, använd --run_id i stället. ID för körningen under vilken taggen ska loggas.

Global flags

databricks experiment update-experiment

Uppdatera ett experiment.

databricks experiments update-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID för det associerade experimentet.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--new-name string

    Om det anges ändras experimentets namn till det nya namnet.

Global flags

databricks experiment update-run

Uppdatera en körning.

databricks experiments update-run [flags]

Arguments

None

Options

--end-time int

    Unix-tidsstämpel i millisekunder för när körningen avslutades.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--run-id string

    ID för körningen som ska uppdateras.

--run-name string

    Körningens namn har uppdaterats.

--run-uuid string

    Inaktuell, använd --run_id i stället. ID för körningen som ska uppdateras.

--status UpdateRunStatus

    Körningens status har uppdaterats. Värden som stöds: FAILED, FINISHED, KILLED, , RUNNINGSCHEDULED

Global flags

databricks-experiment get-permission-levels

Hämta experimentbehörighetsnivåer.

databricks experiments get-permission-levels EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Experimentet som du vill hämta eller hantera behörigheter för.

Options

Global flags

get-permissions för databricks-experiment

Hämta behörigheterna för ett experiment. Experiment kan ärva behörigheter från rotobjektet.

databricks experiments get-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Experimentet som du vill hämta eller hantera behörigheter för.

Options

Global flags

set-permissions för databricks-experiment

Ange experimentbehörigheter.

Anger behörigheter för ett objekt och ersätter befintliga behörigheter om de finns. Tar bort alla direktbehörigheter om inga har angetts. Objekt kan ärva behörigheter från sina rotobjekt.

databricks experiments set-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Experimentet som du vill hämta eller hantera behörigheter för.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks-experiment med uppdateringsbehörigheter

Uppdatera experimentbehörigheter. Experiment kan ärva behörigheter från rotobjektet.

databricks experiments update-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Experimentet som du vill hämta eller hantera behörigheter för.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

Global flags

--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 eller textjson. 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 filen som ~/.databrickscfg 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