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

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 Database

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

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

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

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

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

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

gcloud CLI

لإنشاء فهرس نصي، استخدِم الأمر gcloud firestore indexes composite create. اضبط النوع --api-scope على mongodb-compatible-api.

gcloud firestore indexes composite create \
  --database='DATABASE_ID' \
  --collection-group=COLLECTION_GROUP \
  --field-config=field-path=FIELD_NAME,search-config='{"text-spec": {"index-specs": [{"index-type": "tokenized", "match-type": "match-globally"}]}}' \
  --api-scope=mongodb-compatible-api \
  --search-index-options=text-language=en \
  --async

غيِّر القيم في السلسلة على الشكل التالي:

• ‫DATABASE_ID: معرِّف قاعدة البيانات
• ‫COLLECTION_GROUP: معرّف المجموعة المطلوب فهرستها
• ‫FIELD_NAME: اسم الحقل المطلوب فهرسته

تُشغِّل العلامة --async عملية إنشاء الفهرس في الخلفية.

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 Database

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

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

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

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

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

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

gcloud CLI

لإنشاء فهرس 2dsphere، استخدِم الأمر gcloud firestore indexes composite create. اضبط النوع --api-scope على mongodb-compatible-api.

gcloud firestore indexes composite create \
  --database='DATABASE_ID' \
  --collection-group=COLLECTION_GROUP \
  --field-config=field-path=FIELD_NAME,search-config='{"geo-spec": {}}' \
  --api-scope=mongodb-compatible-api \
  --async

غيِّر القيم في السلسلة على الشكل التالي:

• ‫DATABASE_ID: معرِّف قاعدة البيانات
• ‫COLLECTION_GROUP: معرّف المجموعة المطلوب فهرستها
• ‫FIELD_NAME: اسم الحقل المطلوب فهرسته

تُشغِّل العلامة --async عملية إنشاء الفهرس في الخلفية.