Cloud Firestore đảm bảo hiệu suất truy vấn bằng cách yêu cầu một chỉ mục cho mọi truy vấn. Các chỉ mục cần thiết cho các truy vấn cơ bản nhất được tạo tự động cho bạn. Khi bạn sử dụng và kiểm tra ứng dụng của mình, Cloud Firestore sẽ tạo các thông báo lỗi giúp bạn tạo các chỉ mục bổ sung mà ứng dụng của bạn yêu cầu. Trang này mô tả cách quản lý các chỉ mục trường đơn và chỉ mục tổng hợp của bạn.
Tạo chỉ mục bị thiếu thông qua thông báo lỗi
Nếu bạn thử truy vấn phức hợp với mệnh đề phạm vi không ánh xạ tới chỉ mục hiện có, thì bạn sẽ gặp lỗi. Thông báo lỗi bao gồm một liên kết trực tiếp để tạo chỉ mục bị thiếu trong bảng điều khiển Firebase.
Theo liên kết được tạo tới bảng điều khiển Firebase, xem lại thông tin được điền tự động và nhấp vào Tạo .
Vai trò và quyền
Trước khi bạn có thể tạo chỉ mục trong Cloud Firestore, hãy đảm bảo rằng bạn được chỉ định một trong các vai trò sau:
-
roles/datastore.owner
-
roles/datastore.indexAdmin
-
roles/editor
-
roles/owner
Nếu bạn đã xác định vai trò tùy chỉnh, hãy chỉ định tất cả các quyền sau để tạo chỉ mục:
-
datastore.indexes.create
-
datastore.indexes.delete
-
datastore.indexes.get
-
datastore.indexes.list
-
datastore.indexes.update
Sử dụng bảng điều khiển Firebase
Để tạo chỉ mục mới theo cách thủ công từ bảng điều khiển Firebase:
- Chuyển đến phần Cloud Firestore của bảng điều khiển Firebase .
- Chuyển đến tab Chỉ mục và nhấp vào Thêm chỉ mục .
- Nhập tên bộ sưu tập và đặt các trường bạn muốn sắp xếp chỉ mục theo.
- Nhấp vào Tạo .
Các chỉ mục có thể mất vài phút để tạo, tùy thuộc vào kích thước của truy vấn. Sau khi bạn tạo chúng, bạn có thể xem các chỉ mục của mình và trạng thái của chúng trong phần Chỉ mục tổng hợp. Nếu họ vẫn đang xây dựng, bảng điều khiển Firebase sẽ có thanh trạng thái tòa nhà.
Xóa chỉ mục
Để xóa một chỉ mục:
- Chuyển đến phần Cloud Firestore của bảng điều khiển Firebase .
- Nhấp vào tab Chỉ mục .
- Di chuột qua chỉ mục bạn muốn xóa và chọn Xóa từ menu ngữ cảnh.
- Xác nhận rằng bạn muốn xóa nó bằng cách nhấp vào Xóa khỏi cảnh báo.
Sử dụng Firebase CLI
Bạn cũng có thể triển khai các chỉ mục với Firebase CLI . Để bắt đầu, hãy chạy firebase init firestore
trong thư mục dự án của bạn. Trong quá trình thiết lập, Firebase CLI tạo một tệp JSON với các chỉ mục mặc định ở định dạng chính xác. Chỉnh sửa tệp để thêm nhiều chỉ mục hơn và triển khai nó bằng lệnh firebase deploy
. Nếu bạn chỉ muốn triển khai các chỉ mục, hãy thêm cờ --only firestore:indexes
. Nếu bạn chỉnh sửa các chỉ mục bằng bảng điều khiển Firebase, hãy đảm bảo rằng bạn cũng cập nhật tệp chỉ mục cục bộ của mình. Tham khảo tài liệu tham khảo định nghĩa chỉ mục JSON .
Thời gian xây dựng chỉ mục
Để tạo chỉ mục, Cloud Firestore phải thiết lập chỉ mục rồi chèn lấp chỉ mục bằng dữ liệu hiện có. Thời gian xây dựng chỉ mục là tổng của thời gian thiết lập và thời gian chèn lấp:
Việc thiết lập một chỉ mục mất vài phút. Thời gian xây dựng tối thiểu cho một chỉ mục là vài phút, ngay cả đối với cơ sở dữ liệu trống.
Thời gian chèn lấp phụ thuộc vào lượng dữ liệu hiện có thuộc về chỉ mục mới. Càng nhiều giá trị trường khớp với định nghĩa chỉ mục thì càng mất nhiều thời gian để chèn lấp chỉ mục.
Việc xây dựng chỉ mục là các hoạt động kéo dài .
Sau khi bạn bắt đầu xây dựng chỉ mục, Cloud Firestore sẽ gán cho hoạt động một tên duy nhất. Tên hoạt động có tiền tố là projects/[PROJECT_ID]/databases/(default)/operations/
, ví dụ:
projects/project-id/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg
Tuy nhiên, bạn có thể bỏ tiền tố khi chỉ định tên hoạt động cho lệnh describe
.
Liệt kê tất cả các hoạt động chạy dài
Để liệt kê các hoạt động chạy dài, hãy sử dụng lệnh danh sách hoạt động của gcloud firestore . Lệnh này liệt kê các hoạt động đang diễn ra và đã hoàn thành gần đây. Các hoạt động được liệt kê trong một vài ngày sau khi hoàn thành:
gcloud firestore operations list
Kiểm tra tình trạng hoạt động
Thay vì liệt kê tất cả các hoạt động kéo dài, bạn có thể liệt kê chi tiết của một hoạt động:
gcloud firestore operations describe operation-name
Ước tính thời gian hoàn thành
Khi thao tác của bạn chạy, hãy xem giá trị của trường state
để biết trạng thái chung của thao tác.
Yêu cầu về trạng thái của một hoạt động chạy dài cũng trả về chỉ số workEstimated
và workCompleted
. Các số liệu này được trả về cho số lượng tài liệu. workEstimated
hiển thị tổng số tài liệu ước tính mà một thao tác sẽ xử lý. workCompleted
hiển thị số lượng tài liệu được xử lý cho đến nay. Sau khi thao tác hoàn tất, workCompleted
phản ánh tổng số tài liệu đã thực sự được xử lý, giá trị này có thể khác với giá trị của workEstimated
.
Chia workCompleted
theo workEstimated
để ước tính tiến độ sơ bộ. Ước tính có thể không chính xác vì nó phụ thuộc vào việc thu thập số liệu thống kê bị trì hoãn.
Ví dụ: đây là trạng thái tiến trình của việc xây dựng chỉ mục:
{ "operations": [ { "name": "projects/project-id/operations/AyAyMDBiM2U5NTgwZDAtZGIyYi0zYjc0LTIzYWEtZjg1ZGdWFmZWQHEjF0c2Flc3UtcmV4ZWRuaS1uaW1kYRUKSBI", "metadata": { "@type": "type.googleapis.com/google.firestore.admin.v1.IndexOperationMetadata", "common": { "operationType": "CREATE_INDEX", "startTime": "2020-06-23T16:52:25.697539Z", "state": "PROCESSING" }, "progressDocuments": { "workCompleted": "219327", "workEstimated": "2198182" } }, }, ...
Khi một hoạt động được thực hiện, mô tả hoạt động sẽ chứa "done": true
. Xem giá trị của trường state
để biết kết quả của thao tác. Nếu trường done
không được đặt trong phản hồi, thì giá trị của nó là false
. Không phụ thuộc vào sự tồn tại của giá trị done
cho các hoạt động đang diễn ra.
Lỗi xây dựng chỉ mục
Bạn có thể gặp phải lỗi xây dựng chỉ mục khi quản lý chỉ mục tổng hợp và miễn trừ chỉ mục trường đơn. Thao tác lập chỉ mục có thể không thành công nếu Cloud Firestore gặp sự cố với dữ liệu mà nó đang lập chỉ mục. Thông thường nhất, điều này có nghĩa là bạn đã đạt đến giới hạn chỉ mục . Ví dụ: thao tác có thể đã đạt đến số mục nhập chỉ mục tối đa trên mỗi tài liệu.
Nếu việc tạo chỉ mục không thành công, bạn sẽ thấy thông báo lỗi trong bảng điều khiển. Sau khi bạn xác minh rằng bạn không đạt đến bất kỳ giới hạn chỉ mục nào , hãy thử lại thao tác lập chỉ mục của bạn.