Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Die Verwendung von Databricks CLI unterliegt der Datenbricks-Lizenz - und Databricks-Datenschutzerklärung, einschließlich der Bestimmungen zu Nutzungsdaten.
Von Bedeutung
Der SSH-Tunnel befindet sich in Der Betaversion.
Mit ssh der Befehlsgruppe in der Databricks CLI können Sie SSH-Verbindungen zu Ihren Databricks Compute und Arbeitsbereich einrichten und einrichten. Siehe Herstellen einer Verbindung mit Databricks mithilfe eines SSH-Tunnels.
Databricks SSH Connect
Stellen Sie über SSH eine Verbindung mit Ihren Databricks-Berechnungen und -Arbeitsbereichen her. Dieser Befehl stellt eine SSH-Verbindung zu Databricks Compute her, richtet den SSH-Tunnel ein und verwaltet den Verbindungsproxy.
databricks ssh connect [flags]
Options
--accelerator string
Der GPU-Zugriffstastentyp beim Herstellen einer Verbindung mit der AI-Runtime. Für diesen Parameter kann GPU_1xA10 oder GPU_8xH100 angegeben werden.
--auto-approve
Überspringen Sie Bestätigungsaufforderungen beim Installieren von IDE-Erweiterungen und Anwenden von IDE-Einstellungen. Standardwert: false.
--auto-start-cluster
Falls der Cluster nicht läuft, starten Sie ihn automatisch. Standardwert: true.
--base-environment string
Eine Arbeitsbereichsbasisumgebung zum Vorabkonfigurieren Python Abhängigkeiten beim Herstellen einer Verbindung mit serverlosem Compute. Unterstützt mit serverloser Umgebung, Version 4 und darunter; Serverlose Umgebung, Version 5, wird nicht unterstützt. Akzeptiert eines der folgenden Formate:
- Ein Anzeigename, z. B.
my-workspace-env - Ein YAML-Dateipfad, z. B.
/Workspace/path/to/env.yaml - Eine Ressourcen-ID, z. B.
workspace-base-environments/dbe_123
Dieses Kennzeichen kann nicht mit --cluster.
--cluster string
Databricks-ID für einen dedizierten Einzelbenutzercluster. Wenn diese Option nicht angegeben wird, stellt der SSH-Tunnel eine Verbindung mit serverlosem Compute bereit.
Dieses Kennzeichen kann nicht mit --base-environment.
--ide string
IDE, die für die Sitzung gestartet werden soll. Für diesen Parameter kann vscode oder cursor angegeben werden. Um die Sitzung in Ihrem Terminal zu starten, lassen Sie dieses Kennzeichen aus, und verwenden cd /Workspace/Users/someone@example.com Sie dann den Zugriff auf Ihren Arbeitsbereich.
--keep-detached-processes
Während die Arbeit noch läuft, halten Sie den SSH-Tunnel und alle Prozesse mit , setsid, oder nohup laufend, begrenzt durch --server-timeout, von der Sitzung tmuxgetrennt. Unterstützt auf Serverless und Classic Compute. Während getrennte Prozesse laufen, läuft die Berechnung weiter, und ein klassischer Cluster beendet nicht automatisch. Siehe Abgetrennte Prozesse laufen lassen. Standardwert: false.
--max-clients int
Maximale Anzahl von SSH-Clients. Standardwert: 10.
--name string
Verbindungsname, der für alle Sitzungen wiederverwendet werden soll. Nur Serverlose Berechnung.
--server-timeout duration
Maximale Lebensdauer des SSH-Tunnels. Der Tunnel schaltet sich nach dieser Dauer ab, selbst wenn die Clients verbunden sind. Wenn du dieses Flag nicht setzt, ist die Lebensdauer die längere des Standard-und .--shutdown-delay Wenn du es einstellst, --shutdown-delay darf es nicht länger als dieser Wert sein. Standardwert: 24h0m0s.
--shutdown-delay duration
Verzögern Sie, bevor Sie den Tunnel abschalten, nachdem der letzte Client die Verbindung getrennt hat. Standardwert: 10m0s.
--usage-policy-id string
Nutzungsrichtlinien-ID für den serverlosen SSH-Tunnel. Nur serverlos.
Examples
Im folgenden Beispiel wird eine Verbindung mit serverloser Berechnung hergestellt:
databricks ssh connect
Im folgenden Beispiel wird mithilfe eines GPU-Zugriffstastes eine Verbindung mit serverloser Berechnung auf der KI-Runtime hergestellt:
databricks ssh connect --accelerator GPU_1xA10
Im folgenden Beispiel wird eine Verbindung mit serverloser Berechnung mithilfe einer Arbeitsbereichsbasisumgebung hergestellt, die Python vorkonfigurierten Abhängigkeiten aufweist.
databricks ssh connect --base-environment my-workspace-env
Im folgenden Beispiel wird eine Verbindung mit einem dedizierten Cluster hergestellt:
databricks ssh connect --cluster 0123-456789-abcdefgh
Im folgenden Beispiel wird eine Verbindung mit einem Cluster mithilfe eines bestimmten Profils hergestellt:
databricks ssh connect --cluster 0123-456789-abcdefgh --profile my-profile
Im folgenden Beispiel wird eine Verbindung mit einer benutzerdefinierten Verzögerung beim Herunterfahren hergestellt:
databricks ssh connect --cluster 0123-456789-abcdefgh --shutdown-delay 30m
databricks ssh-Setup
Richten Sie die SSH-Konfiguration für Verbindungen mit der klassischen Compute ein. Es werden nur Verbindungen mit dedizierten Clustern (Einzelbenutzer) unterstützt. Mit diesem Befehl wird Ihrer SSH-Konfigurationsdatei eine SSH-Hostkonfiguration hinzugefügt. Nach dem Ausführen des Setups können Sie eine Verbindung mit ssh <name>.
Verwenden Sie für serverlose Verbindungen databricks ssh connect. Es ist kein Setupschritt erforderlich.
databricks ssh setup [flags]
Options
--auto-approve
Überspringen Sie Bestätigungsaufforderungen, wenn Sie vorhandene SSH-Hostkonfigurationen neu erstellen. Standardwert: false.
--auto-start-cluster
Starten Sie den Cluster beim Einrichten der SSH-Verbindung automatisch. Standardwert: true.
--cluster string
Databricks-ID für einen dedizierten Einzelbenutzercluster.
--keep-detached-processes
Während die Arbeit noch läuft, halten Sie den SSH-Tunnel und alle Prozesse mit , setsid, oder nohup laufend, begrenzt durch --server-timeout, von der Sitzung tmuxgetrennt. Nur klassische Berechnung. Serverlose Verbindungen erfordern keine Einrichtung, also um getrennte Prozesse auf serverloser Berechnung laufen zu lassen, gib dieses Flag stattdessen an databricks ssh connect weiter. Während getrennte Prozesse laufen, beendet der Cluster nicht automatisch. Siehe Abgetrennte Prozesse laufen lassen. Der generierte SSH-Host-Eintrag verwendet dieses Flag jedes Mal, wenn du dich verbindest. Standardwert: false.
--name string
Hostname, der in der SSH-Konfiguration verwendet werden soll.
--server-timeout duration
Maximale Lebensdauer des SSH-Tunnels. Der Tunnel schaltet sich nach dieser Dauer ab, selbst wenn die Clients verbunden sind. Wenn du dieses Flag nicht setzt, ist die Lebensdauer die längere des Standard-und .--shutdown-delay Wenn du es einstellst, --shutdown-delay darf es nicht länger als dieser Wert sein. Standardwert: 24h0m0s.
--shutdown-delay duration
Der SSH-Tunnel endet nach dieser Verzögerung, wenn keine aktiven Verbindungen vorhanden sind. Standardwert: 10m0s.
--ssh-config string
Pfad zur SSH-Konfigurationsdatei. Standardwert: ~/.ssh/config.
Examples
Im folgenden Beispiel wird die SSH-Konfiguration für einen Cluster eingerichtet:
databricks ssh setup --name my-cluster --cluster 0123-456789-abcdefgh
Nach dem Ausführen des Setups können Sie eine Verbindung mit dem standardmäßigen SSH-Client herstellen:
ssh my-cluster
Globale Kennzeichnungen
--debug
Gibt an, ob die Debugprotokollierung aktiviert werden soll.
-h oder --help
Hilfe für die Databricks CLI oder die zugehörige Befehlsgruppe oder den zugehörigen Befehl anzeigen.
--log-file Schnur
Eine Zeichenfolge, die die Datei darstellt, in die Ausgabeprotokolle geschrieben werden sollen. Wenn dieses Flag nicht angegeben ist, werden Ausgabeprotokolle standardmäßig in stderr geschrieben.
--log-format Format
Der Protokollformattyp text oder json. Der Standardwert ist text.
--log-level Schnur
Eine Zeichenfolge, die die Protokollformatebene darstellt. Wenn nicht angegeben, ist die Protokollformatebene deaktiviert.
-o, --output Typ
Der Befehlsausgabetyp text oder json. Der Standardwert ist text.
-p, --profile Schnur
Der Name des Profils in der ~/.databrickscfg Datei, das zum Ausführen des Befehls verwendet werden soll. Wenn dieses Flag nicht angegeben wird, wird, falls vorhanden, das Profil mit dem Namen DEFAULT verwendet.
--progress-format Format
Das Format zum Anzeigen von Statusprotokollen: default, , append, inplaceoder json
-t, --target Schnur
Falls zutreffend, das zu verwendende Bündelziel