أدلة عملية معمقة

بناء قاموس بيانات قابل للاستخدام

وصف مستوى الصف والأعمدة والأنواع والوحدات والقيم المفقودة والمفاتيح قبل الحساب أو الربط.

آخر تحديث :

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

رسم توضيحي مولّد بالذكاء الاصطناعي

هل يتيح التعريف فحص كل قيمة؟

اسم العمود لا يكفي لفهم الملف. يربط القاموس الحقول بتعريفاتها ومجالات القيم ونسخة المخطط. ميّز مجموعة البيانات عن توزيعاتها مثل CSV وAPI.

  1. تعريف الصف

    حدد الكائن والإقليم والفترة: شركة-سنة تختلف عن منشأة-شهر. وضح المفتاح الفريد المتوقع والعلاقات بالجداول.

  2. وصف كل حقل

    لكل عمود اكتب الاسم الدقيق والتعريف والنوع والتنسيق والوحدة والأكواد وقبول الفراغ والمنشأ. احفظ المعرّفات ذات الأصفار الأولى كنص.

  3. اختبار وتحديد النسخة

    اختبر التفرد ومجالات القيم والحقول المطلوبة على الملف الفعلي. الفراغ وعدم الانطباق والصفر معانٍ مختلفة. أرّخ تغييرات التعريف والأكواد والأنواع.

ورشة قراءة البيانات

عقد سجل دون إصلاح صامت

يحدد عقد DEMO صفاً لكل ملف. قواعده مختلقة ولا تصف سجلاً حقيقياً.

بيانات وسجلات افتراضية للتعلم: لا تأتي هذه النتائج من استعلام مباشر لأي خدمة.

حفظ المستلم ورفض المخالفة

التوزيعة JSON: record_id سلسلة من أربعة أرقام وstate يساوي OPEN أو CLOSED وamount عدد عشري أو null. يجب أن يكون record_id فريداً. حالة الحروف والأنواع جزء من العقد.

إذا تجاوز الجدول الشاشة فمرره أفقياً؛ تعمل أسهم لوحة المفاتيح عند تركيز المنطقة.

حفظ المستلم ورفض المخالفة
الحقل أو القاعدةالقيمة المختبرةقراءة العقدالإجراء
record_id: نص"0042"; العدد 42تقبل السلسلة ويخالف العدد النوعارفض 42 دون اختلاق أصفاره.
state: رمز مطابقOPEN; openيقبل OPEN ويخرج open عن المجاللا تغير الحروف دون قاعدة معتمدة.
amount: عدد أو null12.5; "12.5"; null; ""يقبل العدد وnull وترفض السلسلتانتعني null مجهولاً؛ لا صفر افتراضي.
تفرد record_idصفان يحملان "0042"يتكرر المفتاح ولو اختلف المبلغانلا تعتمد المخرج واطلب مستوى الرصد الصحيح.

هل يجعل التحويل التلقائي كل الصفوف صالحة؟

افتح كل اقتراح لمقارنة تشخيصه. قد تبقى فحوص إضافية ضرورية.

نعم؛ يكفي تحويل الأعداد والحروف والفراغات

لا؛ يمحو المخالفات ويضيف افتراضات لا يتضمنها العقد.

لا؛ تحفظ القيم الخام والمخالفات المسماة

نعم. افصل أخطاء النوع والرموز غير المقبولة وتكرار المفتاح ثم عالجها بالتوثيق أو مع المنتج.

null والسلسلة الفارغة متكافئتان دائماً

لا؛ يميزهما عقد JSON هذا. قد يملك CSV قاعدة أخرى توثق منفصلة.

سجل تحقق افتراضي

العقد: DEMO، صف لكل ملف، JSON
record_id: نص من أربعة أرقام ومفتاح فريد
state: OPEN أو CLOSED بحروف مطابقة
amount: عدد عشري أو null؛ null=مجهول
المخالفات: نوع ورمز وسلسلة فارغة ومفتاح مكرر
القرار: حفظ الخام وعدم اعتماد المخرج

تلخص الصياغة عقداً تعليمياً لا مخططاً تنفيذياً كاملاً. لا يفحص التمرين ملفاً للمستخدم.

توثيق القواعد منفصل عن الأمثلة الافتراضية

مقارنة حالات وتمارين أخرى

رمز محول إلى عدد

احفظ الرمز الدقيق واختبر بقاء الأصفار الأولى عند التحميل.

مبلغ بلا وحدة

حدد العملة والمقياس والفترة قبل الجمع؛ لا تستنتج الوحدة من الحجم.

قراءة موجهة لمقطع

ثلاثة صفوف وأربع قواعد للفحص

في هذا المثال الافتراضي، يصف كل صف موقعًا لسنة واحدة. يحدد القاموس التالي قواعد القراءة؛ وتتضمن البيانات خللًا مقصودًا.

تمرين خيالي: توضح المعرفات والقيم والتواريخ التحقق. المقطع ليس ردا جمع مباشرة.

  1. قراءة المفتاح

    يجب أن يكون الزوج site_id وyear فريدًا. يمكن أن يظهر الموقع نفسه في سنوات مختلفة.

  2. قراءة القيم

    site_id معرّف نصي من ثلاثة أرقام. amount_kEUR مبلغ سنوي بآلاف اليورو؛ وتعني الخلية الفارغة أن القيمة غير مبلّغ عنها.

  3. الفحص قبل الحساب

    قارن أزواج المفاتيح واحفظ الأصفار الأولى وميّز المبلغ الصفري من المبلغ المجهول قبل التجميع.

مقتطف وقاموس مبسط

site_id,year,amount_kEUR
007,2024,
007,2025,0
007,2025,12.5

site_id     : string; pattern = ^[0-9]{3}$; required
year        : integer; required
amount_kEUR : decimal; unit = 1000 EUR; empty = unknown
key         : (site_id, year); unique

ما ينبغي فحصه

مفتاح مركب
يحمل الصفان الأخيران الزوج نفسه 007 و2025: وهذا يخالف شرط التفرد. لا تختر عشوائيًا أي صف تحتفظ به.
الوحدة
تمثل 12.5 مبلغ 12 500 EUR في هذا المثال، دون تحويل عملة.
قيمة مفقودة
المبلغ الفارغ في الصف الأول مجهول؛ أما 0 في الصف الثاني فهو مبلغ صفري مبلّغ عنه.
هل يمكن جمع عمود المبالغ مباشرة؟

التعليل

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

مراجع رسمية : W3C — Model for Tabular Data and Metadata on the Web

تمرين مع الحل

وحدة ودقة غائبتان عن القاموس

مثال افتراضي: القيم والوثائق لتعلم الطريقة ولا تصف مؤسسة حقيقية.

يعرّف المنتج amount بآلاف اليورو مقربة إلى عُشر. لا يذكر القاموس الداخلي إلا «عدد»، ولم تُقدم المبالغ الخام.

إذا تجاوز الجدول الشاشة فمرره أفقياً؛ تعمل أسهم لوحة المفاتيح عند تركيز المنطقة.

المعطيات الأولية
الصفamount
A1.2
B2.5

ما ينبغي التحقق منه

  1. أضف الوحدة والمضاعف وقاعدة التقريب.
  2. افصل النوع الحاسوبي عن المعنى.
  3. افحص الحسابات السابقة بهذا الحقل.
قراءة الحل

الحل والقرار

مجموع المنشور 3.7 آلاف يورو، أي 3 700 يورو. لا تضيف كتابة 3.70 دقة. حدد الوحدة واشرح أن المجموع يعتمد قيماً مقربة لا مبالغ دقيقة معروفة.

إذا تغيرت الحالة

إذا توفرت مبالغ خام غير مقربة، فاحسبها منفصلة وحدد نسختها. أضف حالة غياب إلى البيانات الافتراضية؛ تعني amount=0 مبلغاً صفرياً معروفاً، بينما لا تقدم الخلية المعلنة مجهولة أي مبلغ. وثّق رمز الغياب وتحقق من أن الاستيراد لا يحوله بصمت إلى صفر قبل التجميع.

السجل الواجب حفظه

احفظ التعريف والوحدة والمقياس والدقة ورموز الغياب ومثالاً صحيحاً.

مرجع توثيقي : W3C — CSV on the Web: A Primer · تاريخ الاطلاع

مرجع موثق

JSON Pointer: التمييز بين الغياب والصفر و⁦null⁩

تعنون RFC 6901 قيمة داخل JSON؛ ليست ⁦JSONPath⁩ أو عملية تعديل. يستخدم القارئ وثيقة تعليمية مخترعة لا مشاهدات، ويفصل القيمة والمسار الغائب والصياغة غير الصحيحة.

items0count/items/0/count → 0
JSON Pointer: التمييز بين الغياب والصفر و⁦null⁩
المرجعالقيمة أو الصيغةما الذي يحدده
""Root valueتختار السلسلة الفارغة الوثيقة كلها، لا غياب النتائج.
/Empty member nameتختار الشرطة المائلة وحدها خاصية اسمها فارغ إن وجدت، لا الجذر.
~1/ inside member nameيرمز للشرطة المائلة داخل الاسم بـ⁦~1⁩. تختلف خاصية ⁦a/b⁩ عن a التي تحتوي b.
~0~ inside member nameيرمز للتلدة بـ⁦~0⁩. فك ⁦~1⁩ قبل ⁦~0⁩: تعني ⁦~01⁩ الاسم الحرفي ⁦~1⁩ لا شرطة مائلة.
/items/0Zero-based array indexيبدأ فهرس المصفوفة بصفر؛ عدد صحيح غير سالب دون أصفار بادئة زائدة.
/items/01Invalid array indexليس 01 فهرس مصفوفة صالحاً لكنه قد يكون مفتاح كائن حرفياً.
/items/-No existing array memberتشير الشرطة إلى ما بعد العنصر الأخير، غير الموجود للقراءة؛ ليست إضافة تلقائية.
#/a~1bURI-fragment formيبدأ جزء URI بـ# ويطبق فك URI. رمز النسبة يحتاج ترميزاً هناك لا في الصيغة النصية.

قراءة JSON Pointer في مثال تعليمي

وثيقة مخترعة للتمرين: الأرقام ليست مشاهدات. قراءة محلية دون طلبات أو تعديل الوثيقة.

وثيقة تعليمية

{
    "items": [
        {
            "id": "A",
            "count": 0,
            "note": null
        },
        {
            "id": "B",
            "count": 3,
            "note": ""
        }
    ],
    "a/b": {
        "m~n": true
    },
    "": false,
    "01": "code",
    "é": "accent",
    "~1": "literal",
    "c%d": "percent"
}

المثال الأول: ⁦/items/0/count⁩ يعطي 0؛ ⁦/items/0/note⁩ يعطي ⁦null⁩؛ ⁦/items/1/note⁩ نصاً فارغاً؛ ⁦/⁩ يعطي ⁦false⁩.

وجدت القيمة · عدد

القيمة المختارة

0

أسماء الخصائص حرفية: لا تحذف المسافات ولا تطبع العلامات. لا يضيف القارئ عناصر ولا يعالج ⁦JSONPath⁩.

ما يُحفظ في الملف

قارن الأسماء حرفياً دون تصحيح العلامات أو الحالة أو المسافات. احفظ ⁦null⁩ و⁦false⁩ والصفر والنص الفارغ. قد لا يحل مسار صحيح إلى قيمة؛ لا تخترع صفراً. لا تتغير المفاتيح بلغة الواجهة.

لماذا يجد ⁦/items/0/note⁩ قيمة ⁦null⁩ ويفشل مسار آخر؟

توجد الخاصية وتحمل ⁦null⁩ صراحة. الخاصية الغائبة لا تحل إلى قيمة؛ يختلف الأثر في الربط والتحويل لجدول.

الوثائق الأصلية

تاريخ الاطلاع على الوثائق .

مرجع موثق

⁦JSON⁩: قد يفقد نص صالح معرفاً

تحدد ⁦RFC 8259⁩ الصياغة لا الدقة المطلقة. قد تتغير الأعداد الطويلة عند القراءة. أمثلة تعليمية لا معرفات ممنوحة.

⁦JSON⁩: قد يفقد نص صالح معرفاً
المرجعالقيمة أو الصيغةما الذي يحدده
Integer interoperability⁦−9007199254740991⁩ … ⁦9007199254740991⁩نطاق صحيح قابل للتبادل مع ⁦binary64⁩، لا حد صياغة ⁦JSON⁩.
Beyond 2^53 − 1⁦binary64⁩ · ⁦2⁩^⁦53 + 1⁩خارجه تبقى أعداد دقيقة لكن لا تتميز كل الأعداد المتتالية.
"00123" / 123"⁦00123⁩" ≠ ⁦123⁩يحفظ النص "⁦00123⁩" الأصفار والعدد ⁦123⁩ لا؛ الرمز ليس بالضرورة كمية.
NaN / Infinity⁦JSON⁩: ✗ليست ⁦NaN⁩ و⁦Infinity⁩ قيماً عددية بصياغة ⁦JSON⁩.
Duplicate object namesSHOULDينبغي ⁦SHOULD⁩ تفرد الأسماء؛ قد يحتفظ القارئ بالأخير أو يرفض أو يعرض الجميع.
Network exchange⁦UTF-8⁩ · ⁦RFC 8259⁩ §⁦8.1⁩يتطلب التبادل خارج بيئة مغلقة ⁦UTF-8⁩؛ لا يمنع التقريب العددي.

ما يُحفظ في الملف

حدد الأنواع قبل القراءة. لا يستعيد نص العدد المقرب أرقامه. افحص الأسماء المكررة قبل استبدالها واحفظ المصدر.

هل يتحقق ⁦JSON.parse⁩ من كل معرف طويل؟

لا: قد يقرب الأعداد ويستبدل المفاتيح. تحقق من التمثيل الأصلي أيضاً.

الوثائق الأصلية

تاريخ الاطلاع على الوثائق .

الدليل المطلوب حفظه

  • كائن الصف والمفتاح المتوقع.
  • التعريفات والأنواع والوحدات والأكواد وقواعد القيم المفقودة.
  • نسخة المخطط والملف المفحوص والشذوذ المكتشف.

مراجع رسمية

صفحات المصادر المرتبطة

بروتوكولات ذات صلة

فحوص قبل الاستنتاج

  • هل المفتاح المتوقع فريد في الملف المفحوص؟
  • هل الأنواع والوحدات والقيم المفقودة معرّفة دون افتراضات ضمنية؟
  • هل تُسجّل الفروق عن القاموس قبل الحساب؟

أسئلة شائعة

هل تكفي الأمثلة؟

لا؛ المثال يوضح قيمة والتعريف يحدد جميع القيم المقبولة.

هل يلزم إصدار لكل تنسيق؟

وثّق المخطط المشترك وفروق التوزيع: الأسماء والتنسيقات وقواعد الفراغ.

ماذا تفعل إذا كان هناك نقص في تعريف الحقل؟

البحث عن الوثائق والحفاظ على عدم اليقين. قد تساعد القيم الملاحظة في صياغة فرضية، ولكنها ليست كافية دائما لتأكيد المعنى أو العمليات ذات الصلة.

أدوات / سجلات

المعلومات المطلوب تسجيلها

اختبر التفرد ومجالات القيم والحقول المطلوبة على الملف الفعلي. الفراغ وعدم الانطباق والصفر معانٍ مختلفة. أرّخ تغييرات التعريف والأكواد والأنواع.

  • تاريخ الاطلاع والمنطقة الزمنية
  • الرابط الدقيق
  • النسخة / المراجعة
  • كائن الصف
  • اسم العمود الدقيق
  • النوع المنطقي والتنسيق
  • المنهج / التعريف
  • الوحدة / أساس الحساب
  • مجال القيم وقائمة الأكواد
  • القيم المفقودة وقبول الفراغ
  • المفتاح المتوقع والتفرد
  • المنتج / الناشر
  • القرار / الخطوة التالية
  • مسؤول المراجعة
  • المراجعة التالية

مرجع موثق

المفاتيح والقيود ضمانات مختلفة

ليس حقل ⁦id⁩ مفتاحاً أساسياً تلقائياً. المهم القيد الفعال. قواعد ⁦PostgreSQL 18⁩ وقد تختلف أنظمة أخرى مع ⁦NULL⁩.

[[null], [null]]UNIQUE → ✓UNIQUE NULLS NOT DISTINCT → ✕ · PRIMARY KEY → ✕
المفاتيح والقيود ضمانات مختلفة
المرجعالقيمة أو الصيغةما الذي يحدده
PRIMARY KEY (a)فريد وغير ⁦NULL⁩المفتاح البسيط فريد وغير ⁦NULL⁩؛ لا يثبت صحة الهوية أو ثبات الزمن.
UNIQUE (a)⁦NULL⁩ مختلفة افتراضياًيسمح ⁦UNIQUE⁩ افتراضياً بـ⁦NULL⁩ متكرر؛ لا يضمن الاكتمال.
UNIQUE NULLS NOT DISTINCT (a)⁦NULL⁩ واحدة على الأكثر في العموديسمح ⁦NULLS NOT DISTINCT⁩ بغياب واحد في العمود ⁦a⁩، لا يمنعه كله.
PRIMARY KEY (a, b)زوج فريد ومكونات غير ⁦NULL⁩المفتاح المركب يفرد الزوج لا كل مكون؛ كلاهما غير ⁦NULL⁩.
FOREIGN KEY · MATCH SIMPLEقد يعفي أي ⁦NULL⁩ المرجعقد يعفي ⁦MATCH SIMPLE⁩ المرجع عند ⁦NULL⁩ بأي مكون.
FOREIGN KEY · MATCH FULLتعفي كلها ⁦NULL⁩ فقطيعفي ⁦MATCH FULL⁩ فقط إذا كانت كلها ⁦NULL⁩؛ يفشل الخليط. أضف ⁦NOT NULL⁩ للإلزام.
CHECK (x > 0)يمر الصحيح أو المجهوليمر ⁦CHECK⁩ مع صحيح أو مجهول؛ قد يمر ⁦x⁩ الغائب باختبار ⁦x⁩ > ⁦0⁩.

مقارنة ثلاث سياسات على المفاتيح نفسها

مصفوف JSON من 0 إلى 50 صفاً؛ لكل صف 1 إلى 3 مكونات بالعدد نفسه دائماً. المكون سلسلة لا تتجاوز 64 نقطة ترميز أو null. يجب تماثل عرض الجدولين المربوطين. الحد 20000 محرف JSON لكل حقل. تظل السلسلة الفارغة قيمة مختلفة عن null.

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

حُسب المثال التعليمي؛ عدل المدخلات ثم افحصها.

الصفوف المدخلة
2
صفوف فيها NULL واحد على الأقل
2
UNIQUE
متوافق مع هذه السياسة
UNIQUE NULLS NOT DISTINCT
غير متوافق مع هذه السياسة
PRIMARY KEY
غير متوافق مع هذه السياسة
ست مجموعات تعليمية: التوافق حسب السياسة
مجموعة المفاتيحUNIQUEUNIQUE NULLS NOT DISTINCTPRIMARY KEY
[["001"],["002"]]متوافق مع هذه السياسةمتوافق مع هذه السياسةمتوافق مع هذه السياسة
[["001"],["001"]]غير متوافق مع هذه السياسةغير متوافق مع هذه السياسةغير متوافق مع هذه السياسة
[[null]]متوافق مع هذه السياسةمتوافق مع هذه السياسةغير متوافق مع هذه السياسة
[[null],[null]]متوافق مع هذه السياسةغير متوافق مع هذه السياسةغير متوافق مع هذه السياسة
[["FR",null],["FR",null]]متوافق مع هذه السياسةغير متوافق مع هذه السياسةغير متوافق مع هذه السياسة
[["FR","001"],["FI","001"]]متوافق مع هذه السياسةمتوافق مع هذه السياسةمتوافق مع هذه السياسة
بيانات المثال التعليمي الأولي
{
    "keys": [
        [
            null
        ],
        [
            null
        ]
    ]
}

ما يُحفظ في الملف

لا يجعل المفتاح الأجنبي العلاقة واحداً لواحد؛ قد يشير أبناء عدة للأصل. احفظ الأعمدة وسياسة ⁦NULL⁩. لا ينقل ⁦CSV⁩ القيود تلقائياً.

هل يبرر ⁦UNIQUE⁩ حذف التكرارات المصدرة؟

لا؛ قد تتغير وحدة الصف أو السنوات المدمجة أو مكونات المفتاح. تحقق أولاً.

الوثائق الأصلية

تاريخ الاطلاع على الوثائق .

قراءة موسعة / تطبيق عملي

وصف الحقول قبل تحويلها

يحتوي الجدول على أسماء الأعمدة القصيرة والرموز التي يصعب تفسيرها. يجب أن يقدم القاموس تعريفًا قابلًا للاستخدام ويحافظ على الفوضى غير المحددة.

آخر تحديث في .

الفحوص ذات الأولوية

وثيقة الاسم والنوع والوحدة والطرق والقيم المفقودة والأمثلة. تحديد المفاتيح والحقول التي يعتمد معنىها على متغير آخر.

أخطاء التفسير

النوع الرقمي لا يعني أنه يمكن إضافة القيم. يمكن أن يمثل الرمز فئة أو معرف أو قيمة مفقودة.

وثيقة العمل التي ينبغي حفظها

يربط القاموس الميدان الأصلي والتعريف وقواعد القراءة والمصدر الوثائقي. يتم فصل الافتراضات عن التعريفات المؤكدة.