ComponentOperations 클래스

ComponentOperations.

이 클래스를 직접 인스턴스화해서는 안 됩니다. 대신 MLClient instance 만들어 이를 인스턴스화하고 특성으로 연결해야 합니다.

상속

azure.ai.ml._scope_dependent_operations._ScopeDependentOperations

ComponentOperations

생성자

ComponentOperations(operation_scope: OperationScope, operation_config: OperationConfig, service_client: AzureMachineLearningWorkspaces | AzureMachineLearningWorkspaces, all_operations: OperationsContainer, preflight_operation: DeploymentsOperations | None = None, **kwargs: Dict)

매개 변수

operation_scope

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

필수

작업이 scope.

operation_config

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

필수

작업 구성입니다.

service_client

Union[ <xref:azure.ai.ml._restclient.v2022_10_01.AzureMachineLearningWorkspaces>, <xref:azure.ai.ml._restclient.v2021_10_01_dataplanepreview.AzureMachineLearningWorkspaces>]

필수

API 작업에 대한 서비스 클라이언트입니다.

all_operations

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

필수

사용 가능한 모든 작업에 대한 컨테이너입니다.

preflight_operation

Optional[<xref:azure.ai.ml._vendor.azure_resources.operations.DeploymentsOperations>]

기본값: None

배포에 대한 실행 전 작업입니다.

kwargs

Dict

필수

추가 키워드(keyword) 인수입니다.

메서드

archive	구성 요소를 보관합니다.
create_or_update	지정된 구성 요소를 만들거나 업데이트합니다. 인라인으로 정의된 엔터티(예: 환경, 코드)가 있는 경우 구성 요소와 함께 만들어집니다.
download	참고 이는 실험적인 메서드이며 언제든지 변경될 수도 있습니다. 자세한 내용은 https://aka.ms/azuremlexperimental을 참조하세요. 지정된 구성 요소 및 해당 종속성을 로컬로 다운로드합니다. 로컬 구성 요소를 사용하여 다른 작업 영역 또는 오프라인 개발에 구성 요소를 만들 수 있습니다.
get	지정된 구성 요소에 대한 정보를 반환합니다.
list	작업 영역의 특정 구성 요소 또는 구성 요소를 나열합니다.
restore	보관된 구성 요소를 복원합니다.
validate	참고 이는 실험적인 메서드이며 언제든지 변경될 수도 있습니다. 자세한 내용은 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.components.archive(name=component_example.name)

create_or_update

지정된 구성 요소를 만들거나 업데이트합니다. 인라인으로 정의된 엔터티(예: 환경, 코드)가 있는 경우 구성 요소와 함께 만들어집니다.

create_or_update(component: Component | function, version=None, *, skip_validation: bool = False, **kwargs) -> Component

매개 변수

component

Union[Component, FunctionType]

필수

구성 요소 개체 또는 구성 요소 개체를 생성하는 mldesigner 구성 요소 함수

version

str

필수

재정의할 구성 요소 버전입니다.

skip_validation

bool

구성 요소를 만들/업데이트하기 전에 유효성 검사를 건너뛸지 여부, 기본값은 False입니다.

반환

지정된 구성 요소 개체입니다.

반환 형식

Component

예외

ValidationException

구성 요소의 유효성을 성공적으로 검사할 수 없는 경우 발생합니다. 자세한 내용은 오류 메시지에 제공됩니다.

AssetException

구성 요소 자산(예: 데이터, 코드, 모델, 환경)의 유효성을 성공적으로 검사할 수 없는 경우 발생합니다. 자세한 내용은 오류 메시지에 제공됩니다.

ComponentException

구성 요소 형식이 지원되지 않는 경우 발생합니다. 자세한 내용은 오류 메시지에 제공됩니다.

ModelException

구성 요소 모델의 유효성을 성공적으로 검사할 수 없는 경우 발생합니다. 자세한 내용은 오류 메시지에 제공됩니다.

EmptyDirectoryError

로컬 경로 제공이 빈 디렉터리를 가리키는 경우 발생합니다.

예제

구성 요소 예제를 만듭니다.

   from azure.ai.ml import load_component
   from azure.ai.ml.entities._component.component import Component

   component_example = load_component(
       source="./sdk/ml/azure-ai-ml/tests/test_configs/components/helloworld_component.yml",
       params_override=[{"version": "1.0.2"}],
   )
   component = ml_client.components.create_or_update(component_example)

download

참고

이는 실험적인 메서드이며 언제든지 변경될 수도 있습니다. 자세한 내용은 https://aka.ms/azuremlexperimental을 참조하세요.

지정된 구성 요소 및 해당 종속성을 로컬로 다운로드합니다. 로컬 구성 요소를 사용하여 다른 작업 영역 또는 오프라인 개발에 구성 요소를 만들 수 있습니다.

download(name: str, download_path: PathLike | str = '.', *, version: str = None) -> None

매개 변수

name

str

필수

코드 구성 요소의 이름입니다.

download_path

str

필수

다운로드 대상으로 로컬 경로는 기본적으로 현재 사용자의 현재 작업 디렉터리로 설정됩니다. 없는 경우 만들어집니다.

version

Optional[str]

구성 요소 버전입니다.

반환

지정된 구성 요소 개체입니다.

반환 형식

Component

예외

OSError

download_path 비어 있지 않은 기존 디렉터리를 가리키는 경우 발생합니다. 식별되고 검색되었습니다. 자세한 내용은 오류 메시지에 제공됩니다.

get

지정된 구성 요소에 대한 정보를 반환합니다.

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

매개 변수

name

str

필수

코드 구성 요소의 이름입니다.

version

Optional[str]

필수

구성 요소 버전입니다.

label

Optional[str]

필수

버전과 함께 사용할 수 없는 구성 요소의 레이블입니다.

반환

지정된 구성 요소 개체입니다.

반환 형식

Component

예외

ValidationException

구성 요소를 성공적으로 식별하고 검색할 수 없는 경우 발생합니다. 자세한 내용은 오류 메시지에 제공됩니다.

예제

구성 요소 예제를 가져옵니다.

   ml_client.components.get(name=component_example.name, version="1.0.2")

list

작업 영역의 특정 구성 요소 또는 구성 요소를 나열합니다.

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

매개 변수

name

Optional[str]

필수

구성 요소 이름을 설정하지 않으면 작업 영역의 모든 구성 요소를 나열합니다.

list_view_type

보관된 구성 요소 포함/제외(예: )에 대한 보기 형식입니다. 기본값: ACTIVE_ONLY.

반환

구성 요소 개체의 instance 같은 반복기

반환 형식

ItemPaged[Component]

예제

구성 요소 예제를 나열합니다.

   print(ml_client.components.list())

restore

보관된 구성 요소를 복원합니다.

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

매개 변수

name

str

필수

구성 요소의 이름입니다.

version

str

필수

구성 요소 버전입니다.

label

str

필수

구성 요소의 레이블입니다. (버전과 상호 배타적).

예제

복원 구성 요소 예제입니다.

   ml_client.components.restore(name=component_example.name)

validate

참고

이는 실험적인 메서드이며 언제든지 변경될 수도 있습니다. 자세한 내용은 https://aka.ms/azuremlexperimental을 참조하세요.

지정된 구성 요소의 유효성을 검사합니다. 인라인으로 정의된 엔터티(예: 환경, 코드)가 있는 경우 생성되지 않습니다.

validate(component: Component | function, raise_on_failure: bool = False, **kwargs) -> ValidationResult

매개 변수

component

Union[Component, FunctionType]

필수

구성 요소 개체 또는 구성 요소 개체를 생성하는 mldesigner 구성 요소 함수

raise_on_failure

bool

필수

유효성 검사 오류에 대한 예외를 발생할지 여부입니다. 기본값은 False입니다.

반환

모든 유효성 검사 오류

반환 형식

ValidationResult