Udostępnij przez


experiments grupa poleceń

Note

Te informacje dotyczą interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej. Interfejs CLI Databricks jest w publicznej wersji testowej.

Korzystanie z interfejsu wiersza polecenia usługi Databricks podlega licencjom usługi Databricks i powiadomieniom o ochronie prywatności usługi Databricks, w tym wszelkim przepisom dotyczącym danych użycia.

Grupa experiments poleceń w interfejsie wiersza polecenia usługi Databricks umożliwia tworzenie, edytowanie, usuwanie eksperymentów i zarządzanie nimi w usłudze MLflow. Zobacz Organizowanie przebiegów trenowania przy użyciu eksperymentów MLflow.

tworzenie-eksperymentu w Databricks

Utwórz eksperyment z nazwą. Zwraca identyfikator nowo utworzonego eksperymentu. Sprawdza, czy inny eksperyment o tej samej nazwie jeszcze nie istnieje i kończy się niepowodzeniem, jeśli inny eksperyment o tej samej nazwie już istnieje.

Zgłasza wyjątek RESOURCE_ALREADY_EXISTS, jeśli istnieje eksperyment o podanej nazwie.

databricks experiments create-experiment NAME [flags]

Arguments

NAME

    Nazwa eksperymentu.

Opcje

--artifact-location string

    Lokalizacja, w której są przechowywane wszystkie artefakty eksperymentu.

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

Flagi globalne

eksperymenty usługi Databricks utwórz-uruchom

Utwórz nowy przebieg w ramach eksperymentu. Uruchomienie jest zwykle pojedynczym wykonaniem potoku ETL uczenia maszynowego lub danych. Narzędzie MLflow używa przebiegów do śledzenia parametrów mlflowParam, mlflowMetric i mlflowRunTag skojarzonych z jednym wykonaniem.

databricks experiments create-run [flags]

Arguments

None

Opcje

--experiment-id string

    Identyfikator skojarzonego eksperymentu.

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania

--run-name string

    Nazwa przebiegu.

--start-time int

    Sygnatura czasowa systemu Unix w milisekundach czasu uruchomienia.

--user-id string

    Identyfikator użytkownika wykonującego zadanie.

Flagi globalne

usuń eksperyment Databricks

Oznaczanie eksperymentu i skojarzonych metadanych, przebiegów, metryk, parametrów i tagów do usunięcia. Jeśli eksperyment korzysta z magazynu plików, artefakty skojarzone z eksperymentem również zostaną usunięte.

databricks experiments delete-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Identyfikator skojarzonego eksperymentu.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania

Flagi globalne

Usuwanie uruchomienia eksperymentu w Databricks

Oznacz przebieg do usunięcia.

databricks experiments delete-run RUN_ID [flags]

Arguments

RUN_ID

    Identyfikator przebiegu do usunięcia.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania

Flagi globalne

eksperymenty usuwania usługi databricks

Zbiorcze usuwanie uruchamia się, aby usunąć przebiegi eksperymentu, które zostały utworzone przed lub o określonym znaczniku czasu. Usuwa co najwyżej max_runs na żądanie. Aby wywołać ten interfejs API z notesu usługi Databricks w języku Python, możesz użyć fragmentu kodu klienta

databricks experiments delete-runs EXPERIMENT_ID MAX_TIMESTAMP_MILLIS [flags]

Arguments

EXPERIMENT_ID

    Identyfikator eksperymentu zawierającego uruchomienia, które mają zostać usunięte.

MAX_TIMESTAMP_MILLIS

    Maksymalny znacznik czasu utworzenia w milisekundach od epoki UNIX do usuwania uruchomień. Usuwane są tylko uruchomienia utworzone przed znacznikami czasu lub w tym momencie.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania

--max-runs int

    Opcjonalna dodatnia liczba całkowita wskazująca maksymalną liczbę przebiegów do usunięcia.

Flagi globalne

eksperymenty Databricks usuń-znacznik

Usuń tag w uruchomieniu. Tagi są metadanymi procesu uruchamiania, które można zaktualizować podczas jego trwania i po zakończeniu.

databricks experiments delete-tag RUN_ID KEY [flags]

Arguments

RUN_ID

    Identyfikator procesu, w ramach którego zarejestrowano tag. Required.

KEY

    Nazwa tagu. Maksymalny rozmiar to 255 bajtów. Required.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania

Flagi globalne

eksperymenty Databricks w funkcji pobierania-po-nazwie

Pobieranie metadanych eksperymentu z określoną nazwą.

To polecenie zwróci usunięte eksperymenty, ale preferuje aktywny eksperyment, jeśli aktywny i usunięty eksperyment ma taką samą nazwę. Jeśli wiele usuniętych eksperymentów ma taką samą nazwę, interfejs API zwróci jeden z nich.

Zgłasza błąd RESOURCE_DOES_NOT_EXIST , jeśli nie istnieje żaden eksperyment z określoną nazwą.

databricks experiments get-by-name EXPERIMENT_NAME [flags]

Arguments

EXPERIMENT_NAME

    Nazwa skojarzonego eksperymentu.

Opcje

Flagi globalne

eksperymenty get-experiments usługi databricks

Pobierz metadane eksperymentu o określonym identyfikatorze. To polecenie działa w przypadku usuniętych eksperymentów.

databricks experiments get-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Identyfikator skojarzonego eksperymentu.

Opcje

Flagi globalne

eksperymenty usługi databricks get-history

Pobierz listę wszystkich wartości dla określonej metryki dla danego przebiegu.

databricks experiments get-history METRIC_KEY [flags]

Arguments

METRIC_KEY

    Nazwa metryki.

Opcje

--max-results int

    Maksymalna liczba rekordów metryk do zwrócenia w jednym żądaniu stronicowanym.

--page-token string

    Token wskazujący stronę historii metryk do pobrania.

--run-id string

    Identyfikator przebiegu, z którego mają być pobrane wartości metryk.

--run-uuid string

    Przestarzałe, użyj --run_id zamiast tego. Identyfikator przebiegu, z którego mają być pobrane wartości metryk.

Flagi globalne

eksperymenty get-run w usłudze databricks

Pobierz metadane, metryki, parametry i tagi dla uruchomienia. W przypadku, gdy wiele metryk o tym samym kluczu jest rejestrowanych dla przebiegu, zwróć tylko wartość z najnowszym znacznikiem czasu.

Jeśli istnieje wiele wartości z najnowszym znacznikiem czasu, zwróć maksymalną z tych wartości.

databricks experiments get-run RUN_ID [flags]

Arguments

RUN_ID

    Identyfikator przebiegu do pobrania. Należy podać.

Opcje

--run-uuid string

    Przestarzałe, użyj --run_id zamiast tego. Identyfikator przebiegu do pobrania.

Flagi globalne

eksperymenty usługi databricks list-artifacts

Wypisz artefakty dla przebiegu. Pobiera opcjonalny artifact_path prefiks, który w przypadku określenia odpowiedzi zawiera tylko artefakty z określonym prefiksem. Dla woluminów Unity Catalog zostanie pobranych maksymalnie 1000 artefaktów. Użyj databricks fs ls do wyświetlania artefaktów w woluminach katalogu Unity, które obsługują stronicowanie.

databricks experiments list-artifacts [flags]

Arguments

None

Opcje

--page-token string

    Token wskazujący stronę wyników artefaktu do pobrania.

--path string

    Filtruj artefakty pasujące do tej ścieżki (ścieżka względna z głównego katalogu artefaktów).

--run-id string

    Identyfikator przebiegu, którego artefakty mają być wyświetlone.

--run-uuid string

    Przestarzałe, użyj --run_id zamiast tego. Identyfikator przebiegu, którego artefakty mają być wyświetlone.

Flagi globalne

Lista eksperymentów Databricks

Pobierz listę wszystkich eksperymentów.

databricks experiments list-experiments [flags]

Arguments

None

Opcje

--max-results int

    Maksymalna liczba żądanych eksperymentów.

--page-token string

    Token wskazujący stronę eksperymentów do pobrania.

--view-type ViewType

    Kwalifikator dla typu eksperymentów, które mają być zwracane. Obsługiwane wartości: ACTIVE_ONLY, ALL, DELETED_ONLY

Flagi globalne

eksperymenty usługi databricks log-batch

Rejestrowanie partii metryk, parametrów oraz tagów dla procesu uruchomienia. Jeśli nie udało się zachować żadnych danych, serwer zwróci błąd (status stanu inny niż 200). W celu uzyskania informacji na temat zachowania nadpisywania i limitów żądań, zobacz Eksperymenty.

databricks experiments log-batch [flags]

Arguments

None

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--run-id string

    Identyfikator przebiegu do zalogowania.

Flagi globalne

rejestrowanie danych wejściowych eksperymentów w Databricks

Note

To polecenie jest eksperymentalne.

Loguje dane wejściowe, takie jak zestawy danych i modele, do przebiegu MLflow.

databricks experiments log-inputs RUN_ID [flags]

Arguments

RUN_ID

    Identyfikator uruchomienia do zalogowania

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

Flagi globalne

Databricks experiments log-metric (metryka dzienników eksperymentów usługi databricks)

Rejestrować metrykę dla przebiegu. Metryka to para klucz-wartość (klucz typu ciąg znaków, wartość zmiennoprzecinkowa) z przypisanym znacznikiem czasu. Przykłady obejmują różne metryki reprezentujące dokładność modelu uczenia maszynowego. Metryka może być rejestrowana wiele razy.

databricks experiments log-metric KEY VALUE TIMESTAMP [flags]

Arguments

KEY

    Nazwa metryki.

VALUE

    Podwójna wartość rejestrowanej metryki.

TIMESTAMP

    Sygnatura czasowa systemu Unix w milisekundach w czasie rejestrowania metryki.

Opcje

--dataset-digest string

    Skrótowy przegląd zestawu danych powiązanego z metryką, np.

--dataset-name string

    Nazwa zestawu danych skojarzonego z metryki.

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--model-id string

    Identyfikator zalogowanego modelu skojarzonego z metryką, jeśli ma to zastosowanie.

--run-id string

    Identyfikator przebiegu, w którym ma być rejestrowana metryka.

--run-uuid string

    Przestarzałe, użyj --run_id zamiast tego. Identyfikator przebiegu, w którym ma być rejestrowana metryka.

--step int

    Krok rejestrowania metryki.

Flagi globalne

eksperymenty Databricks log-model

Zarejestruj model.

Note

To polecenie jest eksperymentalne.

databricks experiments log-model [flags]

Arguments

None

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--model-json string

    Plik MLmodel w formacie json.

--run-id string

    Identyfikator przebiegu do zalogowania.

Flagi globalne

log-param dla eksperymentów w Databricks

Zapisz parametr używany podczas uruchomienia. Param to para klucz-wartość (klucz tekstowy, wartość tekstowa). Przykłady obejmują hiperparametry używane do trenowania modelu uczenia maszynowego oraz stałe daty i wartości używane w potoku ETL. Parametr może być rejestrowany tylko raz na przebieg.

databricks experiments log-param KEY VALUE [flags]

Arguments

KEY

    Nazwa parametru. Maksymalny rozmiar to 255 bajtów.

VALUE

    Wartość ciągu rejestrowanego parametru. Maksymalny rozmiar to 500 bajtów.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--run-id string

    Identyfikator przebiegu, w którym ma być rejestrowany parametr.

--run-uuid string

    [Przestarzałe, użyj run_id zamiast tego] Identyfikator przebiegu, w którym ma być rejestrowane parametry.

Flagi globalne

eksperymenty w Databricks przywróć eksperyment

Przywróć eksperyment oznaczony do usunięcia. Spowoduje to również przywrócenie skojarzonych metadanych, przebiegów, metryk, parametrów i tagów. Jeśli eksperyment korzysta z usługi FileStore, przywracane są również podstawowe artefakty skojarzone z eksperymentem.

RESOURCE_DOES_NOT_EXIST Zgłasza błąd, jeśli eksperyment nigdy nie został utworzony lub został trwale usunięty.

databricks experiments restore-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Identyfikator skojarzonego eksperymentu.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

Flagi globalne

przywracanie uruchomień eksperymentów w usłudze Databricks

Przywróć usunięty przebieg. Spowoduje to również przywrócenie skojarzonych metadanych, przebiegów, metryk, parametrów i tagów.

RESOURCE_DOES_NOT_EXIST Zgłasza błąd, jeśli przebieg nigdy nie został utworzony lub został trwale usunięty.

databricks experiments restore-run RUN_ID [flags]

Arguments

RUN_ID

    ID przebiegu do przywrócenia.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

Flagi globalne

eksperymenty Databricks przywracanie uruchomień

Zbiorcze przywracanie przebiegów eksperymentów, które zostały usunięte nie wcześniej niż w określonym znaczniku czasu. Przywraca co najwyżej max_runs na żądanie.

databricks experiments restore-runs EXPERIMENT_ID MIN_TIMESTAMP_MILLIS [flags]

Arguments

EXPERIMENT_ID

    Identyfikator eksperymentu zawierającego przebiegi do przywrócenia.

MIN_TIMESTAMP_MILLIS

    Minimalny znacznik czasu usuwania w milisekundach od epoki SYSTEMU UNIX na potrzeby przywracania przebiegów. Przywracane są tylko przebiegi usunięte nie wcześniej niż ten znacznik czasu.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--max-runs int

    Opcjonalna dodatnia liczba całkowita wskazująca maksymalną liczbę przebiegów do przywrócenia.

Flagi globalne

eksperymenty usługi databricks wyszukiwanie-eksperymentów

Wyszukuje eksperymenty spełniające określone kryteria wyszukiwania.

databricks experiments search-experiments [flags]

Arguments

None

Opcje

--filter string

    Ciąg reprezentujący warunek filtru SQL

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--max-results int

    Maksymalna liczba żądanych eksperymentów.

--page-token string

    Token wskazujący stronę eksperymentów do pobrania.

--view-type ViewType

    Kwalifikator dla typu eksperymentów, które mają być zwracane. Obsługiwane wartości: ACTIVE_ONLY, ALL, DELETED_ONLY

Flagi globalne

eksperymenty usługi databricks z przebiegami wyszukiwania

Wyszukuje uruchomienia spełniające wyrażenia. Wyrażenia wyszukiwania mogą używać kluczy mlflowMetric i mlflowParam.

databricks experiments search-runs [flags]

Arguments

None

Opcje

--filter string

    Wyrażenie filtrujące dla parametrów, metryk i tagów, które umożliwia zwrócenie podzestawu wykonanych operacji.

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--max-results int

    Maksymalna wymagana liczba przebiegów.

--page-token string

    Token dla bieżącej strony przebiegów.

--run-view-type ViewType

    Czy mają być wyświetlane tylko aktywne, tylko usunięte, czy wszystkie uruchomienia. Obsługiwane wartości: ACTIVE_ONLY, ALL, DELETED_ONLY

Flagi globalne

eksperymenty usługi databricks set-experiment-tag

Ustawia tag na eksperymencie. Tagi eksperymentu to metadane, które można zaktualizować.

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

Arguments

EXPERIMENT_ID

    Identyfikator eksperymentu, pod którym ma być rejestrowany tag. Należy podać.

KEY

    Nazwa tagu. Obsługiwane są klucze o rozmiarze do 250 bajtów.

VALUE

    Wartość ciągu znaków tagu, który jest rejestrowany. Obsługiwane są wartości o rozmiarze do 64 KB.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

Flagi globalne

zestaw-tag eksperymentów usługi databricks

Ustawia tag w przebiegu. Tagi są metadanymi procesu uruchamiania, które można zaktualizować podczas jego trwania i po zakończeniu.

databricks experiments set-tag KEY VALUE [flags]

Arguments

KEY

    Nazwa tagu. Obsługiwane są klucze o rozmiarze do 250 bajtów.

VALUE

    Wartość ciągu znaków tagu, który jest rejestrowany. Obsługiwane są wartości o rozmiarze do 64 KB.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--run-id string

    Identyfikator przebiegu, dla którego ma być rejestrowany znacznik.

--run-uuid string

    Przestarzałe, użyj --run_id zamiast tego. Identyfikator przebiegu, dla którego ma być rejestrowany znacznik.

Flagi globalne

eksperymenty w usłudze Databricks, aktualizacja eksperymentu

Aktualizowanie eksperymentu.

databricks experiments update-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Identyfikator skojarzonego eksperymentu.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--new-name string

    Jeśli zostanie podana, nazwa eksperymentu zostanie zmieniona na nową nazwę.

Flagi globalne

Aktualizacja eksperymentów w Databricks - uruchomienie

Aktualizować uruchomienie.

databricks experiments update-run [flags]

Arguments

None

Opcje

--end-time int

    Sygnatura czasowa systemu Unix w milisekundach z momentu zakończenia uruchomienia.

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--run-id string

    Identyfikator przebiegu do zaktualizowania.

--run-name string

    Zaktualizowano nazwę przebiegu.

--run-uuid string

    Przestarzałe, użyj --run_id zamiast tego. Identyfikator przebiegu do zaktualizowania.

--status UpdateRunStatus

    Zaktualizowano stan przebiegu. Obsługiwane wartości: FAILED, , FINISHEDKILLED, , RUNNINGSCHEDULED

Flagi globalne

Eksperymenty Databricks uzyskaj-poziom-uprawnień

Uzyskiwanie poziomów uprawnień eksperymentu.

databricks experiments get-permission-levels EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Eksperyment, dla którego chcesz uzyskać uprawnienia lub zarządzać nimi.

Opcje

Flagi globalne

eksperymenty Databricks — pobieranie uprawnień

Uzyskaj uprawnienia do eksperymentu. Eksperymenty mogą dziedziczyć uprawnienia po ich obiekcie głównym.

databricks experiments get-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Eksperyment, dla którego chcesz uzyskać uprawnienia lub zarządzać nimi.

Opcje

Flagi globalne

Ustawianie uprawnień eksperymentów w Databricks

Ustawianie uprawnień eksperymentu.

Ustawia uprawnienia do obiektu, zastępując istniejące uprawnienia, jeśli istnieją. Usuwa wszystkie uprawnienia bezpośrednie, jeśli nie określono żadnego. Obiekty mogą dziedziczyć uprawnienia po ich obiekcie głównym.

databricks experiments set-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Eksperyment, dla którego chcesz uzyskać uprawnienia lub zarządzać nimi.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

Flagi globalne

Eksperymenty usługi Databricks update-permissions

Aktualizowanie uprawnień eksperymentu. Eksperymenty mogą dziedziczyć uprawnienia po ich obiekcie głównym.

databricks experiments update-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Eksperyment, dla którego chcesz uzyskać uprawnienia lub zarządzać nimi.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

Flagi globalne

Flagi globalne

--debug

  Czy włączyć logowanie debugowe.

-h lub --help

    Wyświetl pomoc dla Databricks CLI lub dla powiązanej grupy poleceń czy pojedynczego polecenia.

--log-file struna

    Ciąg reprezentujący plik do zapisywania dzienników wyjściowych. Jeśli ta flaga nie zostanie określona, wartością domyślną jest zapisywanie dzienników wyjściowych w programie stderr.

--log-format formatowanie

    Format typu logu text lub json. Wartość domyślna to text.

--log-level struna

    Ciąg reprezentujący poziom formatu zapisu dziennika. Jeśli nie zostanie określony, poziom formatu dziennika jest wyłączony.

-o, --output typ

    Typ danych wyjściowych polecenia: text lub json. Wartość domyślna to text.

-p, --profile struna

    Nazwa profilu pliku ~/.databrickscfg, którego użyć do uruchomienia polecenia. Jeśli ta flaga nie zostanie określona, zostanie użyty profil o nazwie DEFAULT .

--progress-format formatowanie

    Format wyświetlania dzienników postępu: default, , appendinplacelubjson

-t, --target struna

    Jeśli ma to zastosowanie, docelowy obiekt pakietu do użycia