Устранение неполадок командного интерфейса Databricks

Примечание.

Использование интерфейса командной строки Databricks распространяется на лицензию Databricks и уведомление о конфиденциальности Databricks, включая все положения об использовании.

Используйте следующие сведения для устранения неполадок с интерфейсом командной строки Databricks.

Включение ведения журналов

Если команда завершается ошибкой или не создает ожидаемые выходные данные, можно использовать ведение журнала, чтобы определить, что могло произойти неправильно. Вы можете записывать сообщения, которые databricks CLI выводит о различных событиях команд, предупреждениях и ошибках. Чтобы записать эти сообщения, укажите следующие параметры командной строки Databricks:

Флаг Описание
--log-file Строка, представляющая файл для записи журналов выходных данных. Если этот флаг не указан, по умолчанию используется запись журналов выходных данных в stderr.
--log-format text для записи журналов выходных данных в текст или json записи журналов выходных данных в JSON. Если этот флаг не указан, выходные журналы записываются как текст.
--log-level Строка, представляющая уровень формата журнала. Допустимые уровни журнала: error, warn, info, debug, traceи disabled. Уровень по умолчанию disabled, что означает, что ничего не регистрируется. --debug эквивалентна --log-level debug.

В следующем примере команды записываются сообщения трассировки для указанной команды в файл с именем databricks-cli.log в формате JSON.

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

Ошибка при скачивании Terraform

Истекший срок действия ключа в некоторых версиях интерфейса командной строки Databricks приводит к следующей ошибке при выполнении databricks bundle deploy:

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

Чтобы устранить эту ошибку, обновите интерфейс командной строки Databricks до последней исправленной версии, которая обновляет механизм проверки для работы с новым ключом. Обновитесь до исправленной версии, соответствующей вашей текущей минорной версии CLI.

  • Binary install: скачайте исправленную версию на странице выпусков Databricks CLI на GitHub.

  • setup-cli (как скрипт установки или действие GitHub): обновите версию в конфигурации до исправленной версии со страницы с выпусками Databricks CLI на GitHub.

    Например, чтобы использовать 0.296.1 с GitHub Action:

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

Ошибка сохраненных учетных данных

Начиная с Databricks CLI версии 1.0.0, интерфейс командной строки Databricks сохраняет маркеры проверки подлинности пользователей и компьютеров (U2M) в защищенном хранилище ОС (цепочка ключей в macOS, Диспетчер учетных данных на Windows, D-Bus Secret Service в Linux) вместо JSON-файла. См. раздел хранилища токенов. Если рабочий процесс строится на основе JSON-файла, он не будет работать с новым методом хранения, и в следующих сценариях могут возникнуть проблемы:

  • Обновлено до общедоступной версии, повторный вход в систему еще не выполнен. Интерфейс командной строки Databricks больше не считывает учетные данные, хранящиеся в более старых версиях, и возвращает ошибку:

    Stored credentials from older CLI versions are no longer used.
Run "databricks auth login" to sign in again.

If secure storage is not available in this environment, set
DATABRICKS_AUTH_STORAGE=plaintext and re-run login.

    Выполните команду databricks auth login , чтобы устранить эту проблему.

  • Проверка защищённого хранилища завершается ошибкой при входе При databricks auth loginCLI Databricks проверяет защищённое хранилище перед запуском потока OAuth. Если проверка не проходит (чаще всего в контейнерах Linux, сеансах SSH, WSL1 и серверах без графического интерфейса, где не запущен D-Bus), поведение зависит от того, было ли явно настроено безопасное хранилище:

    • Режим по умолчанию, без явной настройки хранилища: Databricks CLI без уведомления переключается на хранение в открытом виде и записывает auth_storage = plaintext в раздел [__settings__] файла ~/.databrickscfg. Последующие команды используют обычный текст без повторной проверки.
    • Явный безопасный режим (DATABRICKS_AUTH_STORAGE=secure или auth_storage = secure в профиле конфигурации): интерфейс командной строки Databricks возвращает ошибку, указывающую на резервный DATABRICKS_AUTH_STORAGE=plaintext вариант.

    Если проверка завершается по тайм-ауту, а не сразу с ошибкой (например, связка ключей заблокирована, но доступна), Databricks CLI продолжает использовать backend связки ключей, а запрос ОС на разблокировку выполняется параллельно с процессом OAuth-аутентификации в браузере.

    Чтобы убедиться, какой режим хранения использует интерфейс командной строки Databricks после входа, выполните команду databricks auth describe.

  • Связка ключей недоступна при чтении сохранённого токена. В отличие от входа в систему, Databricks CLI не выполняет автоматический переход к резервному варианту без уведомления, если при чтении токена не может получить доступ к связке ключей. Например, если вы вошли в систему на настольном компьютере, а затем подключились по SSH в сеансе без графического интерфейса, команды, которым требуется сохранённый токен, завершаются ошибкой. Используйте резервную версию открытого текста, чтобы устранить эту проблему. См. Использование резервного варианта с обычным текстом.

Команды не завершены

При выполнении такой команды, как databricks cluster list и она, как представляется, зависает, обновите версию интерфейса командной строки Databricks до последней версии. Более ранние версии CLI пытались загрузить полные списки, даже если количество элементов в списке было большим, и команда казалась незавершенной.

  • Last updated on