وقت القراءة المقدر : 5 min · تاريخ النشر
وصف عقد البيانات
اكتب قاموسًا ميدانيًا يغطي المعنى والنوع والوحدة والحالة المطلوبة والقيم المفقودة. تحديد المعرفات والعلاقات المستقرة. قد يتطلب الرمز البريدي أو رقم المنتج أو الرمز الإداري تمثيلًا نصيًا للحفاظ على معناه.
حدد التشفير والمحدد والتواريخ والمناطق الزمنية والاتفاقيات العشرية. تشرح وثائق PSV الخاصة بـ Python تكوين اللهجة ؛ لا يفرض امتداد الملف وحده اصطلاحات متطابقة على كل منتج.
صف لهجة CSV قبل عد السطور. في تنسيق RFC 4180 تحاط الحقول التي تضم فاصلة أو اقتباسًا أو سطرًا جديدًا باقتباسين مزدوجين وتضاعف الاقتباسات الداخلية. يمثل [CRLF] في الجدول زوجًا فعليًا من إرجاع العربة وتغذية السطر في الاختبار. يظل الحقل جزءًا من سجل منطقي واحد.
اختبار: رأس وسجلا بيانات مع CRLF داخل حقل مقتبس في الثاني تشغل أربعة سطور فعلية، لا أربعة سجلات. استخدم محلل CSV وقارن الحقول. يعيد قارئ Python الافتراضي سلاسل؛ فتحفظ 00120 أصفارها حتى تحويل لاحق. حدد معنى الفراغ وفتح الجدول منفصلين؛ اقتباسات CSV لا تعطل الصيغ وحدها.
مرّر الجدول أفقيًا لقراءة جميع الأعمدة. باستخدام لوحة المفاتيح، انقل التركيز إلى الجدول ثم استخدم مفاتيح الأسهم.
| مقطع توضيحي | عدد الحقول | الحقول المقروءة ممثلة نصيًا |
|---|---|---|
| "Paris, France" | 1 | ["Paris, France"] |
| "A ""B""" | 1 | ["A \"B\""] |
| "A[CRLF]B" | 1 | ["A[CRLF]B"] |
| 00120, | 2 | ["00120", ""] |
بناء دفعة تتحدى الحدود
قم بتضمين اسم مميز وقيمة مفقودة اختيارية ومعرف مع صفر بادئ ووصف متعدد الأسطر وعلاقة مفقودة. أضف نسخة مكررة وتنسيق غير صالح عمدًا. احتفظ بمجموعة البيانات هذه اصطناعية ومصنفة بوضوح على أنها بيانات اختبار.
حدد ما إذا كانت المشكلة ترفض صفًا واحدًا أو ترفض الملف أو تنتج استيرادًا بتقرير مشكلة. تجنب الإبلاغ عن النجاح أثناء إسقاط الحقول بصمت. تم قبول التقرير ورفضه ومراجعة الصفوف المطلوبة.
خطة أذونات التبادل والسلامة
تحديد من يمكنه تصدير واستيراد وإزالة دفعة. لا تضع عمليات تصدير سرية في مجلد عام بشكل افتراضي. بالنسبة للملفات المفتوحة في جداول البيانات ، راجع الحقول التي يمكن تفسيرها على أنها صيغ باستخدام طريقة مناسبة لبرنامج الاستقبال.
افصل البيانات المصرح بها عن السياق الداخلي التي يجب ألا تنتقل ، مثل التعليقات الخاصة أو تفاصيل الاتصال غير الضرورية أو المفاتيح الفنية. استخدم نسخ اختبار نظيفة أو اصطناعية. تخزين المستندات والاحتفاظ بها ومن يزيل الصادرات المؤقتة.
تسوية البيانات بعد المعالجة
قارن المعرفات والعلاقات والإجماليات والقيم التي تم أخذ عينات منها قبل وبعد المعالجة. إذا كان الدعم ذهابًا وإيابًا مطلوبًا ، فقم بالتصدير وإعادة الاستيراد إلى بيئة اختبار ، ثم قارن المعنى بدلاً من حجم الملف وحده.
احتفظ بنسخة احتياطية وسجل قبل الاستيراد المدمر. التمييز بين التحديثات والإضافات والحذف. لا يعني الصف المفقود في تصدير جزئي تلقائيًا أنه يجب حذفه. اتفق على هذه القواعد قبل معالجة قاعدة البيانات الكاملة.
التوثيق الأساسي: بيثون - قراءة وكتابة ملفات CSV.
دفعة افتراضية: تحمل ستة سجلات، بهذا الترتيب، المعرّفات النصية 00120 و00121 و00120 و00122 و00123 و00124. قبل الاستيراد يوجد 00121 بقيمة تحتاج تعديلًا، ويوجد 00122 دون تغيير. تقبل القاعدة المختارة أول ظهور للمفتاح وترفض تكراره داخل الدفعة، وترفض 00123 بسبب غياب علاقة إلزامية. تكون حصيلة المرور الأول 2 إنشاء + 1 تحديث + 1 دون تغيير + 2 رفض = 6 سجلات مفحوصة.
بعد ذلك تحتوي الوجهة على أربعة معرّفات: 00120 و00121 و00122 و00124. إعادة الدفعة نفسها تمامًا، بالقواعد نفسها ودون تغييرات أخرى، يجب أن تنتج 0 إنشاء و0 تحديث و4 دون تغيير و2 رفض. يعتمد ذلك على اتفاق الاستيراد المختار لا على خاصية تلقائية في CSV. احفظ الأصفار البادئة واحسب السجلات المنطقية التي يقرأها المحلل؛ فقد يحتوي حقل محاط بعلامتي اقتباس على فاصل سطر.
مرّر الجدول أفقيًا لقراءة جميع الأعمدة. باستخدام لوحة المفاتيح، انقل التركيز إلى الجدول ثم استخدم مفاتيح الأسهم.
| النتيجة | العدد | السجلات المعنية |
|---|---|---|
| إنشاء | 2 | 00120 و00124 |
| تحديث | 1 | 00121: قيمة مختلفة عن الوجهة |
| دون تغيير | 1 | 00122: القيمة مطابقة بالفعل |
| رفض | 2 | الظهور 3: تكرار 00120؛ الظهور 5: علاقة مفقودة لـ 00123 |
- بيثون - قراءة وكتابة ملفات CSV
Python CSV، تمت مراجعته في 22 أكتوبر 2026: القراءة والصيغ. البيانات وقواعد القبول مثال افتراضي.
تقديم صادرات بأسماء مقروءة في اللغات المنشورة.
حالة افتراضية: يحتوي اسم تصدير على العربية. اختبر filename وfilename* ونوع المحتوى والملف المحفوظ. نظّف الأسماء القادمة من إدخال قبل بناء الترويسات. لا تحمي هذه الترويسة الوصول ولا تستبدل التحقق من الصلاحيات.
- الاسم مقروء والنوع صحيح ولا يستطيع الإدخال حقن ترويسة إضافية.
- MDN Content-Disposition
مرجع للعرض أو التنزيل، بما في ذلك معلمات اسم الملف.
مقارنة التصدير وإعادة الاستيراد

حالة مقترحة: تتغير الأصفار الأولية والتواريخ بعد التصدير والاستيراد رغم ثبات عدد الصفوف.
استخدم بيانات خيالية تضم حروفًا مختلفة وقيمًا فارغة وتنسيقات متعددة. قارن الحقول منفردة وسجل التحويلات المقبولة والخاطئة.
- إعداد حالات متنوعة
- مقارنة الحقول المستوردة
- تسجيل التحويلات
- تمييز نسخ المنتجات
قم بإعداد كتالوج منتج مفيد قبل بناء المتجر
المستندات المرجعية
- MDN Content-Disposition · مصدر تمت مراجعته
- W3C WAI : Tables Tutorial · مصدر تمت مراجعته
- MDN : URLSearchParams · مصدر تمت مراجعته
- IETF : RFC 4180: CSV format · مصدر تمت مراجعته
- بيثون - قراءة وكتابة ملفات CSV · مصدر تمت مراجعته
- OWASP - حقن CSV · مصدر تمت مراجعته
تاريخ تحديث المحتوى
مراجع موثقة لهذا الموضوع
| المرجع | القيمة أو الصيغة | النطاق |
|---|---|---|
| RFC 4180 · CSV | text/csv · "a,b" | تُحاط الحقول التي تحتوي على فاصلة أو اقتباس أو سطر جديد باقتباس؛ وتُضاعف علامات الاقتباس الداخلية. |
| RFC 8259 · JSON | application/json · UTF-8 | لا يسمح JSON القياسي بالتعليقات أو الفاصلة الختامية؛ وتستخدم السلاسل علامات اقتباس مزدوجة. |
| RFC 3339 · Date-time | 2026-10-22T09:00:00+02:00 | يربط فرق التوقيت الصريح الوقت المحلي بـUTC؛ هذا المثال ليس موعدًا. |
تشير التواريخ إلى الاطلاع على المراجع. هذه المعلومات ليست تدقيقاً للموقع ولا إعلاناً شاملاً عن المطابقة.
