dbt / المتوسط: التاريخ والمسارات المضبوطة / الدرس 11

المحددات وضبط نطاق التنفيذ

عبّر عن نطاق الرسم بدقة وراجع الموارد المختارة قبل عمل مكلف أومؤثر في البيانات.

وقت القراءة التقريبي: 4 دقيقةتاريخ مراجعة المحتوى 2026-10-28

في هذه الصفحة

أهداف الدرس

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

الاختيار عملية مجموعات على موارد معلنة

قد يحوي المشروع تجهيزاً وحقائق وتقارير بوسوم وتجسيدات مختلفة. يسمي المحدد مجموعة موارد، ولا يغير المعنى أوالصلاحيات. تضيف + السابقة أسلافاً مدعومة واللاحقة أبناء وفق الصياغة. لا تُدرج العقد المستقلة خارج المسار تلقائياً. حدد نطاق المتطلبات والتابعين قبل العلامات. وقد يحول تغير صغير عملاً واحداً إلى إعادة بناء واسعة؛ فراجع المحدد كـSQL.

راجع الأسماء بدلاً من استنتاجها من الأمر

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

text مثال تقني توضيحي؛ النتائج المنطقية مستنتجة ولم تُختبر على المحرك.

dbt ls --select fct_loans+ --resource-type model

نص CLI توضيحي فقط لم يُنفذ. يستبعد مرشح نوع المورد عمداً الموارد التي ليست من نوع model من المجموعة المعروضة.

اجعل التقاطع القابل لإعادة الاستخدام مقروءاً

يعني المحدد الموارد ذات الوسم nightly والتجسيد table معاً، لا أي شرط منفرد. يوحّد الاسم المقصد بدلاً من أوامر متشابهة بالتنسيق. راجع إسناد الوسم والتجسيد الفعال؛ فقد يغير التكوين المجموعة دون تغير الملف. ليست الوسوم أمناً للبيانات أوفرض ملكية. يفترض المقطع موارد موسومة مناسبة ولا ينشئ وظيفة أوجدولاً زمنياً أوعملية مستودع.

yaml مثال تقني توضيحي؛ النتائج المنطقية مستنتجة ولم تُختبر على المحرك.

selectors:
  - name: nightly_tables
    definition:
      intersection:
        - method: tag
          value: nightly
        - method: config.materialized
          value: table

تقاطع في selectors.yml للمراجعة. تعتمد العقد الفعلية على بيانات المشروع وسياق الأمر.

للاختبارات غير المباشرة دلالات اختيار خاصة

قد يجلب نموذج مختار اختباراته وفق سياسة الاختيار غير المباشر. وقد تختلف اختبارات الآباء المتعددين بين eager وcautious وغيرها. لا يمنع استبعاد مورد من البناء قراءة علاقته القائمة بواسطة نموذج آخر. ميّز عدم البناء وعدم المرجع وعدم التفويض. راجع المختار والمدخل المحلول والمنح معاً. لا يؤمّن محدد ضيق سراً واسعاً وحده، ولا يعني فشل البناء تراجع كل ما سبقه ذرياً.

يعتمد اختيار الحالة على أساس مقارنة موثوق

تقارن state:modified بيانات المشروع بأثر سابق وفق توافق موثق، ولا تفحص كل صف مصدر تغير. وقد توسع إضافة الأبناء التنفيذ، ويغير الإرجاء حل المراجع غير المختارة. افصل manifest المقارنة من المخرجات الجديدة كي لا يُستبدل أثناء الاستخدام. تحقق من مشروعه ونسخته وأصل بيئته. لا تنفذ الدورة قائمة أوبناء أوحالة أوإرجاء؛ تفحص نموذجياً أسلاف الرسم وأبناءه فقط، لا محلل dbt الكامل أوإذن المستودع.

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

تُقرأ + اللاحقة كمتطلبات سابقة فقط

لماذا يحدث؟: عُكس اتجاه الأسلاف والأبناء.
كيف تصلحه؟: افحص الرسم وراجع الموارد الدقيقة.
كيف تتجنب تكراره؟: احفظ أمثلة محددات صغيرة بمجموعات متوقعة.

يُنفذ تقاطع الوسوم كاتحاد

لماذا يحدث؟: حل أي شرط محل اشتراط الاثنين.
كيف تصلحه؟: استخدم تقاطعاً مسمى واضحاً وتحقق من العضوية.
كيف تتجنب تكراره؟: اختبر مورداً يحقق كل شرط وحده.

يُعلن غياب النماذج المختارة نشراً ناجحاً

لماذا يحدث؟: لم يُطابق الفراغ بالنطاق المتوقع.
كيف تصلحه؟: راجع المسارات والوسوم والتكوين وأساس الحالة.
كيف تتجنب تكراره؟: اطلب أعداداً وأسماء مفسرة في دليل النشر.

اختبر فهمك

1. في تجهيز ثم حقيقة ثم تقرير، ماذا تشمل fact+ مفهوماً؟

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

تشمل الحقيقة وأبناءها كالتقرير وفق اختيار الرسم. لا تشمل التجهيز لمجرد كونه سلفاً. راجع الموارد الفعلية وسلوك الاختبارات والعلاقات العلوية القائمة مستقلة.

2. هل يضمن استبعاد نموذج مصدر عدم قراءة SQL المختارة لجدوله القائم؟