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

Note

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

Группа metastores команд в интерфейсе командной строки Databricks позволяет управлять хранилищами метаданных. Хранилище метаданных — это контейнер верхнего уровня объектов в каталоге Unity. Он хранит ресурсы данных (таблицы и представления) и разрешения, которые управляют доступом к ним. См. раздел "Хранилище метаданных".

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

Создайте новое назначение хранилища метаданных. Если назначение для того же workspace_id существует, оно будет перезаписано новым metastore_id и default_catalog_name. Вызвавший должен быть администратором учетной записи.

databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]

Arguments

WORKSPACE_ID

    Идентификатор рабочей области.

METASTORE_ID

    Уникальный идентификатор хранилища метаданных.

DEFAULT_CATALOG_NAME

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

Options

--json JSON

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

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

Examples

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

databricks metastores assign 123456789 abc123-def456-ghi789 main

создание хранилищ метаданных databricks

Создайте новое метахранилище на основе предоставленного имени и необязательного корневого пути к хранилищу. По умолчанию (если поле владельца не задано), владелец нового хранилища метаданных является пользователем, вызывающим API createMetastore. Если для поля владельца задана пустая строка (""), вместо этого пользователю системы назначается право владения.

databricks metastores create NAME [flags]

Arguments

NAME

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

Options

--json JSON

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

--region string

    Облачный регион, обслуживающий хранилище метаданных (например, us-west-2, westus).

--storage-root string

    URL-адрес корневого хранилища для хранилища метаданных.

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

Examples

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

databricks metastores create my-metastore --storage-root s3://my-bucket/metastore-root --region us-west-2

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

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

databricks metastores current [flags]

Options

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

Examples

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

databricks metastores current

Удалить метасторы Databricks

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

databricks metastores delete ID [flags]

Arguments

ID

    Уникальный идентификатор хранилища метаданных.

Options

--force

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

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

Examples

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

databricks metastores delete abc123-def456-ghi789

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

databricks metastores delete abc123-def456-ghi789 --force

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

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

databricks metastores get ID [flags]

Arguments

ID

    Уникальный идентификатор хранилища метаданных.

Options

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

Examples

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

databricks metastores get abc123-def456-ghi789

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

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

databricks metastores list [flags]

Options

--limit int

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

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

Examples

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

databricks metastores list

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

databricks metastores list --limit 10

Сводка по метахранилищам Databricks

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

databricks metastores summary [flags]

Options

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

Examples

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

databricks metastores summary

хранилище метаданных databricks отменить назначение

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

databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]

Arguments

WORKSPACE_ID

    Идентификатор рабочей области.

METASTORE_ID

    Запрос идентификатора хранилища метаданных для удаления.

Options

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

Examples

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

databricks metastores unassign 123456789 abc123-def456-ghi789

Обновление хранилищ метаданных Databricks

Обновите сведения для определенного хранилища метаданных. Вызывающий должен быть администратором Metastore. Если для поля владельца задана пустая строка (""), владение обновляется на Системного Пользователя.

databricks metastores update ID [flags]

Arguments

ID

    Уникальный идентификатор хранилища метаданных.

Options

--delta-sharing-organization-name string

    Имя организации сущности OpenSharing для использования в Databricks-to-Databricks OpenSharing в качестве официального имени.

--delta-sharing-recipient-token-lifetime-in-seconds int

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

--delta-sharing-scope DeltaSharingScopeEnum

    Область OpenSharing, включенная для хранилища метаданных. Поддерживаемые значения: INTERNAL, INTERNAL_AND_EXTERNAL

--json JSON

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

--new-name string

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

--owner string

    Владелец хранилища метаданных.

--privilege-model-version string

    Версия модели привилегий метастора в формате major.minor (например, 1.0).

--storage-root-credential-id string

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

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

Examples

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

databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore

В следующем примере обновляется хранилище метаданных с помощью конфигурации OpenSharing:

databricks metastores update abc123-def456-ghi789 --delta-sharing-scope INTERNAL_AND_EXTERNAL --delta-sharing-organization-name my-org

databricks метахранилища обновить-назначение

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

databricks metastores update-assignment WORKSPACE_ID [flags]

Arguments

WORKSPACE_ID

    Идентификатор рабочей области.

Options

--default-catalog-name string

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

--json JSON

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

--metastore-id string

    Уникальный идентификатор хранилища метаданных.

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

Examples

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

databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog

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

databricks metastores update-assignment 123456789 --metastore-id new-metastore-id

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

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

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