مراجع البيانات الوصفية للجداول والأعمدة

نظرة عامة

تتيح لك حقول Metadata Reference Custom Fields إنشاء روابط بنيوية بين كائنات كتالوج Validatar ومشاريعه. وعلى عكس الحقول النصية الحرة، تشير هذه الحقول إلى كائنات بيانات وصفية موجودة فعليًا، مما يتيح توثيقًا أغنى وتتبع العلاقات وأتمتة عبر بيئة بياناتك.

يتوفّر نوعان من حقول Metadata Reference المخصصة:

• Table Metadata Reference – مراجع إلى جداول في الكتالوج.
• Column Metadata Reference – مراجع إلى أعمدة في الكتالوج.

يمكنك إضافة أي من نوعَي Metadata Reference على أي مستوى داخل Validatar، بما في ذلك:

• Catalog: Data Sources، Schemas، Tables، Columns
• Projects: Projects، Tests، Jobs، Labels

توفّر هذه المرونة إمكانية نمذجة المفاتيح والتبعيات وغيرها من العلاقات مباشرة داخل بياناتك الوصفية.

إنشاء حقل Metadata Reference

عند إنشاء حقل Metadata Reference، تقوم بتهيئة العناصر التالية:

1. Basic Details

• Name – الاسم المعروض للحقل (مثل: Business Keys، Foreign Key، Source Tables).
• Reference Key – المفتاح الفريد لتحديد الحقل داخليًا.
• Description (اختياري) – سياق إضافي حول الحقل.

2. Scope Limitation

تحكّم في الكائنات التي يمكن اختيارها من خلال تحديد نطاق المرجع إلى المستوى الذي تريده:

• Any Data Source – السماح بالإشارة إلى أي كائن عبر جميع مصادر البيانات.
• Same Data Source – قصر الاختيار على الكائنات ضمن نفس مصدر البيانات.
• Same Schema – قصر الاختيار على الكائنات ضمن نفس المخطط.
• Same Table – قصر الاختيار على الكائنات ضمن نفس الجدول.

يضمن هذا أن تكون المراجع ذات معنى ومحددة النطاق بشكل مناسب.

3. Value Cardinality

حدد ما إذا كان الحقل يقبل قيمة واحدة أو عدة قيم:

• Single Value – مرجع واحد لكل حقل (مثل ربط عمود المفتاح الأجنبي بعمود واحد بالتحديد).
• Multiple Values – عدة مراجع لكل حقل (مثل المفاتيح التجارية الممتدة عبر عدة أعمدة).

أمثلة

المثال الأول: Business Keys

• Type: Column Metadata Reference
• Level: Table
• Scope: Same Table
• Cardinality: Multiple Values

استخدم هذا لالتقاط أعمدة المفتاح التجاري (business key) لجدول ما، مثل AccountID و ClientID.

المثال الثاني: Foreign Key

• Type: Column Metadata Reference
• Level: Column
• Scope: Same Data Source
• Cardinality: Single Value

استخدم هذا لتوثيق علاقة مفتاح أجنبي (foreign key) من عمود في جدول ما إلى عمود في جدول آخر ضمن نفس مصدر البيانات.

المثال الثالث: Source Tables

• Type: Table Metadata Reference
• Level: Table
• Scope: Unlimited
• Cardinality: Multiple Values

استخدم هذا لتوثيق المصادر الأصلية لجدول ما، والتي قد تمتد عبر عدة مصادر بيانات.

استخدام حقول Metadata Reference

بمجرد إنشائها، تظهر حقول Metadata Reference المخصصة جنبًا إلى جنب مع الحقول المخصصة الأخرى في الكتالوج والمشاريع. عند تعديل كائن ما (مثل جدول أو عمود)، يمكنك الآن اختيار كائنات بيانات وصفية فعلية بدلاً من كتابة نص حر.

يتيح هذا ما يلي:

• توثيق أوضح للمفاتيح والعلاقات.
• فرص أتمتة للاختبار والقولبة (templating).
• مراجع متسقة عبر سياقات الكتالوج والمشاريع.

على سبيل المثال:

• على مستوى الجدول، قد توثّق المفاتيح التجارية (AccountID، ClientID).
• على مستوى العمود، قد توثّق علاقة مفتاح أجنبي (DimAccount.ClientID → RawAccount.ClientID).
• على مستوى الجدول، قد تحدد الجداول المصدرية التي تغذي جدولًا محوّلاً.

الفوائد

• Consistency – الإشارة إلى كائنات موجودة بدلاً من إعادة كتابة الأسماء يدويًا.
• Automation – دفع اختبارات القوالب الديناميكية اعتمادًا على مراجع البيانات الوصفية.
• Flexibility – التطبيق على كائنات الكتالوج أو المشاريع في أي مستوى.