DataOperations الفصل

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

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

توريث

azure.ai.ml._scope_dependent_operations._ScopeDependentOperations

DataOperations

الدالمنشئ

DataOperations(operation_scope: OperationScope, operation_config: OperationConfig, service_client: AzureMachineLearningWorkspaces | AzureMachineLearningWorkspaces, datastore_operations: DatastoreOperations, **kwargs: Dict)

المعلمات

operation_scope

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

مطلوب

متغيرات النطاق لفئات العمليات لعنصر MLClient.

operation_config

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

مطلوب

التكوين الشائع لفئات العمليات لعنصر 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>]

مطلوب

عميل الخدمة للسماح للمستخدمين النهائيين بالعمل على موارد مساحة عمل التعلم الآلي من Microsoft Azure (ServiceClient042023Preview أو ServiceClient102021Dataplane).

datastore_operations

DatastoreOperations

مطلوب

يمثل عميلا لتنفيذ العمليات على مخازن البيانات.

الأساليب

archive	أرشفة أصل بيانات.
create_or_update	إرجاع أصل البيانات الذي تم إنشاؤه أو تحديثه. إذا لم يكن موجودا بالفعل في التخزين، فسيتم تحميل الأصل إلى تخزين الكائن الثنائي كبير الحجم لمساحة العمل.
get	احصل على أصل البيانات المحدد.
import_data	ملاحظة هذه طريقة تجريبية، وقد تتغير في أي وقت. يرجى مراجعة https://aka.ms/azuremlexperimental لمزيد من المعلومات. إرجاع مهمة استيراد البيانات التي تقوم بإنشاء أصل البيانات.
list	سرد أصول البيانات لمساحة العمل.
list_materialization_status	ملاحظة هذه طريقة تجريبية، وقد تتغير في أي وقت. يرجى مراجعة https://aka.ms/azuremlexperimental لمزيد من المعلومات. سرد مهام التجسيد للأصل.
restore	استعادة أصل بيانات مؤرشف.
share	ملاحظة هذه طريقة تجريبية، وقد تتغير في أي وقت. يرجى مراجعة 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.data.archive("data-asset-name")

create_or_update

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

إذا لم يكن موجودا بالفعل في التخزين، فسيتم تحميل الأصل إلى تخزين الكائن الثنائي كبير الحجم لمساحة العمل.

create_or_update(data: Data) -> Data

المعلمات

data

Data

مطلوب

كائن أصل البيانات.

المرتجعات

كائن أصل البيانات.

نوع الإرجاع

Data

استثناءات

AssetPathException

يتم رفعه عندما يكون مسار البيانات الاصطناعية مرتبطا بالفعل بمصدر آخر

ValidationException

يتم رفعه إذا تعذر التحقق من صحة البيانات بنجاح. سيتم توفير التفاصيل في رسالة الخطأ.

EmptyDirectoryError

يتم رفعه إذا كان المسار المحلي يوفر نقاطا إلى دليل فارغ.

أمثلة

إنشاء مثال على أصول البيانات.

   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

احصل على أصل البيانات المحدد.

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

المعلمات

name

str

مطلوب

اسم أصل البيانات.

version

str

مطلوب

إصدار أصل البيانات.

label

str

مطلوب

تسمية أصل البيانات. (حصري بشكل متبادل مع الإصدار)

المرتجعات

كائن أصل البيانات.

نوع الإرجاع

Data

استثناءات

ValidationException

يتم رفعه إذا تعذر تحديد البيانات واستردادها بنجاح. سيتم توفير التفاصيل في رسالة الخطأ.

أمثلة

الحصول على مثال أصول البيانات.

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

import_data

ملاحظة

هذه طريقة تجريبية، وقد تتغير في أي وقت. يرجى مراجعة https://aka.ms/azuremlexperimental لمزيد من المعلومات.

إرجاع مهمة استيراد البيانات التي تقوم بإنشاء أصل البيانات.

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

المعلمات

data_import

DataImport

مطلوب

كائن DataImport.

المرتجعات

كائن مهمة استيراد البيانات.

نوع الإرجاع

PipelineJob

أمثلة

مثال على استيراد أصول البيانات.

   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

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

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

المعلمات

name

Optional[str]

مطلوب

اسم أصل بيانات معين، اختياري.

list_view_type

نوع العرض لتضمين/استبعاد (على سبيل المثال) أصول البيانات المؤرشفة. الافتراضي: ACTIVE_ONLY.

المرتجعات

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

نوع الإرجاع

ItemPaged[Data]

أمثلة

مثال على أصول بيانات القائمة.

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

list_materialization_status

ملاحظة

هذه طريقة تجريبية، وقد تتغير في أي وقت. يرجى مراجعة https://aka.ms/azuremlexperimental لمزيد من المعلومات.

سرد مهام التجسيد للأصل.

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

المعلمات

name

str

مطلوب

اسم الأصل الذي يتم إنشاؤه بواسطة وظائف التجسيد.

list_view_type

Optional[<xref:ListViewType>]

نوع العرض لتضمين/استبعاد المهام المؤرشفة (على سبيل المثال). الافتراضي: ACTIVE_ONLY.

المرتجعات

مكرر مثل مثيل كائنات الوظيفة.

نوع الإرجاع

ItemPaged[PipelineJob]

أمثلة

مثال على مهام تجسيد القائمة.

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

restore

استعادة أصل بيانات مؤرشف.

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

المعلمات

name

str

مطلوب

اسم أصل البيانات.

version

str

مطلوب

إصدار أصل البيانات.

label

str

مطلوب

تسمية أصل البيانات. (حصري بشكل متبادل مع الإصدار)

المرتجعات

بلا

أمثلة

استعادة مثال أصل البيانات.

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

share

ملاحظة

هذه طريقة تجريبية، وقد تتغير في أي وقت. يرجى مراجعة https://aka.ms/azuremlexperimental لمزيد من المعلومات.

مشاركة أصل بيانات من مساحة العمل إلى السجل.

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

المعلمات

name

str

مطلوب

اسم أصل البيانات.

version

str

مطلوب

إصدار أصل البيانات.

share_with_name

str

اسم أصل البيانات للمشاركة معه.

share_with_version

str

إصدار أصل البيانات للمشاركة معه.

registry_name

str

اسم السجل الوجهة.

المرتجعات

كائن أصل البيانات.

نوع الإرجاع

Data

أمثلة

مثال على مشاركة أصول البيانات.

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