Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Note
Использование интерфейса командной строки Databricks подчиняется лицензии Databricks и уведомлению о конфиденциальности Databricks, включая любые положения о данных использования.
Группа warehouses команд в интерфейсе командной строки Databricks позволяет управлять хранилищами SQL. Хранилище SQL — это вычислительный ресурс, который позволяет выполнять команды SQL на объектах данных в Databricks SQL. См. статью "Подключение к хранилищу SQL".
создание databricks хранилищ
Создайте хранилище SQL.
databricks warehouses create [flags]
Arguments
None
Options
--auto-stop-mins int
Время в минутах, когда хранилище SQL должно быть неактивным (другими словами, без RUNNING запросов), прежде чем он будет остановлен автоматически.
--cluster-size string
Размер кластеров, выделенных для этого хранилища.
--creator-name string
Имя создателя хранилища.
--enable-photon
Настраивает, следует ли использовать оптимизированные для хранилища кластеры Photon.
--enable-serverless-compute
Настраивает, следует ли использовать бессерверные вычислительные ресурсы хранилища.
--instance-profile-arn string
Deprecated.
--json JSON
Строка JSON inline или @path к JSON-файлу с телом запроса.
--max-num-clusters int
Максимальное количество кластеров, создаваемых автомасштабированием для обработки одновременных запросов.
--min-num-clusters int
Минимальное количество доступных кластеров, которые будут поддерживаться для этого хранилища SQL.
--name string
Логическое имя кластера.
--no-wait
Не подождите, чтобы достичь состояния ВЫПОЛНЕНИЯ
--spot-instance-policy SpotInstancePolicy
Конфигурации, должны ли хранилище использовать точечные экземпляры. Поддерживаемые значения: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
Максимальное время достижения RUNNING состояния (по умолчанию 20 мс)
--warehouse-type CreateWarehouseRequestWarehouseType
Тип хранилища: PRO или CLASSIC. Поддерживаемые значения: CLASSIC, PRO, TYPE_UNSPECIFIED
Examples
В следующем примере создается новое хранилище SQL с базовой конфигурацией:
databricks warehouses create --name "my-warehouse" --cluster-size "Small" --min-num-clusters 1 --max-num-clusters 10 --auto-stop-mins 60
В следующем примере создается бессерверное хранилище с включенным Photon:
databricks warehouses create --name "serverless-warehouse" --enable-serverless-compute --enable-photon --warehouse-type PRO
хранилища databricks create-default-warehouse-override
Создайте переопределение хранилища по умолчанию для пользователя. Пользователи могут создавать собственные переопределения. Администраторы могут создавать переопределения для любого пользователя.
databricks warehouses create-default-warehouse-override DEFAULT_WAREHOUSE_OVERRIDE_ID TYPE [flags]
Arguments
DEFAULT_WAREHOUSE_OVERRIDE_ID
Идентификатор переопределения. Используйте числовый идентификатор пользователя или литеральную строку me для текущего пользователя.
TYPE
Тип поведения переопределения. Поддерживаемые значения: CUSTOM, LAST_SELECTED.
Options
--json JSON
Строка JSON inline или @path к JSON-файлу с телом запроса.
--name string
Имя ресурса переопределения хранилища по умолчанию.
--warehouse-id string
Определенный идентификатор хранилища при типе CUSTOM.
Examples
В следующем примере создается переопределение пользовательского хранилища для текущего пользователя:
databricks warehouses create-default-warehouse-override me CUSTOM --warehouse-id 1234567890abcdef
Удаление хранилищ Databricks
Удаление хранилища SQL.
databricks warehouses delete ID [flags]
Arguments
ID
Required. Идентификатор хранилища SQL.
Options
Examples
В следующем примере удаляется хранилище с указанным идентификатором:
databricks warehouses delete 1234567890abcdef
хранилища databricks delete-default-warehouse-override
Удалите переопределение хранилища по умолчанию для пользователя. Пользователи могут удалять свои собственные переопределения. Администраторы могут удалять переопределения для любого пользователя. После удаления используется хранилище рабочей области по умолчанию.
databricks warehouses delete-default-warehouse-override NAME [flags]
Arguments
NAME
Имя ресурса хранилища по умолчанию переопределяется для удаления. Формат: default-warehouse-overrides/{default_warehouse_override_id}. Идентификатор может быть числовым идентификатором пользователя или строкой me литерала для текущего пользователя.
Options
Examples
В следующем примере удаляется переопределение хранилища по умолчанию для текущего пользователя:
databricks warehouses delete-default-warehouse-override default-warehouse-overrides/me
Изменение хранилищ Датабрикс
Обновление хранилища. Обновляет конфигурацию для хранилища SQL.
databricks warehouses edit ID [flags]
Arguments
ID
Required. Идентификатор настраиваемого хранилища.
Options
--auto-stop-mins int
Время в минутах, когда хранилище SQL должно быть неактивным (другими словами, без RUNNING запросов), прежде чем он будет остановлен автоматически.
--cluster-size string
Размер кластеров, выделенных для этого хранилища.
--creator-name string
Имя создателя хранилища.
--enable-photon
Настраивает, следует ли использовать оптимизированные для хранилища кластеры Photon.
--enable-serverless-compute
Настраивает, следует ли использовать бессерверные вычислительные ресурсы хранилища.
--instance-profile-arn string
Deprecated.
--json JSON
Строка JSON inline или @path к JSON-файлу с телом запроса.
--max-num-clusters int
Максимальное количество кластеров, создаваемых автомасштабированием для обработки одновременных запросов.
--min-num-clusters int
Минимальное количество доступных кластеров, которые будут поддерживаться для этого хранилища SQL.
--name string
Логическое имя кластера.
--no-wait
Не подождите, чтобы достичь RUNNING состояния
--spot-instance-policy SpotInstancePolicy
Конфигурации, должны ли хранилище использовать точечные экземпляры. Поддерживаемые значения: COST_OPTIMIZED, POLICY_UNSPECIFIED, RELIABILITY_OPTIMIZED
--timeout duration
Максимальное время достижения RUNNING состояния (по умолчанию 20 мс)
--warehouse-type EditWarehouseRequestWarehouseType
Тип хранилища. Поддерживаемые значения: CLASSIC, PRO, TYPE_UNSPECIFIED
Examples
В следующем примере хранилище обновляется для изменения размера кластера и времени автоматической остановки.
databricks warehouses edit 1234567890abcdef --cluster-size "Medium" --auto-stop-mins 30
Следующий пример включает Photon для существующего хранилища:
databricks warehouses edit 1234567890abcdef --enable-photon
Получить хранилища Databricks
Получите сведения для одного хранилища SQL.
databricks warehouses get ID [flags]
Arguments
ID
Required. Идентификатор хранилища SQL.
Options
Examples
В следующем примере показано, как получить сведения о хранилище с указанным идентификатором:
databricks warehouses get 1234567890abcdef
хранилища databricks get-default-warehouse-override
Получите переопределение хранилища по умолчанию для пользователя. Пользователи могут получить собственные переопределения. Администраторы могут получать переопределения для любого пользователя. Если переопределение не существует, используется хранилище рабочей области по умолчанию.
databricks warehouses get-default-warehouse-override NAME [flags]
Arguments
NAME
Имя ресурса хранилища по умолчанию переопределяется для получения. Формат: default-warehouse-overrides/{default_warehouse_override_id}. Идентификатор может быть числовым идентификатором пользователя или строкой me литерала для текущего пользователя.
Options
Examples
Следующий пример получает переопределение хранилища по умолчанию для текущего пользователя:
databricks warehouses get-default-warehouse-override default-warehouse-overrides/me
хранилища Databricks get-workspace-warehouse-config
Получите конфигурацию уровня рабочей области, доступную всем хранилищам SQL в рабочей области.
databricks warehouses get-workspace-warehouse-config [flags]
Arguments
None
Options
Examples
В следующем примере показано, как настроить хранилище рабочих областей:
databricks warehouses get-workspace-warehouse-config
список хранилищ Databricks
Вывод списка всех хранилищ SQL, на которые пользователь имеет разрешения на управление.
databricks warehouses list [flags]
Arguments
None
Options
--run-as-user-id int
Субъект-служба, который будет использоваться для получения списка хранилищ.
Examples
В следующем примере перечислены все склады:
databricks warehouses list
В следующем примере перечислены склады с помощью определенного сервисного принципала:
databricks warehouses list --run-as-user-id 123456789
databricks warehouses list-default-warehouse-overrides
Перечислить все переопределения хранилища по умолчанию в рабочей области. Только администраторы рабочей области могут перечислять все переопределения.
databricks warehouses list-default-warehouse-overrides [flags]
Options
--page-size int
Максимальное количество возвращаемых переопределения.
--page-token string
Маркер страницы, полученный от предыдущего list-default-warehouse-overrides вызова.
Examples
В следующем примере перечислены все переопределения хранилища по умолчанию:
databricks warehouses list-default-warehouse-overrides
databricks warehouses set-workspace-warehouse-config
Задайте конфигурацию уровня рабочей области, доступную всем хранилищам SQL в рабочей области.
databricks warehouses set-workspace-warehouse-config [flags]
Arguments
None
Options
--google-service-account string
Только GCP: служебная учетная запись Google, используемая для передачи кластеру с целью доступа к Облачному хранилищу Google.
--instance-profile-arn string
Только AWS: профиль экземпляра, используемый для передачи роли IAM в кластер.
--json JSON
Строка JSON inline или @path к JSON-файлу с телом запроса.
--security-policy SetWorkspaceWarehouseConfigRequestSecurityPolicy
Политика безопасности для складов. Поддерживаемые значения: DATA_ACCESS_CONTROL, NONE, PASSTHROUGH
Examples
В следующем примере настраивается конфигурация хранилища рабочей области с политикой безопасности:
databricks warehouses set-workspace-warehouse-config --security-policy DATA_ACCESS_CONTROL
Запуск хранилищ Databricks
Запустите хранилище SQL.
databricks warehouses start ID [flags]
Arguments
ID
Required. Идентификатор хранилища SQL.
Options
--no-wait
Не подождите, чтобы достичь RUNNING состояния
--timeout duration
Максимальное время достижения RUNNING состояния (по умолчанию 20 мс)
Examples
В следующем примере запускается хранилище с указанным идентификатором:
databricks warehouses start 1234567890abcdef
В следующем примере запускается хранилище, не дожидаясь изменения RUNNING состояния.
databricks warehouses start 1234567890abcdef --no-wait
Остановка хранилищ Databricks
Остановите SQL хранилище данных.
databricks warehouses stop ID [flags]
Arguments
ID
Required. Идентификатор хранилища SQL.
Options
--no-wait
Не подождите, чтобы достичь STOPPED состояния
--timeout duration
Максимальное время достижения STOPPED состояния (по умолчанию 20 мс)
Examples
Следующий пример останавливает хранилище с указанным идентификатором:
databricks warehouses stop 1234567890abcdef
В следующем примере хранилище останавливается, не дожидаясь, пока оно достигнет состояния STOPPED.
databricks warehouses stop 1234567890abcdef --no-wait
databricks warehouses update-default-warehouse-override
Обновите существующее переопределение хранилища по умолчанию для пользователя. Пользователи могут обновлять свои собственные переопределения. Администраторы могут обновлять переопределения для любого пользователя.
databricks warehouses update-default-warehouse-override NAME UPDATE_MASK TYPE [flags]
Arguments
NAME
Имя ресурса переопределения хранилища по умолчанию. Формат: default-warehouse-overrides/{default_warehouse_override_id}.
UPDATE_MASK
Маска поля, указывающая, какие поля необходимо обновить. Используется * для обновления всех полей. Если --allow-missing задано, это поле игнорируется и применяются все поля.
TYPE
Тип поведения переопределения. Поддерживаемые значения: CUSTOM, LAST_SELECTED.
Options
--allow-missing
Если задано и переопределение не найдено, создайте новую переопределение.
--json JSON
Строка JSON inline или @path к JSON-файлу с телом запроса.
--name string
Имя ресурса переопределения хранилища по умолчанию.
--warehouse-id string
Определенный идентификатор хранилища при типе CUSTOM.
Examples
В следующем примере обновляется переопределение текущего пользователя на определенное хранилище:
databricks warehouses update-default-warehouse-override default-warehouse-overrides/me warehouse_id CUSTOM --warehouse-id 1234567890abcdef
хранилища databricks получение уровней разрешений
Получите уровни разрешений для хранилища SQL.
databricks warehouses get-permission-levels WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Хранилище SQL, для которого требуется получить или управлять разрешениями.
Options
Examples
Следующий пример получает уровни разрешений для хранилища:
databricks warehouses get-permission-levels 1234567890abcdef
databricks warehouses разрешения-на-получение
Получение разрешений хранилища SQL. Хранилища SQL могут наследовать разрешения от корневого объекта.
databricks warehouses get-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Хранилище SQL, для которого требуется получить или управлять разрешениями.
Options
Examples
В следующем примере получаются права доступа для хранилища:
databricks warehouses get-permissions 1234567890abcdef
databricks warehouses установить права доступа
Задайте разрешения хранилища SQL. Задает разрешения для объекта, заменив существующие разрешения, если они существуют. Удаляет все прямые разрешения, если они не указаны. Объекты могут наследовать разрешения от корневого объекта.
databricks warehouses set-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Хранилище SQL, для которого требуется получить или управлять разрешениями.
Options
--json JSON
Строка JSON inline или @path к JSON-файлу с телом запроса.
Examples
В следующем примере задаются разрешения для хранилища с помощью JSON-файла:
databricks warehouses set-permissions 1234567890abcdef --json @permissions.json
Склады Databricks обновление разрешений
Обновите разрешения в хранилище SQL. Хранилища SQL могут наследовать разрешения от корневого объекта.
databricks warehouses update-permissions WAREHOUSE_ID [flags]
Arguments
WAREHOUSE_ID
Хранилище SQL, для которого требуется получить или управлять разрешениями.
Options
--json JSON
Строка JSON inline или @path к JSON-файлу с телом запроса.
Examples
В следующем примере обновляются разрешения для хранилища с помощью JSON-файла:
databricks warehouses update-permissions 1234567890abcdef --json @permissions.json
Глобальные флаги
--debug
Следует ли включить ведение журнала отладки.
-h или --help
Отобразить справку по интерфейсу командной строки Databricks, связанной группе команд или отдельной команде.
--log-file струна
Строка, представляющая файл для записи журналов выходных данных. Если этот флаг не указан, по умолчанию используется запись журналов выходных данных в stderr.
--log-format формат
Тип формата журнала: text или json. Значение по умолчанию — text.
--log-level струна
Строка, представляющая уровень формата журнала. Если не указано, уровень формата журнала отключен.
типа -o, --output
Тип выходных данных команды: text или json. Значение по умолчанию — text.
-p, --profile струна
Имя профиля в ~/.databrickscfg файле, используемого для выполнения команды. Если флаг не указан, используется профиль DEFAULT, если он существует.
--progress-format формат
Формат для отображения журналов хода выполнения: default, appendinplace, илиjson
-t, --target струна
Если применимо, целевой объект пакета для использования