az ml datastore

Примечание.

Эта ссылка является частью расширения ml для Azure CLI (версия 2.15.0 или более поздней). Расширение автоматически установит команду az ml datastore при первом запуске. Подробнее о расширениях.

Управление хранилищами данных Машинного обучения Azure.

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

При создании рабочей области учетная запись служба хранилища Azure автоматически создается в качестве связанного ресурса. Контейнер BLOB-объектов создается в этой учетной записи, а его сведения о подключении хранятся в качестве хранилища данных с именем Workspaceblobstore. Это служит хранилищем данных по умолчанию рабочей области, а контейнер BLOB-объектов используется для хранения артефактов рабочей области и журналов заданий машинного обучения и выходных данных.

Команды

Имя Описание Тип Состояние
az ml datastore create

Создайте хранилище данных.

Расширение Общедоступная версия
az ml datastore delete

Удаление хранилища данных.

Расширение Общедоступная версия
az ml datastore list

Вывод списка хранилищ данных в рабочей области.

Расширение Общедоступная версия
az ml datastore mount

Подключите определенное хранилище данных к локальному пути. Сейчас поддерживается только Linux.

Расширение Предварительный просмотр
az ml datastore show

Отображение сведений о хранилище данных.

Расширение Общедоступная версия
az ml datastore update

Обновление хранилища данных.

Расширение Общедоступная версия

az ml datastore create

Создайте хранилище данных.

Это подключает базовую службу хранилища Azure к рабочей области. Типы служб хранилища, к которым можно подключиться, создав хранилище данных, включают хранилище BLOB-объектов Azure, общую папку Azure, azure Data Lake Storage 1-го поколения и Azure Data Lake Storage 2-го поколения.

az ml datastore create --file
                       --resource-group
                       --workspace-name
                       [--name]
                       [--set]

Примеры

Создание хранилища данных из файла спецификации YAML

az ml datastore create --file blobstore.yml --resource-group my-resource-group --workspace-name my-workspace

Обязательные параметры

--file -f

Локальный путь к YAML-файлу, содержаму спецификацию хранилища данных Машинного обучения Azure. Справочные документы YAML для хранилища данных можно найти по адресу: https://aka.ms/ml-cli-v2-datastore-blob-yaml-reference, https://aka.ms/ml-cli-v2-datastore-file-yaml-reference, https://aka.ms/ml-cli-v2-datastore-data-lake-gen1-yaml-reference. https://aka.ms/ml-cli-v2-datastore-data-lake-gen2-yaml-reference

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Необязательные параметры

--name -n

Имя хранилища данных. Это перезаписывает поле "имя" в ФАЙЛЕ YAML, предоставленном --file/-f.

--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

az ml datastore delete

Удаление хранилища данных.

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

az ml datastore delete --name
                       --resource-group
                       --workspace-name

Обязательные параметры

--name -n

Имя хранилища данных.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

az ml datastore list

Вывод списка хранилищ данных в рабочей области.

az ml datastore list --resource-group
                     --workspace-name
                     [--max-results]

Примеры

Перечислите все хранилища данных в рабочей области с помощью аргумента --query для выполнения запроса JMESPath в результатах команд.

az ml datastore list --query "[].{Name:name}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Обязательные параметры

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Необязательные параметры

--max-results -r

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

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

az ml datastore mount

Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Подключите определенное хранилище данных к локальному пути. Сейчас поддерживается только Linux.

az ml datastore mount --path
                      [--mode]
                      [--mount-point]
                      [--persistent]
                      [--resource-group]
                      [--workspace-name]

Примеры

Подключение хранилища данных по имени

az ml datastore mount --mount-point /mnt/my-datastore --mode ro_mount --path my-datastore

Подключение хранилища данных по URL-адресу короткой формы хранилища данных

az ml datastore mount --mount-point /mnt/my-datastore --mode ro_mount --path azureml://datastores/my-datastore

Подключение хранилища данных по URL-адресу длинной формы хранилища данных

az ml datastore mount --mount-point /mnt/my-datastore --mode ro_mount --path azureml://subscriptions/my-sub-id/resourcegroups/my-rg/providers/Microsoft.MachineLearningServices/workspaces/myworkspace/datastores/my-datastore

Обязательные параметры

--path

Путь к хранилищу данных для подключения в виде <datastore_name> или azureml://datastores/<datastore_name>.

Необязательные параметры

--mode

Режим подключения( ro_mount только для чтения) или rw_mount (чтение-запись).

значение по умолчанию: ro_mount
--mount-point

Локальный путь, используемый в качестве точки подключения.

значение по умолчанию: /home/azureuser/mount/data
--persistent

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

значение по умолчанию: False
--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

az ml datastore show

Отображение сведений о хранилище данных.

az ml datastore show --name
                     --resource-group
                     --workspace-name

Обязательные параметры

--name -n

Имя хранилища данных.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

az ml datastore update

Обновление хранилища данных.

Можно обновить свойства "description", "tags" и "credential".

az ml datastore update --resource-group
                       --workspace-name
                       [--add]
                       [--file]
                       [--force-string]
                       [--name]
                       [--remove]
                       [--set]

Обязательные параметры

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Необязательные параметры

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

значение по умолчанию: []
--file -f

Локальный путь к YAML-файлу, содержаму спецификацию хранилища данных Машинного обучения Azure. Справочные документы YAML для хранилища данных можно найти по адресу: https://aka.ms/ml-cli-v2-datastore-blob-yaml-reference, https://aka.ms/ml-cli-v2-datastore-file-yaml-reference, https://aka.ms/ml-cli-v2-datastore-data-lake-gen1-yaml-reference. https://aka.ms/ml-cli-v2-datastore-data-lake-gen2-yaml-reference

--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

значение по умолчанию: False
--name -n

Имя хранилища данных. Это перезаписывает поле "имя" в ФАЙЛЕ YAML, предоставленном --file/-f.

--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

значение по умолчанию: []
--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

значение по умолчанию: []
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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