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.
Note
Questa API di riferimento documenta le API per il Registro modelli di area di lavoro. Databricks consiglia invece di usare modelli in Unity Catalog . I modelli in Unity Catalog offrono governance centralizzata dei modelli, accesso trasversale tra le aree di lavoro, tracciabilità e distribuzione. Il Workspace Model Registry sarà ritirato in futuro.
Il model-registry gruppo di comandi all'interno dell'interfaccia della riga di comando di Databricks consente di gestire il ciclo di vita completo dei modelli MLflow. Il Registro modelli di area di lavoro è un repository di modelli centralizzato e un'interfaccia utente e un set di API che consentono di gestire il ciclo di vita completo dei modelli MLflow.
databricks modello-registro approva-richiesta-di-transizione
Approvare una richiesta di transizione della fase della versione del modello.
databricks model-registry approve-transition-request NAME VERSION STAGE ARCHIVE_EXISTING_VERSIONS [flags]
Arguments
NAME
Nome del modello.
VERSION
Versione del modello.
STAGE
Fase obiettivo della transizione. Valori supportati: Archived, None, Production, Staging
ARCHIVE_EXISTING_VERSIONS
Specifica se archiviare tutte le versioni correnti del modello nella fase di destinazione.
Options
--comment string
Commento fornito dall'utente sull'azione.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
Comando registrazione-modello databricks: crea-commento
Pubblicare un commento su una versione del modello. Un commento può essere inviato da un utente o a livello di codice per visualizzare informazioni pertinenti sul modello. Ad esempio, i risultati dei test o gli errori di distribuzione.
databricks model-registry create-comment NAME VERSION COMMENT [flags]
Arguments
NAME
Nome del modello.
VERSION
Versione del modello.
COMMENT
Commento fornito dall'utente sull'azione.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
databricks model-registry create-model
Creare un nuovo modello registrato con il nome specificato nel corpo della richiesta.
Genera RESOURCE_ALREADY_EXISTS se esiste un modello registrato con il nome specificato.
databricks model-registry create-model NAME [flags]
Arguments
NAME
Registrare i modelli con questo nome
Options
--description string
Descrizione facoltativa per il modello registrato.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
databricks model-registry create-model-version (crea una nuova versione del modello nel sistema di registrazione di Databricks)
Creare una versione del modello.
databricks model-registry create-model-version NAME SOURCE [flags]
Arguments
NAME
Registrare il modello con questo nome
SOURCE
URI che indica la posizione degli artefatti del modello.
Options
--description string
Descrizione facoltativa per la versione del modello.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--run-id string
ID dell'esecuzione MLflow per la correlazione, se l'origine è stata generata da un esperimento eseguito nel server di tracciamento MLflow.
--run-link string
Collegamento di esecuzione di MLflow: questo è il collegamento esatto dell'esecuzione che ha generato questa versione del modello, potenzialmente ospitata in un'altra istanza di MLflow.
databricks model-registry creare-richiesta-di-transizione
Creare una richiesta di transizione della fase della versione del modello.
databricks model-registry create-transition-request NAME VERSION STAGE [flags]
Arguments
NAME
Nome del modello.
VERSION
Versione del modello.
STAGE
Fase obiettivo della transizione. I valori validi sono:
- Nessuno: fase iniziale di una versione del modello.
- Staging: fase di staging o di pre-produzione.
- Produzione: fase di produzione.
- Archiviato: Fase archiviata.
Valori supportati: [Archiviato, Nessuno, Produzione, Collaudo]
Options
--comment string
Commento fornito dall'utente sull'azione.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
databricks model-registry create-webhook
Note
Questo comando è disponibile in anteprima pubblica.
Creare un webhook del Registro di sistema.
databricks model-registry create-webhook [flags]
Arguments
None
Options
--description string
Descrizione specificata dall'utente per il webhook.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--model-name string
Nome del modello i cui eventi attiverebbero questo webhook.
--status RegistryWebhookStatus
Abilitare o disabilitare l'attivazione del webhook o inserire il webhook in modalità di test. Valori supportati: [ATTIVO (ACTIVE), DISABILITATO (DISABLED), MODALITÀ TEST (TEST_MODE)]
databricks model-registry delete-comment
Eliminare un commento di una versione del modello.
databricks model-registry delete-comment ID [flags]
Arguments
ID
Identificatore univoco del commento da eliminare.
Options
Eliminare modello del registro di databricks
Eliminare un modello registrato.
databricks model-registry delete-model NAME [flags]
Arguments
NAME
Identificatore di nome univoco del modello registrato.
Options
La cancellazione del tag del modello nel registro di Databricks
Eliminare il tag per un modello registrato.
databricks model-registry delete-model-tag NAME KEY [flags]
Arguments
NAME
Nome del modello registrato con cui è stato registrato il tag.
KEY
Nome del tag. Il nome deve essere una corrispondenza esatta; l'eliminazione con caratteri jolly non è supportata. La dimensione massima è di 250 byte.
Options
databricks registro-modelli elimina-versione-modello
Eliminare una versione del modello.
databricks model-registry delete-model-version NAME VERSION [flags]
Arguments
NAME
Nome del modello registrato
VERSION
Numero di versione del modello
Options
databricks repository-modelli elimina-tag-versione-modello
Eliminare un tag di versione del modello.
databricks model-registry delete-model-version-tag NAME VERSION KEY [flags]
Arguments
NAME
Nome del modello registrato con cui è stato registrato il tag.
VERSION
Numero di versione del modello con cui è stato registrato il tag.
KEY
Nome del tag. Il nome deve essere una corrispondenza esatta; l'eliminazione con caratteri jolly non è supportata. La dimensione massima è di 250 byte.
Options
databricks registrazione modello elimina richiesta di transizione
Annullare una richiesta di transizione della fase della versione del modello.
databricks model-registry delete-transition-request NAME VERSION STAGE CREATOR [flags]
Arguments
NAME
Nome del modello.
VERSION
Versione del modello.
STAGE
Fase di destinazione della richiesta di transizione. I valori validi sono:
- Nessuno: fase iniziale di una versione del modello.
- Staging: fase di staging o di pre-produzione.
- Produzione: fase di produzione.
- Archiviato: Fase archiviata.
Valori supportati: [Archiviato, Nessuno, Produzione, Collaudo]
CREATOR
Nome utente dell'utente che ha creato questa richiesta. Delle richieste di transizione corrispondenti ai dettagli specificati, verrà eliminata solo una transizione creata dall'utente.
Options
--comment string
Commento fornito dall'utente sull'azione.
databricks model-registry delete-webhook
Note
Questo comando è disponibile in anteprima pubblica.
Elimina un webhook del Registro di sistema.
databricks model-registry delete-webhook [flags]
Arguments
None
Options
--id string
ID webhook necessario per eliminare un webhook del registro.
databricks model-registry get-latest-versions
Ottenere la versione più recente di un modello registrato.
databricks model-registry get-latest-versions NAME [flags]
Arguments
NAME
Identificatore di nome univoco del modello registrato.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
databricks model-registry ottieni-modello
Ottenere i dettagli di un modello. Si tratta di una versione dell'area di lavoro databricks dell'endpoint MLflow che restituisce anche l'ID dell'area di lavoro Databricks del modello e il livello di autorizzazione dell'utente richiedente nel modello.
databricks model-registry get-model NAME [flags]
Arguments
NAME
Identificatore di nome univoco del modello registrato.
Options
databricks model-registry ottieni-versione-modello
Ottieni una versione modello.
databricks model-registry get-model-version NAME VERSION [flags]
Arguments
NAME
Nome del modello registrato
VERSION
Numero di versione del modello
Options
databricks model-registry ottieni-uri-di-download-versione-modello
Ottenere un URI per scaricare la versione del modello.
databricks model-registry get-model-version-download-uri NAME VERSION [flags]
Arguments
NAME
Nome del modello registrato
VERSION
Numero di versione del modello
Options
elenco-modelli in databricks model-registry
Elencare tutti i modelli registrati disponibili, fino al limite specificato in max_results.
databricks model-registry list-models [flags]
Arguments
None
Options
--max-results int
Numero massimo di modelli registrati desiderati.
--page-token string
Token di paginazione per passare alla pagina successiva in base a una query precedente.
databricks model-registry list-transition-requests
Ottieni un elenco di tutte le richieste di transizione delle fasi aperte per la versione del modello.
databricks model-registry list-transition-requests NAME VERSION [flags]
Arguments
NAME
Nome del modello.
VERSION
Versione del modello.
Options
databricks model-registry list-webhooks
Note
Questo comando è disponibile in anteprima pubblica.
Elenca tutti i webhook del registro.
databricks model-registry list-webhooks [flags]
Arguments
None
Options
--model-name string
Se non specificato, vengono elencati tutti i webhook associati agli eventi specificati, indipendentemente dal modello associato.
--page-token string
Token che indica la pagina dei risultati dell'artefatto da recuperare.
Registro modelli databricks richiesta-rifiuto-transizione
Rifiutare una richiesta di transizione della fase della versione del modello.
databricks model-registry reject-transition-request NAME VERSION STAGE [flags]
Arguments
NAME
Nome del modello.
VERSION
Versione del modello.
STAGE
Fase obiettivo della transizione. I valori validi sono:
- Nessuno: fase iniziale di una versione del modello.
- Staging: fase di staging o di pre-produzione.
- Produzione: fase di produzione.
- Archiviato: Fase archiviata.
Valori supportati: [Archiviato, Nessuno, Produzione, Collaudo]
Options
--comment string
Commento fornito dall'utente sull'azione.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
databricks registro-modello rinomina-modello
Rinominare un modello registrato.
databricks model-registry rename-model NAME [flags]
Arguments
NAME
Identificatore di nome univoco del modello registrato.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--new-name string
Se specificato, aggiorna il nome per questo registered_model.
No improvement necessary; the translation aligns with domain-specific usage conventions in Italian technical contexts.
Cercare versioni specifiche del modello in base al filtro fornito.
databricks model-registry search-model-versions [flags]
Arguments
None
Options
--filter string
Condizione di filtro stringa, ad esempio "name='my-model-name'".
--max-results int
Numero massimo di modelli desiderati.
--page-token string
Token di paginazione per passare alla pagina successiva in base alla query di ricerca precedente.
databricks modello-registro cerca-modelli
Cercare i modelli registrati in base al filtro specificato.
databricks model-registry search-models [flags]
Arguments
None
Options
--filter string
Condizione di filtro stringa, ad esempio "name LIKE 'my-model-name'".
--max-results int
Numero massimo di modelli desiderati.
--page-token string
Token di paginazione per accedere alla pagina successiva in base a una query di ricerca precedente.
databricks model-registry imposta-etichetta-modello
Impostare un tag su un modello registrato.
databricks model-registry set-model-tag NAME KEY VALUE [flags]
Arguments
NAME
Nome univoco del modello.
KEY
Nome del tag. La dimensione massima dipende dal back-end di archiviazione. Se esiste già un tag con questo nome, il relativo valore preesistente verrà sostituito dal valore specificato. Tutti i back-end di archiviazione sono garantiti per supportare i valori delle chiavi fino a 250 byte.
VALUE
Valore stringa del tag registrato. La dimensione massima dipende dal back-end di archiviazione. Tutti i back-end di archiviazione sono garantiti per supportare valori chiave fino a 5000 byte di dimensioni.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
Utilizzo del comando 'databricks model-registry set-model-version-tag'
Impostare un tag di versione del modello.
databricks model-registry set-model-version-tag NAME VERSION KEY VALUE [flags]
Arguments
NAME
Nome univoco del modello.
VERSION
Numero di versione del modello.
KEY
Nome del tag. La dimensione massima dipende dal back-end di archiviazione. Se esiste già un tag con questo nome, il relativo valore preesistente verrà sostituito dal valore specificato. Tutti i back-end di archiviazione sono garantiti per supportare i valori delle chiavi fino a 250 byte.
VALUE
Valore stringa del tag registrato. La dimensione massima dipende dal back-end di archiviazione. Tutti i back-end di archiviazione sono garantiti per supportare valori chiave fino a 5000 byte di dimensioni.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
databricks model-registry test-registry-webhook
Note
Questo comando è disponibile in anteprima pubblica.
Testare un webhook del Registro di sistema.
databricks model-registry test-registry-webhook ID [flags]
Arguments
ID
Webhook ID
Options
--event RegistryWebhookEvent
Se viene specificato l'evento, il trigger di test usa l'evento specificato. Valori supportati: [ COMMENT_CREATED, MODEL_VERSION_CREATED, MODEL_VERSION_TAG_SET, MODEL_VERSION_TRANSITIONED_STAGE, MODEL_VERSION_TRANSITIONED_TO_ARCHIVED, MODEL_VERSION_TRANSITIONED_TO_PRODUCTION, MODEL_VERSION_TRANSITIONED_TO_STAGING, REGISTERED_MODEL_CREATED, TRANSITION_REQUEST_CREATED, TRANSITION_REQUEST_TO_ARCHIVED_CREATED, TRANSITION_REQUEST_TO_PRODUCTION_CREATED, TRANSITION_REQUEST_TO_STAGING_CREATED ]
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
databricks model-registry fase di transizione
Transizione della fase di una versione del modello. Si tratta di una versione dell'area di lavoro databricks dell'endpoint MLflow che accetta anche un commento associato alla transizione da registrare.
databricks model-registry transition-stage NAME VERSION STAGE ARCHIVE_EXISTING_VERSIONS [flags]
Arguments
NAME
Nome del modello.
VERSION
Versione del modello.
STAGE
Fase obiettivo della transizione. I valori validi sono:
- Nessuno: fase iniziale di una versione del modello.
- Staging: fase di staging o di pre-produzione.
- Produzione: fase di produzione.
- Archiviato: Fase archiviata.
Valori supportati: [Archiviato, Nessuno, Produzione, Collaudo]
ARCHIVE_EXISTING_VERSIONS
Specifica se archiviare tutte le versioni correnti del modello nella fase di destinazione.
Options
--comment string
Commento fornito dall'utente sull'azione.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
databricks registro-modelli aggiorna-commento
Pubblicare una modifica in un commento su una versione del modello.
databricks model-registry update-comment ID COMMENT [flags]
Arguments
ID
Identificatore univoco di un'attività
COMMENT
Commento fornito dall'utente sull'azione.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
databricks model-registry aggiorna-modello
Aggiornare un modello registrato.
databricks model-registry update-model NAME [flags]
Arguments
NAME
Identificatore di nome univoco del modello registrato.
Options
--description string
Se specificato, aggiorna la descrizione per questo registered_model.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
databricks model-registry aggiorna-versione-modello
Aggiornare la versione del modello.
databricks model-registry update-model-version NAME VERSION [flags]
Arguments
NAME
Nome del modello registrato
VERSION
Numero di versione del modello
Options
--description string
Se specificato, aggiorna la descrizione per questo registered_model.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
databricks model-registry update-webhook
Note
Questo comando è disponibile in anteprima pubblica.
Aggiornare un webhook del Registro di sistema.
databricks model-registry update-webhook ID [flags]
Arguments
ID
Webhook ID
Options
--description string
Descrizione specificata dall'utente per il webhook.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--status RegistryWebhookStatus
Abilitare o disabilitare l'attivazione del webhook o inserire il webhook in modalità di test. Valori supportati: [ATTIVO (ACTIVE), DISABILITATO (DISABLED), MODALITÀ TEST (TEST_MODE)]
databricks model-registry get-permission-levels (Ottieni i livelli di autorizzazione)
Ottieni i livelli di autorizzazione del modello registrato.
databricks model-registry get-permission-levels REGISTERED_MODEL_ID [flags]
Arguments
REGISTERED_MODEL_ID
Modello registrato per il quale ottenere o gestire le autorizzazioni.
Options
databricks model-registry ottieni-permessi
Ottiene le autorizzazioni di un modello registrato. I modelli registrati possono ereditare le autorizzazioni dal relativo oggetto radice.
databricks model-registry get-permissions REGISTERED_MODEL_ID [flags]
Arguments
REGISTERED_MODEL_ID
Modello registrato per il quale ottenere o gestire le autorizzazioni.
Options
databricks registro modelli imposta permessi
Impostare le autorizzazioni del modello registrato, sostituendo le autorizzazioni esistenti, se presenti. Elimina tutte le autorizzazioni dirette se non è specificato alcuno. Gli oggetti possono ereditare le autorizzazioni dal relativo oggetto radice.
databricks model-registry set-permissions REGISTERED_MODEL_ID [flags]
Arguments
REGISTERED_MODEL_ID
Modello registrato per il quale ottenere o gestire le autorizzazioni.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
comando databricks model-registry update-permissions
Aggiornare le autorizzazioni per un modello registrato. I modelli registrati possono ereditare le autorizzazioni dal relativo oggetto radice.
databricks model-registry update-permissions REGISTERED_MODEL_ID [flags]
Arguments
REGISTERED_MODEL_ID
Modello registrato 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