Базовое использование интерфейса командной строки 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

Использование 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-адрес прокси-сервера.

Чтобы задать переменные среды, ознакомьтесь с документацией операционной системы.