Quản lý chỉ mục

MongoDB API

Sử dụng phương thức createIndex() để tạo chỉ mục văn bản. Trong ví dụ sau, khi một tài liệu được ghi vào tập hợp cities có các trường country hoặc food được điền sẵn, các trường này sẽ được lập chỉ mục cho mục đích tìm kiếm.

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

Trường phải là một chuỗi hoặc một mảng chuỗi cần được lập chỉ mục. Chỉ mục mảng không được lập chỉ mục tìm kiếm. Do đó, việc lập chỉ mục a.1.b sẽ lập chỉ mục something trong {a: {1: {b: something}}}, nhưng không lập chỉ mục trong {a: [one, {b: something}]}.

Bạn cũng có thể tạo chỉ mục bằng db.runCommand(). Bạn chỉ có thể có một chỉ mục văn bản cho mỗi tập hợp, nhưng có thể tạo nhiều chỉ mục thuộc nhiều loại trong một db.runCommand(). Ví dụ sau đây sử dụng db.runCommand() để tạo chỉ mục văn bản:

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

Chỉ định ngôn ngữ mặc định

Bạn cũng có thể tuỳ ý chỉ định ngôn ngữ mặc định hoặc đường dẫn trường trong tài liệu sẽ chứa ngôn ngữ mặc định.

Trong ví dụ sau, myLanguageField được chỉ định là language_override. Khi một tài liệu trong tập hợp cities chứa một trường có tên là myLanguageField, giá trị của trường đó sẽ được dùng để xác định ngôn ngữ lập chỉ mục trường country cho tài liệu cụ thể đó. Giá trị đó sẽ ghi đè ngôn ngữ mặc định của french.

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

• Bạn có thể nhập ngôn ngữ dưới dạng tên đầy đủ (english) hoặc mã ngôn ngữ ISO gồm hai chữ cái (en).
• Nếu bạn không đặt ngôn ngữ mặc định, thì Cloud Firestore sẽ mặc định là tiếng Anh.
• Trường ghi đè ngôn ngữ phải là trường cấp cao nhất. Nếu bạn không đặt, trường ghi đè ngôn ngữ sẽ mặc định là language.
• Nếu bạn đặt ngôn ngữ mặc định thành ký tự null, thì Cloud Firestore sẽ không sử dụng bất kỳ trường nào làm ngôn ngữ ghi đè.

Phân vùng chỉ mục văn bản

Bạn cũng có thể phân vùng chỉ mục bằng một trường để có thể lọc truy vấn theo một giá trị trường cụ thể. Cấu hình này cho phép bạn chạy các truy vấn hiệu quả hơn nếu bạn luôn cần lọc một trường cụ thể trong chỉ mục mà bạn đang truy vấn.

Để tạo chỉ mục có phân vùng, hãy định cấu hình trường firestoreOptions như sau:

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

Địa điểm:

• PARTITIONED_FIELD là tên của trường được dùng cho phân vùng. Giá trị này phải là một chuỗi và phải tham chiếu đến một trường cấp cao nhất. Khi chạy một truy vấn đối với chỉ mục được phân vùng, bạn có thể lọc kết quả dựa trên giá trị của trường này. Ví dụ: bạn có thể phân vùng chỉ mục bằng city. Nếu bạn xác định trường city trong chỉ mục văn bản, thì người dùng có thể truy vấn một thành phố cụ thể.

  Phân vùng chỉ được có một trường. Nếu phân vùng một chỉ mục, thì bạn chỉ có thể chạy các truy vấn trong đó trường được phân vùng được chỉ định.

Giới hạn

• Bạn chỉ có thể tạo một chỉ mục cho mỗi yêu cầu.
• Nhật ký kiểm tra cho việc tạo chỉ mục bằng API MongoDB sử dụng tên phương thức google.firestore.admin.v1.FirestoreAdmin.CreateIndex.
• Để biết các tuỳ chọn chỉ mục được hỗ trợ, hãy xem phần chỉ mục và thuộc tính chỉ mục.

bảng điều khiển của Firebase

1. Trong bảng điều khiển của Firebase, hãy chuyển đến trang Firestore Database (Cơ sở dữ liệu Firestore).

   Chuyển đến Firestore Database

2. Chọn một cơ sở dữ liệu trong danh sách cơ sở dữ liệu.

3. Trong thẻ Chỉ mục, hãy nhấp vào Tạo chỉ mục.

4. Nhập Mã bộ sưu tập.

5. Thêm một hoặc nhiều đường dẫn trường và chọn một tuỳ chọn chỉ mục cho mỗi đường dẫn.

6. Nhấp vào Tạo.

7. Chỉ mục mới của bạn sẽ xuất hiện trong danh sách chỉ mục và các thao tác tương thích với MongoDB sẽ bắt đầu tạo chỉ mục của bạn. Khi chỉ mục được tạo, bạn sẽ thấy dấu kiểm màu xanh lục bên cạnh chỉ mục đó. Nếu chỉ mục không được tạo, hãy xem phần Lỗi tạo chỉ mục để biết các nguyên nhân có thể xảy ra.

gcloud CLI

Để tạo chỉ mục văn bản, hãy dùng lệnh gcloud firestore indexes composite create. Thiết lập --api-scope thành 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

Thay thế nội dung sau:

• DATABASE_ID: mã nhận dạng cơ sở dữ liệu.
• COLLECTION_GROUP: mã nhận dạng của tập hợp cần lập chỉ mục.
• FIELD_NAME: tên của trường cần lập chỉ mục.

Cờ --async chạy thao tác tạo chỉ mục ở chế độ nền.

MongoDB API

Sử dụng phương thức createIndex() để tạo chỉ mục. Ví dụ:

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

Việc tạo chỉ mục bằng db.runCommand() cũng được hỗ trợ với tối đa một chỉ mục:

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

Phân vùng chỉ mục 2dsphere

Bạn cũng có thể phân vùng chỉ mục bằng một trường để có thể lọc truy vấn theo một giá trị trường cụ thể. Cấu hình này cho phép bạn chạy các truy vấn hiệu quả hơn nếu bạn luôn cần lọc một trường cụ thể trong chỉ mục mà bạn đang truy vấn.

Để tạo chỉ mục có phân vùng, hãy định cấu hình trường firestoreOptions như sau:

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

Địa điểm:

• PARTITIONED_FIELD là tên của trường được dùng cho phân vùng. Khi chạy một truy vấn đối với chỉ mục được phân vùng, bạn có thể lọc kết quả dựa trên giá trị của trường này. Ví dụ: nếu chỉ mục của bạn có trường region cho vị trí theo khu vực, bạn có thể phân vùng chỉ mục bằng region để người dùng có thể truy vấn các nhà hàng trong khu vực của họ.

  Nếu phân vùng một chỉ mục, thì bạn chỉ có thể chạy các truy vấn trong đó trường được phân vùng được chỉ định.

Giới hạn

• Bạn chỉ có thể tạo một chỉ mục cho mỗi yêu cầu.
• Nhật ký kiểm tra cho việc tạo chỉ mục bằng API MongoDB sử dụng tên phương thức google.firestore.admin.v1.FirestoreAdmin.CreateIndex.
• Để biết các tuỳ chọn chỉ mục được hỗ trợ, hãy xem phần chỉ mục và thuộc tính chỉ mục.

bảng điều khiển của Firebase

1. Trong bảng điều khiển của Firebase, hãy chuyển đến trang Firestore Database (Cơ sở dữ liệu Firestore).

   Chuyển đến Firestore Database

2. Chọn một cơ sở dữ liệu trong danh sách cơ sở dữ liệu.

3. Trong thẻ Chỉ mục, hãy nhấp vào Tạo chỉ mục.

4. Nhập Mã bộ sưu tập.

5. Thêm một hoặc nhiều đường dẫn trường và chọn một tuỳ chọn chỉ mục cho mỗi đường dẫn.

6. Nhấp vào Tạo.

7. Chỉ mục mới của bạn sẽ xuất hiện trong danh sách chỉ mục và các thao tác tương thích với MongoDB sẽ bắt đầu tạo chỉ mục của bạn. Khi chỉ mục được tạo, bạn sẽ thấy dấu kiểm màu xanh lục bên cạnh chỉ mục đó. Nếu chỉ mục không được tạo, hãy xem phần Lỗi tạo chỉ mục để biết các nguyên nhân có thể xảy ra.

gcloud CLI

Để tạo chỉ mục 2dsphere, hãy dùng lệnh gcloud firestore indexes composite create. Thiết lập --api-scope thành 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

Thay thế nội dung sau:

• DATABASE_ID: mã nhận dạng cơ sở dữ liệu.
• COLLECTION_GROUP: mã nhận dạng của tập hợp cần lập chỉ mục.
• FIELD_NAME: tên của trường cần lập chỉ mục.

Cờ --async chạy thao tác tạo chỉ mục ở chế độ nền.