DataOperations Classe

DataOperations.

Você não deve instanciar essa classe diretamente. Em vez disso, você deve criar uma instância do MLClient que a instancie para você e a anexa como um atributo.

Herança

azure.ai.ml._scope_dependent_operations._ScopeDependentOperations

DataOperations

Construtor

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>

Obrigatório

Variáveis de escopo para as classes de operações de um objeto MLClient.

operation_config

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

Obrigatório

Configuração comum para classes de operações de um 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>]

Obrigatório

Cliente de serviço para permitir que os usuários finais operem nos recursos do Workspace do Azure Machine Learning (ServiceClient042023Preview ou ServiceClient102021Dataplane).

datastore_operations

DatastoreOperations

Obrigatório

Representa um cliente para executar operações em Armazenamentos de Dados.

Métodos

archive	Arquive um ativo de dados.
create_or_update	Retorna o ativo de dados criado ou atualizado. Se ainda não estiver no armazenamento, o ativo será carregado no armazenamento de blobs do workspace.
get	Obtenha o ativo de dados especificado.
import_data	Observação Esse é um método experimental e pode mudar a qualquer momento. Consulte https://aka.ms/azuremlexperimental para obter mais informações. Retorna o trabalho de importação de dados que está criando o ativo de dados.
list	Liste os ativos de dados do workspace.
list_materialization_status	Observação Esse é um método experimental e pode mudar a qualquer momento. Consulte https://aka.ms/azuremlexperimental para obter mais informações. Listar trabalhos de materialização do ativo.
restore	Restaurar um ativo de dados arquivado.
share	Observação Esse é um método experimental e pode mudar a qualquer momento. Consulte https://aka.ms/azuremlexperimental para obter mais informações. Compartilhe um ativo de dados do workspace para o registro.

archive

Arquive um ativo de dados.

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

Parâmetros

name

str

Obrigatório

Nome do ativo de dados.

version

str

Obrigatório

Versão do ativo de dados.

label

str

Obrigatório

Rótulo do ativo de dados. (mutuamente exclusivo com a versão)

Retornos

Nenhum

Exemplos

Exemplo de ativo de dados de arquivo morto.

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

create_or_update

Retorna o ativo de dados criado ou atualizado.

Se ainda não estiver no armazenamento, o ativo será carregado no armazenamento de blobs do workspace.

create_or_update(data: Data) -> Data

Parâmetros

data

Data

Obrigatório

Objeto de ativo de dados.

Retornos

Objeto de ativo de dados.

Tipo de retorno

Data

Exceções

AssetPathException

Gerado quando o caminho do artefato de dados já está vinculado a outro ativo

ValidationException

Gerado se Os dados não puderem ser validados com êxito. Os detalhes serão fornecidos na mensagem de erro.

EmptyDirectoryError

Gerado se o caminho local fornecido apontar para um diretório vazio.

Exemplos

Exemplo de criar ativos de dados.

   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

Obtenha o ativo de dados especificado.

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

Parâmetros

name

str

Obrigatório

Nome do ativo de dados.

version

str

Obrigatório

Versão do ativo de dados.

label

str

Obrigatório

Rótulo do ativo de dados. (mutuamente exclusivo com a versão)

Retornos

Objeto de ativo de dados.

Tipo de retorno

Data

Exceções

ValidationException

Gerado se os dados não puderem ser identificados e recuperados com êxito. Os detalhes serão fornecidos na mensagem de erro.

Exemplos

Obter exemplo de ativos de dados.

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

import_data

Observação

Esse é um método experimental e pode mudar a qualquer momento. Consulte https://aka.ms/azuremlexperimental para obter mais informações.

Retorna o trabalho de importação de dados que está criando o ativo de dados.

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

Parâmetros

data_import

DataImport

Obrigatório

Objeto DataImport.

Retornos

objeto de trabalho de importação de dados.

Tipo de retorno

PipelineJob

Exemplos

Exemplo de importação de ativos de dados.

   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

Liste os ativos de dados do workspace.

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

Parâmetros

name

Optional[str]

Obrigatório

Nome de um ativo de dados específico, opcional.

list_view_type

Tipo de exibição para incluir/excluir (por exemplo) ativos de dados arquivados. Padrão: ACTIVE_ONLY.

Retornos

Um iterador como a instância de objetos Data

Tipo de retorno

ItemPaged[Data]

Exemplos

Exemplo de ativos de dados de lista.

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

list_materialization_status

Observação

Esse é um método experimental e pode mudar a qualquer momento. Consulte https://aka.ms/azuremlexperimental para obter mais informações.

Listar trabalhos de materialização do ativo.

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

Parâmetros

name

str

Obrigatório

nome do ativo que está sendo criado pelos trabalhos de materialização.

list_view_type

Optional[<xref:ListViewType>]

Tipo de exibição para incluir/excluir (por exemplo) trabalhos arquivados. Padrão: ACTIVE_ONLY.

Retornos

Um iterador como a instância de objetos Job.

Tipo de retorno

ItemPaged[PipelineJob]

Exemplos

Exemplo de trabalhos de materialização de lista.

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

restore

Restaurar um ativo de dados arquivado.

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

Parâmetros

name

str

Obrigatório

Nome do ativo de dados.

version

str

Obrigatório

Versão do ativo de dados.

label

str

Obrigatório

Rótulo do ativo de dados. (mutuamente exclusivo com a versão)

Retornos

Nenhum

Exemplos

Exemplo de ativo de dados de restauração.

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

share

Observação

Esse é um método experimental e pode mudar a qualquer momento. Consulte https://aka.ms/azuremlexperimental para obter mais informações.

Compartilhe um ativo de dados do workspace para o registro.

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

Parâmetros

name

str

Obrigatório

Nome do ativo de dados.

version

str

Obrigatório

Versão do ativo de dados.

share_with_name

str

Nome do ativo de dados com o qual compartilhar.

share_with_version

str

Versão do ativo de dados com a qual compartilhar.

registry_name

str

Nome do registro de destino.

Retornos

Objeto de ativo de dados.

Tipo de retorno

Data

Exemplos

Exemplo de ativo de dados de compartilhamento.

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