Fehlerbehebung für die Databricks CLI

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.

Verwenden Sie die folgenden Informationen, um Probleme mit der Databricks CLI zu beheben.

Aktivieren der Protokollierung

Wenn ein Befehl fehlschlägt oder nicht die erwartete Ausgabe erzeugt, können Sie die Protokollierung verwenden, um zu ermitteln, was möglicherweise schief gegangen ist. Sie können Nachrichten protokollieren, die die Databricks CLI über verschiedene Befehlsereignisse, Warnungen und Fehler ausgibt. Um diese Nachrichten zu protokollieren, geben Sie die folgenden Databricks CLI-Befehlsoptionen an:

Flag Beschreibung
--log-file 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 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. Gültige Protokollebenen sind error, warn, info, debug, trace und disabled. Die Standardebene lautet disabled, was bedeutet, dass nichts protokolliert wird. --debug entspricht --log-level debug.

Im folgenden Beispielbefehl werden Ablaufverfolgungsmeldungen für den angegebenen Befehl in eine Datei namens databricks-cli.log im JSON-Format protokolliert.

databricks clusters list --log-file databricks-cli.log --log-format json --log-level trace

Fehler beim Herunterladen von Terraform

Ein abgelaufener Schlüssel in einigen Versionen der Databricks CLI verursacht den folgenden Fehler beim Ausführen databricks bundle deploy:

error downloading Terraform: unable to verify checksums signature: openpgp: key expired

Um diesen Fehler zu beheben, aktualisieren Sie die Databricks CLI auf eine neueste gepatchte Version, die den Überprüfungsmechanismus aktualisiert, um mit einem neueren Schlüssel zu arbeiten. Aktualisieren Sie auf die gepatchte Version, die Ihrer aktuellen CLI-Nebenversion entspricht:

  • Binärinstallation: Laden Sie die gepatchte Version von der Seite mit Databricks CLI-Veröffentlichungen auf GitHub herunter.

  • setup-cli (als Installationsskript oder GitHub Aktion): Aktualisieren Sie die Version in Ihrer Konfiguration auf eine gepatchte Version von der Seite Databricks CLI auf GitHub.

    Verwenden Sie z. B. 0.296.1 mit der GitHub Aktion:

    - uses: databricks/setup-cli@main
      with:
        version: 0.296.1
    

Befehle werden nicht beendet

Wenn Sie einen Befehl wie databricks cluster list ausführen und er scheint hängen zu bleiben, aktualisieren Sie Ihre Version der Databricks CLI auf die neueste Version. Frühere Versionen der CLI würden versuchen, vollständige Listen zu laden, auch wenn die Anzahl der Elemente in der Liste groß war, und der Befehl scheint nicht fertig zu sein.