Microsoft Fabric: إدخال صف

استخدم Microsoft Fabric: إدخال صف لبث صف واحد إلى جدول Eventhouse (KQL) من خطوة في الرحلة، عبر واجهة برمجة تطبيقات الإدخال الخاصة بـ Fabric. على عكس نقاط التكامل الأخرى التي تأخذ رمزًا خاصًا بها، تتم مصادقة هذه النقطة من خلال تطبيق Entra ID متصل مرة واحدة للحساب بأكمله. لا يوجد حقل للرمز المميز في النقطة نفسها.

الاستخدامات النموذجية:

• تغذية جدول تقارير: أدخل صفًا لكل خطوة في الرحلة تم الوصول إليها، للوحة معلومات أو استعلام مجدول لاحق.
• تسجيل الأحداث فور حدوثها: بث بيانات الرحلة الأولية إلى Eventhouse بدلاً من انتظار خط أنابيب دفعي.
• الربط مع البيانات الموجودة: أدخل قيمة جهاز أو وسم يمكن لجداول Fabric الخاصة بك الربط بها مع مجموعات البيانات الخاصة بك.

قبل أن تبدأ

قم بتوصيل تطبيق Entra ID تحت الإعدادات > تكاملات الطرف الثالث > Microsoft Azure:

1. سجل تطبيقًا في دليل Entra ID الخاص بك وأنشئ سر عميل له.
2. في معرف الدليل (المستأجر)، أدخل المستأجر الخاص بك، على سبيل المثال contoso.onmicrosoft.com.
3. في معرف التطبيق (العميل)، أدخل معرف العميل لتسجيل التطبيق.
4. في سر العميل، الصق السر. يتم تخزينه للكتابة فقط: لن يعرضه Pushwoosh مرة أخرى، لذا الصق واحدًا جديدًا لاستبداله.
5. انقر على توصيل Azure.

بعد توصيل Azure، قم بتثبيت التكامل حتى تظهر النقطة في منشئ الرحلات.

تنبيه

لسر العميل تاريخ انتهاء صلاحية خاص به، يتم تعيينه عند إنشائه في Entra ID. في يوم انتهاء صلاحيته، تبدأ النقطة في الفشل وتعرض لوحة التحكم حالة عامة “أعد توصيل التكامل” - لا شيء يشير إلى السر على وجه التحديد. ضع تذكيرًا بتاريخ انتهاء صلاحية السر حتى تقوم بتدويره قبل حدوث ذلك، وليس بعده.

يجب أيضًا توفر ثلاثة أشياء من جانب Eventhouse، وإلا سيفشل الطلب:

• يحتاج الجدول المستهدف إلى تعيين إدخال JSON — لا يعمل إدخال البث لـ JSON بدونه.
• يحتاج تسجيل التطبيق إلى دور ingestor على Eventhouse. لا يوجد زر لهذا في واجهة مستخدم Fabric — امنحه عن طريق تشغيل هذا في نافذة استعلام Eventhouse:

  .add database ['<database name>'] ingestors ('aadapp=<Application (client) ID>;<Directory (tenant) ID>')

• تحتاج قاعدة بيانات KQL إلى تمكين سياسة إدخال البث الخاصة بها. قم بتشغيل هذا في نفس نافذة الاستعلام:

  .alter database ['<database name>'] policy streamingingestion enable

احتفظ بـ ['...'] حول اسم قاعدة البيانات في هذه الأوامر إذا كان يحتوي على واصلة - سيفشل تحليل الاسم الذي يحتوي على واصلة بدونها.

تكوين النقطة

1. اسحب Microsoft Fabric: إدخال صف من قسم التكاملات في اللوحة اليسرى إلى لوحة الرسم.
2. انقر نقرًا مزدوجًا على النقطة وأدخل اسم الخطوة.
3. في مضيف URI للاستعلام، أدخل مضيف Eventhouse الخاص بك من URI للاستعلام الخاص به، في صفحة نظرة عامة على النظام لـ Eventhouse. لا تقم بتضمين https://، على سبيل المثال trd-abc123.z9.kusto.fabric.microsoft.com.

4. في قاعدة بيانات KQL، أدخل اسم قاعدة البيانات المستهدفة.

5. في الجدول، أدخل اسم الجدول المستهدف.

6. في تعيين الإدخال، أدخل اسم تعيين JSON الذي تم إنشاؤه على ذلك الجدول.

7. في الأعمدة، أضف صفًا واحدًا لكل عمود Eventhouse للكتابة فيه. أدخل اسم العمود والقيمة. يجب أن تكون الأسماء غير فارغة وفريدة. يمكن أن تكون القيمة نصًا ثابتًا أو ماكرو مسافر مثل {{tag:Name}}، وهي نفس وحدات الماكرو الموجودة في نص Webhook. أو انقر على إدراج قيمة ديناميكية لاختيار سمة أنتجتها خطوة سابقة في هذه الرحلة، على سبيل المثال استجابة LLM أو قيمة Webhook معينة.

مثال

مع تعيين الجدول إلى Events، فإن تعيين الأعمدة إلى device_id مع معرف جهاز المسافر ({{device:hwid}}) يكتب صفًا في عمود device_id لذلك الجدول.

8. انقر على حفظ.

الاستجابة

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

السمات بعد تشغيل الخطوة

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

الإخفاقات والاستجابات غير المتوقعة

افتح سجل المكالمات في درج النقطة وتحقق من الاستجابة:

• 401 أو 403 — بيانات اعتماد تطبيق Entra ID المتصل أو دور ingestor الخاص به خاطئة أو مفقودة.
• 520 مع StreamingIngestionException: Failed to initialize cursor tracker... — لم يتم تمكين سياسة إدخال البث لقاعدة بيانات KQL. تُقرأ علامة الخطأ permanent: false على أنها “أعد المحاولة لاحقًا”، لكن إعادة المحاولة لا تصلح هذا. قم بتشغيل .alter database ['<database name>'] policy streamingingestion enable في نافذة استعلام Eventhouse (انظر قبل أن تبدأ).

يؤدي الطلب الفاشل إلى إسقاط المسافر من الرحلة. انظر الأخطاء والطلبات الفاشلة.

سيناريو مثال: بث نشاط الرحلة إلى لوحة معلومات Fabric

يريد فريق لوحة معلومات حية لكل خطوة يتم الوصول إليها عبر رحلة نشطة، دون انتظار تصدير دفعي.

1. أضف Microsoft Fabric: إدخال صف مباشرة بعد الخطوة التي تريد تتبعها. قم بتعيين قاعدة بيانات KQL إلى am-test، والجدول إلى Events، وتعيين الإدخال إلى EventsJsonMapping. في الأعمدة، قم بتعيين device_id إلى {{device:hwid}}.
2. انقر على حفظ.

بمجرد تشغيل هذا، يظهر كل مسافر يصل إلى هذه الخطوة في جدول Eventhouse في غضون ثوانٍ، ويكون جاهزًا للوحة المعلومات.