storage-credentials группа команд

Note

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

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

Группа storage-credentials команд в интерфейсе командной строки Databricks содержит команды для управления учетными данными хранения в каталоге Unity. Учетные данные хранилища представляют механизм проверки подлинности и авторизации для доступа к данным, хранящимся в облачном клиенте. Каждые учетные данные хранения подлежат политикам управления доступом каталога Unity, которые определяют, какие пользователи и группы могут получить доступ к учетным данным. Если у пользователя нет доступа к учетным данным хранилища в каталоге Unity, запрос завершается ошибкой, и каталог Unity не пытается пройти проверку подлинности в облачном клиенте от имени пользователя. См. раздел "Управление учетными данными хранилища".

создание данных databricks storage-credentials

Создайте учетные данные для хранения данных.

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

databricks storage-credentials create NAME [flags]

Arguments

NAME

    Имя учетных данных. Имя должно быть уникальным среди учетных данных хранилища и службы в метахранилище.

Options

--comment string

    Комментарий, связанный с учетными данными.

--json JSON

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

--read-only

    Можно ли использовать учетные данные только для операций чтения.

--skip-validation

    Если задать значение true для этого аргумента, проверка созданных учетных данных пропускается.

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

Examples

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

databricks storage-credentials create my-storage-credential

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

databricks storage-credentials create my-storage-credential --comment "S3 credential for analytics data"

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

databricks storage-credentials create my-storage-credential --read-only

удаление учетных данных хранилища databricks

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

databricks storage-credentials delete NAME [flags]

Arguments

NAME

    Имя учетных данных хранилища.

Options

--force

    Выполните принудительное обновление, даже если существуют зависимые внешние расположения или внешние таблицы (если целью является STORAGE) или зависимые службы (если целью является SERVICE).

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

Examples

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

databricks storage-credentials delete my-storage-credential

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

databricks storage-credentials delete my-storage-credential --force

получение данных databricks storage-credentials

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

databricks storage-credentials get NAME [flags]

Arguments

NAME

    Имя учетных данных хранилища.

Options

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

Examples

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

databricks storage-credentials get my-storage-credential

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

Список учетных данных хранилища. Список ограничен только теми учетными данными хранилища, к которым запрашивающий имеет разрешение на доступ. Если вызывающий является администратором метахранилища, получение учетных данных является неограниченным. Никакой гарантии упорядочения элементов в массиве нет.

databricks storage-credentials list [flags]

Options

--max-results int

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

--page-token string

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

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

Examples

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

databricks storage-credentials list

обновить учетные данные хранилища databricks

Обновите учетные данные для доступа к хранилищу в метахранилище.

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

databricks storage-credentials update NAME [flags]

Arguments

NAME

    Имя учетных данных хранилища.

Options

--comment string

    Комментарий, связанный с учетными данными.

--force

    Принудительное обновление даже при наличии зависимых внешних расположений или внешних таблиц.

--isolation-mode IsolationMode

    Доступен ли текущий защищаемый объект из всех рабочих областей или определенного набора рабочих областей. Поддерживаемые значения: [ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN]

--json JSON

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

--new-name string

    Новое имя учетных данных хранилища.

--owner string

    Имя пользователя текущего владельца учетных данных.

--read-only

    Можно ли использовать учетные данные только для операций чтения.

--skip-validation

    Если в этом аргументе задано значение true, проверка обновленных учетных данных пропускается.

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

Examples

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

databricks storage-credentials update my-storage-credential --comment "Updated S3 credential"

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

databricks storage-credentials update my-storage-credential --owner someone@example.com

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

databricks storage-credentials update my-storage-credential --new-name updated-credential

валидация учетных данных хранения databricks

Проверка учетных данных хранилища. По крайней мере один из external_location_name и url должен быть предоставлен. Если предоставляется только один из них, он будет использоваться для проверки. Если оба указаны, url будет использоваться для проверки, а external_location_name будет игнорироваться при проверке на совпадение URL-адресов.

Либо учетные данные storage_credential_name, либо учетные данные, относящиеся к облаку, должны быть предоставлены.

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

databricks storage-credentials validate [flags]

Options

--external-location-name string

    Имя существующего внешнего местоположения для валидации.

--json JSON

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

--read-only

    Можно ли использовать учетные данные хранилища только для операций чтения.

--storage-credential-name string

    Required.

--url string

    URL-адрес внешнего расположения для проверки.

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

Examples

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

databricks storage-credentials validate --storage-credential-name my-storage-credential --external-location-name my-external-location

В следующем примере проверяются учетные данные хранилища с помощью URL-адреса.

databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path

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

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

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