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

وحدة تحكُّم Firebase

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

   الانتقال إلى Firestore Database

2. اختَر قاعدة بيانات من قائمة قواعد البيانات.
3. في علامة التبويب الفهارس، انقر على إنشاء فهرس.
4. أدخِل معرّف المجموعة.
5. أضِف مسار حقل واحدًا أو أكثر وحدِّد خيار فهرسة لكلّ منها.
6. حدِّد خيارًا لتوفّر الحقل، إما "غير متناثر" أو "متناثر".
7. انقر على إنشاء.
8. يظهر الفهرس الجديد في قائمة الفهارس ويبدأ Cloud Firestore في إنشاء الفهرس. عند إنشاء الفهرس، ستظهر علامة صح خضراء بجانب الفهرس. إذا لم يتم إنشاء الفهرس، يمكنك الاطّلاع على أخطاء إنشاء الفهرس لمعرفة الأسباب المحتملة.

gcloud CLI

لإنشاء فهرس، استخدِم الأمر gcloud firestore indexes composite create.

gcloud firestore indexes composite create \
--database='DATABASE_ID' \
--collection-group=COLLECTION \
--field-config=FIELD_CONFIGURATION \
--query-scope=collection-group \
--density=dense

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

• ‫DATABASE_ID: معرِّف قاعدة البيانات
• ‫COLLECTION: اسم المجموعة
• ‫FIELD_CONFIGURATION: إعدادات الحقل لكل حقل، أضِف --field-config=field-path=. على سبيل المثال:

      --field-config=field-path=user-id,order=descending \
      --field-config=field-path=score,order=descending
      

  لمزيد من المعلومات حول ضبط هذه الحقول، يُرجى الاطّلاع على --field-config.

لإنشاء فهرس متناثر، اضبط --density=sparse-any.

لإنشاء فهرس فريد، أضِف العلامة --unique.

Terraform

استخدِم المرجع google_firestore_index.

resource "google_firestore_index" "index" {
  database    = "DATABASE_ID"
  collection  = "COLLECTION"
  query_scope = "COLLECTION_GROUP"

  // You can include multiple field blocks
  fields {
    field_path = "FIELD_PATH"
    order      = "ORDER"
  }

  // Optional
  multikey = true
  density  = "DENSITY"
}

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

• ‫DATABASE_ID: معرّف قاعدة البيانات التي اخترتها
• ‫COLLECTION: اسم المجموعة المطلوب فهرستها
• ‫FIELD_PATH: اسم الحقل المطلوب فهرسته
• ‫ORDER: إما ASCENDING أو DESCENDING
• ‫DENSITY: إما SPARSE_ANY أو DENSE

Google Cloud Console

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

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

2. اختَر قاعدة بيانات من قائمة قواعد البيانات.
3. في قائمة التنقّل، انقر على الفهارس.
4. اختياري: أدخِل اسمًا للفهرس.
5. انتقِل إلى نوع البحث واختَر نص.
6. أدخِل معرّف المجموعة.
7. اضبط حقلاً واحدًا أو أكثر لفهرسته.
8. اضبط نطاق طلب البحث للفهرس.
9. اختَر لغة تلقائية.
10. اختياري: يمكنك ضبط مسار تجاوز اللغة على اسم حقل يحتوي على إعداد لغة المستند.
11. انقر على إنشاء.
12. يظهر الفهرس الجديد في قائمة الفهارس ويبدأ Cloud Firestore في إنشاء الفهرس. عند إنشاء الفهرس، تظهر علامة صح خضراء بجانبه.

gcloud CLI

لإنشاء فهرس نصي، استخدِم الأمر gcloud firestore indexes composite create:

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"}]}}' \
  --search-index-options=text-language=en \
  --async

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

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

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

Google Cloud Console

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

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

2. اختَر قاعدة بيانات من قائمة قواعد البيانات.
3. في قائمة التنقّل، انقر على الفهارس.
4. اختياري: أدخِل اسمًا للفهرس.
5. انتقِل إلى نوع البحث (Search Type) واختَر الموقع الجغرافي (2dsphere) (Geo (2dsphere)).
6. أدخِل معرّف المجموعة.
7. اضبط حقلاً واحدًا أو أكثر لفهرسته.
8. اضبط نطاق طلب البحث للفهرس.
9. انقر على إنشاء.

يظهر الفهرس الجديد في قائمة الفهارس ويبدأ Cloud Firestore في إنشاء الفهرس. عند إنشاء الفهرس، تظهر علامة صح خضراء بجانبه.

gcloud CLI

لإنشاء فهرس جغرافي مكاني، استخدِم الأمر gcloud firestore indexes composite create:

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

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

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

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

وحدة تحكُّم Firebase

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

   الانتقال إلى Firestore Database

2. اختَر قاعدة بيانات من قائمة قواعد البيانات.
3. انقر على علامة التبويب الفهارس.
4. في قائمة الفهارس، انقر على حذف من الزر المزيد more_vert للفهرس الذي تريد حذفه.
5. انقر على حذف الفهرس.

gcloud CLI

1. للعثور على اسم الفهرس، استخدِم الأمر gcloud firestore indexes composite list.

   gcloud firestore indexes composite list \
   --database='DATABASE_ID'

   استبدِل DATABASE_ID بمعرّف قاعدة البيانات.

2. لحذف الفهرس، استخدِم الأمر gcloud firestore indexes composite delete.

   gcloud firestore indexes composite delete INDEX_NAME \
   --database='DATABASE_ID'

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

   • ‫INDEX_NAME: اسم الفهرس
   • ‫DATABASE_ID: معرِّف قاعدة البيانات