warehouses группа команд

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 струна

    Если применимо, целевой объект пакета для использования