Базовое использование интерфейса командной строки Databricks
Примечание.
Эта информация относится к Интерфейсу командной строки Databricks версии 0.205 и выше, которые находятся в общедоступной предварительной версии. Чтобы найти версию интерфейса командной строки Databricks, выполните команду databricks -v
.
В этой статье показано, как вывести список команд и команд Databricks CLI, отобразить справку по Интерфейсу командной строки Databricks и работать с выходными данными интерфейса командной строки Databricks. См. сведения о интерфейсе командной строки Databricks?.
В этой статье предполагается, что вы уже установили интерфейс командной строки Databricks и настроили интерфейс командной строки для проверки подлинности. См. статью "Установка или обновление интерфейса командной строки Databricks" и проверки подлинности для интерфейса командной строки Databricks.
Перечисление групп команд CLI
Вы перечисляете группы команд с помощью --help
или -h
параметра. Например:
databricks -h
Перечисление команд CLI
Вы перечисляете команды для любой группы команд с помощью --help
или -h
параметра. Например, чтобы вывести список clusters
команд:
databricks clusters -h
Справка по команде CLI
Вы отображаете справку для команды с помощью --help
или -h
параметра. Например, чтобы отобразить справку для clusters list
команды:
databricks clusters list -h
Выполнение команды
Полные сведения об использовании и синтаксис для отдельных команд можно найти в справке командной строки, но команды CLI Databricks обычно соответствуют следующему синтаксису:
databricks <command-group> <command-name> <subcommand-name> [command-argument-value1] [--<flag1-name> <flag1-value>]
Не каждая команда имеет дополнительные подкоманда. Доступны глобальные флаги , а некоторые команды имеют дополнительные флаги. Например, следующая команда выводит доступные кластеры с помощью флага, зависяющего от команды:
databricks clusters list --can-use-client JOBS
Совет
Команды CLI Databricks можно запускать из рабочей области Databricks с помощью веб-терминала. Веб-терминал может использоваться многими пользователями на одном вычислительном компьютере и не требует настройки ключей. См . статью "Запуск команд оболочки" в веб-терминале Azure Databricks.
Использование jq
для фильтрации выходных данных JSON
Некоторые команды CLI Databricks выводит JSON, что означает, что для фильтрации выходных данных можно использовать jq . Например, чтобы указать только отображаемое имя кластера Azure Databricks с указанным идентификатором кластера:
databricks clusters get 1234-567890-abcde123 | jq -r .cluster_name
My-11.3-LTS-Cluster
Вы можете установить jq
на macOS с помощью Homebrew или brew install jq
в Windows с помощью Шоколада choco install jq
. См. сведения об jq
в руководстве по jq.
Параметры строки JSON
Формат строковых параметров обрабатывается по-разному в формате JSON в зависимости от операционной системы:
Linux и macOS
Необходимо заключить строковые параметры JSON в двойные кавычки, и необходимо заключить всю полезные данные JSON в одинарные кавычки. Некоторые примеры:
'{"cluster_id": "1234-567890-abcde123"}'
'["20230323", "Amsterdam"]'
Windows
Необходимо заключить строковые параметры JSON и всю полезные данные JSON в двойные кавычки, а символы двойной кавычки внутри полезных данных JSON должны предшествовать \
. Некоторые примеры:
"{\"cluster_id\": \"1234-567890-abcde123\"}"
"[\"20230323\", \"Amsterdam\"]"
Конфигурация прокси-сервера
Чтобы маршрутизировать запросы и ответы Databricks через прокси-сервер, задайте HTTPS_PROXY
переменную среды на компьютере, где интерфейс командной строки Databricks установлен на URL-адрес прокси-сервера.
Чтобы задать переменные среды, ознакомьтесь с документацией операционной системы.