Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Note
Queste informazioni si applicano all'interfaccia della riga di comando di Databricks versione 0.205 e successive. L'interfaccia della riga di comando di Databricks è disponibile in anteprima pubblica.
L'uso della CLI di Databricks è soggetto alla Licenza di Databricks e all'Informativa sulla privacy di Databricks, incluse eventuali disposizioni sui dati di utilizzo.
Il experiments gruppo di comandi all'interno dell'interfaccia della riga di comando di Databricks consente di creare, modificare, eliminare e gestire esperimenti in MLflow. Vedi Come organizzare le esecuzioni di training con esperimenti di MLflow.
Gli esperimenti di Databricks `create-experiment`
Creare un esperimento con un nome. Restituisce l'ID dell'esperimento appena creato. Verifica che un altro esperimento con lo stesso nome non esista già e abbia esito negativo se esiste già un altro esperimento con lo stesso nome.
Genera un'eccezione RESOURCE_ALREADY_EXISTS se esiste un esperimento con il nome specificato.
databricks experiments create-experiment NAME [flags]
Arguments
NAME
Nome esperimento.
Options
--artifact-location string
Posizione in cui vengono archiviati tutti gli artefatti per l'esperimento.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
esperimenti di databricks creazione-esecuzione
Crea una nuova esecuzione all'interno di un esperimento. Un'esecuzione è solitamente una singola esecuzione di una pipeline di machine learning o di ETL sui dati. MLflow usa le esecuzioni per tenere traccia del mlflowParam, mlflowMetric e mlflowRunTag associato a una singola esecuzione.
databricks experiments create-run [flags]
Arguments
None
Options
--experiment-id string
ID dell'esperimento associato.
--json JSON
Stringa JSON inline oppure @path nel file JSON contenente il corpo della richiesta
--run-name string
Nome della corsa.
--start-time int
Timestamp Unix in millisecondi di quando è iniziata l'esecuzione.
--user-id string
ID dell'utente che esegue l'esecuzione.
Databricks esperimenti delete-experiment
Contrassegnare un esperimento e metadati associati, esecuzioni, metriche, parametri e tag per l'eliminazione. Se l'esperimento usa FileStore, vengono eliminati anche gli artefatti associati all'esperimento.
databricks experiments delete-experiment EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
ID dell'esperimento associato.
Options
--json JSON
Stringa JSON inline oppure @path nel file JSON contenente il corpo della richiesta
esperimenti di databricks eliminazione esecuzione
Contrassegnare un'attività per l'eliminazione.
databricks experiments delete-run RUN_ID [flags]
Arguments
RUN_ID
ID dell'esecuzione da eliminare.
Options
--json JSON
Stringa JSON inline oppure @path nel file JSON contenente il corpo della richiesta
esperimenti di databricks eliminano le esecuzioni
L'eliminazione in blocco viene eseguita per le esecuzioni di un esperimento che sono state create prima o al timestamp specificato. Elimina al massimo max_runs per richiesta. Per chiamare questa API da un notebook di Databricks in Python, è possibile usare il frammento di codice client in
databricks experiments delete-runs EXPERIMENT_ID MAX_TIMESTAMP_MILLIS [flags]
Arguments
EXPERIMENT_ID
ID dell'esperimento contenente le esecuzioni da eliminare.
MAX_TIMESTAMP_MILLIS
Timestamp massimo di creazione in millisecondi dall'epoca UNIX per l'eliminazione dei processi. Vengono eliminate solo le esecuzioni create prima o in corrispondenza di questo timestamp.
Options
--json JSON
Stringa JSON inline oppure @path nel file JSON contenente il corpo della richiesta
--max-runs int
Intero positivo facoltativo che indica il numero massimo di esecuzioni da eliminare.
esperimenti di databricks rimuovi-etichetta
Eliminare un tag su un'esecuzione. I tag sono metadati di esecuzione che possono essere aggiornati durante un'esecuzione e dopo il completamento di un'esecuzione.
databricks experiments delete-tag RUN_ID KEY [flags]
Arguments
RUN_ID
ID dell'esecuzione sotto la quale è stato registrato il tag. Required.
KEY
Nome del tag. La dimensione massima è di 255 byte. Required.
Options
--json JSON
Stringa JSON inline oppure @path nel file JSON contenente il corpo della richiesta
esperimenti di Databricks get-by-name
Ottenere i metadati per un esperimento con il nome specificato.
Questo comando restituirà esperimenti eliminati, ma preferisce l'esperimento attivo se un esperimento attivo ed eliminato condivide lo stesso nome. Se più esperimenti eliminati condividono lo stesso nome, l'API restituirà uno di essi.
Genera un'eccezione RESOURCE_DOES_NOT_EXIST se non esiste alcun esperimento con il nome specificato.
databricks experiments get-by-name EXPERIMENT_NAME [flags]
Arguments
EXPERIMENT_NAME
Nome dell'esperimento associato.
Options
Esperimenti di databricks get-experiment
Ottenere i metadati per un esperimento con l'ID specificato. Questo comando funziona sugli esperimenti eliminati.
databricks experiments get-experiment EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
ID dell'esperimento associato.
Options
get-history degli esperimenti di databricks
Ottenere un elenco di tutti i valori per la metrica specificata per una determinata esecuzione.
databricks experiments get-history METRIC_KEY [flags]
Arguments
METRIC_KEY
Nome della metrica.
Options
--max-results int
Numero massimo di record delle metriche da restituire per richiesta paginata.
--page-token string
Token che indica la pagina delle cronologie delle metriche da recuperare.
--run-id string
ID dell'esecuzione dalla quale recuperare i valori delle metriche.
--run-uuid string
Deprecato, usare --run_id invece . ID dell'esecuzione dalla quale recuperare i valori delle metriche.
esperimenti di databricks recupera-esecuzione
Ottenere i metadati, le metriche, i parametri e i tag per un'esecuzione. Nel caso in cui vengano registrate più metriche con la stessa chiave per un'esecuzione, restituire solo il valore con il timestamp più recente.
Se sono presenti più valori con il timestamp più recente, restituire il massimo di questi valori.
databricks experiments get-run RUN_ID [flags]
Arguments
RUN_ID
ID dell'esecuzione da recuperare. Deve essere specificato.
Options
--run-uuid string
Deprecato, usare --run_id invece . ID dell'esecuzione da recuperare.
databricks esperimenti list-artifacts
Elenca gli artefatti per un'esecuzione. Accetta un prefisso facoltativo artifact_path che, se specificato, la risposta contiene solo artefatti con il prefisso specificato. Verrà recuperato un massimo di 1000 artefatti per i volumi del catalogo Unity. Usare databricks fs ls per visualizzare gli artefatti nei volumi di Unity Catalog, che supporta la funzionalità di paginazione.
databricks experiments list-artifacts [flags]
Arguments
None
Options
--page-token string
Token che indica la pagina dei risultati dell'artefatto da recuperare.
--path string
Filtra gli artefatti che corrispondono a questo percorso (percorso relativo dalla directory radice degli artefatti).
--run-id string
ID dell'esecuzione di cui elencare gli artefatti.
--run-uuid string
Deprecato, usare --run_id invece . ID dell'esecuzione di cui elencare gli artefatti.
Elenco esperimenti Databricks list-experiments
Ottenere un elenco di tutti gli esperimenti.
databricks experiments list-experiments [flags]
Arguments
None
Options
--max-results int
Numero massimo di esperimenti desiderati.
--page-token string
Token che indica la pagina degli esperimenti da recuperare.
--view-type ViewType
Qualificatore per il tipo di esperimenti da restituire. Valori supportati: ACTIVE_ONLY, ALL, DELETED_ONLY
esperimenti di log-batch di Databricks
Registrare un batch di metriche, parametri e tag per un'esecuzione. Se non è stato possibile rendere persistenti i dati, il server risponderà con un errore (codice di stato diverso da 200). Per il comportamento di sovrascrittura e i limiti delle richieste, vedere Esperimenti.
databricks experiments log-batch [flags]
Arguments
None
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--run-id string
ID della sessione sotto cui registrare.
input di log degli esperimenti di databricks
Note
Questo comando è sperimentale.
Registra input, ad esempio set di dati e modelli, in un Run di MLflow.
databricks experiments log-inputs RUN_ID [flags]
Arguments
RUN_ID
ID dell'esecuzione da registrare sotto
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
metrica di registro degli esperimenti di Databricks
Registrare una metrica per un'esecuzione. Una metrica è una coppia chiave-valore (chiave stringa, valore float) con un timestamp associato. Gli esempi includono le varie metriche che rappresentano l'accuratezza del modello di Machine Learning. Una metrica può essere registrata più volte.
databricks experiments log-metric KEY VALUE TIMESTAMP [flags]
Arguments
KEY
Nome della metrica.
VALUE
Valore doppio della metrica registrata.
TIMESTAMP
Timestamp Unix in millisecondi nel momento in cui la metrica è stata registrata.
Options
--dataset-digest string
Riepilogo del set di dati associato alla metrica, ad esempio
--dataset-name string
Nome del set di dati associato alla metrica.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--model-id string
ID del modello registrato associato alla metrica, se applicabile.
--run-id string
ID dell'esecuzione in cui registrare la metrica.
--run-uuid string
Deprecato, usare --run_id invece . ID dell'esecuzione in cui registrare la metrica.
--step int
Passaggio in cui registrare la metrica.
modello di log degli esperimenti di databricks
Registrare un modello.
Note
Questo comando è sperimentale.
databricks experiments log-model [flags]
Arguments
None
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--model-json string
File MLmodel in formato json.
--run-id string
ID della sessione sotto cui registrare.
esperimenti di registrazione dei parametri di Databricks
Registrare un parametro usato per un'esecuzione. Un parametro è una coppia chiave-valore (chiave stringa, valore stringa). Gli esempi includono gli iperparametri usati per il training del modello di Machine Learning e le date e i valori costanti usati in una pipeline ETL. Un parametro può essere registrato una sola volta per un'esecuzione.
databricks experiments log-param KEY VALUE [flags]
Arguments
KEY
Nome del parametro. La dimensione massima è di 255 byte.
VALUE
Valore stringa del parametro registrato. La dimensione massima è di 500 byte.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--run-id string
ID dell'esecuzione in cui registrare il parametro.
--run-uuid string
[Deprecato, usare invece run_id] ID dell'esecuzione in cui registrare il parametro.
esperimenti di Databricks restore-experiment
Ripristinare un esperimento contrassegnato per l'eliminazione. In questo modo vengono ripristinati anche i metadati, le esecuzioni, le metriche, i parametri e i tag associati. Se l'esperimento usa FileStore, vengono ripristinati anche gli artefatti sottostanti associati all'esperimento.
RESOURCE_DOES_NOT_EXIST Genera un'eccezione se l'esperimento non è mai stato creato o è stato eliminato definitivamente.
databricks experiments restore-experiment EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
ID dell'esperimento associato.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
esperimenti di Databricks ripristino-esecuzione
Ripristinare un'esecuzione eliminata. In questo modo vengono ripristinati anche i metadati, le esecuzioni, le metriche, i parametri e i tag associati.
RESOURCE_DOES_NOT_EXIST Genera un'eccezione se l'esecuzione non è mai stata creata o è stata eliminata definitivamente.
databricks experiments restore-run RUN_ID [flags]
Arguments
RUN_ID
ID dell'esecuzione da ripristinare.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
esperimenti di databricks restore-runs
Vengono ripristinate collettivamente le esecuzioni in un esperimento che sono state eliminate non prima dell'orario specificato. Ripristina al massimo max_runs per ogni richiesta.
databricks experiments restore-runs EXPERIMENT_ID MIN_TIMESTAMP_MILLIS [flags]
Arguments
EXPERIMENT_ID
ID dell'esperimento contenente le esecuzioni da ripristinare.
MIN_TIMESTAMP_MILLIS
Timestamp di eliminazione minimo in millisecondi dall'epoca UNIX per ripristinare le esecuzioni. Vengono ripristinate solo le esecuzioni eliminate non precedenti a questo timestamp.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--max-runs int
Un intero positivo opzionale che indica il numero massimo di esecuzioni da ripristinare.
esperimenti di ricerca su databricks
Cerca esperimenti che soddisfano i criteri di ricerca specificati.
databricks experiments search-experiments [flags]
Arguments
None
Options
--filter string
Stringa che rappresenta una condizione di filtro SQL
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--max-results int
Numero massimo di esperimenti desiderati.
--page-token string
Token che indica la pagina degli esperimenti da recuperare.
--view-type ViewType
Qualificatore per il tipo di esperimenti da restituire. Valori supportati: ACTIVE_ONLY, ALL, DELETED_ONLY
esperimenti di databricks - esecuzioni di ricerca
Cerca le esecuzioni di codice che soddisfano le espressioni. Le espressioni di ricerca possono usare chiavi mlflowMetric e mlflowParam.
databricks experiments search-runs [flags]
Arguments
None
Options
--filter string
Espressione di filtro su parametri, metriche e tag, che consente di restituire un subset di esecuzioni.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--max-results int
Numero massimo di esecuzioni desiderate.
--page-token string
Token per la pagina corrente di esecuzioni.
--run-view-type ViewType
Indica se visualizzare solamente le esecuzioni attive, solamente quelle eliminate, o tutte. Valori supportati: ACTIVE_ONLY, ALL, DELETED_ONLY
Esperimenti in Databricks set-experiment-tag
Imposta un tag su un esperimento. I tag dell'esperimento sono metadati che possono essere aggiornati.
databricks experiments set-experiment-tag EXPERIMENT_ID KEY VALUE [flags]
Arguments
EXPERIMENT_ID
ID dell'esperimento in cui registrare il tag. Deve essere specificato.
KEY
Nome del tag. Sono supportate chiavi con dimensioni fino a 250 byte.
VALUE
Valore stringa del tag registrato. Sono supportati valori fino a 64 KB.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
Esperimenti di Databricks set-tag
Imposta un tag durante un'esecuzione. I tag sono metadati di esecuzione che possono essere aggiornati durante un'esecuzione e dopo il completamento di un'esecuzione.
databricks experiments set-tag KEY VALUE [flags]
Arguments
KEY
Nome del tag. Sono supportate chiavi con dimensioni fino a 250 byte.
VALUE
Valore stringa del tag registrato. Sono supportati valori fino a 64 KB.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--run-id string
ID del processo sotto cui registrare il tag.
--run-uuid string
Deprecato, usare --run_id invece . ID del processo sotto cui registrare il tag.
Esperimenti Databricks update-experiment
Aggiornare un esperimento.
databricks experiments update-experiment EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
ID dell'esperimento associato.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--new-name string
Se specificato, il nome dell'esperimento viene modificato nel nuovo nome.
esperimenti di Databricks esecuzione aggiornamento
Aggiornare un'esecuzione.
databricks experiments update-run [flags]
Arguments
None
Options
--end-time int
Unix timestamp in millisecondi dell'orario in cui l'esecuzione si è conclusa.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--run-id string
ID dell'esecuzione da aggiornare.
--run-name string
Nome aggiornato dell'esecuzione.
--run-uuid string
Deprecato, usare --run_id invece . ID dell'esecuzione da aggiornare.
--status UpdateRunStatus
Stato dell'esecuzione aggiornato. Valori supportati: FAILED, FINISHED, KILLED, RUNNING, SCHEDULED
Esperimenti di Databricks ottieni-livelli-di-autorizzazione
Ottieni i livelli di autorizzazione dell'esperimento.
databricks experiments get-permission-levels EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
Esperimento per il quale ottenere o gestire le autorizzazioni.
Options
ottenere le autorizzazioni per gli esperimenti di databricks
Ottenere le autorizzazioni di un esperimento. Gli esperimenti possono ereditare le autorizzazioni dal relativo oggetto radice.
databricks experiments get-permissions EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
Esperimento per il quale ottenere o gestire le autorizzazioni.
Options
set-permissions degli esperimenti di databricks
Impostare le autorizzazioni dell'esperimento.
Imposta le autorizzazioni per un oggetto, sostituendo le autorizzazioni esistenti, se esistenti. Elimina tutte le autorizzazioni dirette se non è specificato alcuno. Gli oggetti possono ereditare le autorizzazioni dal relativo oggetto radice.
databricks experiments set-permissions EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
Esperimento per il quale ottenere o gestire le autorizzazioni.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
autorizzazioni di aggiornamento degli esperimenti di Databricks
Aggiornare le autorizzazioni dell'esperimento. Gli esperimenti possono ereditare le autorizzazioni dal relativo oggetto radice.
databricks experiments update-permissions EXPERIMENT_ID [flags]
Arguments
EXPERIMENT_ID
Esperimento per il quale ottenere o gestire le autorizzazioni.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
Bandiere globali
--debug
Indica se abilitare la registrazione di debug.
-h oppure --help
Mostra la guida per il Databricks CLI, il gruppo di comandi correlato o il comando correlato.
--log-file stringa
Stringa che rappresenta il file in cui scrivere i log di output. Se questo flag non viene specificato, l'impostazione predefinita prevede la scrittura dei log di output su stderr.
--log-format formato
Tipo di formato del log, text o json. Il valore predefinito è text.
--log-level stringa
Stringa che rappresenta il livello di formato del log. Se non specificato, il livello di formato del log è disabilitato.
tipo
Tipo di output del comando, text o json. Il valore predefinito è text.
-p, --profile stringa
Nome del profilo nel ~/.databrickscfg file da usare per eseguire il comando . Se questo flag non viene specificato, se esiste, viene usato il profilo denominato DEFAULT .
--progress-format formato
Formato per visualizzare i log di stato: default, append, inplaceo json
-t, --target stringa
Se applicabile, la destinazione del bundle da utilizzare