مدیریت نمایه‌ها

کنسول Firebase

1. در کنسول Firebase، به صفحه Firestore Database بروید.

   رفتن به 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

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

1. در کنسول Google Cloud، به صفحه پایگاه‌های داده بروید.

   رفتن به پایگاه‌های داده

2. پایگاه داده‌ای را از فهرست پایگاه‌های داده انتخاب کنید.
3. در منو پیمایش، روی نمایه‌ها کلیک کنید.
4. اختیاری: نامی برای نمایه وارد کنید.
5. به نوع جستجو بروید و جغرافیایی (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 Database بروید.

   رفتن به 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: شناسه پایگاه داده