تكامل البيانات الخارجية

مكتمل

يقوم عامل تشغيل البيانات الخارجية بإرجاع جدول تم تعريف مخططه في الاستعلام نفسه. ويتم قراءة بياناته من عنصر تخزين خارجي، مثل blob في تخزين Azure Blob أو ملف تخزين Azure Data Lake.

بناء الجملة

 externaldata ( ColumnName : ColumnType [, ...] )
  [ StorageConnectionString [, ...] ]
  [with ( PropertyName = PropertyValue [, ...] )]

الوسيطات

  • ColumnName ،ColumnType: تعرف الوسيطات مخطط الجدول. الصيغة هي نفسها المستخدمة عند تعريف جدول في إنشاء جدول.

  • StorageConnectionString: سلاسل اتصال التخزين التي تصف النتائج الملموسة للتخزين التي تحمل البيانات لإرجاعها.

  • PropertyName،PropertyValue،...: المزيد من الخصائص تصف كيفية تفسير البيانات التي تم استردادها من التخزين، كما هو موضح تحت خصائص الاستيعاب.

الخصائص المعتمدة حاليًا:

الوسيطات

الخاصية نوع ‏‏الوصف
format سلسلة تنسيق البيانات. إذا لم يتم التحديد، يتم إجراء محاولة للكشف عن تنسيق البيانات من ملحق الملف (الافتراضيات إلى CSV). أي من تنسيقات بيانات الاستيعاب معتمدة.
ignoreFirstRecord منطقي إذا تم تعيينها إلى «true»، تشير إلى أن السجل الأول في كل ملف تم تجاهله. تكون هذه الخاصية مفيدة عند الاستعلام عن ملفات CSV مع عناوين.
ingestionMapping سلسلة قيمة سلسلة تشير إلى كيفية تعيين البيانات من الملف المصدر إلى الأعمدة الفعلية في مجموعة نتائج عامل التشغيل. راجع تعيينات البيانات.

المرتجعات

يقوم عامل تشغيل البيانات الخارجية بإرجاع جدول بيانات المخطط المعطى مع بيانات تم توزيعها من أداة التخزين المحددة، مشار إليها بواسطة سلسلة اتصال التخزين.

إشعار

هذا المثال غير متوفر في بيئة العرض التوضيحي.

Users
| where UserID in ((externaldata (UserID:string) [
    @"https://storageaccount.blob.core.windows.net/storagecontainer/users.txt" 
      h@"?...SAS..." // Secret token needed to access the blob
    ]))
| ...