لا يدعم MongoDB، وهو قاعدة بيانات NoSQL، ملفات CSV بشكلٍ أصلي. ومع ذلك، فإن استيراد البيانات من ملفات CSV إلى مجموعات MongoDB الخاصة بك عملية مباشرة باستخدام أداة سطر الأوامر mongoimport
. يوفر هذا الدليل شرحًا شاملاً.
جدول المحتويات
- فهم ملفات CSV
- استخدام
mongoimport
- معالجة فاصلات مختلفة
- استكشاف أخطاء استيراد البيانات وإصلاحها
- الخلاصة
فهم ملفات CSV
ملف CSV (Comma Separated Values) هو ملف نصي بسيط حيث يمثل كل سطر سجلاً (أو مستندًا في MongoDB). يتم فصل القيم داخل كل سجل بواسطة فاصلات، وعادةً ما تكون فواصل. على سبيل المثال:
name,age,city
John Doe,30,New York
Jane Smith,25,London
Peter Jones,40,Paris
يستخدم هذا المثال فاصلة كفاصل. تشمل الفواصل الشائعة الأخرى الفواصل المنقوطة (;)، والعلامات التبويب ( )، والخطوط العمودية (|) فهم بنية ملف CSV الخاص بك، بما في ذلك الفاصل وما إذا كان يحتوي على صف رأس، أمر بالغ الأهمية لنجاح الاستيراد.
استخدام mongoimport
أمر mongoimport
هو أداة سطر أوامر متضمنة مع MongoDB. فيما يلي بناء الجملة الأساسي:
mongoimport --db <database_name> --collection <collection_name> --type csv --file <path_to_csv_file> --headerline
الخيارات:
--db <database_name>
: اسم قاعدة البيانات. سيقومmongoimport
بإنشائها إذا لم تكن موجودة.--collection <collection_name>
: اسم المجموعة داخل قاعدة البيانات.--type csv
: يحدد نوع ملف الإدخال.--file <path_to_csv_file>
: المسار الكامل لملف CSV الخاص بك.--headerline
: يشير إلى أن السطر الأول يحتوي على رؤوس (أسماء الحقول). قم بحذف هذا إذا كان ملف CSV الخاص بك يفتقر إلى صف الرأس.
مثال:
لاستيراد /data/users.csv
إلى قاعدة بيانات mydb
ومجموعة users
:
mongoimport --db mydb --collection users --type csv --file /data/users.csv --headerline
معالجة فاصلات مختلفة
بالنسبة لملفات CSV التي تحتوي على فاصلات بخلاف الفواصل، استخدم خيارات --fieldsEnclosed
و --fieldDelimiter
. على سبيل المثال، ملف مفصول بفواصل منقوطة مع علامات اقتباس مزدوجة كأقواس للحقول:
mongoimport --db mydb --collection users --type csv --file /data/users.csv --headerline --fieldsEnclosed '"' --fieldDelimiter ';'
استكشاف أخطاء استيراد البيانات وإصلاحها
يوفر mongoimport
مخرجات تشير إلى النجاح أو الفشل. راجع بعناية أي رسائل خطأ. تشمل المشكلات الشائعة مسارات الملفات غير الصحيحة، أو الخيارات المفقودة (مثل --headerline
)، أو مشاكل في تنسيق ملف CSV. تأكد من أن ملف CSV الخاص بك تم تنسيقه بشكل صحيح وأن المسار صحيح. يمكن استخدام محرر نصوص لفحص ملف CSV بحثًا عن أحرف غير متوقعة أو عدم اتساقات للمساعدة في حل المشكلات.
الخلاصة
استيراد بيانات CSV إلى MongoDB باستخدام mongoimport
عملية فعالة ومباشرة. إن فهم خيارات الأمر وبنية ملف CSV الخاص بك يضمن عملية استيراد سلسة. تحقق دائمًا من المخرجات بحثًا عن الأخطاء وافحص ملف CSV الخاص بك بعناية بحثًا عن أي عدم اتساق في التنسيق لحل أي مشكلات قد تنشأ.