registered-models группа команд

Note

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

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

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

создать зарегистрированные модели в databricks

Создайте зарегистрированную модель в каталоге Unity.

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

Для успешного создания зарегистрированной модели пользователь должен выполнить следующие условия:

• Вызывающий должен быть администратором хранилища метаданных или быть владельцем родительского каталога или родительской схемы, или иметь USE_CATALOG привилегии на родительский каталог и USE_SCHEMA привилегии на родительскую схему.
• Вызывающий объект должен иметь привилегию CREATE MODEL или CREATE FUNCTION для родительской схемы.

databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]

Arguments

CATALOG_NAME

    Имя каталога, в котором находится схема и зарегистрированная модель.

SCHEMA_NAME

    Имя схемы, в которой находится зарегистрированная модель.

NAME

    Имя зарегистрированной модели.

Options

--comment string

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

--json JSON

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

--storage-location string

    Расположение хранилища в облаке, в котором хранятся файлы данных версии модели.

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

Examples

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

databricks registered-models create main my_schema my_model

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

databricks registered-models create main my_schema my_model --comment "My model description"

удаление зарегистрированных моделей databricks

Удалите зарегистрированную модель и все ее версии из указанного родительского каталога и схемы.

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

databricks registered-models delete FULL_NAME [flags]

Arguments

FULL_NAME

    Трехуровневое (полностью квалифицированное) имя зарегистрированной модели.

Options

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

Examples

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

databricks registered-models delete main.my_schema.my_model

databricks зарегистрированные модели delete-alias

Удалите зарегистрированный псевдоним модели.

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

databricks registered-models delete-alias FULL_NAME ALIAS [flags]

Arguments

FULL_NAME

    Трехуровневое (полностью квалифицированное) имя зарегистрированной модели.

ALIAS

    Имя псевдонима.

Options

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

Examples

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

databricks registered-models delete-alias main.my_schema.my_model production

Получение зарегистрированных моделей Databricks

Получение зарегистрированной модели.

Пользователь должен быть администратором хранилища метаданных или владельцем зарегистрированной модели (или иметь на неё EXECUTE права). В последнем случае вызывающий объект также должен быть владельцем или иметь USE_CATALOG привилегии в родительском каталоге и USE_SCHEMA привилегии родительской схемы.

databricks registered-models get FULL_NAME [flags]

Arguments

FULL_NAME

    Трехуровневое (полностью квалифицированное) имя зарегистрированной модели.

Options

--include-aliases

    Следует ли включать в ответ зарегистрированные псевдонимы модели.

--include-browse

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

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

Examples

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

databricks registered-models get main.my_schema.my_model

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

databricks registered-models get main.my_schema.my_model --include-aliases

список зарегистрированных моделей databricks

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

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

В ответе не гарантируется определенное упорядочение элементов.

databricks registered-models list [flags]

Options

--catalog-name string

    Идентификатор каталога, в котором будут перечислены зарегистрированные модели.

--include-browse

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

--max-results int

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

--page-token string

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

--schema-name string

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

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

Examples

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

databricks registered-models list

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

databricks registered-models list --catalog-name main

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

databricks registered-models list --catalog-name main --schema-name my_schema

databricks зарегистрированные модели set-alias

Задайте псевдоним для указанной зарегистрированной модели.

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

databricks registered-models set-alias FULL_NAME ALIAS VERSION_NUM [flags]

Arguments

FULL_NAME

    Полное имя зарегистрированной модели.

ALIAS

    Имя псевдонима.

VERSION_NUM

    Номер версии модели, на которую указывает псевдоним.

Options

--json JSON

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

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

Examples

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

databricks registered-models set-alias main.my_schema.my_model production 1

Обновление моделей, зарегистрированных в Databricks

Обновите указанную зарегистрированную модель.

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

В настоящее время можно обновить только имя, имя владельца или комментарии к зарегистрированной модели.

databricks registered-models update FULL_NAME [flags]

Arguments

FULL_NAME

    Трехуровневое (полностью квалифицированное) имя зарегистрированной модели.

Options

--comment string

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

--json JSON

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

`--new-name string`**

    Новое имя зарегистрированной модели.

--owner string

    Идентификатор пользователя, которому принадлежит зарегистрированная модель.

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

Examples

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

databricks registered-models update main.my_schema.my_model --comment "Updated model description"

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

databricks registered-models update main.my_schema.my_model --new-name my_new_model

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

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

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