إدارة الفهارس

MongoDB API

استخدِم طريقة createIndex() لإنشاء فهرس نصي. في المثال التالي، عند كتابة مستند في المجموعة cities مع ملء الحقلين country أو food، يتم فهرسة هذين الحقلين لأغراض البحث.

db.cities.createIndex({"country": "text", "food": "text"})

يجب أن يكون الحقل عبارة عن سلسلة أو صفيف من السلاسل ليتم فهرسته، ولا تتم فهرسة فهارس الصفيف، وبالتالي، ستؤدي فهرسة a.1.b إلى فهرسة something في {a: {1: {b: something}}}، ولكن ليس في {a: [one, {b: something}]}.

يمكنك أيضًا إنشاء فهارس باستخدام db.runCommand(). يمكنك إنشاء فهرس نصي واحد فقط لكل مجموعة، ولكن يمكنك إنشاء فهارس متعددة من أنواع مختلفة في db.runCommand() واحد. يستخدم المثال التالي db.runCommand() لإنشاء فهرس نصي:

db.runCommand({
  createIndexes: "cities",
  indexes: [
    {
      key: { "country": "text", "food": "text" },
      name: "country_text_food_text"
    }
  ]
})

تحديد لغة تلقائية

يمكنك أيضًا تحديد لغة تلقائية أو مسار حقل في المستند يتضمّن اللغة التلقائية.

في المثال التالي، تم تحديد myLanguageField كـ language_override. عندما يحتوي مستند في المجموعة cities على حقل باسم myLanguageField، يتم استخدام قيمة هذا الحقل لتحديد اللغة التي سيتم بها فهرسة الحقل country لهذا المستند المحدّد. تلغي هذه القيمة اللغة التلقائية لـ french.

db.cities.createIndex({"country": "text"}, {"default_language": "french", "language_override": "myLanguageField"})

• يمكنك إدخال اللغة إما باسمها الكامل (english) أو باستخدام رمز اللغة المكوّن من حرفَين وفقًا لمعيار ISO (en).
• في حال عدم ضبط اللغة التلقائية، سيتم ضبط Cloud Firestore تلقائيًا على اللغة الإنجليزية.
• يجب أن يكون حقل تجاهل اللغة حقل مستوى أعلى. في حال عدم ضبط الحقل، سيتم ضبطه تلقائيًا على language.
• إذا ضبطت اللغة التلقائية على الحرف null، لن يستخدم Cloud Firestore أي حقل كبديل للغة.

تقسيم فهرس نصي

يمكنك أيضًا تقسيم الفهرس باستخدام حقل لتتمكّن من فلترة طلبات البحث حسب قيمة حقل معيّنة. تتيح لك هذه الإعدادات التنفيذ السريع للاستعلامات إذا كنت بحاجة دائمًا إلى فلترة حقل معيّن في الفهرس الذي تستعلم عنه.

لإنشاء فهرس مع قسم، اضبط حقل firestoreOptions على النحو التالي:

db.runCommand({
  createIndexes: "cities",
  indexes: [
    {
      key: { "country": "text", "food": "text"},
      name: "country_text_food_text"
      firestoreOptions: {"customPartitionFields": ["PARTITIONED_FIELD"]
    }
  ]
})

المكان:

• PARTITIONED_FIELD هو اسم الحقل المستخدَم في التقسيم، ويجب أن تكون هذه القيمة سلسلة ويجب أن تشير إلى حقل من المستوى الأعلى. عند تنفيذ طلب بحث على فهرس مقسَّم، يمكنك فلترة النتائج استنادًا إلى قيمة هذا الحقل. على سبيل المثال، يمكنك تقسيم الفهرس باستخدام city. إذا تم تحديد حقل city في فهرس النص، يمكن للمستخدمين البحث عن مدينة معيّنة.

  يجب أن يكون القسم حقلاً واحدًا فقط. إذا قسّمت فهرسًا، يمكنك تنفيذ الاستعلامات التي تم فيها تحديد الحقل المقسّم فقط.

القيود

• يمكنك إنشاء فهرس واحد فقط لكل طلب.
• تستخدم سجلّات التدقيق لإنشاء الفهرس باستخدام واجهة برمجة التطبيقات MongoDB اسم الطريقة google.firestore.admin.v1.FirestoreAdmin.CreateIndex.
• للاطّلاع على خيارات الفهرس المتوافقة، يُرجى الرجوع إلى الفهارس وخصائص الفهرس.

وحدة تحكُّم Firebase

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة قاعدة بيانات Firestore.

   الانتقال إلى "قاعدة بيانات Firestore"

2. اختَر قاعدة بيانات من قائمة قواعد البيانات.

3. في علامة التبويب الفهارس، انقر على إنشاء فهرس.

4. أدخِل معرّف مجموعة.

5. أضِف مسار حقل واحدًا أو أكثر واختَر خيار فهرس لكل مسار.

6. انقر على إنشاء.

7. يظهر الفهرس الجديد في قائمة الفهارس، وتبدأ العمليات المتوافقة مع MongoDB في إنشاء الفهرس. وعند اكتمال إنشاء الفهرس، ستظهر علامة اختيار خضراء بجانبه. وإذا لم يتم إنشاء الفهرس، يمكنك الاطّلاع على أخطاء إنشاء الفهرس لمعرفة الأسباب المحتملة.

MongoDB API

استخدِم طريقة createIndex() لإنشاء فهرس. على سبيل المثال:

db.restaurants.createIndex({"location" : "2dsphere", "region": "2dsphere"})

يتيح db.runCommand() أيضًا إنشاء الفهرس مع فهرس واحد على الأكثر:

db.runCommand({
  createIndexes: "restaurants",
  indexes: [
    {
      key: { "location": "2dsphere", "region": "2dsphere" },
      name: "location_2dsphere_region_2dsphere"
    }
  ]
})

تقسيم فهرس 2dsphere

يمكنك أيضًا تقسيم الفهرس باستخدام حقل لتتمكّن من فلترة طلبات البحث حسب قيمة حقل معيّنة. تتيح لك هذه الإعدادات التنفيذ السريع للاستعلامات إذا كنت بحاجة دائمًا إلى فلترة حقل معيّن في الفهرس الذي تستعلم عنه.

لإنشاء فهرس مع قسم، اضبط حقل firestoreOptions على النحو التالي:

db.runCommand({
  createIndexes: "restaurants",
  indexes: [
    {
      key: { "location": "2dsphere", "region": "2dsphere" },
      name: "location_2dsphere_region_2dsphere"
      firestoreOptions: {"customPartitionFields": ["PARTITIONED_FIELD"]
    }
  ]
})

المكان:

• PARTITIONED_FIELD هو اسم الحقل المستخدَم في التقسيم. عند تنفيذ طلب بحث على فهرس مقسَّم، يمكنك فلترة النتائج استنادًا إلى قيمة هذا الحقل. على سبيل المثال، إذا كان الفهرس يتضمّن الحقل region الخاص بالمواقع الجغرافية الإقليمية، يمكنك تقسيم الفهرس باستخدام region ليتمكّن المستخدمون من البحث عن المطاعم في منطقتهم.

  إذا قسّمت فهرسًا، يمكنك فقط تنفيذ طلبات البحث التي تم فيها تحديد الحقل المقسّم.

القيود

• يمكنك إنشاء فهرس واحد فقط لكل طلب.
• تستخدم سجلّات التدقيق لإنشاء الفهرس باستخدام واجهة برمجة التطبيقات MongoDB اسم الطريقة google.firestore.admin.v1.FirestoreAdmin.CreateIndex.
• للاطّلاع على خيارات الفهرس المتوافقة، يُرجى الرجوع إلى الفهارس وخصائص الفهرس.

وحدة تحكُّم Firebase

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة قاعدة بيانات Firestore.

   الانتقال إلى "قاعدة بيانات Firestore"

2. اختَر قاعدة بيانات من قائمة قواعد البيانات.

3. في علامة التبويب الفهارس، انقر على إنشاء فهرس.

4. أدخِل معرّف مجموعة.

5. أضِف مسار حقل واحدًا أو أكثر واختَر خيار فهرس لكل مسار.

6. انقر على إنشاء.

7. يظهر الفهرس الجديد في قائمة الفهارس، وتبدأ العمليات المتوافقة مع MongoDB في إنشاء الفهرس. وعند اكتمال إنشاء الفهرس، ستظهر علامة اختيار خضراء بجانبه. وإذا لم يتم إنشاء الفهرس، يمكنك الاطّلاع على أخطاء إنشاء الفهرس لمعرفة الأسباب المحتملة.