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

البذور والبيانات المرجعية وحداثة المصدر

احكم المرجع الصغير الثابت وفسّر الحداثة دون اعتبار أيهما نظام إدخال كاملاً.

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

في هذه الصفحة

أهداف الدرس

اختر seeds لمرجع محدود خاضع للمراجعة.
ميّز وقت الحداثة وإصدار الملف واكتمال الأعمال.

البذرة بيانات بإصدار تتحول إلى علاقة

يمكن لقائمة حالات إعارة صغيرة العيش في CSV مراجعة. هي بيانات لا قالب Jinja ولا بديل لإدخال الأحداث الخام. يحمّل أمر seed الملف لعلاقة هدف، فينفذ عمل قاعدة. اجعل الحجم والتغير مناسبين لإدارة المصدر، ولا تضع بيانات مستعير شخصية أوأسراراً. قد يغير المرجع تقارير تاريخية إذا استُخدمت قيمه الحالية دائماً؛ فراجع المعنى مثل SQL. يسجل التحكم في الإصدارات التعديل ولا يقرر فترة سريان معنى الرمز.

احفظ كتابة الهوية ومعنى الصف

للمثال صف لكل state_code وتسمية عرض. يحتاج رمز بأصفار بادئة نوعاً نصياً لا استنتاجاً رقمياً. وقد يضاعف الرمز المكرر ربط الإعارات كأي مرجع مكرر. وثق الخلية الخالية والاقتباس والحالة ولا تستنتجها من ورقة عرض. يُحلل المثال محلياً كـCSV، فيثبت بنية النص فقط. لا يُنشأ جدول أويُحمّل أويقارن بمستودع، ولا يُدعى استنتاج نوع على المحرك.

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

state_code,state_label
open,Open loan
returned,Returned loan

CSV اصطناعي كامل بصفين. التسميات قيم بيانات مضبوطة وتبقى نفسها بين لغتي الدورة.

يظل تكوين seed معتمداً على الهدف

يحدد المقطع varchar للرمز بافتراض دعم الهدف للاسم والعرض. يجب أن يطابق نطاقه المشروع والبذرة. يمنع تجاوز النوع خطأ استنتاج معيناً ولا يثبت التفرّد أوالتسمية أوتاريخ المعنى. وقد يحتاج تغير النوع بناء مدعوماً لا إلحاقاً عابراً. راجع الاختبارات والمستهلكين مع التغيير. لا تنفذ seed أوتحديثاً شاملاً على بيئة مهيأة لفحص المثال؛ فالتكوين غير قابل للتشغيل.

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

seeds:
  library_analytics:
    loan_state_codes:
      +column_types:
        state_code: varchar(16)

تجاوز نوع تابع للهدف لبذرة خيالية؛ لا يحمّل بيانات أويفرض مفتاحاً.

تقيس الحداثة إشارة ساعة لا جودة البيانات كلها

قد تقارن الحداثة إشارة loaded-at مضبوطة أووقت بيانات وصفية مدعوماً بحدود. لا يثبت أقصى وقت حديث تسليم كل الفروع أواكتمال الصفوف أوموثوقية الساعات. قد يخفي صف حديث قسماً تاريخياً غائباً إذا فُحص الأقصى العام. وقد تشوه أوقات مستقبلية أومنطقة الإشارة. حدد ساعة الإدخال ومعالجة المصدر الخالي. تختلف الصياغة والدعم حسب الجيل والمحوّل؛ فاستخدم الوثائق المختارة لا مثال منصة أخرى.

اجمع حوكمة المرجع وأدلة تسليم المصدر

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

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

تُستخدم seed لإدخال أحداث غير محدود

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

يُعلن المصدر الحديث مكتملاً

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

يضخم رمز seed مكرر أعداد التقرير

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

اختبر فهمك

1. هل يثبت أقصى loaded-at من اليوم وصول كل فروع الأمس؟

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

لا؛ يدعم مقارنة الساعة المضبوطة فقط. افحص التغطية ومحاسبة الصفوف مستقلة. قد يترافق صف حديث مع نقص كبير، فتحتاج سياسة قبول التقرير دليل اكتمال.

2. ماذا يثبت تحليل البذرة ذات الصفين محلياً؟