Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Note
Tyto informace platí pro Databricks CLI verze 0.205 a vyšší. Rozhraní příkazového řádku Databricks je ve veřejné ukázce.
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 experiments příkazů v rozhraní příkazového řádku Databricks umožňuje vytvářet, upravovat, odstraňovat a spravovat experimenty v MLflow. Viz Uspořádání trénovacích běhů pomocí experimentů MLflow.
Experimenty databricks vytvořit-experiment
Vytvořte experiment s názvem. Vrátí ID nově vytvořeného experimentu. Ověří, že ještě neexistuje jiný experiment se stejným názvem a selže, pokud již existuje jiný experiment se stejným názvem.
Vyvolá chybu RESOURCE_ALREADY_EXISTS, pokud existuje experiment s daným názvem.
databricks experiments create-experiment NAME [flags]
Arguments
NAME
Název experimentu
Možnosti
--artifact-location string
Umístění, kde jsou uloženy všechny artefakty experimentu.
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
Vytvoření a spuštění experimentu v Databricks
Vytvořte nový běh v experimentu. Jeden běh obvykle představuje jednotlivé spuštění kanálu strojového učení nebo ETL kanálu pro zpracování dat. MLflow používá běhy ke sledování mlflowParam, mlflowMetric a mlflowRunTag přidružených k jediné exekuci.
databricks experiments create-run [flags]
Arguments
None
Možnosti
--experiment-id string
ID přidruženého experimentu.
--json JSON
Vložený řetězec JSON nebo soubor JSON @path s tělem požadavku
--run-name string
Název běhu.
--start-time int
Časové razítko unixu v milisekundách od spuštění.
--user-id string
ID uživatele, který provádí běh.
Experimenty Databricks delete-experiment
Označte experiment a s ním spojená metadata, spuštění, metriky, parametry a značky k odstranění. Pokud experiment používá FileStore, odstraní se také artefakty přidružené k experimentu.
databricks experiments delete-experiment EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
ID přidruženého experimentu.
Možnosti
--json JSON
Vložený řetězec JSON nebo soubor JSON @path s tělem požadavku
Experimenty Databricks smazání běhu
Označte spuštění pro odstranění.
databricks experiments delete-run RUN_ID [flags]
Arguments
RUN_ID
ID spuštění, které chcete odstranit.
Možnosti
--json JSON
Vložený řetězec JSON nebo soubor JSON @path s tělem požadavku
Experimenty Databricks s odstraněním spuštění
Hromadné odstranění běhů v experimentu, které byly vytvořeny před nebo v zadaném časovém razítku. Odstraní maximálně max_runs na požadavek. K volání tohoto rozhraní API z poznámkového bloku Databricks v Pythonu můžete použít fragment kódu klienta.
databricks experiments delete-runs EXPERIMENT_ID MAX_TIMESTAMP_MILLIS [flags]
Arguments
EXPERIMENT_ID
ID experimentu, který obsahuje běhy, jež se mají odstranit.
MAX_TIMESTAMP_MILLIS
Maximální časové razítko vytváření v milisekundách od epochy UNIX pro odstranění spuštění. Odstraní se pouze spuštění vytvořená před nebo v tomto časovém razítku.
Možnosti
--json JSON
Vložený řetězec JSON nebo soubor JSON @path s tělem požadavku
--max-runs int
Volitelné kladné celé číslo označující maximální počet spuštění, která se mají odstranit.
Experimenty v databricks - odstranění štítku
Odstranit značku během běhu. Značky jsou metadata spuštění, která je možné aktualizovat během spuštění a po dokončení spuštění.
databricks experiments delete-tag RUN_ID KEY [flags]
Arguments
RUN_ID
ID spuštění, pod kterým byl štítek zaznamenán. Required.
KEY
Název značky Maximální velikost je 255 bajtů. Required.
Možnosti
--json JSON
Vložený řetězec JSON nebo soubor JSON @path s tělem požadavku
Experimenty Databricks get-by-name
Získejte metadata pro experiment se zadaným názvem.
Tento příkaz vrátí odstraněné experimenty, ale upřednostňuje aktivní experiment, pokud aktivní a odstraněný experiment sdílí stejný název. Pokud několik odstraněných experimentů sdílí stejný název, rozhraní API vrátí jeden z nich.
RESOURCE_DOES_NOT_EXIST Vyvolá chybu, pokud neexistuje žádný experiment se zadaným názvem.
databricks experiments get-by-name EXPERIMENT_NAME [flags]
Arguments
EXPERIMENT_NAME
Název přidruženého experimentu
Možnosti
Experimenty Databricks get-experiment
Získejte metadata pro experiment se zadaným ID. Tento příkaz funguje na odstraněných experimentech.
databricks experiments get-experiment EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
ID přidruženého experimentu.
Možnosti
Získání historie experimentů databricks
Získejte seznam všech hodnot pro zadanou metriku u daného spuštění.
databricks experiments get-history METRIC_KEY [flags]
Arguments
METRIC_KEY
Název metriky
Možnosti
--max-results int
Maximální počet záznamů metrik, které se vrátí na jeden stránkovaný dotaz.
--page-token string
Token označující stránku historie metrik, které se mají načíst.
--run-id string
ID spuštění, ze kterého se mají načíst hodnoty metrik.
--run-uuid string
Zastaralé, použijte --run_id místo toho. ID spuštění, ze kterého se mají načíst hodnoty metrik.
Experimenty Databricks získat-run
Získejte metadata, metriky, parametry a značky pro spuštění. V případě, že jsou pro spuštění zaznamenány více metrik, které mají stejný klíč, vrátí se pouze hodnota s nejnovějším časovým razítkem.
Pokud existuje více hodnot s posledním časovým razítkem, vraťte maximum těchto hodnot.
databricks experiments get-run RUN_ID [flags]
Arguments
RUN_ID
ID spuštění, které se má načíst. Je nutné zadat.
Možnosti
--run-uuid string
Zastaralé, použijte --run_id místo toho. ID spuštění, které se má načíst.
Experimenty Databricks – seznam artefaktů
Seznam artefaktů pro běh Přebírá volitelnou předponu artifact_path, která je-li zadána, obsahuje odpověď pouze artefakty se zadanou předponou. Pro svazky katalogu Unity se načte maximálně 1 000 artefaktů. K výpisu artefaktů ve svazcích katalogu Unity, které podporují stránkování, použijte databricks fs ls .
databricks experiments list-artifacts [flags]
Arguments
None
Možnosti
--page-token string
Token označující stránku výsledků artefaktů, které se mají načíst.
--path string
Filtruje artefakty odpovídající této cestě (relativní cesta z kořenového adresáře artefaktů).
--run-id string
ID spuštění, jehož soubory se mají vypsat.
--run-uuid string
Zastaralé, použijte --run_id místo toho. ID spuštění, jehož soubory se mají vypsat.
Seznam experimentů databricks
Získejte seznam všech experimentů.
databricks experiments list-experiments [flags]
Arguments
None
Možnosti
--max-results int
Maximální požadovaný počet experimentů
--page-token string
Token určující stránku experimentů, které se mají načíst.
--view-type ViewType
Určující prvek pro typ experimentů, které mají být vráceny. Podporované hodnoty: ACTIVE_ONLY, ALL, DELETED_ONLY
Experimenty databricks – záznam dávky
Zaznamenává dávku metrik, parametrů a značek pro běh. Pokud se nepodařilo zachovat nějaká data, server odpoví chybou (stavový kód bez 200). Informace o přepsání chování a omezení požadavků najdete v tématu Experimenty.
databricks experiments log-batch [flags]
Arguments
None
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--run-id string
ID spuštění, pod kterým se má zaznamenávat.
Databricks experimentuje se vstupy protokolů
Note
Tento příkaz je experimentální.
Zaznamenává vstupy, jako jsou datové sady a modely, v rámci běhu MLflow.
databricks experiments log-inputs RUN_ID [flags]
Arguments
RUN_ID
ID spuštění pro zaznamenání pod
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
Protokolovací metriky experimentů v Databricks
Zaznamenejte metriku pro běh. Metrika je pár klíč-hodnota (řetězcový klíč, plovoucí hodnota) s přidruženým časovým razítkem. Mezi příklady patří různé metriky, které představují přesnost modelu ML. Metriku je možné protokolovat vícekrát.
databricks experiments log-metric KEY VALUE TIMESTAMP [flags]
Arguments
KEY
Název metriky
VALUE
Dvojitá hodnota protokolované metriky
TIMESTAMP
Časové razítko unixu v milisekundách v době, kdy byla metrika zaznamenána.
Možnosti
--dataset-digest string
Shrnutí datové sady přidružené k metrice, např.
--dataset-name string
Název datové sady přidružené k metrice.
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--model-id string
ID protokolovaného modelu přidruženého k metrice( pokud je to možné).
--run-id string
ID spuštění, pod kterým se má metrika protokolovat.
--run-uuid string
Zastaralé, použijte --run_id místo toho. ID spuštění, pod kterým se má metrika protokolovat.
--step int
Krok, ve kterém chcete metriku protokolovat.
Databricks experimenty s log-modelem
Protokolujte model
Note
Tento příkaz je experimentální.
databricks experiments log-model [flags]
Arguments
None
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--model-json string
Soubor MLmodel ve formátu JSON
--run-id string
ID spuštění, pod kterým se má zaznamenávat.
Experimenty Databricks zaznamenávají parametry
Zaznamenejte parametr použitý ke spuštění. Parametr je pár klíč-hodnota (řetězcový klíč, řetězcová hodnota). Mezi příklady patří hyperparametry používané pro trénování modelu ML a konstantní data a hodnoty používané v kanálu ETL. Parametr lze protokolovat pouze jednou během jednoho spuštění.
databricks experiments log-param KEY VALUE [flags]
Arguments
KEY
Název parametru. Maximální velikost je 255 bajtů.
VALUE
Řetězcová hodnota parametru, který se protokoluje. Maximální velikost je 500 bajtů.
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--run-id string
ID spuštění, pod kterým se má parametr protokolovat.
--run-uuid string
[Zastaralé, použijte místo toho run_id] ID spuštění, pod kterým se má parametr protokolovat.
Experimenty Databricks: restore-experiment
Obnovení experimentu označeného k odstranění Tím se také obnoví přidružená metadata, spuštění, metriky, parametry a značky. Pokud experiment používá FileStore, obnoví se také základní artefakty přidružené k experimentu.
RESOURCE_DOES_NOT_EXIST Vyvolá chybu, pokud se experiment nikdy nevytvořil nebo byl trvale odstraněn.
databricks experiments restore-experiment EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
ID přidruženého experimentu.
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
Experimenty databricks – obnovení a spuštění
Obnovení odstraněného spuštění Tím se také obnoví přidružená metadata, spuštění, metriky, parametry a značky.
Vyvolá RESOURCE_DOES_NOT_EXIST, pokud spuštění nebylo nikdy vytvořeno nebo bylo trvale odstraněno.
databricks experiments restore-run RUN_ID [flags]
Arguments
RUN_ID
ID spuštění, které se má obnovit.
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
Experimenty v Databricks: obnovení běhů
Hromadné obnovení se spustí v experimentu, který nebyl odstraněn dříve než zadané časové razítko. Obnoví maximálně max_runs na požadavek.
databricks experiments restore-runs EXPERIMENT_ID MIN_TIMESTAMP_MILLIS [flags]
Arguments
EXPERIMENT_ID
ID experimentu obsahujícího spuštění k obnovení.
MIN_TIMESTAMP_MILLIS
Minimální časové razítko odstranění v milisekundách od epochy UNIX pro obnovení běhů. Obnoví se pouze odstraněná před tímto časovým razítkem.
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--max-runs int
Volitelné kladné celé číslo označující maximální počet spuštění, která se mají obnovit.
Experimenty Databricks vyhledávání-experimentů
Vyhledá experimenty, které splňují zadaná kritéria hledání.
databricks experiments search-experiments [flags]
Arguments
None
Možnosti
--filter string
Řetězec představující podmínku filtru SQL
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--max-results int
Maximální požadovaný počet experimentů
--page-token string
Token určující stránku experimentů, které se mají načíst.
--view-type ViewType
Určující prvek pro typ experimentů, které mají být vráceny. Podporované hodnoty: ACTIVE_ONLY, ALL, DELETED_ONLY
Experimenty databricks – spuštění hledání
Vyhledá spuštění, která vyhovují výrazům. Vyhledávací výrazy můžou používat klíče mlflowMetric a mlflowParam.
databricks experiments search-runs [flags]
Arguments
None
Možnosti
--filter string
Výraz filtru nad parametry, metrikami a značkami, který umožňuje vrátit podmnožinu běhů.
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--max-results int
Maximální požadovaný počet spuštění
--page-token string
Token pro aktuální stránku běhů
--run-view-type ViewType
Zobrazení pouze aktivních, pouze odstraněných nebo všech běhů. Podporované hodnoty: ACTIVE_ONLY, ALL, DELETED_ONLY
Databricks experimenty příkaz set-experiment-tag
Nastaví štítek pro experiment. Značky experimentu jsou metadata, která je možné aktualizovat.
databricks experiments set-experiment-tag EXPERIMENT_ID KEY VALUE [flags]
Arguments
EXPERIMENT_ID
ID experimentu, pro který se má značka zaznamenat. Je nutné zadat.
KEY
Název značky Podporují se klíče o velikosti až 250 bajtů.
VALUE
Řetězcová hodnota značky, která se protokoluje. Podporují se hodnoty o velikosti až 64 kB.
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
Nastavení značky pro experimenty v Databricks
Nastaví značku při spuštění. Značky jsou metadata spuštění, která je možné aktualizovat během spuštění a po dokončení spuštění.
databricks experiments set-tag KEY VALUE [flags]
Arguments
KEY
Název značky Podporují se klíče o velikosti až 250 bajtů.
VALUE
Řetězcová hodnota značky, která se protokoluje. Podporují se hodnoty o velikosti až 64 kB.
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--run-id string
ID spuštění, pod kterým se má značka zaznamenat.
--run-uuid string
Zastaralé, použijte --run_id místo toho. ID spuštění, pod kterým se má značka zaznamenat.
Experimenty Databricks aktualizovat-experiment
Aktualizujte experiment.
databricks experiments update-experiment EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
ID přidruženého experimentu.
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--new-name string
V případě potřeby se název experimentu změní na nový název.
Aktualizace spuštění experimentů Databricks
Aktualizujte spuštění.
databricks experiments update-run [flags]
Arguments
None
Možnosti
--end-time int
Unixový časový razítko v milisekundách, kdy běh skončil.
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
--run-id string
ID spuštění, které se má aktualizovat.
--run-name string
Aktualizovaný název operace
--run-uuid string
Zastaralé, použijte --run_id místo toho. ID spuštění, které se má aktualizovat.
--status UpdateRunStatus
Aktualizovaný stav spuštění Podporované hodnoty: FAILED, FINISHED, KILLED, RUNNINGSCHEDULED
Úrovně oprávnění pro experimenty v Databricks
Získejte úrovně oprávnění experimentu.
databricks experiments get-permission-levels EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
Experiment, pro který chcete získat nebo spravovat oprávnění.
Možnosti
Experimenty Databricks získat oprávnění
Získejte oprávnění experimentu. Experimenty mohou dědit oprávnění z kořenového objektu.
databricks experiments get-permissions EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
Experiment, pro který chcete získat nebo spravovat oprávnění.
Možnosti
Nastavení oprávnění pro experimenty Databricks
Nastavte oprávnění experimentu.
Nastaví oprávnění pro objekt a nahradí stávající oprávnění, pokud existují. Odstraní všechna přímá oprávnění, pokud nejsou zadána žádná. Objekty mohou dědit oprávnění z kořenového objektu.
databricks experiments set-permissions EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
Experiment, pro který chcete získat nebo spravovat oprávnění.
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
Experimenty Databricks s oprávněními k aktualizaci
Aktualizujte oprávnění experimentu. Experimenty mohou dědit oprávnění z kořenového objektu.
databricks experiments update-permissions EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
Experiment, pro který chcete získat nebo spravovat oprávnění.
Možnosti
--json JSON
Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.
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