Grundlegende Nutzung der Databricks-CLI

In diesem Abschnitt erfahren Sie, wie Sie Databricks-CLI-Befehlsgruppen und -Befehle auflisten, Databricks-CLI-Hilfe anzeigen und mit der Databricks CLI-Ausgabe arbeiten. Weitere Informationen finden Sie unter Was ist die Databricks-CLI?.

In diesem Artikel wird davon ausgegangen, dass Sie die Databricks CLI bereits installiert und die Authentifizierung für die CLI konfiguriert haben. Siehe Installieren oder Aktualisieren der Databricks CLI und Authentifizierung für Databricks CLI.

Auflisten von CLI-Befehlsgruppen

Um die verfügbaren CLI-Befehlsgruppen aufzulisten, verwenden Sie die --help oder -h Option, z. B.:

databricks -h

Auflisten der CLI-Befehle

Wenn Sie die Befehle für eine beliebige Befehlsgruppe auflisten möchten, verwenden Sie die --help Oder-Option -h . So listen Sie beispielsweise die clusters-Befehle auf:

databricks clusters -h

Anzeigen der Hilfe zum CLI-Befehl

Um Verwendungsinformationen für einen Befehl anzuzeigen, verwenden Sie die Option --help oder die Option -h mit dem Befehl. So zeigen Sie beispielsweise die Hilfe für den Befehl clusters list an:

databricks clusters list -h

Eine Befehlsreferenz ist verfügbar. Weitere Informationen unter Databricks CLI-Befehle.

Ausführen eines Befehls

Vollständige Verwendungsinformationen und Syntax für einzelne Befehle finden Sie in der Befehlszeilenhilfe und -Referenz, aber Databricks CLI-Befehle entsprechen in der Regel der folgenden Syntax:

databricks <command-group> <command-name> <subcommand-name> [command-argument-value1] [--<flag1-name> <flag1-value>]

Nicht jeder Befehl verfügt über zusätzliche Unterbefehle. Globale Flags sind verfügbar, und einige Befehle verfügen über zusätzliche Flags. Beispielsweise gibt der folgende Befehl verfügbare Cluster mithilfe eines befehlsspezifischen Flags aus:

databricks clusters list --can-use-client JOBS

Verwenden Sie jq zum Filtern der JSON-Ausgabe

Einige Databricks CLI-Befehle geben JSON aus, was bedeutet, dass Sie jq verwenden können, um die Ausgabe zu filtern. Wenn Sie beispielsweise nur den Anzeigenamen eines Azure Databricks-Clusters mit der angegebenen Cluster-ID auflisten möchten:

databricks clusters get 1234-567890-abcde123 | jq -r .cluster_name

My-11.3-LTS-Cluster

Sie können jq unter macOS mithilfe von Homebrew (brew install jq) oder unter Windows mithilfe von Chocolatey (choco install jq) installieren. Weitere Informationen zu jq finden Sie im Leitfaden zu jq.

JSON-Zeichenfolgenparameter

Das Format von Zeichenfolgenparametern wird in JSON je nach Betriebssystem unterschiedlich behandelt:

Linux oder macOS

Sie müssen JSON-Zeichenfolgenparameter in doppelte Anführungszeichen einschließen, und Sie müssen die gesamte JSON-Nutzlast in einfache Anführungszeichen einschließen. Beispiele:

'{"cluster_id": "1234-567890-abcde123"}'

'["20230323", "Amsterdam"]'

Windows

Sie müssen JSON-String-Parameter und die gesamte JSON-Nutzlast in doppelte Anführungszeichen einschließen, und den doppelten Anführungszeichen innerhalb der JSON-Nutzlast muss ein \ vorangestellt sein. Beispiele:

"{\"cluster_id\": \"1234-567890-abcde123\"}"

"[\"20230323\", \"Amsterdam\"]"

Proxyserverkonfiguration

Um Databricks CLI-Anforderungen und -Antworten über einen Proxyserver weiterzuleiten, legen Sie die HTTPS_PROXY Umgebungsvariable auf dem Computer fest, auf dem die Databricks CLI auf der URL des Proxyservers installiert ist.

Informationen zum Festlegen von Umgebungsvariablen finden Sie in der Dokumentation Ihres Betriebssystems.