ComponentOperations الفصل

عمليات المكونات.

يجب عدم إنشاء مثيل لهذه الفئة مباشرة. بدلا من ذلك، يجب إنشاء مثيل MLClient يقوم بإنشاء مثيل لك وإرفاقه كسمة.

توريث

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>

مطلوب

نطاق العملية.

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>]

مطلوب

عميل الخدمة لعمليات واجهة برمجة التطبيقات.

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

مطلوب

وسيطات كلمات أساسية إضافية.

الأساليب

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.

المرتجعات

مكرر مثل مثيل كائنات المكون

نوع الإرجاع

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