DataOperations Clase

  • Referencia

DataOperations.

No debe crear una instancia de esta clase directamente. En su lugar, debe crear una instancia de MLClient que le cree instancias y la adjunte como un atributo.

Herencia
azure.ai.ml._scope_dependent_operations._ScopeDependentOperations
DataOperations

Constructor

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

Parámetros

operation_scope
<xref:azure.ai.ml._scope_dependent_operations.OperationScope>
Requerido

Variables de ámbito para las clases de operaciones de un objeto MLClient.

operation_config
<xref:azure.ai.ml._scope_dependent_operations.OperationConfig>
Requerido

Configuración común para las clases de operaciones de un objeto 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>]
Requerido

Cliente de servicio para permitir que los usuarios finales funcionen en recursos del área de trabajo de Azure Machine Learning (ServiceClient042023Preview o ServiceClient102021Dataplane).

datastore_operations
DatastoreOperations
Requerido

Representa un cliente para realizar operaciones en almacenes de datos.

Métodos

archive

Archivar un recurso de datos.
create_or_update

Devuelve el recurso de datos creado o actualizado.

Si aún no está en el almacenamiento, el recurso se cargará en el almacenamiento de blobs del área de trabajo.
get

Obtiene el recurso de datos especificado.
import_data

Nota

Se trata de un método experimental y puede cambiar en cualquier momento. Consulte https://aka.ms/azuremlexperimental para más información.

Devuelve el trabajo de importación de datos que crea el recurso de datos.
list

Enumere los recursos de datos del área de trabajo.
list_materialization_status

Nota

Se trata de un método experimental y puede cambiar en cualquier momento. Consulte https://aka.ms/azuremlexperimental para más información.

Enumera los trabajos de materialización del recurso.
restore

Restaure un recurso de datos archivado.
share

Nota

Se trata de un método experimental y puede cambiar en cualquier momento. Consulte https://aka.ms/azuremlexperimental para más información.

Comparta un recurso de datos del área de trabajo al registro.

archive

Archivar un recurso de datos.

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

Parámetros

name
str
Requerido

Nombre del recurso de datos.

version
str
Requerido

Versión del recurso de datos.

label
str
Requerido

Etiqueta del recurso de datos. (mutuamente excluyente con la versión)

Devoluciones

Ninguno

Ejemplos

Ejemplo de recurso de datos de archivo.


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

create_or_update

Devuelve el recurso de datos creado o actualizado.

Si aún no está en el almacenamiento, el recurso se cargará en el almacenamiento de blobs del área de trabajo.

create_or_update(data: Data) -> Data

Parámetros

data
Data
Requerido

Objeto de recurso de datos.

Devoluciones

Objeto de recurso de datos.

Tipo de valor devuelto

Data

Excepciones

AssetPathException

Se genera cuando la ruta de acceso del artefacto de datos ya está vinculada a otro recurso

ValidationException

Se genera si los datos no se pueden validar correctamente. Los detalles se proporcionarán en el mensaje de error.

EmptyDirectoryError

Se genera si la ruta de acceso local proporcionada apunta a un directorio vacío.

Ejemplos

Ejemplo de creación de recursos de datos.


   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

Obtiene el recurso de datos especificado.

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

Parámetros

name
str
Requerido

Nombre del recurso de datos.

version
str
Requerido

Versión del recurso de datos.

label
str
Requerido

Etiqueta del recurso de datos. (mutuamente excluyente con la versión)

Devoluciones

Objeto de recurso de datos.

Tipo de valor devuelto

Data

Excepciones

ValidationException

Se genera si los datos no se pueden identificar y recuperar correctamente. Los detalles se proporcionarán en el mensaje de error.

Ejemplos

Ejemplo de obtención de recursos de datos.


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

import_data

Nota

Se trata de un método experimental y puede cambiar en cualquier momento. Consulte https://aka.ms/azuremlexperimental para más información.

Devuelve el trabajo de importación de datos que crea el recurso de datos.

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

Parámetros

data_import
DataImport
Requerido

Objeto DataImport.

Devoluciones

objeto de trabajo de importación de datos.

Tipo de valor devuelto

PipelineJob

Ejemplos

Ejemplo de importación de recursos de datos.


   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

Enumere los recursos de datos del área de trabajo.

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

Parámetros

name
Optional[str]
Requerido

Nombre de un recurso de datos específico, opcional.

list_view_type

Tipo de vista para incluir o excluir (por ejemplo) recursos de datos archivados. Valor predeterminado: ACTIVE_ONLY.

Devoluciones

Iterador como la instancia de objetos Data

Tipo de valor devuelto

ItemPaged[Data]

Ejemplos

Ejemplo de recursos de datos de lista.


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

list_materialization_status

Nota

Se trata de un método experimental y puede cambiar en cualquier momento. Consulte https://aka.ms/azuremlexperimental para más información.

Enumera los trabajos de materialización del recurso.

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

Parámetros

name
str
Requerido

nombre del recurso que crean los trabajos de materialización.

list_view_type
Optional[<xref:ListViewType>]

Tipo de vista para incluir o excluir (por ejemplo) trabajos archivados. Valor predeterminado: ACTIVE_ONLY.

Devoluciones

Iterador como la instancia de objetos Job.

Tipo de valor devuelto

ItemPaged[PipelineJob]

Ejemplos

Ejemplo de trabajos de materialización de lista.


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

restore

Restaure un recurso de datos archivado.

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

Parámetros

name
str
Requerido

Nombre del recurso de datos.

version
str
Requerido

Versión del recurso de datos.

label
str
Requerido

Etiqueta del recurso de datos. (mutuamente excluyente con la versión)

Devoluciones

Ninguno

Ejemplos

Ejemplo de recurso de datos de restauración.


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

share

Nota

Se trata de un método experimental y puede cambiar en cualquier momento. Consulte https://aka.ms/azuremlexperimental para más información.

Comparta un recurso de datos del área de trabajo al registro.

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

Parámetros

name
str
Requerido

Nombre del recurso de datos.

version
str
Requerido

Versión del recurso de datos.

share_with_name
str

Nombre del recurso de datos con el que se va a compartir.

share_with_version
str

Versión del recurso de datos con la que se va a compartir.

registry_name
str

Nombre del registro de destino.

Devoluciones

Objeto de recurso de datos.

Tipo de valor devuelto

Data

Ejemplos

Ejemplo de recurso compartido de datos.


       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",
       )