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

Note

Эта информация относится к Интерфейсу командной строки Databricks версии 0.205 и выше. Интерфейс командной строки Databricks находится в общедоступной предварительной версии.

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

Группа providers команд в Databricks CLI содержит команды для управления поставщиками Delta sharing. Поставщик данных представляет организацию в реальном мире, которая предоставляет общий доступ к данным. См. Что такое Delta Sharing?.

Создание поставщиков в Databricks

Создайте нового поставщика проверки подлинности, минимально используя имя и тип аутентификации. Вызывающий объект должен быть администратором в хранилище метаданных.

databricks providers create NAME AUTHENTICATION_TYPE [flags]

Arguments

NAME

    Имя поставщика.

AUTHENTICATION_TYPE

    Тип аутентификации для delta sharing. Поддерживаемые значения: DATABRICKS, OAUTH_CLIENT_CREDENTIALS, OIDC_FEDERATION, TOKEN

Options

--comment string

    Описание поставщика.

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

--recipient-profile-str string

    Это поле необходимо, если authentication_type — TOKEN, OAUTH_CLIENT_CREDENTIALS или не указано.

Глобальные флаги

Examples

В следующем примере создается поставщик с TOKEN-аутентификацией:

databricks providers create my_provider TOKEN --comment "My data provider" --recipient-profile-str "my_profile"

В следующем примере создается поставщик с проверкой подлинности DATABRICKS:

databricks providers create my_provider DATABRICKS --comment "Internal provider"

Удаление поставщиков Databricks

Удалите поставщика проверки подлинности, если вызывающий является администратором хранилища метаданных или является владельцем поставщика.

databricks providers delete NAME [flags]

Arguments

NAME

    Имя поставщика.

Options

Глобальные флаги

Examples

В следующем примере удаляется поставщик:

databricks providers delete my_provider

получение данных о поставщиках для databricks

Выберите конкретного провайдера аутентификации. Вызывающий объект должен указать имя поставщика и должен быть администратором хранилища метаданных или владельцем поставщика.

databricks providers get NAME [flags]

Arguments

NAME

    Имя поставщика.

Options

Глобальные флаги

Examples

В следующем примере показано, как получить сведения о поставщике:

databricks providers get my_provider

Список поставщиков Databricks

Список доступных поставщиков проверки подлинности. Вызывающий объект должен быть администратором хранилища метаданных или владельцем поставщиков. Поставщики, не принадлежащие вызывающему абоненту, не включаются в ответ. Никакой гарантии упорядочения элементов в массиве нет.

databricks providers list [flags]

Options

--data-provider-global-metastore-id string

    Если это не указано, будут возвращены все поставщики.

--max-results int

    Максимальное количество возвращаемых поставщиков.

--page-token string

    Непрозрачный маркер разбиения на страницы, чтобы перейти на следующую страницу на основе предыдущего запроса.

Глобальные флаги

Examples

В следующем примере перечислены все поставщики:

databricks providers list

В следующем примере перечислены поставщики с разбивкой на страницы:

databricks providers list --max-results 10

В следующем примере перечислены поставщики для определенного хранилища метаданных:

databricks providers list --data-provider-global-metastore-id "my-metastore-id"

поставщики databricks list-provider-share-assets

Перечислить активы, связанные с долей указанного поставщика. Звонящий является получателем совместного доступа.

databricks providers list-provider-share-assets PROVIDER_NAME SHARE_NAME [flags]

Arguments

PROVIDER_NAME

    Имя поставщика, которому принадлежит общий ресурс.

SHARE_NAME

    Имя общей папки.

Options

--function-max-results int

    Максимальное количество функций, которые можно вернуть.

--notebook-max-results int

    Максимальное количество возвращаемых записных книжек.

--table-max-results int

    Максимальное количество возвращаемых таблиц.

--volume-max-results int

    Максимальное количество возвращаемых томов.

Глобальные флаги

Examples

В следующем примере перечислены все ресурсы в общей папке поставщика:

databricks providers list-provider-share-assets my_provider my_share

В следующем примере перечислены ресурсы с ограничениями для каждого типа:

databricks providers list-provider-share-assets my_provider my_share --table-max-results 5 --function-max-results 3

databricks поставщики список-долей

Список акций указанного поставщика в хранилище метаданных, где:

• вызывающий объект является администратором хранилища метаданных,
• или вызывающий является владельцем.

databricks providers list-shares NAME [flags]

Arguments

NAME

    Название поставщика, в котором нужно перечислить акции.

Options

--max-results int

    Максимальное количество возвращаемых акций.

--page-token string

    Непрозрачный маркер разбиения на страницы, чтобы перейти на следующую страницу на основе предыдущего запроса.

Глобальные флаги

Examples

В следующем примере перечислены все ресурсы общего доступа для поставщика:

databricks providers list-shares my_provider

В следующем примере перечислены общие папки с разбивкой на страницы:

databricks providers list-shares my_provider --max-results 10

Обновление провайдеров Databricks

Обновите сведения для поставщика проверки подлинности, если вызывающий является администратором хранилища метаданных или является владельцем поставщика. Если обновление изменяет имя поставщика, вызывающий объект должен быть как администратором хранилища метаданных, так и владельцем поставщика.

databricks providers update NAME [flags]

Arguments

NAME

    Имя поставщика.

Options

--comment string

    Описание поставщика.

--json JSON

    Строка JSON inline или @path к JSON-файлу с телом запроса.

--new-name string

    Новое имя поставщика.

--owner string

    Имя пользователя владельца поставщика.

--recipient-profile-str string

    Это поле необходимо, если authentication_type — TOKEN, OAUTH_CLIENT_CREDENTIALS или не указано.

Глобальные флаги

Examples

В следующем примере обновляется комментарий поставщика:

databricks providers update my_provider --comment "Updated provider description"

В следующем примере обновляется имя и владелец поставщика:

databricks providers update my_provider --new-name "my_new_provider" --owner "new_owner@example.com"

Глобальные флаги

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

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