خصائص عرض بيانات Azure Synapse Data Explorer (إصدار أولي)
استيعاب البيانات هو العملية التي يتم من خلالها إضافة البيانات إلى جدول وإتاحتها للاستعلام في Data Explorer. أضف خصائص إلى أمر العرض بعد الكلمة الرئيسية with.
خصائص الاستيعاب
يسرد الجدول التالي الخصائص التي يدعمها Data Explorer ويصفها ويقدم أمثلة:
| الخاصية | الوصف | مثال |
|---|---|---|
ingestionMapping |
قيمة سلسلة تشير إلى كيفية تعيين البيانات من الملف المصدر إلى الأعمدة الفعلية في الجدول. حدد قيمة format بنوع التعيين ذي الصلة. راجع تعيينات البيانات. |
with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")(تم إيقافه: avroMapping، csvMapping، jsonMapping) |
ingestionMappingReference |
قيمة سلسلة تشير إلى كيفية تعيين البيانات من الملف المصدر إلى الأعمدة الفعلية في الجدول باستخدام عنصر نهج تعيين مسمى. حدد قيمة format بنوع التعيين ذي الصلة. راجع تعيينات البيانات. |
with (format="csv", ingestionMappingReference = "Mapping1")(تم إيقافه: avroMappingReference، csvMappingReference، jsonMappingReference) |
creationTime |
قيمة التاريخ والوقت (المنسقة كسلسلة ISO8601) لاستخدامها في وقت إنشاء نطاقات البيانات التي تم إدخالها. إذا لم يتم تحديدها، فسيتم استخدام القيمة الحالية (now()). يعد تجاوز الإعداد الافتراضي مفيداً عند استيعاب البيانات القديمة، بحيث يتم تطبيق نهج الاحتفاظ بشكل صحيح. عند التحديد، تأكد من أن الخاصية Lookback في Extents merge policy الفعالة للجدول المستهدف تتماشى مع القيمة المحددة. |
with (creationTime="2017-02-13") |
extend_schema |
قيمة Boolean، إذا تم تحديدها، توجه الأمر لتوسيع مخطط الجدول (الافتراضي هو false). ينطبق هذا الخيار فقط على الأوامر .append و.set-or-append. تحتوي ملحقات المخطط الوحيدة المسموح بها على أعمدة إضافية مضافة إلى الجدول في النهاية. |
إذا كان مخطط الجدول الأصلي هو (a:string, b:int)، فإن ملحق مخطط صالح سيكون (a:string, b:int, c:datetime, d:string)، ولكن (a:string, c:datetime) لن يكون صالحاً |
folder |
بالنسبة لأوامر ingest-from-query، المجلد المطلوب تعيينه للجدول. إذا كان الجدول موجوداً بالفعل، فستحل هذه الخاصية محل مجلد الجدول. | with (folder="Tables/Temporary") |
format |
تنسيق البيانات (راجع تنسيقات البيانات المدعومة). | with (format="csv") |
ingestIfNotExists |
قيمة سلسلة تمنع، إذا تم تحديدها، نجاح العرض إذا كان الجدول يحتوي بالفعل على بيانات مميزة بعلامة ingest-by: بالقيمة نفسها. هذا يضمن استيعاب البيانات غير الفعالة. لمزيد من المعلومات، راجع علامات :ingest-by. |
تشير الخصائص with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') إلى أنه إذا كانت البيانات التي تحتوي على العلامة ingest-by:Part0001 موجودة بالفعل، فلا تكمل عملية العرض الحالية. إذا لم تكن موجودة بالفعل، فيجب أن تتضمن عملية العرض الجديدة هذه مجموعة العلامات (في حال محاولة العرض المستقبلية استيعاب البيانات نفسها مرة أخرى) |
ignoreFirstRecord |
قيمة منطقية، إذا تم تعيينها على true، فإنها تشير إلى أن العرض يجب أن يتجاهل السجل الأول لكل ملف. هذه الخاصية مفيدة للملفات ذات التنسيقات CSVوالتنسيقات المماثلة، إذا كان السجل الأول في الملف هو أسماء الأعمدة. بشكل افتراضي، يتم افتراض false. |
with (ignoreFirstRecord=false) |
persistDetails |
قيمة منطقية تشير، إذا تم تحديدها، إلى أن الأمر يجب أن يستمر في النتائج التفصيلية (حتى إذا نجحت) حتى يتمكن الأمر . show operation details من استردادها. الإعدادات الافتراضية لـ false. |
with (persistDetails=true) |
policy_ingestiontime |
قيمة منطقية تصف، إذا تم تحديدها، ما إذا كان سيتم تمكين Ingestion Time Policy في جدول تم إنشاؤه بواسطة هذا الأمر. الافتراضي هو true. |
with (policy_ingestiontime=false) |
recreate_schema |
قيمة منطقية تصف، إذا تم تحديدها، ما إذا كان بإمكان الأمر إعادة إنشاء مخطط الجدول. تنطبق هذه الخاصية فقط على الأمر .set-or-replace. هذه الخاصية لها الأسبقية على الخاصية extend_schema إذا تم تعيين كليهما. |
with (recreate_schema=true) |
tags |
قائمة tags لربطها بالبيانات التي تم إدخالها، والتي تم تنسيقها كسلسلة JSON | with (tags="['Tag1', 'Tag2']") |
validationPolicy |
سلسلة JSON تشير إلى عمليات التحقق التي يجب تشغيلها أثناء العرض. راجع عرض البيانات للحصول على شرح للخيارات المختلفة. | with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (هذا هو النهج الافتراضي في الواقع) |
zipPattern |
استخدم هذه الخاصية عند إدخال البيانات من وحدة تخزين بها أرشيف بتنسيق ZIP. هذه قيمة سلسلة تشير إلى التعبير العادي الذي يجب استخدامه عند تحديد الملفات في أرشيف ZIP لاستيعابها. سيتم تجاهل جميع الملفات الأخرى في الأرشيف. | with (zipPattern="*.csv") |
الخطوات التالية
- تعرف على المزيد حول عرض البيانات.
- تعرف على المزيد حول تنسيقات البيانات المدعومة.