مشاركة عبر

MLClient الفصل

  • ‏‏المرجع

فئة عميل للتفاعل مع خدمات التعلم الآلي من Microsoft Azure.

استخدم هذا العميل لإدارة موارد التعلم الآلي من Microsoft Azure مثل مساحات العمل والوظائف والنماذج وما إلى ذلك.

توريث
builtins.object
MLClient

الدالمنشئ

MLClient(credential: TokenCredential, subscription_id: str | None = None, resource_group_name: str | None = None, workspace_name: str | None = None, registry_name: str | None = None, **kwargs: Any)

المعلمات

credential
TokenCredential
مطلوب

بيانات الاعتماد التي يجب استخدامها للمصادقة.

subscription_id
Optional[str]
القيمة الافتراضية: None

معرف اشتراك Azure. اختياري لأصول التسجيل فقط. الإعدادات الافتراضية إلى بلا.

resource_group_name
Optional[str]
القيمة الافتراضية: None

مجموعة موارد Azure. اختياري لأصول التسجيل فقط. الإعدادات الافتراضية إلى بلا.

workspace_name
Optional[str]
القيمة الافتراضية: None

مساحة العمل المراد استخدامها في العميل. اختياري فقط للعمليات التي لا تعتمد على مساحة العمل. الإعدادات الافتراضية إلى بلا.

registry_name
Optional[str]
القيمة الافتراضية: None

السجل المراد استخدامه في العميل. اختياري فقط للعمليات التي لا تعتمد على مساحة العمل. الإعدادات الافتراضية إلى بلا.

show_progress
Optional[bool]

يحدد ما إذا كان سيتم عرض أشرطة التقدم للعمليات طويلة الأمد أم لا (على سبيل المثال، قد يفكر العملاء في تعيين هذا إلى False إذا لم يكن استخدام SDK هذا في إعداد تفاعلي). الإعدادات الافتراضية إلى True.

enable_telemetry
Optional[bool]

يحدد ما إذا كان يجب تمكين بيانات تتبع الاستخدام أم لا. سيتم تجاوزه إلى False إذا لم يكن في Jupyter Notebook. الإعدادات الافتراضية إلى True إذا كانت في Jupyter Notebook.

cloud
Optional[str]

اسم السحابة المراد استخدامه. الإعدادات الافتراضية ل "AzureCloud".

أمثلة

عند استخدام المجالات ذات السيادة (أي أي أي سحابة أخرى غير AZURE_PUBLIC_CLOUD)، يجب تمرير اسم السحابة في kwargs ويجب عليك استخدام سلطة مع DefaultAzureCredential.


   from azure.ai.ml import MLClient
   from azure.identity import AzureAuthorityHosts, DefaultAzureCredential

   kwargs = {"cloud": "AzureChinaCloud"}
   ml_client = MLClient(
       subscription_id=subscription_id,
       resource_group_name=resource_group,
       credential=DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_CHINA),
       **kwargs,
   )

الأساليب

begin_create_or_update

إنشاء مورد التعلم الآلي من Microsoft Azure أو تحديثه بشكل غير متزامن.
create_or_update

إنشاء مورد التعلم الآلي من Microsoft Azure أو تحديثه.
from_config

إرجاع عميل من مساحة عمل التعلم الآلي من Azure موجودة باستخدام تكوين ملف.

يوفر هذا الأسلوب طريقة بسيطة لإعادة استخدام نفس مساحة العمل عبر دفاتر ملاحظات أو مشاريع Python متعددة. يمكنك حفظ خصائص Azure Resource Manager (ARM) لمساحة العمل في ملف تكوين JSON باستخدام هذا التنسيق:


   {
       "subscription_id": "<subscription-id>",
       "resource_group": "<resource-group>",
       "workspace_name": "<workspace-name>"
   }

بعد ذلك، يمكنك استخدام هذا الأسلوب لتحميل نفس مساحة العمل في دفاتر ملاحظات أو مشاريع Python مختلفة دون إعادة كتابة خصائص ARM لمساحة العمل.

begin_create_or_update

إنشاء مورد التعلم الآلي من Microsoft Azure أو تحديثه بشكل غير متزامن.

begin_create_or_update(entity: R, **kwargs) -> LROPoller[R]

المعلمات

entity
Union[Workspace , Registry, Compute, OnlineDeployment , OnlineEndpoint, BatchDeployment , BatchEndpoint, Schedule]
مطلوب

المورد المراد إنشاؤه أو تحديثه.

المرتجعات

المورد بعد عملية الإنشاء/التحديث.

نوع الإرجاع

LROPoller[Union[Workspace , Registry, Compute, OnlineDeployment , OnlineEndpoint, BatchDeployment , BatchEndpoint, Schedule]]

create_or_update

إنشاء مورد التعلم الآلي من Microsoft Azure أو تحديثه.

create_or_update(entity: T, **kwargs) -> T

المعلمات

entity
Union[Job , Model, Environment, Component , Datastore]
مطلوب

المورد المراد إنشاؤه أو تحديثه.

المرتجعات

المورد الذي تم إنشاؤه أو تحديثه.

نوع الإرجاع

Union[Job, Model , Environment, Component, Datastore]

from_config

إرجاع عميل من مساحة عمل التعلم الآلي من Azure موجودة باستخدام تكوين ملف.

يوفر هذا الأسلوب طريقة بسيطة لإعادة استخدام نفس مساحة العمل عبر دفاتر ملاحظات أو مشاريع Python متعددة. يمكنك حفظ خصائص Azure Resource Manager (ARM) لمساحة العمل في ملف تكوين JSON باستخدام هذا التنسيق:


   {
       "subscription_id": "<subscription-id>",
       "resource_group": "<resource-group>",
       "workspace_name": "<workspace-name>"
   }

بعد ذلك، يمكنك استخدام هذا الأسلوب لتحميل نفس مساحة العمل في دفاتر ملاحظات أو مشاريع Python مختلفة دون إعادة كتابة خصائص ARM لمساحة العمل.

from_config(credential: TokenCredential, *, path: PathLike | str | None = None, file_name=None, **kwargs) -> MLClient

المعلمات

credential
TokenCredential
مطلوب

كائن بيانات الاعتماد لمساحة العمل.

path
Optional[Union[PathLike, str]]

المسار إلى ملف التكوين أو بدء الدليل للبحث عن ملف التكوين داخله. الإعدادات الافتراضية إلى بلا، مما يشير إلى أنه سيتم استخدام الدليل الحالي.

file_name
Optional[str]

اسم ملف التكوين للبحث عن عندما يكون المسار مسار دليل. الإعدادات الافتراضية ل "config.json".

cloud
Optional[str]

اسم السحابة المراد استخدامه. الإعدادات الافتراضية ل "AzureCloud".

المرتجعات

العميل لمساحة عمل التعلم الآلي من Microsoft Azure موجودة.

نوع الإرجاع

MLClient

استثناءات

ValidationException

يرفع إذا تعذر العثور على "config.json"، أو file_name إذا تم تجاوزه، في الدليل. سيتم توفير التفاصيل في رسالة الخطأ.

أمثلة

إنشاء MLClient من ملف يسمى "config.json" في الدليل "src".


   from azure.ai.ml import MLClient

   client = MLClient.from_config(credential=DefaultAzureCredential(), path="./sdk/ml/azure-ai-ml/samples/src")

إنشاء MLClient من ملف يسمى "team_workspace_configuration.json" في الدليل الحالي.


   from azure.ai.ml import MLClient

   client = MLClient.from_config(
       credential=DefaultAzureCredential(),
       file_name="./sdk/ml/azure-ai-ml/samples/team_workspace_configuration.json",
   )

السمات

batch_deployments

مجموعة من العمليات المتعلقة بنشر الدفعات.

المرتجعات

عمليات نشر الدفعات.

نوع الإرجاع

BatchDeploymentOperations

batch_endpoints

مجموعة من العمليات المتعلقة بنقطة النهاية الدفعية.

المرتجعات

عمليات نقطة النهاية الدفعية

نوع الإرجاع

BatchEndpointOperations

components

مجموعة من العمليات المتعلقة بالمكونات.

المرتجعات

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

نوع الإرجاع

ComponentOperations

compute

مجموعة من العمليات المتعلقة بالحوسبة.

المرتجعات

عمليات الحوسبة

نوع الإرجاع

ComputeOperations

connections

مجموعة من العمليات المتعلقة باتصال مساحة العمل.

المرتجعات

عمليات اتصالات مساحة العمل

نوع الإرجاع

WorkspaceConnectionsOperations

data

مجموعة من العمليات المتعلقة بالبيانات.

المرتجعات

عمليات البيانات.

نوع الإرجاع

DataOperations

datastores

مجموعة من العمليات ذات الصلة بمستوي البيانات.

المرتجعات

عمليات مخزن البيانات.

نوع الإرجاع

DatastoreOperations

environments

مجموعة من العمليات المتعلقة بالبيئة.

المرتجعات

عمليات البيئة.

نوع الإرجاع

EnvironmentOperations

feature_sets

aka.ms/azuremlexperimental لمزيد من المعلومات.

مجموعة من العمليات ذات الصلة بمجموعة الميزات.

المرتجعات

عمليات مجموعة الميزات

نوع الإرجاع

FeatureSetOperations

feature_store_entities

aka.ms/azuremlexperimental لمزيد من المعلومات.

مجموعة من العمليات المتعلقة بوحدة مخزن الميزات.

المرتجعات

عمليات FeatureStoreEntity

نوع الإرجاع

FeatureStoreEntityOperations

feature_stores

aka.ms/azuremlexperimental لمزيد من المعلومات.

مجموعة من العمليات ذات الصلة بمخزن الميزات.

المرتجعات

عمليات FeatureStore

نوع الإرجاع

FeatureStoreOperations

jobs

مجموعة من العمليات المتعلقة بالوظيفة.

المرتجعات

عمليات الوظائف

نوع الإرجاع

JobOperations

models

مجموعة من العمليات ذات الصلة بالنموذج.

المرتجعات

عمليات النموذج

نوع الإرجاع

ModelOperations

online_deployments

مجموعة من العمليات المتعلقة بالنشر عبر الإنترنت.

المرتجعات

عمليات النشر عبر الإنترنت

نوع الإرجاع

OnlineDeploymentOperations

online_endpoints

مجموعة من العمليات المتعلقة بنقطة النهاية عبر الإنترنت.

المرتجعات

عمليات نقطة النهاية عبر الإنترنت

نوع الإرجاع

OnlineEndpointOperations

registries

aka.ms/azuremlexperimental لمزيد من المعلومات.

مجموعة من العمليات المتعلقة بالسجل.

المرتجعات

عمليات السجل

نوع الإرجاع

RegistryOperations

resource_group_name

احصل على اسم مجموعة الموارد لعنصر MLClient.

المرتجعات

اسم مجموعة موارد Azure.

نوع الإرجاع

str

schedules

مجموعة من العمليات ذات الصلة بجدول زمني.

المرتجعات

جدولة العمليات.

نوع الإرجاع

ScheduleOperations

subscription_id

احصل على معرف الاشتراك لكائن MLClient.

المرتجعات

معرف اشتراك Azure.

نوع الإرجاع

str

workspace_hubs

aka.ms/azuremlexperimental لمزيد من المعلومات.

مجموعة من العمليات المتعلقة بمركز مساحة العمل.

المرتجعات

عمليات المركز

نوع الإرجاع

<xref:HubOperations>

workspace_name

اسم مساحة العمل حيث سيتم تنفيذ العمليات المعتمدة على مساحة العمل.

المرتجعات

اسم مساحة العمل الافتراضية.

نوع الإرجاع

Optional[str]

workspace_outbound_rules

مجموعة من العمليات المتعلقة بقاعدة مساحة العمل الصادرة.

المرتجعات

عمليات قاعدة صادرة لمساحة العمل

نوع الإرجاع

WorkspaceOutboundRuleOperations

workspaces

مجموعة من العمليات المتعلقة بمساحة العمل.

المرتجعات

عمليات مساحة العمل

نوع الإرجاع

WorkspaceOperations

R 

R = ~R

T 

T = ~T