Поделиться через

DataOperations Класс

  • Ссылка

DataOperations.

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

Наследование
azure.ai.ml._scope_dependent_operations._ScopeDependentOperations
DataOperations

Конструктор

DataOperations(operation_scope: OperationScope, operation_config: OperationConfig, service_client: AzureMachineLearningWorkspaces | AzureMachineLearningWorkspaces, datastore_operations: DatastoreOperations, **kwargs: Dict)

Параметры

operation_scope
<xref:azure.ai.ml._scope_dependent_operations.OperationScope>
Обязательно

Переменные области для классов операций объекта MLClient.

operation_config
<xref:azure.ai.ml._scope_dependent_operations.OperationConfig>
Обязательно

Общая конфигурация для классов операций объекта MLClient.

service_client
Union[ <xref:azure.ai.ml._restclient.v2023_04_01_preview._azure_machine_learning_workspaces.AzureMachineLearningWorkspaces>, <xref:azure.ai.ml._restclient.v2021_10_01_dataplanepreview._azure_machine_learning_workspaces. AzureMachineLearningWorkspaces>]
Обязательно

Клиент службы, позволяющий конечным пользователям работать с ресурсами рабочей области Машинного обучения Azure (ServiceClient042023Preview или ServiceClient102021Dataplane).

datastore_operations
DatastoreOperations
Обязательно

Представляет клиент для выполнения операций с хранилищами данных.

Методы

archive

Архивация ресурса данных.
create_or_update

Возвращает созданный или обновленный ресурс данных.

Если он еще не находится в хранилище, ресурс будет отправлен в хранилище BLOB-объектов рабочей области.
get

Получение указанного ресурса данных.
import_data

Примечание

Это экспериментальный метод, который может быть изменен в любое время. Дополнительные сведения см. по адресу https://aka.ms/azuremlexperimental.

Возвращает задание импорта данных, которое создает ресурс данных.
list

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

Примечание

Это экспериментальный метод, который может быть изменен в любое время. Дополнительные сведения см. по адресу https://aka.ms/azuremlexperimental.

Вывод списка заданий материализации ресурса.
restore

Восстановление архивного ресурса данных.
share

Примечание

Это экспериментальный метод, который может быть изменен в любое время. Дополнительные сведения см. по адресу https://aka.ms/azuremlexperimental.

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

archive

Архивация ресурса данных.

archive(name: str, version: str | None = None, label: str | None = None, **kwargs) -> None

Параметры

name
str
Обязательно

Имя ресурса данных.

version
str
Обязательно

Версия ресурса данных.

label
str
Обязательно

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

Возвращаемое значение

Нет

Примеры

Пример архивного ресурса данных.


   ml_client.data.archive("data-asset-name")

create_or_update

Возвращает созданный или обновленный ресурс данных.

Если он еще не находится в хранилище, ресурс будет отправлен в хранилище BLOB-объектов рабочей области.

create_or_update(data: Data) -> Data

Параметры

data
Data
Обязательно

Объект ресурса данных.

Возвращаемое значение

Объект ресурса данных.

Возвращаемый тип

Data

Исключения

AssetPathException

Возникает, когда путь артефакта данных уже связан с другим ресурсом

ValidationException

Возникает, если данные не могут быть успешно проверены. Подробные сведения будут указаны в сообщении об ошибке.

EmptyDirectoryError

Возникает, если указанный локальный путь указывает на пустой каталог.

Примеры

Пример создания ресурсов данных.


   from azure.ai.ml.entities import Data

   data_asset_example = Data(name=data_asset_name, version="2.0", path="./sdk/ml/azure-ai-ml/samples/src")
   ml_client.data.create_or_update(data_asset_example)

get

Получение указанного ресурса данных.

get(name: str, version: str | None = None, label: str | None = None) -> Data

Параметры

name
str
Обязательно

Имя ресурса данных.

version
str
Обязательно

Версия ресурса данных.

label
str
Обязательно

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

Возвращаемое значение

Объект ресурса данных.

Возвращаемый тип

Data

Исключения

ValidationException

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

Примеры

Пример получения ресурсов данных.


   ml_client.data.get(name="data-asset-name", version="2.0")

import_data

Примечание

Это экспериментальный метод, который может быть изменен в любое время. Дополнительные сведения см. по адресу https://aka.ms/azuremlexperimental.

Возвращает задание импорта данных, которое создает ресурс данных.

import_data(data_import: DataImport, **kwargs) -> PipelineJob

Параметры

data_import
DataImport
Обязательно

Объект DataImport.

Возвращаемое значение

объект задания импорта данных.

Возвращаемый тип

PipelineJob

Примеры

Пример импорта ресурсов данных.


   from azure.ai.ml.entities._data_import.data_import import DataImport
   from azure.ai.ml.entities._inputs_outputs.external_data import Database

   database_example = Database(query="SELECT ID FROM DataTable", connection="azureml:my_azuresqldb_connection")
   data_import_example = DataImport(
       name="data-asset-name", path="azureml://datastores/workspaceblobstore/paths/", source=database_example
   )
   ml_client.data.import_data(data_import_example)

list

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

list(name: str | None = None, *, list_view_type: ListViewType = ListViewType.ACTIVE_ONLY) -> ItemPaged[Data]

Параметры

name
Optional[str]
Обязательно

Имя определенного ресурса данных(необязательно).

list_view_type

Тип представления для включения или исключения (например) архивных ресурсов данных. По умолчанию: ACTIVE_ONLY.

Возвращаемое значение

Итератор, подобный экземпляру объектов Data

Возвращаемый тип

ItemPaged[Data]

Примеры

Пример перечисления ресурсов данных.


   ml_client.data.list(name="data-asset-name")

list_materialization_status

Примечание

Это экспериментальный метод, который может быть изменен в любое время. Дополнительные сведения см. по адресу https://aka.ms/azuremlexperimental.

Вывод списка заданий материализации ресурса.

list_materialization_status(name: str, *, list_view_type: ListViewType = ListViewType.ACTIVE_ONLY, **kwargs) -> Iterable[PipelineJob]

Параметры

name
str
Обязательно

имя ресурса, создаваемого заданиями материализации.

list_view_type
Optional[<xref:ListViewType>]

Тип представления для включения и исключения (например) архивных заданий. По умолчанию: ACTIVE_ONLY.

Возвращаемое значение

Итератор, подобный экземпляру объектов Job.

Возвращаемый тип

ItemPaged[PipelineJob]

Примеры

Пример списка заданий материализации.


   ml_client.data.list_materialization_status("data-asset-name")

restore

Восстановление архивного ресурса данных.

restore(name: str, version: str | None = None, label: str | None = None, **kwargs) -> None

Параметры

name
str
Обязательно

Имя ресурса данных.

version
str
Обязательно

Версия ресурса данных.

label
str
Обязательно

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

Возвращаемое значение

Нет

Примеры

Пример восстановления ресурса данных.


   ml_client.data.restore("data-asset-name")

share

Примечание

Это экспериментальный метод, который может быть изменен в любое время. Дополнительные сведения см. по адресу https://aka.ms/azuremlexperimental.

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

share(name, version, *, share_with_name, share_with_version, registry_name, **kwargs) -> Data

Параметры

name
str
Обязательно

Имя ресурса данных.

version
str
Обязательно

Версия ресурса данных.

share_with_name
str

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

share_with_version
str

Версия ресурса данных для совместного использования.

registry_name
str

Имя целевого реестра.

Возвращаемое значение

Объект ресурса данных.

Возвращаемый тип

Data

Примеры

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


       ml_client.data.share(
           name="data-asset-name",
           version="2.0",
           registry_name="my-registry",
           share_with_name="transformed-nyc-taxi-data-shared-from-ws",
           share_with_version="2.0",
       )