จัดการดัชนี

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() ได้ด้วย คุณสามารถมีดัชนีข้อความได้เพียง 1 รายการต่อคอลเล็กชัน แต่สามารถสร้างดัชนีหลายรายการที่มีประเภทแตกต่างกันใน 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 แบบ 2 ตัวอักษร (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 ในดัชนีข้อความ ผู้ใช้จะค้นหาเมืองที่เจาะจงได้

  พาร์ติชันต้องมีเพียงช่องเดียว หากแบ่งพาร์ติชันดัชนี คุณจะเรียกใช้ได้เฉพาะการค้นหาที่ระบุฟิลด์ที่แบ่งพาร์ติชันไว้เท่านั้น

ข้อจำกัด

• คุณสร้างดัชนีได้เพียง 1 รายการต่อคำขอ
• บันทึกการตรวจสอบสำหรับการสร้างดัชนีด้วย MongoDB API จะใช้ชื่อเมธอด google.firestore.admin.v1.FirestoreAdmin.CreateIndex
• ดูตัวเลือกดัชนีที่รองรับได้ที่ดัชนีและพร็อพเพอร์ตี้ดัชนี

คอนโซล Firebase

1. ในคอนโซล Firebase ให้ไปที่หน้าฐานข้อมูล Firestore

   ไปที่ฐานข้อมูล Firestore

2. เลือกฐานข้อมูลจากรายการฐานข้อมูล

3. ในแท็บดัชนี ให้คลิกสร้างดัชนี

4. ป้อนรหัสคอลเล็กชัน

5. เพิ่มเส้นทางฟิลด์อย่างน้อย 1 รายการ แล้วเลือกตัวเลือกดัชนีสำหรับแต่ละรายการ

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() โดยมีดัชนีได้สูงสุด 1 รายการ ดังนี้

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 เพื่อให้ผู้ใช้ค้นหาร้านอาหารในภูมิภาคของตนได้

  หากแบ่งพาร์ติชันดัชนี คุณจะเรียกใช้การค้นหาได้เฉพาะในกรณีที่มีการระบุฟิลด์ที่แบ่งพาร์ติชันไว้เท่านั้น

ข้อจำกัด

• คุณสร้างดัชนีได้เพียง 1 รายการต่อคำขอ
• บันทึกการตรวจสอบสำหรับการสร้างดัชนีด้วย MongoDB API จะใช้ชื่อเมธอด google.firestore.admin.v1.FirestoreAdmin.CreateIndex
• ดูตัวเลือกดัชนีที่รองรับได้ที่ดัชนีและพร็อพเพอร์ตี้ดัชนี

คอนโซล Firebase

1. ในคอนโซล Firebase ให้ไปที่หน้าฐานข้อมูล Firestore

   ไปที่ฐานข้อมูล Firestore

2. เลือกฐานข้อมูลจากรายการฐานข้อมูล

3. ในแท็บดัชนี ให้คลิกสร้างดัชนี

4. ป้อนรหัสคอลเล็กชัน

5. เพิ่มเส้นทางฟิลด์อย่างน้อย 1 รายการ แล้วเลือกตัวเลือกดัชนีสำหรับแต่ละรายการ

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 จะเรียกใช้การดำเนินการสร้างดัชนีในเบื้องหลัง