رمز محول إلى عدد
احفظ الرمز الدقيق واختبر بقاء الأصفار الأولى عند التحميل.
أدلة عملية معمقة
وصف مستوى الصف والأعمدة والأنواع والوحدات والقيم المفقودة والمفاتيح قبل الحساب أو الربط.
آخر تحديث :

رسم توضيحي مولّد بالذكاء الاصطناعي
اسم العمود لا يكفي لفهم الملف. يربط القاموس الحقول بتعريفاتها ومجالات القيم ونسخة المخطط. ميّز مجموعة البيانات عن توزيعاتها مثل CSV وAPI.
حدد الكائن والإقليم والفترة: شركة-سنة تختلف عن منشأة-شهر. وضح المفتاح الفريد المتوقع والعلاقات بالجداول.
لكل عمود اكتب الاسم الدقيق والتعريف والنوع والتنسيق والوحدة والأكواد وقبول الفراغ والمنشأ. احفظ المعرّفات ذات الأصفار الأولى كنص.
اختبر التفرد ومجالات القيم والحقول المطلوبة على الملف الفعلي. الفراغ وعدم الانطباق والصفر معانٍ مختلفة. أرّخ تغييرات التعريف والأكواد والأنواع.
ورشة قراءة البيانات
يحدد عقد DEMO صفاً لكل ملف. قواعده مختلقة ولا تصف سجلاً حقيقياً.
بيانات وسجلات افتراضية للتعلم: لا تأتي هذه النتائج من استعلام مباشر لأي خدمة.
التوزيعة JSON: record_id سلسلة من أربعة أرقام وstate يساوي OPEN أو CLOSED وamount عدد عشري أو null. يجب أن يكون record_id فريداً. حالة الحروف والأنواع جزء من العقد.
إذا تجاوز الجدول الشاشة فمرره أفقياً؛ تعمل أسهم لوحة المفاتيح عند تركيز المنطقة.
| الحقل أو القاعدة | القيمة المختبرة | قراءة العقد | الإجراء |
|---|---|---|---|
| record_id: نص | "0042"; العدد 42 | تقبل السلسلة ويخالف العدد النوع | ارفض 42 دون اختلاق أصفاره. |
| state: رمز مطابق | OPEN; open | يقبل OPEN ويخرج open عن المجال | لا تغير الحروف دون قاعدة معتمدة. |
| amount: عدد أو null | 12.5; "12.5"; null; "" | يقبل العدد وnull وترفض السلسلتان | تعني null مجهولاً؛ لا صفر افتراضي. |
| تفرد record_id | صفان يحملان "0042" | يتكرر المفتاح ولو اختلف المبلغان | لا تعتمد المخرج واطلب مستوى الرصد الصحيح. |
افتح كل اقتراح لمقارنة تشخيصه. قد تبقى فحوص إضافية ضرورية.
لا؛ يمحو المخالفات ويضيف افتراضات لا يتضمنها العقد.
نعم. افصل أخطاء النوع والرموز غير المقبولة وتكرار المفتاح ثم عالجها بالتوثيق أو مع المنتج.
لا؛ يميزهما عقد JSON هذا. قد يملك CSV قاعدة أخرى توثق منفصلة.
العقد: DEMO، صف لكل ملف، JSON record_id: نص من أربعة أرقام ومفتاح فريد state: OPEN أو CLOSED بحروف مطابقة amount: عدد عشري أو null؛ null=مجهول المخالفات: نوع ورمز وسلسلة فارغة ومفتاح مكرر القرار: حفظ الخام وعدم اعتماد المخرج
تلخص الصياغة عقداً تعليمياً لا مخططاً تنفيذياً كاملاً. لا يفحص التمرين ملفاً للمستخدم.
احفظ الرمز الدقيق واختبر بقاء الأصفار الأولى عند التحميل.
حدد العملة والمقياس والفترة قبل الجمع؛ لا تستنتج الوحدة من الحجم.
قراءة موجهة لمقطع
في هذا المثال الافتراضي، يصف كل صف موقعًا لسنة واحدة. يحدد القاموس التالي قواعد القراءة؛ وتتضمن البيانات خللًا مقصودًا.
تمرين خيالي: توضح المعرفات والقيم والتواريخ التحقق. المقطع ليس ردا جمع مباشرة.
يجب أن يكون الزوج site_id وyear فريدًا. يمكن أن يظهر الموقع نفسه في سنوات مختلفة.
site_id معرّف نصي من ثلاثة أرقام. amount_kEUR مبلغ سنوي بآلاف اليورو؛ وتعني الخلية الفارغة أن القيمة غير مبلّغ عنها.
قارن أزواج المفاتيح واحفظ الأصفار الأولى وميّز المبلغ الصفري من المبلغ المجهول قبل التجميع.
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لا. عالج أولًا تكرار المفتاح مع المنتج وحدد طريقة التعامل مع القيم المفقودة. جمع القيم المعروفة وحدها يخفي الصف المجهول وقد يحتسب الموقع والسنة نفسيهما مرتين. احتفظ بالصفوف الأصلية ووثّق القرار.
مراجع رسمية : W3C — Model for Tabular Data and Metadata on the Web
تمرين مع الحل
مثال افتراضي: القيم والوثائق لتعلم الطريقة ولا تصف مؤسسة حقيقية.
يعرّف المنتج amount بآلاف اليورو مقربة إلى عُشر. لا يذكر القاموس الداخلي إلا «عدد»، ولم تُقدم المبالغ الخام.
إذا تجاوز الجدول الشاشة فمرره أفقياً؛ تعمل أسهم لوحة المفاتيح عند تركيز المنطقة.
| الصف | amount |
|---|---|
| A | 1.2 |
| B | 2.5 |
مجموع المنشور 3.7 آلاف يورو، أي 3 700 يورو. لا تضيف كتابة 3.70 دقة. حدد الوحدة واشرح أن المجموع يعتمد قيماً مقربة لا مبالغ دقيقة معروفة.
إذا توفرت مبالغ خام غير مقربة، فاحسبها منفصلة وحدد نسختها. أضف حالة غياب إلى البيانات الافتراضية؛ تعني amount=0 مبلغاً صفرياً معروفاً، بينما لا تقدم الخلية المعلنة مجهولة أي مبلغ. وثّق رمز الغياب وتحقق من أن الاستيراد لا يحوله بصمت إلى صفر قبل التجميع.
احفظ التعريف والوحدة والمقياس والدقة ورموز الغياب ومثالاً صحيحاً.
مرجع توثيقي : W3C — CSV on the Web: A Primer · تاريخ الاطلاع
مرجع موثق
تعنون RFC 6901 قيمة داخل JSON؛ ليست JSONPath أو عملية تعديل. يستخدم القارئ وثيقة تعليمية مخترعة لا مشاهدات، ويفصل القيمة والمسار الغائب والصياغة غير الصحيحة.
| المرجع | القيمة أو الصيغة | ما الذي يحدده |
|---|---|---|
| "" | Root value | تختار السلسلة الفارغة الوثيقة كلها، لا غياب النتائج. |
| / | Empty member name | تختار الشرطة المائلة وحدها خاصية اسمها فارغ إن وجدت، لا الجذر. |
| ~1 | / inside member name | يرمز للشرطة المائلة داخل الاسم بـ~1. تختلف خاصية a/b عن a التي تحتوي b. |
| ~0 | ~ inside member name | يرمز للتلدة بـ~0. فك ~1 قبل ~0: تعني ~01 الاسم الحرفي ~1 لا شرطة مائلة. |
| /items/0 | Zero-based array index | يبدأ فهرس المصفوفة بصفر؛ عدد صحيح غير سالب دون أصفار بادئة زائدة. |
| /items/01 | Invalid array index | ليس 01 فهرس مصفوفة صالحاً لكنه قد يكون مفتاح كائن حرفياً. |
| /items/- | No existing array member | تشير الشرطة إلى ما بعد العنصر الأخير، غير الموجود للقراءة؛ ليست إضافة تلقائية. |
| #/a~1b | URI-fragment form | يبدأ جزء URI بـ# ويطبق فك URI. رمز النسبة يحتاج ترميزاً هناك لا في الصيغة النصية. |
وثيقة مخترعة للتمرين: الأرقام ليست مشاهدات. قراءة محلية دون طلبات أو تعديل الوثيقة.
{
"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 والصفر والنص الفارغ. قد لا يحل مسار صحيح إلى قيمة؛ لا تخترع صفراً. لا تتغير المفاتيح بلغة الواجهة.
توجد الخاصية وتحمل null صراحة. الخاصية الغائبة لا تحل إلى قيمة؛ يختلف الأثر في الربط والتحويل لجدول.
تاريخ الاطلاع على الوثائق .
مرجع موثق
تحدد RFC 8259 الصياغة لا الدقة المطلقة. قد تتغير الأعداد الطويلة عند القراءة. أمثلة تعليمية لا معرفات ممنوحة.
| المرجع | القيمة أو الصيغة | ما الذي يحدده |
|---|---|---|
| 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 names | SHOULD | ينبغي SHOULD تفرد الأسماء؛ قد يحتفظ القارئ بالأخير أو يرفض أو يعرض الجميع. |
| Network exchange | UTF-8 · RFC 8259 §8.1 | يتطلب التبادل خارج بيئة مغلقة UTF-8؛ لا يمنع التقريب العددي. |
حدد الأنواع قبل القراءة. لا يستعيد نص العدد المقرب أرقامه. افحص الأسماء المكررة قبل استبدالها واحفظ المصدر.
لا: قد يقرب الأعداد ويستبدل المفاتيح. تحقق من التمثيل الأصلي أيضاً.
تاريخ الاطلاع على الوثائق .
لا؛ المثال يوضح قيمة والتعريف يحدد جميع القيم المقبولة.
وثّق المخطط المشترك وفروق التوزيع: الأسماء والتنسيقات وقواعد الفراغ.
البحث عن الوثائق والحفاظ على عدم اليقين. قد تساعد القيم الملاحظة في صياغة فرضية، ولكنها ليست كافية دائما لتأكيد المعنى أو العمليات ذات الصلة.
أدوات / سجلات
اختبر التفرد ومجالات القيم والحقول المطلوبة على الملف الفعلي. الفراغ وعدم الانطباق والصفر معانٍ مختلفة. أرّخ تغييرات التعريف والأكواد والأنواع.
مرجع موثق
ليس حقل id مفتاحاً أساسياً تلقائياً. المهم القيد الفعال. قواعد PostgreSQL 18 وقد تختلف أنظمة أخرى مع NULL.
| المرجع | القيمة أو الصيغة | ما الذي يحدده |
|---|---|---|
| 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 أو تحويل أنواع. تصف النتائج الصفوف المدخلة وحدها ولا تصدق قيود قاعدة فعلية.
حُسب المثال التعليمي؛ عدل المدخلات ثم افحصها.
| مجموعة المفاتيح | UNIQUE | UNIQUE NULLS NOT DISTINCT | PRIMARY KEY |
|---|---|---|---|
| [["001"],["002"]] | متوافق مع هذه السياسة | متوافق مع هذه السياسة | متوافق مع هذه السياسة |
| [["001"],["001"]] | غير متوافق مع هذه السياسة | غير متوافق مع هذه السياسة | غير متوافق مع هذه السياسة |
| [[null]] | متوافق مع هذه السياسة | متوافق مع هذه السياسة | غير متوافق مع هذه السياسة |
| [[null],[null]] | متوافق مع هذه السياسة | غير متوافق مع هذه السياسة | غير متوافق مع هذه السياسة |
| [["FR",null],["FR",null]] | متوافق مع هذه السياسة | غير متوافق مع هذه السياسة | غير متوافق مع هذه السياسة |
| [["FR","001"],["FI","001"]] | متوافق مع هذه السياسة | متوافق مع هذه السياسة | متوافق مع هذه السياسة |
{
"keys": [
[
null
],
[
null
]
]
}لا يجعل المفتاح الأجنبي العلاقة واحداً لواحد؛ قد يشير أبناء عدة للأصل. احفظ الأعمدة وسياسة NULL. لا ينقل CSV القيود تلقائياً.
لا؛ قد تتغير وحدة الصف أو السنوات المدمجة أو مكونات المفتاح. تحقق أولاً.
تاريخ الاطلاع على الوثائق .
قراءة موسعة / تطبيق عملي
يحتوي الجدول على أسماء الأعمدة القصيرة والرموز التي يصعب تفسيرها. يجب أن يقدم القاموس تعريفًا قابلًا للاستخدام ويحافظ على الفوضى غير المحددة.
آخر تحديث في .
وثيقة الاسم والنوع والوحدة والطرق والقيم المفقودة والأمثلة. تحديد المفاتيح والحقول التي يعتمد معنىها على متغير آخر.
النوع الرقمي لا يعني أنه يمكن إضافة القيم. يمكن أن يمثل الرمز فئة أو معرف أو قيمة مفقودة.
يربط القاموس الميدان الأصلي والتعريف وقواعد القراءة والمصدر الوثائقي. يتم فصل الافتراضات عن التعريفات المؤكدة.