CommandComponent الفصل

إصدار مكون الأمر، يستخدم لتعريف مكون أمر أو مهمة.

توريث

azure.ai.ml.entities._component.component.Component

CommandComponent

azure.ai.ml.entities._job.parameterized_command.ParameterizedCommand

CommandComponent

azure.ai.ml.entities._component._additional_includes.AdditionalIncludesMixin

CommandComponent

الدالمنشئ

CommandComponent(*, name: str | None = None, version: str | None = None, description: str | None = None, tags: Dict | None = None, display_name: str | None = None, command: str | None = None, code: PathLike | str | None = None, environment: Environment | str | None = None, distribution: Dict | MpiDistribution | TensorFlowDistribution | PyTorchDistribution | RayDistribution | DistributionConfiguration | None = None, resources: JobResourceConfiguration | None = None, inputs: Dict | None = None, outputs: Dict | None = None, instance_count: int | None = None, is_deterministic: bool = True, additional_includes: List | None = None, properties: Dict | None = None, **kwargs: Any)

معلمات الكلمة الأساسية فقط

الاسم	الوصف
name	Optional[str] اسم مهمة أو مكون الأمر.
version	Optional[str] إصدار مهمة أو مكون الأمر.
description	Optional[str] وصف المكون. الإعدادات الافتراضية إلى بلا.
tags	Optional[dict] قاموس العلامات. يمكن إضافة العلامات وإزالتها وتحديثها. الإعدادات الافتراضية إلى بلا.
display_name	Optional[str] اسم العرض للمكون.
command	Optional[str] الأمر الذي سيتم تنفيذه.
code	التعليمات البرمجية المصدر لتشغيل المهمة. يمكن أن يكون مسارا محليا أو "http:" أو "https:" أو عنوان url "azureml:" يشير إلى موقع بعيد.
environment	Optional[Union[str, Environment]] البيئة التي سيتم تشغيل الوظيفة فيها.
distribution	Optional[Union[PyTorchDistribution, MpiDistribution, TensorFlowDistribution, RayDistribution]] تكوين الوظائف الموزعة. الإعدادات الافتراضية إلى بلا.
resources	Optional[JobResourceConfiguration] تكوين مورد الحساب للأمر .
inputs	Optional[dict[str, Union[ Input, str, bool, int, float, <xref:Enum>, ]]] تعيين أسماء الإدخال لإدخال مصادر البيانات المستخدمة في الوظيفة. الإعدادات الافتراضية إلى بلا.
outputs	Optional[dict[str, Union[str, Output]]] تعيين أسماء الإخراج لإخراج مصادر البيانات المستخدمة في الوظيفة. الإعدادات الافتراضية إلى بلا.
instance_count	Optional[int] عدد المثيلات أو العقد التي سيتم استخدامها بواسطة هدف الحساب. تعود الإعدادات الافتراضية على 1.
is_deterministic	Optional[bool] يحدد ما إذا كان الأمر سيعيد نفس الإخراج نظرا لنفس الإدخال. الإعدادات الافتراضية إلى True. عندما يكون True، إذا كان الأمر (المكون) محددا وتم تشغيله من قبل في مساحة العمل الحالية بنفس الإدخال والإعدادات، فسيعيد استخدام النتائج من مهمة تم إرسالها السابقة عند استخدامها كعقدة أو خطوة في مسار. في هذا السيناريو، لن يتم استخدام موارد الحوسبة. القيمة الافتراضية: True
additional_includes	Optional[List[str]] قائمة بالملفات الإضافية المشتركة التي سيتم تضمينها في المكون. الإعدادات الافتراضية إلى بلا.
properties	Optional[dict[str, str]] قاموس خاصية الوظيفة. الإعدادات الافتراضية إلى بلا.

أمثلة

إنشاء CommandComponent.

   from azure.ai.ml.entities import CommandComponent

   component = CommandComponent(
       name="sample_command_component_basic",
       display_name="CommandComponentBasic",
       description="This is the basic command component",
       tags={"tag": "tagvalue", "owner": "sdkteam"},
       version="1",
       outputs={"component_out_path": {"type": "uri_folder"}},
       command="echo Hello World",
       code="./src",
       environment="AzureML-sklearn-1.0-ubuntu20.04-py38-cpu:33",
   )

الأساليب

dump	تفريغ محتوى المكون في ملف بتنسيق yaml.

dump

تفريغ محتوى المكون في ملف بتنسيق yaml.

dump(dest: str | PathLike | IO, **kwargs: Any) -> None

المعلمات

الاسم	الوصف
dest مطلوب	Union[<xref:PathLike>, str, IO[AnyStr]] الوجهة لتلقي محتوى هذا المكون. يجب أن يكون إما مسارا إلى ملف محلي، أو دفق ملف مفتوح بالفعل. إذا كان dest مسار ملف، فسيتم إنشاء ملف جديد، ويتم رفع استثناء إذا كان الملف موجودا. إذا كان dest ملفا مفتوحا، فستتم كتابة الملف مباشرة، وسيتم رفع استثناء إذا لم يكن الملف قابلا للكتابة.

السمات

base_path

المسار الأساسي للمورد.

المرتجعات

النوع	الوصف
str	المسار الأساسي للمورد.

creation_context

سياق إنشاء المورد.

المرتجعات

النوع	الوصف
Optional[SystemData]	بيانات تعريف الإنشاء للمورد.

display_name

اسم العرض للمكون.

المرتجعات

النوع	الوصف
str	اسم العرض للمكون.

distribution

تكوين مكون الأمر الموزع أو الوظيفة.

المرتجعات

النوع	الوصف
Union[PyTorchDistribution, MpiDistribution, TensorFlowDistribution, RayDistribution]	تكوين التوزيع.

id

معرف المورد.

المرتجعات

النوع	الوصف
Optional[str]	المعرف العمومي للمورد، معرف Azure Resource Manager (ARM).

inputs

مدخلات المكون.

المرتجعات

النوع	الوصف
dict	مدخلات المكون.

instance_count

عدد المثيلات أو العقد التي سيتم استخدامها بواسطة هدف الحساب.

المرتجعات

النوع	الوصف
int	عدد المثيلات أو العقد.

is_deterministic

ما إذا كان المكون محددا.

المرتجعات

النوع	الوصف
bool	ما إذا كان المكون محددا

outputs

مخرجات المكون.

المرتجعات

النوع	الوصف
dict	مخرجات المكون.

resources

تكوين مورد الحساب لمكون الأمر أو الوظيفة.

المرتجعات

النوع	الوصف
JobResourceConfiguration	تكوين مورد الحساب لمكون الأمر أو الوظيفة.

type

نوع المكون، الافتراضي هو "الأمر".

المرتجعات

النوع	الوصف
str	نوع المكون.

version

إصدار المكوّن.

المرتجعات

النوع	الوصف
str	إصدار المكوّن.