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

ترحيل الإصدارات وحدود المنتجات

راجع افتراضات v1.12 وتسمية v2 الحالية والخدمات الاختيارية دون مساواة الصياغة بالاستحقاق.

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

في هذه الصفحة

أهداف الدرس

ميّز سياق المحرك والتوزيعة والمحوّل والحزمة والإصدار المستضاف.
خطط لفحوص المعنى والآثار وتعافي البيانات عبر الإصدار.

استخدم الأسماء المتحقق منها يوم المراجعة

تسمي الوثائق المراجعة في2026-10-28 جيل Python 1.x بـdbt v1، وكان Core 1.x. الجيل المبني على Rust هوv2، وكان Fusion، وتسمى توزيعة Apache فقط dbt OSS. والخدمة المستضافة والحسابات والمسارات بعد آخر. يظل أساس الصياغة v1.12، ولا يعني غياب قدراتv2 أوتجريبيتها أووجودها فيv1. تحقق من الشروط والإتاحة حالياً. ولا تعمم منشوراً قديماً عن ترخيص Fusion أونسخته التجريبية دون مصادر رسمية أحدث.

يغير الإصدار أكثر من رقم الملف التنفيذي

راجع واجهة المحوّل والحزم والأعلام وسياقات YAML وSQL وقراء الآثار. قد يكشف تحققv2 الأشد إعدادات مهملة، ويختلف دعم Jinja بين الملفات والأجيال. لا يثبت التحليل توافق التشغيل. تسمي القائمة مراجعة اصطناعية منv1.12 إلىv2.0 ولا ترقي. اختبر المسارات المستخدمة واحفظ دلالات بيانات التراجع، ولا تفترض أن التغير الكبير تسريع لكل مسار قديم فقط. أظهر حدود المصدر والوجهة غير المحسومة.

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

{"scope":"synthetic migration review","source_generation":"dbt v1.12","destination_generation":"dbt v2.0","verify":["adapter support","package paths","YAML contexts","generated SQL","artifact schemas","incremental and snapshot recovery"]}

قائمة نشر محلية، لا اعتماد نسخة لمحوّل فعلي أودليل ترحيل منفذ.

يحتاج القياس المركزي نموذج حقيقة صحيحاً

عدد المفتوح رصيد عند وقت رصد، بينما loans_started تدفق خلال فترة اقتراض. لا يعطي جمع الرصيد اليومي عدد الإعارات المميزة. حدد الكيانات والتفصيل والوقت والتجميع قبل خدمة متسقة. العقد المحلي مفهومي لا YAML أصلية لـMetricFlow. ولا يصلح التعريف المركزي حقيقة مكررة أومصدر فروع غائباً. احفظ المعنى وأمثلة القبول مع المواصفة المدعومة المستخدمة.

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

{"metric":"open_loans","kind":"stock","entity":"loan_id","grain":"one validated loan lifecycle","time":"explicit observation timestamp","aggregation":"count eligible open loans, not sum daily stocks"}

نموذج قياس تجاري محلي؛ لا ينشئ نموذجاً دلالياً أوخدمة أوواجهة أواستحقاقاً.

لبيانات المشروع والخدمات المستضافة إتاحة مستقلة

لا تعادل MetricFlow والبيانات الدلالية كل واجهة أودمج مستضاف. كما تختلف state والمراجع المرجأة العادية من خدمة dbt State التي تعيد استخدام أواستنساخ موارد بقواعدها. تحقق من الشارات وتسجيل الدخول والاشتراك والمحوّل للعرض الدقيق. لا تستنتج تفعيل خدمة مدفوعة لقبول YAML، ولا تعتبر كل قدرة محلية مستضافة حصراً. لا يقدم الدرس تقدير سعر أوشراء أواستدعاء خدمة؛ بل يوضح الحد للمراجعة الدقيقة.

اقبل الإصدار بأدلة كود وبيانات وتعافٍ

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

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

يُستخدم اسم Fusion القديم لاستنتاج الترخيص أوالحالة الحالية

لماذا يحدث؟: عوملت التسمية التاريخية كدليل استحقاق حالي.
كيف تصلحه؟: راجع وثائق التوزيعة والميزات الرسمية المؤرخة.
كيف تتجنب تكراره؟: سجل يوم المراجعة والجيل الدقيق.

تُجمع أرصدة الإعارات اليومية كإعارات مميزة

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

يُعامل قبول تكوين دلالي كواجهة مستضافة فعالة

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

اختبر فهمك

1. هل يثبت جمع10 إعارات مفتوحة الاثنين و10 الثلاثاء وجود20 إعارة مميزة؟

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

لا؛ قد تكون العشر نفسها. حدد الرصيد في لحظة أويوم إعارة أوهويات مميزة خلال فترة. تطبق الخدمة العقد المختار ولا تستنتج تعريف الأعمال الغائب.

2. ماذا يثبت تحليل مشروع v1.12 ناجح عن ترحيله إلىv2؟