خصائص عرض بيانات 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")

الخطوات التالية