محتويات الدورة

dbt / المتقدم: الأدلة والعزل والنشر القابل للتعافي / الدرس 13

الآثار والنسب وأدلة التدقيق

اقرأ بيانات المشروع والاستدعاء بمخططات إصدارات دون اعتبار manifest تشغيل بيانات ناجحاً.

وقت القراءة التقريبي: 3 دقيقةتاريخ مراجعة المحتوى
في هذه الصفحة

أهداف الدرس

  • ميّز أدلة manifest ونتائج التشغيل والكتالوج والحداثة.
  • اربط هوية المورد وسياق الاستدعاء بأصل موثق.

تجيب الآثار المختلفة عن أسئلة مختلفة

يصف manifest موارد المشروع المحللة وعلاقاتها. وتصف نتائج التشغيل موارد استدعاء معين، وللكتالوج والحداثة شروط إنتاج ومحتويات أخرى. لا يثبت ظهور عقدة تنفيذها أونجاح اختبارها. ولا يثبت نجاح نموذج اختيار كل تقرير لاحق. احفظ الأمر والاستدعاء ومراجعة المشروع مع كل أثر. تتغير الأسماء والتفاصيل بين الأجيال؛ فافحص المخطط المعلن ولا تعامل JSON متبادلة.

نسخة المخطط جزء من عقد القارئ

تتضمن البيانات الرسمية حقول dbt_version وdbt_schema_version وgenerated_at وinvocation_id. تُصدر المخططات مستقلة وقد تتغير مع نسخة إطار فرعية. يسمي النموذج المحلي الحقول دون التظاهر بأنه manifest أصلي كامل. يجب أن يتحقق القارئ من المخطط المعلن ويتحمل التطور الموثق فقط. عادة تكون unique_id أفضل من اسم عرض للربط، لكنها تحتاج سياق الحزمة والمشروع والاستدعاء عند مقارنة التاريخ.

json مثال تقني توضيحي؛ النتائج المنطقية مستنتجة ولم تُختبر على المحرك.
{"scope":"local artifact review model","inspect_metadata":["dbt_version","dbt_schema_version","generated_at","invocation_id"],"resource_id":"model.library_analytics.fct_loans","dependency_ids":["model.library_analytics.stg_loans"]}

ملخص محلي لا manifest أصلي متحقق المخطط ولا دليل استدعاء فعلي.

تحقق من الروابط المعلنة دون ادعاء تحليل dbt

يرتب برنامج Python خريطة صغيرة طوبولوجياً، فيثبت ترتيب المتطلبات للسلسلة المعلنة في النموذج. لا يكتشف ref من الملفات أويفسر شروط Jinja أويعيد محلل dbt. تحتاج الدورة إعادة تصميم حد الاعتماد، وقد تقبل العقد المستقلة ترتيبات عدة. يفيد الرسم في الأثر إذا صحت العلاقات الأصلية. يظل اسم جدول ثابت مخفي غير مرئي للنموذج وقد يضعف النسب الفعلي أيضاً.

python مثال تقني توضيحي؛ النتائج المنطقية مستنتجة ولم تُختبر على المحرك.
from graphlib import TopologicalSorter
graph = {
    'stg_loans': set(),
    'fct_loans': {'stg_loans'},
    'daily_branch_activity': {'fct_loans'},
}
order = list(TopologicalSorter(graph).static_order())
assert order == ['stg_loans', 'fct_loans', 'daily_branch_activity']
print(' -> '.join(order))
الناتج المتوقع
stg_loans -> fct_loans -> daily_branch_activity

يُنفذ كنموذج رسم معزول بالمكتبة القياسية، بلا استيراد dbt أوقراءة مشروع أومستودع.

احفظ الحالات والزمن ضمن نطاقهما الدقيق

اربط هويات النتائج ببيانات manifest متوافقة واحفظ النجاح والتحذير والفشل والخطأ والتخطي وفق المورد. ليس التخطي تأكيداً ناجحاً، ويشمل زمن الاستدعاء أكثر من استعلام. قد تساعد استجابة المحوّل ومعرّفات الاستعلام في التشخيص المصرح، لكن حقولها خاصة بالهدف. لا تجمع مدد عقد متزامنة كأنها الزمن الكلي. وقد يترك استدعاء جزئي علاقات مبنية؛ فيجب ربط النتائج بالنشر والتعافي.

الآثار بيانات تشغيل لها متطلبات وصول

قد تكشف SQL المترجمة والأوصاف وأسماء المصدر والبيانات المخصصة بنية حساسة أوبيانات. احفظ الآثار المعتمدة بوصول واحتفاظ، واحجب الأسرار ولا تنشر مجلد target كاملاً كمرفق اعتيادي. افصل أساس الحالة من المخرجات الجديدة عند المقارنة. لا تولد الدورة أثراً أصلياً أوكتالوجاً ولا تستدعي أمراً؛ تفحص JSON وبرنامج الرسم الصغير فقط، لا مخطط أثر أصلياً أوزمن مستودع أواكتمال نسب حقيقي.

الأخطاء الشائعة وإصلاحها

يُبلغ عن عقدة manifest كأنها بُنيت بنجاح

لماذا يحدث؟
اختلط وجود المورد المحلل بنتيجة الاستدعاء.
كيف تصلحه؟
اربط نتائج متوافقة وتحقق من نطاق التنفيذ.
كيف تتجنب تكراره؟
احفظ المراجعة والاستدعاء والمخطط معاً.

ينكسر قارئ أثر مخصص بعد ترقية فرعية

لماذا يحدث؟
افتُرض شكل JSON ثابت بلا إصدار.
كيف تصلحه؟
افحص النسخة وحدث وفق المخططات الرسمية.
كيف تتجنب تكراره؟
اختبر القارئ بأمثلة نسخ صريحة.

تُجمع مدد العقد المتزامنة كزمن منقضٍ

لماذا يحدث؟
اختلط توقيت التوازي بمدة الاستدعاء.
كيف تصلحه؟
سجل زمن المورد وحد الملاحظة الكلي.
كيف تتجنب تكراره؟
سمِّ مصادر الزمن وقاعدة جمعه.

اختبر فهمك

1. ماذا يثبت برنامج الرسم المحلي عن مشروع dbt؟

اعرض الحل المشروح

يثبت ترتيب نموذج العقد الثلاث المدخل فقط. لا يحلل المراجع أويتحقق من مخطط manifest. استخدم آثاراً معتمدة متوافقة لمشروع حقيقي، واحفظ أصلها والعلاقات غير المحسومة.

2. هل يُعد الاختبار المتخطى تأكيداً ناجحاً؟

اعرض الحل المشروح

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

أهم ما تعلمته

  • هوية الأثر ومخططه وأصل استدعائه مترابطة.
  • يثبت النسب ونتائج التنفيذ حقائق مختلفة.

المراجع الرسمية