Comandi dell'interfaccia della riga di comando di Databricks

Nota

Queste informazioni si applicano alle versioni dell'interfaccia della riga di comando di Databricks 0.205 e successive, disponibili in anteprima pubblica. Per trovare la versione dell'interfaccia della riga di comando di Databricks, eseguire databricks -v.

Questo articolo fornisce informazioni sui comandi dell'interfaccia della riga di comando di Databricks disponibili. Queste informazioni integrano la Guida della riga di comando. Per altre informazioni sull'installazione e l'uso dell'interfaccia della riga di comando di Databricks, vedere Installare o aggiornare l'interfaccia della riga di comando di Databricks e Informazioni sull'interfaccia della riga di comando di Databricks.

L'interfaccia della riga di comando di Databricks include i gruppi di comandi elencati nelle tabelle seguenti. I gruppi di comandi contengono set di comandi correlati, che possono contenere anche sottocomandi. Per restituire informazioni sull'utilizzo e sulla sintassi per un gruppo di comandi, un singolo comando o un sottocomando:

• databricks <command-group> -h
• databricks <command-group> <command-name> -h
• databricks <command-group> <command-name> <subcommand-name> -h

Molti comandi dell'interfaccia della riga di comando eseguono il mapping alle operazioni documentate nelle informazioni di riferimento sull'API REST di Azure Databricks.

Comandi dell'area di lavoro

Raggruppa	Descrizione e comandi
Fs	Comandi per la gestione dei file e del file system: cat, cp, ls, mkdirrm
git-credentials	Comandi per la registrazione di token di accesso personali per Databricks per eseguire operazioni per conto dell'utente: create, delete, get, listupdate
repos	Comandi per consentire agli utenti di gestire i repository Git: create, delete, get, listupdate get-permission-levels, get-permissions, set-permissionsupdate-permissions
secrets	Comandi per la gestione di segreti, ambiti segreti e autorizzazioni di accesso: create-scope, delete-acl, , delete-secret, get-aclget-secret, list-scopeslist-aclslist-secrets, put-acldelete-scopeput-secret
workspace	Comandi per elencare, importare, esportare ed eliminare notebook e cartelle nell'area di lavoro: delete, export, export-dir, get-statusimport, import-dir, , listmkdirs get-permission-levels, get-permissions, set-permissionsupdate-permissions

Comandi di calcolo

Raggruppa	Descrizione e comandi
cluster-policies	Comandi per controllare la capacità degli utenti di configurare i cluster in base a un set di regole: create, delete, edit, getlist get-permission-levels, get-permissions, set-permissionsupdate-permissions
clusters	Comandi che consentono di creare, avviare, modificare, elencare, terminare ed eliminare cluster: change-owner, create, , edit, listpinresizepermanent-deletestartgetspark-versionslist-node-typesrestartlist-zoneseventsdeleteunpin get-permission-levels, get-permissions, set-permissionsupdate-permissions
global-init-scripts	Comandi che consentono agli amministratori dell'area di lavoro di configurare gli script di inizializzazione globali per l'area di lavoro: create, delete, get, listupdate
instance-pools	Comandi per creare, modificare, eliminare ed elencare i pool di istanze usando istanze cloud pronte per l'uso, riducendo i tempi di avvio e ridimensionamento automatico di un cluster: create, delete, edit, getlist get-permission-levels, get-permissions, set-permissionsupdate-permissions
instance-profiles	Comandi per consentire agli amministratori di aggiungere, elencare e rimuovere profili di istanza con cui gli utenti possono avviare cluster con: add, edit, listremove
libraries	Comandi per installare, disinstallare e ottenere lo stato delle librerie in un cluster: all-cluster-statuses, cluster-status, installuninstall
policy-families	Comandi per visualizzare le famiglie di criteri disponibili: get, list

Comandi dei flussi di lavoro

Raggruppa	Descrizione e comandi
jobs	Comandi per gestire i processi: cancel-all-runs, , , , , submitget-run-outputget-runrepair-runresetlist-runslistrun-nowgetexport-rundelete-rundeletecancel-runcreateupdate get-permission-levels, get-permissions, set-permissionsupdate-permissions

Comandi di Tabelle live delta

Raggruppa	Descrizione e comandi
pipelines	Comandi per creare, modificare, eliminare, avviare e visualizzare i dettagli sulle pipeline: createget, delete, , get-update, list-pipeline-eventslist-pipelines, list-updates, start-update, , stopupdate get-permission-levels, get-permissions, set-permissionsupdate-permissions

Comandi di Machine Learning

Raggruppa	Descrizione e comandi
experiments	Comandi per interagire con esperimenti, che sono l'unità principale dell'organizzazione in MLflow; tutte le esecuzioni MLflow appartengono a un esperimento: create-experiment, create-run, delete-run, , search-runslog-batchlog-inputslist-experimentslist-artifactsget-runGetlog-metriclog-modelrestore-runrestore-experimentrestore-runslog-paramsearch-experimentsget-historyupdate-experimentdelete-tagset-tagget-by-nameset-experiment-tagget-experimentdelete-runsdelete-experimentupdate-run get-permission-levels, get-permissions, set-permissionsupdate-permissions
model-registry	Comandi per il Registro modelli di area di lavoro: approve-transition-request, create-comment, create-model-version, create-transition-request, delete-commentcreate-webhookdelete-model-tagget-model-version-download-uriget-model-versionget-latest-versionsdelete-webhookdelete-model-version-tagget-modeldelete-transition-requestdelete-modeldelete-model-versionlist-models, , update-model-versionset-model-version-tagtest-registry-webhookset-model-tagtransition-stageupdate-commentlist-transition-requestsreject-transition-requestupdate-modellist-webhooksrename-modelsearch-model-versionssearch-modelscreate-modelupdate-webhook get-permission-levels, get-permissions, set-permissionsupdate-permissions

Comandi di gestione in tempo reale

Raggruppa	Descrizione e comandi
serving-endpoints	Comandi per creare, aggiornare ed eliminare gli endpoint di gestione del modello: build-logs, create, , export-metrics, getlist, patchlogsput, querydeleteupdate-config get-permission-levels, get-permissions, set-permissionsupdate-permissions

Comandi di gestione delle identità e degli accessi

Raggruppa	Descrizione e comandi
account	Comandi per la gestione degli account Databricks: * Identità e accesso: access-control, groups, service-principals, users, workspace-assignment * Catalogo unity: metastore-assignments, metastores, storage-credentials * Impostazioni: ip-access-lists, network-connectivity, settings * Provisioning: credentials, encryption-keys, networks, private-accessstorage, , vpc-endpointsworkspaces * Fatturazione: billable-usage, log-delivery * OAuth: custom-app-integration, o-auth-published-apps, published-app-integration, service-principal-secrets
aut	Comandi per l'autenticazione: describe, env, login, profilestoken
current-user	Comandi per recuperare informazioni sull'utente o l'entità servizio attualmente autenticati: me
groups	Comandi per i gruppi che semplificano la gestione delle identità, semplificando l'assegnazione dell'accesso all'area di lavoro, ai dati e ad altri oggetti a protezione diretta di Databricks: create, delete, get, list, patchupdate
permissions	Comandi per creare l'accesso in lettura, scrittura, modifica, aggiornamento e gestione per vari utenti su oggetti ed endpoint diversi: get, set, update get-permission-levels
service-principals	Comandi per le identità da usare con processi, strumenti automatizzati e sistemi come script, app e piattaforme CI/CD: create, delete, get, list, patchupdate
users	Comandi per le identità utente riconosciute da Databricks e rappresentate dagli indirizzi di posta elettronica: create, delete, get, list, patchupdate get-permission-levels, get-permissions, set-permissionsupdate-permissions

Comandi correlati a SQL

Raggruppa	Descrizione e comandi
alerts	Comandi per eseguire operazioni sugli avvisi: create, delete, get, listupdate
data-sources	Comandi per creare nuovi oggetti query: list
queries	Comandi per eseguire operazioni sulle definizioni di query: create, delete, get, list, restoreupdate
query-history	Comandi per accedere alla cronologia delle query tramite sql warehouse: list
warehouses	Comandi per gestire sql warehouse, ovvero una risorsa di calcolo che consente di eseguire comandi SQL sugli oggetti dati all'interno di Databricks SQL: create, delete, edit, get, get-workspace-warehouse-configlist, set-workspace-warehouse-config, , startstop get-permission-levels, get-permissions, set-permissionsupdate-permissions

Comandi del catalogo Unity

Raggruppa	Descrizione e comandi
artifact-allowlists	Comandi per gestire gli elenchi di elementi consentiti. In Databricks Runtime 13.3 e versioni successive è possibile aggiungere librerie e script init all'elenco elementi consentiti in UC in modo che gli utenti possano sfruttare questi artefatti nel calcolo configurato con la modalità di accesso condiviso: get, update
catalogs	Comandi per gestire i cataloghi, il primo livello dello spazio dei nomi a tre livelli di Unity Catalog: create, delete, get, listupdate
connections	Comandi per creare una connessione a un'origine dati esterna: create, delete, get, listupdate
external-locations	Comandi per gestire le posizioni esterne, che combinano un percorso di archiviazione cloud con credenziali di archiviazione che autorizzano l'accesso al percorso di archiviazione cloud: create, delete, get, listupdate
functions	Comandi per gestire funzioni definite dall'utente (UDF) nel catalogo unity: create, delete, get, listupdate
grants	Comandi per concedere l'accesso ai dati nel catalogo unity: get, get-effective, update
metastores	Comandi per gestire i metastore, ovvero il contenitore di primo livello degli oggetti in Unity Catalog: assigncurrent, create, , delete, getlist, summary, unassign, , updateupdate-assignment
model-versions	Comandi per gestire le versioni del modello. Databricks offre una versione ospitata di MLflow Model Registry nel catalogo unity. delete, get, get-by-alias, listupdate
online-tables	Comandi per gestire le tabelle online, che offrono una latenza inferiore e un accesso QPS superiore ai dati dalle tabelle Delta: create, delete, get
quality-monitors	Comandi per gestire i monitoraggi, che calcolano e monitorano le metriche di qualità dei dati o del modello per una tabella nel tempo: create, delete, get, get-refreshlist-refreshes, , run-refreshupdate
registered-models	Comandi per gestire i modelli registrati. Databricks offre una versione ospitata di MLflow Model Registry nel catalogo unity. create, delete, delete-alias, getlist, , set-aliasupdate
schemas	Comandi per gestire gli schemi, ovvero il secondo livello dello spazio dei nomi a tre livelli di Unity Catalog: create, delete, get, listupdate
storage-credentials	Comandi per gestire le credenziali di archiviazione, che sono un meccanismo di autenticazione e autorizzazione per l'accesso ai dati archiviati nel tenant cloud: create, delete, get, list, updatevalidate
system-schemas	Comandi per gestire gli schemi di sistema, ovvero schemi che si trovano all'interno del catalogo di sistema: disable, enable, list
table-constraints	Comandi per gestire i vincoli di chiave primaria e di chiave esterna che codificano le relazioni tra i campi nelle tabelle: create, delete
tables	Comandi per gestire le tabelle, che si trovano nel terzo livello dello spazio dei nomi a tre livelli di Unity Catalog: delete, exists, get, listlist-summaries
volumes	Comandi per gestire i volumi, ovvero una funzionalità del catalogo Unity per l'accesso, l'archiviazione, la governance, l'organizzazione e l'elaborazione dei file: create, delete, list, readupdate
workspace-bindings	Comandi per gestire le associazioni di aree di lavoro a protezione diretta. Le entità a protezione diretta in Databricks possono essere configurate come OPEN o ISOLATED. get, get-bindings, updateupdate-bindings

Comandi di condivisione differenziale

Raggruppa	Descrizione e comandi
providers	Comandi per gestire i provider di dati, che rappresentano le organizzazioni che condividono i dati: create, delete, get, list, list-sharesupdate
recipient-activation	Comandi per gestire l'attivazione del destinatario, applicabile solo nel modello di condivisione aperta in cui l'oggetto destinatario ha il tipo di autenticazione TOKEN: get-activation-url-info, retrieve-token
recipients	Comandi per gestire i destinatari, creati con :method:recipients/create per rappresentare un'organizzazione che si vuole consentire l'accesso alle condivisioni: create, delete, get, list, rotate-tokenupdate share-permissions
shares	Comandi per gestire le condivisioni, che sono contenitori di cui è stata creata un'istanza con :method:shares/create: create, delete, get, listupdate share-permissions, update-permissions

Comandi delle impostazioni

Raggruppa	Descrizione e comandi
ip-access-lists	Comandi per consentire agli amministratori di configurare gli elenchi di accesso IP: create, delete, get, list, replaceupdate
settings	Comandi per consentire agli utenti di gestire le impostazioni a livello di area di lavoro: automatic-cluster-update, csp-enablement, default-namespace, esm-enablementrestrict-workspace-admins
token-management	Comandi che consentono agli amministratori di ottenere tutti i token ed eliminare i token per altri utenti: create-obo-token, delete, getlist get-permission-levels, get-permissions, set-permissionsupdate-permissions
tokens	Comandi per creare, elencare e revocare i token che possono essere usati per autenticare e accedere alle API REST di Databricks: create, delete, list
workspace-conf	Comandi per aggiornare le impostazioni dell'area di lavoro: get-status, set-status

comandi Strumenti di sviluppo

Raggruppa	Descrizione e comandi
fascio	Comandi per gestire i bundle di asset di Databricks, che consentono di esprimere i progetti di Databricks come codice: deploy, deployment, destroy, generate, initrun, schema, , syncvalidate
sync	Sincronizzare una directory locale in una directory dell'area di lavoro.

Comandi di ricerca vettoriali

Raggruppa	Descrizione e comandi
vector-search-endpoints	Comandi per gestire gli endpoint di ricerca vettoriali, che rappresentano le risorse di calcolo per gli indici di ricerca vettoriali host: create-endpoint, delete-endpoint, get-endpointlist-endpoints
vector-search-indexes	Comandi per gestire gli indici di ricerca vettoriali, una rappresentazione efficiente dei vettori di incorporamento che supporta query di ricerca approssimate approssimative approssimative (ANN) in tempo reale ed efficienti: create-index, delete-data-vector-index, delete-index, get-indexlist-indexes, query-index, , sync-indexupsert-data-vector-index

Comandi del dashboard

Raggruppa	Descrizione e comandi
dashboards	Comandi per la modifica dei dashboard: create, delete, get, list, restoreupdate
lakeview	Comandi che forniscono operazioni di gestione specifiche per i dashboard di intelligenza artificiale/BI: create, get, get-published, migratepublish, trash, , unpublishupdate

Comandi aggiuntivi

Raggruppa	Descrizione e comandi
api	Comandi per effettuare richieste all'API REST di Databricks: delete, get, head, patch, postput
completion	Comandi per generare lo script di completamento automatico per la shell specificata: bash, fish, powershellzsh
configure	Configurare l'interfaccia della riga di comando di Databricks.
help	Restituisce informazioni sull'utilizzo per qualsiasi comando.
labs	Comandi per gestire le installazioni di Databricks Labs: clear-cache, install, installed, listshow, , uninstallupgrade
version	Recuperare la versione dell'interfaccia della riga di comando attualmente in uso.

Flag globali

I flag seguenti sono disponibili per tutti i comandi dell'interfaccia della riga di comando di Databricks. Si noti che alcuni flag non si applicano ad alcuni comandi. Per informazioni dettagliate su comandi specifici e sui relativi flag, vedere la Guida della riga di comando.

Flag	Descrizione
-h oppure --help	Visualizzare la Guida per l'interfaccia della riga di comando di Databricks o il gruppo di comandi correlato o il comando correlato.
-e oppure --environment string	Stringa che rappresenta l'ambiente bundle da usare se applicabile per il comando correlato.
--log-file	Stringa che rappresenta l'oggetto in cui scrivere i log di output. Se questo flag non viene specificato, il valore predefinito consiste nel scrivere i log di output in stderr.
--log-format	text per scrivere i log di output in testo o json per scrivere i log di output in JSON. Se questo flag non viene specificato, i log di output vengono scritti come testo.
--log-level	Stringa che rappresenta il livello di formato del log. Se non specificato, il livello di formato del log è disabilitato.
-o oppure --output	text per scrivere l'output come testo o json scrivere l'output come JSON. Se questo flag non viene specificato, l'output viene scritto come testo.
-p oppure --profile	Stringa che rappresenta il profilo di configurazione denominato da usare all'interno del .databrickscfg file. Se questo flag non viene specificato, il DEFAULT profilo denominato viene usato se ne esiste uno. È possibile premere Tab dopo --profile o -p per visualizzare un elenco di profili di configurazione disponibili esistenti tra cui scegliere anziché immettere manualmente il nome del profilo di configurazione.
--progress-format	Formato per i log di stato da visualizzare (default (impostazione predefinita) o append o inplace json.