Databricks CLI-Befehle

Hinweis

Diese Informationen gelten für Databricks CLI-Versionen 0.205 und höher. Die Databricks CLI befindet sich in der öffentlichen Vorschau.

Die Verwendung von Databricks CLI unterliegt der Datenbricks-Lizenz - und Databricks-Datenschutzerklärung, einschließlich der Bestimmungen zu Nutzungsdaten.

Dieser Artikel enthält Informationen zu verfügbaren Databricks CLI-Befehlen. Diese Informationen ergänzen die Befehlszeilenhilfe. Weitere Informationen zum Installieren und Verwenden der Databricks CLI finden Sie unter Installieren oder Aktualisieren der Databricks CLI und Was ist die Databricks CLI?.

Die Databricks CLI enthält die in den folgenden Tabellen aufgeführten Befehlsgruppen. Befehlsgruppen enthalten zusammengehörige Befehle, die auch Unterbefehle enthalten können. So geben Sie Verwendungs- und Syntaxinformationen für eine Befehlsgruppe, einen einzelnen Befehl oder einen Unterbefehl aus:

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

Viele CLI-Befehle sind Vorgängen zugeordnet, die in der REST-API-Referenz für Azure Databricks dokumentiert sind.

Arbeitsbereichsbefehle

Group	Beschreibung und Befehle
fs	Befehle zum Verwalten von Dateien und Dateisystem: cat, , cpls, , mkdirrm
git-credentials	Befehle zum Registrieren von persönlichen Zugriffstoken für Databricks zum Ausführen von Vorgängen im Namen des Benutzers: create, , deleteget, , listupdate
repos	Befehle, mit denen Benutzer ihre Git-Repositorys verwalten können: create, , deleteget, , listupdate get-permission-levels, , get-permissionsset-permissionsupdate-permissions
secrets	Befehle zum Verwalten von Geheimnissen, Geheimnisbereichen und Zugriffsberechtigungen: create-scope, delete-acl, delete-scopeget-secretget-acldelete-secret, list-acls, , list-scopes, , , put-acllist-secretsput-secret
workspace	Befehle zum Auflisten, Importieren, Exportieren und Löschen von Notebooks und Ordnern im Arbeitsbereich: delete, , exportexport-dir, get-status, import, import-dir, , listmkdirs get-permission-levels, , get-permissionsset-permissionsupdate-permissions

Computebefehle

Group	Beschreibung und Befehle
cluster-policies	Befehle zum Steuern der Berechtigungen von Benutzern, Cluster basierend auf einer Reihe von Regeln zu konfigurieren: create, , deleteedit, , getlist get-permission-levels, , get-permissionsset-permissionsupdate-permissions
clusters	Befehle, mit denen Sie Cluster erstellen, starten, bearbeiten, auflisten, beenden und löschen können: change-owner, create, , delete, edit, events, listget, , list-node-types, ,pinlist-zonespermanent-deleteresizerestartspark-versionsstartunpin get-permission-levels, , get-permissionsset-permissionsupdate-permissions
global-init-scripts	Befehle, mit denen Arbeitsbereichsadministratoren globale Initialisierungsskripts für ihren Arbeitsbereich konfigurieren können: create, , deleteget, , listupdate
instance-pools	Befehle zum Erstellen, Bearbeiten, Löschen und Auflisten von Instanzpools mit einsatzbereiten Cloudinstanzen, wodurch die Start und automatische Skalierung für Cluster beschleunigt werden: create, , deleteedit, , getlist get-permission-levels, , get-permissionsset-permissionsupdate-permissions
instance-profiles	Befehle, mit denen Administratoren Instanzprofile hinzufügen, auflisten und entfernen können, durch die Benutzer Cluster starten können: add, , editlistremove
libraries	Befehle zum Installieren, Deinstallieren und Abrufen des Status von Bibliotheken in einem Cluster: all-cluster-statuses, , cluster-statusinstalluninstall
policy-families	Befehle zum Anzeigen verfügbarer Richtlinienfamilien: get, list

Auftragsbefehle

Group	Beschreibung und Befehle
jobs	Befehle zum Verwalten von Aufträgen: cancel-all-runs, cancel-run, create, get-run-outputlist-runsrun-nowlistresetget-runrepair-runsubmitdeletedelete-runexport-rungetupdate get-permission-levels, , get-permissionsset-permissionsupdate-permissions

Delta Live Tables-Befehle

Group	Beschreibung und Befehle
pipelines	Befehle zum Erstellen, Bearbeiten, Löschen, Starten und Anzeigen von Details zu Pipelines: create, delete, , get-updateget, list-pipeline-events, list-pipelines, list-updates, , , start-update, , stopupdate get-permission-levels, , get-permissionsset-permissionsupdate-permissions

Machine-Learning-Befehle

Group	Beschreibung und Befehle
experiments	Befehle für die Interaktion mit Experimenten, die die primäre Organisationseinheit in MLflow sind. Alle MLflow-Ausführungen gehören zu einem Experiment: create-experiment, create-run, , delete-experiment, delete-runsget-experimentget-by-namedelete-rundelete-tag, log-inputsget-runGetlog-batchlist-experimentslog-metriclog-paramget-historylist-artifactslog-model, , update-experimentrestore-experimentrestore-runrestore-runssearch-experimentssearch-runsset-experiment-tagset-tagupdate-run get-permission-levels, , get-permissionsset-permissionsupdate-permissions
model-registry	Befehle für die Arbeitsbereichsmodellregistrierung: approve-transition-request, create-comment, , create-model, create-transition-requestdelete-modeldelete-commentcreate-webhookcreate-model-version,get-latest-versionsdelete-transition-requestdelete-model-version-tagdelete-model-tagget-modeldelete-model-versiondelete-webhookget-model-version, list-models, , test-registry-webhookset-model-version-tagtransition-stageset-model-tagupdate-commentupdate-modellist-transition-requestsreject-transition-requestupdate-model-versionlist-webhooksrename-modelsearch-model-versionssearch-modelsget-model-version-download-uriupdate-webhook get-permission-levels, , get-permissionsset-permissionsupdate-permissions

Echtzeitbereitstellungsbefehle

Group	Beschreibung und Befehle
serving-endpoints	Befehle zum Erstellen, Aktualisieren und Löschen von Endpunkten des Modells: build-logs, create, deletelistgetexport-metrics, logs, , patch, , , queryputupdate-config get-permission-levels, , get-permissionsset-permissionsupdate-permissions

Identitäts- und Zugriffsverwaltungsbefehle

Group	Beschreibung und Befehle
account	Befehle zum Verwalten von Databricks-Konten: – Identität und Zugriff: access-control, groups, service-principals, users, workspace-assignment – Unity Catalog: metastore-assignments, metastores, storage-credentials – Einstellungen: ip-access-lists, network-connectivity, settings – Bereitstellung: credentials, encryption-keys, networks, private-access, storage, vpc-endpoints, workspaces – Abrechnung: billable-usage, log-delivery – OAuth: custom-app-integration, o-auth-published-apps, published-app-integration, service-principal-secrets
auth	Befehle für die Authentifizierung: describe, , envlogin, , profilestoken
current-user	Befehle zum Abrufen von Informationen zu aktuell authentifizierten Benutzern oder Dienstprinzipalen: me
groups	Befehle für Gruppen, die die Identitätsverwaltung vereinfachen und das Zuweisen des Zugriffs auf Databricks-Arbeitsbereiche, -Daten und andere sicherungsfähige Objekte erleichtern: create, , deleteget, list, , patchupdate
permissions	Befehle zum Erstellen von Lese-, Schreib-, Bearbeitungs-, Aktualisierungs- und Verwaltungszugriff für verschiedene Benutzer auf verschiedenen Objekte und Endpunkte: get, setupdate get-permission-levels
service-principals	Befehle für Identitäten für die Verwendung mit Aufträgen, automatisierten Tools und Systemen wie Skripts, Apps und CI/CD-Plattformen: create, , deleteget, list, , patchupdate
users	Befehle für Benutzeridentitäten, die von Databricks erkannt und durch E-Mail-Adressen dargestellt werden: create, , deleteget, list, , patchupdate get-permission-levels, , get-permissionsset-permissionsupdate-permissions

SQL-bezogene Befehle

Group	Beschreibung und Befehle
alerts	Befehle zum Ausführen von Vorgängen für Warnungen: create, , deleteget, , listupdate
data-sources	Befehle zum Erstellen neuer Abfrageobjekte: list
queries	Befehle zum Ausführen von Vorgängen für Abfragedefinitionen: create, , deleteget, list, , restoreupdate
query-history	Befehle für den Zugriff auf den Verlauf der Abfragen über SQL-Warehouses: list
warehouses	Befehle zum Verwalten von SQL-Warehouses, bei denen es sich um eine Computeressource handelt, mit der Sie SQL-Befehle für Datenobjekte in Databricks SQL ausführen können: create, delete, , getedit, get-workspace-warehouse-config, list, set-workspace-warehouse-config, , startstop get-permission-levels, , get-permissionsset-permissionsupdate-permissions

Unity Catalog-Befehle

Group	Beschreibung und Befehle
artifact-allowlists	Befehle zum Verwalten von Positivlisten für Artefakte. In Databricks Runtime 13.3 und höher können Sie Bibliotheken und Initialisierungsskripts zur Positivliste in UC hinzufügen, damit Benutzer diese Artefakte für Computevorgänge nutzen können, bei denen der Modus für gemeinsamen Zugriff konfiguriert ist: get, update
catalogs	Befehle zum Verwalten von Katalogen, der ersten Schicht des dreischichtigen Namespaces von Unity Catalog: create, , deleteget, , listupdate
connections	Befehle zum Herstellen einer Verbindung mit einer externen Datenquelle: create, , deleteget, , listupdate
external-locations	Befehle zum Verwalten externer Speicherorte, die einen Cloudspeicherpfad mit Speicheranmeldeinformationen kombinieren, die den Zugriff auf den Cloudspeicherpfad autorisieren: create, , deleteget, , listupdate
functions	Befehle zum Verwalten von benutzerdefinierten Funktionen (User-Defined Functions, UDFs) in Unity Catalog: create, , deleteget, , listupdate
grants	Befehle zum Gewähren des Zugriffs auf Daten in Unity Catalog: get, get-effectiveupdate
metastores	Befehle zum Verwalten von Metastores, die der Objektcontainer der obersten Ebene in Unity Catalog sind: assign, create, , deletecurrent, get, list, summary, , , unassign, , updateupdate-assignment
model-versions	Befehle zum Verwalten von Modellversionen. Databricks stellt eine gehostete Version der MLflow-Modellregistrierung in Unity Catalog bereit. delete, , getget-by-alias, , listupdate
online-tables	Befehle zum Verwalten von Onlinetabellen, die eine niedrigere Latenz und einen höheren QPS-Zugriff auf Daten aus Deltatabellen bieten: create, deleteget
quality-monitors	Befehle zum Verwalten von Monitoren, die Daten- oder Modellqualitätsmetriken für eine Tabelle im Laufe der Zeit berechnen und überwachen: create, , deleteget, get-refresh, list-refreshes, , run-refreshupdate
registered-models	Befehle zum Verwalten registrierter Modelle. Databricks stellt eine gehostete Version der MLflow-Modellregistrierung in Unity Catalog bereit. create, , deletedelete-alias, get, list, , set-aliasupdate
schemas	Befehle zum Verwalten von Schemas, der zweiten Schicht des dreischichtigen Namespaces von Unity Catalog: create, , deleteget, , listupdate
storage-credentials	Befehle zum Verwalten von Speicheranmeldeinformationen, bei denen es sich um einen Authentifizierungs- und Autorisierungsmechanismus für den Zugriff auf Daten handelt, die in Ihrem Cloudmandanten gespeichert sind: create, , deleteget, list, , updatevalidate
system-schemas	Befehle zum Verwalten von Systemschemas, bei denen es sich um Schemas handelt, die sich im Systemkatalog befinden: disable, enablelist
table-constraints	Befehle zum Verwalten von Primärschlüssel- und Fremdschlüsseleinschränkungen, die Beziehungen zwischen Feldern in Tabellen codieren: create, delete
tables	Befehle zum Verwalten von Tabellen, die sich in der dritten Schicht des dreischichtigen Namespaces von Unity Catalog befinden: delete, , existsget, , listlist-summaries
volumes	Befehle zum Verwalten von Volumes, bei denen es sich um eine UC-Funktion (Unity Catalog) für den Zugriff auf und das Speichern, Verwalten, Organisieren und Verarbeiten von Dateien handelt: create, , deletelist, , readupdate
workspace-bindings	Befehle zum Verwalten sicherungsfähiger Arbeitsbereichsbindungen. Sicherungsfähige Objekte in Databricks können als OPEN oder ISOLATED konfiguriert werden. get, , get-bindingsupdateupdate-bindings

Deltafreigabebefehle

Group	Beschreibung und Befehle
providers	Befehle zum Verwalten von Datenanbietern, die Organisationen darstellen, die Daten freigeben: create, , deleteget, list, , list-sharesupdate
recipient-activation	Befehle zum Verwalten der Empfängeraktivierung, die nur im offenen Freigabemodell anwendbar ist, in dem das Empfängerobjekt den TOKEN-Authentifizierungstyp aufweist: get-activation-url-info, retrieve-token
recipients	Befehle zum Verwalten von Empfängern, die Sie mithilfe von :method:recipients/create erstellen, um eine Organisation zu repräsentieren, der Sie den Zugriff auf Freigaben erteilen möchten: create, , deleteget, list, , rotate-tokenupdate share-permissions
shares	Befehle zum Verwalten von Freigaben, bei denen es sich um Container handelt, die mit :method:shares/create instanziiert werden: create, , deleteget, , listupdate share-permissions, update-permissions

Einstellungsbefehle

Group	Beschreibung und Befehle
ip-access-lists	Befehle zum Gestatten der Konfiguration von IP-Zugriffslisten durch Administratoren: create, , deleteget, list, , replaceupdate
settings	Befehle zum Gestatten der Verwaltung von Einstellungen auf Arbeitsbereichsebene durch Benutzer: automatic-cluster-update, , csp-enablementdefault-namespace, , esm-enablementrestrict-workspace-admins
token-management	Befehle zum Gestatten des Abrufs aller Token und des Löschens von Token für andere Benutzer durch Administratoren: create-obo-token, , deletegetlist get-permission-levels, , get-permissionsset-permissionsupdate-permissions
tokens	Befehle zum Erstellen, Auflisten und Widerrufen von Token, die zum Authentifizieren und Zugreifen auf Databricks-REST-APIs verwendet werden können: create, deletelist
workspace-conf	Befehle zum Aktualisieren der Arbeitsbereichseinstellungen: get-status, set-status

Befehle für Entwicklertools

Group	Beschreibung und Befehle
bundle	Befehle zum Verwalten von Databricks-Ressourcenbundles, mit denen Sie Ihre Databricks-Projekte als Code ausdrücken können: deploy, deployment, , generatedestroy, init, run, schema, , syncvalidate
sync	Synchronisiert ein lokales Verzeichnis mit einem Arbeitsbereichsverzeichnis

Vektorsuchbefehle

Group	Beschreibung und Befehle
vector-search-endpoints	Befehle zum Verwalten von Vektorsuchendpunkten, die die Computeressourcen zum Hosten von Vektorsuchindizes darstellen: create-endpoint, , delete-endpointget-endpointlist-endpoints
vector-search-indexes	Befehle zum Verwalten von Vektorsuchindizes, einer effizienten Darstellung Ihrer Einbettungsvektoren, die Echtzeit- und effiziente ANN-Suchabfragen (Approximate Nearest Neighbor) unterstützen: create-index, , delete-data-vector-indexdelete-index, get-index, list-indexes, query-index, , sync-indexupsert-data-vector-index

Dashboardbefehle

Group	Beschreibung und Befehle
dashboards	Befehle zum Ändern von Dashboards: create, , deleteget, list, , restoreupdate
lakeview	Befehle, die bestimmte Verwaltungsvorgänge für KI/BI-Dashboards ermöglichen: create, , getget-published, migrate, publish, trash, , unpublishupdate

Zusätzliche Befehle

Group	Beschreibung und Befehle
api	Befehle zum Senden von Anforderungen an die Databricks-REST-API: delete, , gethead, patch, , postput
completion	Befehle zum Generieren des Autovervollständigungsskripts für die angegebene Shell: bash, , fishpowershellzsh
configure	Konfiguriert die Databricks CLI
help	Ausgabeverwendungsinformationen für jeden Befehl
labs	Befehle zum Verwalten von Databricks Labs-Installationen: clear-cache, , installinstalled, list, show, , uninstallupgrade
version	Ruft die aktuell verwendete CLI-Version ab

Globale Flags

Die folgenden Flags sind für alle Databricks CLI-Befehle verfügbar. Beachten Sie, dass einige Flags für einige Befehle nicht gelten. Ausführliche Informationen zu bestimmten Befehlen und deren Flags finden Sie in der Befehlszeilenhilfe.

Flag	Beschreibung
-h oder --help	Hilfe für die Databricks CLI oder die zugehörige Befehlsgruppe oder den zugehörigen Befehl anzeigen.
-e oder --environment string	Eine Zeichenfolge, die die Bündelumgebung darstellt, die ggf. für den zugehörigen Befehl verwendet werden soll.
--log-file	Eine Zeichenfolge, die die Ausgabeprotokolle darstellt, in die geschrieben werden soll. Wenn dieses Flag nicht angegeben ist, werden Ausgabeprotokolle standardmäßig in stderr geschrieben.
--log-format	text, um Ausgabeprotokolle in Text zu schreiben, oder json, um Ausgabeprotokolle in JSON zu schreiben. Wenn dieses Flag nicht angegeben ist, werden Ausgabeprotokolle als Text geschrieben.
--log-level	Eine Zeichenfolge, die die Protokollformatebene darstellt. Wenn nicht angegeben, ist die Protokollformatebene deaktiviert.
-o oder --output	text, um die Ausgabe als Text zu schreiben, oder json, um die Ausgabe als JSON zu schreiben. Wenn dieses Flag nicht angegeben ist, wird die Ausgabe als Text geschrieben.
-p oder --profile	Eine Zeichenfolge, die das benannte Konfigurationsprofil darstellt, das in Ihrer .databrickscfg-Datei verwendet werden soll. Wenn dieses Flag nicht angegeben ist, wird das benannte DEFAULT-Profil verwendet, sofern vorhanden. Sie können Tab nach --profile oder -p drücken, um eine Liste der vorhandenen verfügbaren Konfigurationsprofile anzuzeigen, aus der Sie auswählen können, anstatt den Namen des Konfigurationsprofils manuell einzugeben.
--progress-format	Das Format für die Anzeige von Statusprotokollen (default (Standard) oder append oder inplace oder json).