external-locations группа команд

Note

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

Группа external-locations команд в интерфейсе командной строки Databricks содержит команды для создания внешних расположений для каталога Unity и управления ими. См. статью Что такое тома каталога Unity?.

создание внешних местоположений databricks

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

databricks external-locations create NAME URL CREDENTIAL_NAME [flags]

Arguments

NAME

    Имя внешнего расположения.

URL

    URL путь внешнего местоположения.

CREDENTIAL_NAME

    Имя учетной записи хранилища, используемой в этом расположении.

Options

--comment string

    Описание текста произвольной формы, предоставленного пользователем.

--enable-file-events

    Следует ли включить события файлов в этом внешнем расположении.

--fallback

    Указывает, включен ли резервный режим для этого внешнего расположения.

--json JSON

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

--read-only

    Указывает, является ли внешнее расположение доступным только для чтения.

--skip-validation

    Пропускает проверку учетных данных хранилища, связанных с внешним расположением.

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

Examples

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

databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"

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

databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only

удаление внешних локаций Databricks

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

databricks external-locations delete NAME [flags]

Arguments

NAME

    Имя внешнего расположения.

Options

--force

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

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

Examples

В следующем примере удаляется внешняя директория с именем my-external-location:

databricks external-locations delete my-external-location

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

databricks external-locations delete my-external-location --force

получение данных databricks external-locations

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

databricks external-locations get NAME [flags]

Arguments

NAME

    Имя внешнего расположения.

Options

--include-browse

    Следует ли включать внешние расположения в ответ, для которого субъект может получить доступ только к выборочным метаданным.

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

Examples

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

databricks external-locations get my-external-location

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

databricks external-locations get my-external-location --include-browse

список внешних расположений для Databricks

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

databricks external-locations list [flags]

Options

--include-browse

    Следует ли включать внешние расположения в ответ, для которого субъект может получить доступ только к выборочным метаданным.

--include-unbound

    Следует ли включать внешние расположения, не привязанные к рабочей области.

--max-results int

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

--page-token string

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

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

Examples

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

databricks external-locations list

В следующем примере перечислены внешние расположения с максимальным числом результатов 10.

databricks external-locations list --max-results 10

Обновление внешних местоположений Databricks

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

databricks external-locations update NAME [flags]

Arguments

NAME

    Имя внешнего расположения.

Options

--comment string

    Описание текста произвольной формы, предоставленного пользователем.

--credential-name string

    Имя учетной записи хранилища, используемой в этом расположении.

--enable-file-events

    Следует ли включить события файлов в этом внешнем расположении.

--fallback

    Указывает, включен ли резервный режим для этого внешнего расположения.

--force

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

--isolation-mode IsolationMode

    Поддерживаемые значения: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN

--json JSON

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

--new-name string

    Новое имя внешней локализации.

--owner string

    Владелец внешней площадки.

--read-only

    Указывает, является ли внешнее расположение доступным только для чтения.

--skip-validation

    Пропускает проверку учетных данных хранилища, связанных с внешним расположением.

--url string

    URL путь внешнего местоположения.

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

Examples

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

databricks external-locations update my-external-location --new-name my-renamed-location

В следующем примере изменяется владелец внешнего хранилища.

databricks external-locations update my-external-location --owner someone@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 струна

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