الكتابة إلى جدول قاعدة بيانات Azure SQL من وظائف Stream Analytics
يدعم Stream Analytics قاعدة بيانات Azure SQL كإخراج لاستعلام الدفق. توضح هذه المقالة كيفية استخدام قاعدة بيانات SQL كإخراج لوظيفة Stream Analytics في مدخل Microsoft Azure.
المتطلبات الأساسية
إنشاء وظيفة تحليلات البث.
إنشاء قاعدة بيانات Azure SQL التي ستكتب فيها وظيفة Stream Analytics الإخراج.
الكتابة إلى جدول جديد في قاعدة بيانات SQL
يصف هذا القسم كيفية تكوين وظيفتك للكتابة في جدول في قاعدة بيانات Azure SQL التي لم يتم إنشاؤها بعد.
في وظيفة Stream Analytics، حدد الإخراجات ضمن مخطط الوظيفة. انقر فوق إضافة واختر قاعدة بيانات SQL.
حدد اسماً مستعاراً للإخراج سيتم استخدامه في استعلام وظيفتك. قم بتوفير اسم قاعدة البيانات ووضع المصادقة. يمكنك معرفة المزيد حول خيارات تكوين إخراج SQL.
أدخل اسم جدول تريد إنشاؤه في قاعدة بيانات Azure SQL. انقر فوق «حفظ» ملاحظة: لا يؤدي حفظ هذا الإخراج إلى إنشاء الجدول في قاعدة بيانات SQL. توفر الخطوات التالية المزيد من التفاصيل حول وقت إنشاء الجدول.
حدد الاستعلام ضمن مخطط الوظيفة واستخدم الاسم المستعار في الاستعلام لكتابة الإخراج في اسم الجدول الذي قدمته في الخطوة السابقة. انقر فوق اختبار الاستعلام لاختبار منطق الاستعلام وعرض نتائج الاختبار التي تعرض مخطط الإخراج الذي سيتم إنتاجه بواسطة الوظيفة. ملاحظة: لاختبار الاستعلام الخاص بك، تحتاج إما إلى وجود بيانات دفق واردة في مصدر الإدخال الخاص بك، أو يمكنك تحميل نموذج البيانات لاختبار الاستعلام. يمكنك معرفة المزيد حول استعلام اختبار Stream Analytics.
انقر فوق مخطط جدول SQL لعرض اسم العمود ونوعه. انقر فوق إنشاء جدول وسيتم إنشاء الجدول في قاعدة بيانات SQL.
إذا تم تعديل استعلام Stream Analytics لإنتاج مخطط مختلف، فستحتاج إلى تغيير تعريف الجدول في قاعدة بيانات SQL. يضمن هذا أن وظيفة Stream Analytics لا تواجه أخطاء في تحويل البيانات أثناء محاولة الكتابة إلى المتلقي.
بمجرد أن يصبح استعلامك نهائياً، حدد نظرة عامة و بدء الوظيفة. يمكنك بعد ذلك الانتقال إلى جدول قاعدة بيانات SQL لمشاهدة إخراج استعلام الدفق.
تحديد جدول موجود من قاعدة بيانات SQL
يصف هذا القسم كيفية تكوين وظيفتك للكتابة في جدول موجود بالفعل في قاعدة بيانات Azure SQL.
في وظيفة Stream Analytics، حدد الإخراجات ضمن مخطط الوظيفة. انقر فوق إضافة واختر قاعدة بيانات SQL.
حدد اسماً مستعاراً للإخراج سيتم استخدامه في استعلام وظيفتك. قم بتوفير اسم قاعدة البيانات ووضع المصادقة. يمكنك معرفة المزيد حول خيارات تكوين إخراج SQL.
يمكنك اختيار جدول موجود من قاعدة بيانات SQL المحددة عن طريق إدخال تفاصيل مصادقة SQL. سيؤدي ذلك إلى تحميل قائمة بأسماء الجداول من قاعدة البيانات. حدد اسم الجدول من القائمة أو أدخل اسم الجدول يدوياً ثم حفظ.
حدد الاستعلام ضمن مخطط الوظيفة واستخدم اسم الاسم المستعار في الاستعلام لكتابة الإخراج في الجدول المحدد. انقر فوق اختبار الاستعلام لاختبار منطق الاستعلام وعرض نتائج الاختبار. ملاحظة: لاختبار الاستعلام الخاص بك، تحتاج إما إلى وجود بيانات دفق واردة في مركز الأحداث/مركز إنترنت الأشياء، أو يمكنك تحميل نموذج البيانات لاختبار الاستعلام. يمكنك معرفة المزيد حول استعلام اختبار Stream Analytics.
في علامة التبويب مخطط جدول SQL، يمكنك رؤية اسم عمود ونوعه من البيانات الواردة وفي الجدول المحدد. يمكنك رؤية الحالة سواء كان نوع البيانات الواردة وجدول SQL المحدد متطابقين أم لا. إذا لم يكن هناك تطابق، فستتم مطالبتك بتحديث الاستعلام لمطابقة مخطط الجدول.
بمجرد أن يصبح استعلامك نهائياً، حدد نظرة عامة و بدء الوظيفة. يمكنك بعد ذلك الانتقال إلى جدول قاعدة بيانات SQL لمشاهدة إخراج استعلام الدفق.
أسباب عدم تطابق نوع البيانات الشائعة
من المهم التأكد من أن إخراج وظيفة Stream Analytics يطابق أسماء الأعمدة وأنواع البيانات المتوقعة من جدول قاعدة بيانات SQL. إذا كان هناك عدم تطابق، فستواجه وظيفتك أخطاء في تحويل البيانات، وتعيد المحاولة باستمرار حتى يتم تغيير تعريف جدول SQL. يمكنك تغيير سلوك وظيفتك لإغفال مثل هذا الإخراج الذي يسبب أخطاء في تحويل البيانات والمتابعة إلى الإخراج التالي. يتم وصف أسباب عدم تطابق المخطط الأكثر شيوعاً أدناه.
- عدم تطابق النوع: أنواع الاستعلام والهدف غير متوافقة. لن يتم إدراج الصفوف في الوجهة. استخدم دالة تحويل مثل TRY_CAST() لتوافق الأنواع في الاستعلام. الخيار البديل هو تغيير الجدول الوجهة في قاعدة بيانات SQL.
- النطاق: نطاق النوع الهدف أصغر بكثير من النطاق المستخدم في الاستعلام. قد لا يتم إدراج صفوف ذات قيم خارج النطاق في الجدول الوجهة، أو يتم اقتطاعها. ضع في اعتبارك تغيير العمود الوجهة إلى نطاق نوع أكبر.
- ضمني: أنواع الاستعلام والهدف مختلفة ولكنها متوافقة. سيتم تحويل البيانات ضمنياً، ولكن قد يؤدي ذلك إلى فقدان البيانات أو فشلها. استخدم دالة تحويل مثل TRY_CAST() لتوافق الأنواع في الاستعلام أو غير الجدول الوجهة.
- السجل: هذا النوع غير مدعوم بعد لهذا الإخراج. سيتم استبدال القيمة بسلسلة "السجل". ضع في اعتبارك تحليل البيانات، أو استخدام UDF من أجل التحويل إلى سلسلة.
- الصفيف: هذا النوع غير مدعوم بعد في الأصل في قاعدة بيانات Azure SQL. سيتم استبدال القيمة بسلسلة "السجل". ضع في اعتبارك تحليل البيانات، أو استخدام UDF من أجل التحويل إلى سلسلة.
- العمود مفقود من الجدول الوجهة: هذا العمود مفقود من الجدول الوجهة. لن يتم إدراج البيانات. أضف هذا العمود إلى الجدول الوجهة إذا لزم الأمر.