Trang này mô tả các loại dữ liệu mà Cloud Firestore hỗ trợ.
Loại dữ liệu
Bảng sau đây liệt kê các loại dữ liệu mà Cloud Firestore hỗ trợ. Trường này cũng mô tả thứ tự sắp xếp được sử dụng khi so sánh các giá trị cùng loại:
| Loại dữ liệu | Thứ tự sắp xếp | Lưu ý |
|---|---|---|
| Mảng | Theo giá trị phần tử |
Một mảng không được chứa một giá trị mảng khác làm một trong các phần tử của mảng đó. Trong một mảng, các phần tử duy trì vị trí được chỉ định cho chúng. Khi sắp xếp hai hoặc nhiều mảng, các mảng được sắp xếp dựa trên giá trị phần tử của chúng.
Khi so sánh hai mảng, các phần tử đầu tiên của mỗi mảng sẽ được so sánh. Nếu các phần tử đầu tiên bằng nhau, thì các phần tử thứ hai sẽ được so sánh và tiếp tục như vậy cho đến khi tìm thấy sự khác biệt. Nếu một mảng hết phần tử để so sánh nhưng bằng nhau cho đến thời điểm đó, thì mảng ngắn hơn sẽ được sắp xếp trước mảng dài hơn. Ví dụ: |
| Boolean | false < true |
— |
| Byte | Thứ tự byte | Tối đa 1.048.487 byte (1 MiB – 89 byte). Các truy vấn chỉ xem xét 1.500 byte đầu tiên. |
| Ngày và giờ | Theo thứ tự thời gian | Khi được lưu trữ trong Cloud Firestore, chỉ chính xác đến micrô giây; mọi độ chính xác bổ sung sẽ được làm tròn xuống. |
| Số dấu phẩy động | Số | Độ chính xác kép 64 bit, IEEE 754. |
| Điểm địa lý | Theo vĩ độ, rồi đến kinh độ | Hiện tại, bạn không nên sử dụng loại dữ liệu này do các hạn chế về truy vấn. Nhìn chung, bạn nên lưu trữ vĩ độ và kinh độ dưới dạng các trường số riêng biệt. Nếu ứng dụng của bạn cần các truy vấn địa lý đơn giản dựa trên khoảng cách, hãy xem phần Truy vấn địa lý |
| Số nguyên | Số | 64 bit, đã ký |
| Bản đồ | Theo khoá, sau đó theo giá trị | Đại diện cho một đối tượng được nhúng trong tài liệu. Khi được lập chỉ mục, bạn có thể truy vấn trên các trường con. Nếu bạn loại trừ giá trị này khỏi việc lập chỉ mục, thì tất cả trường phụ cũng sẽ bị loại trừ khỏi việc lập chỉ mục.
Thứ tự khoá luôn được sắp xếp. Ví dụ: nếu bạn viết Các trường ánh xạ được sắp xếp theo khoá và so sánh theo cặp khoá-giá trị, trước tiên là so sánh khoá, sau đó là so sánh giá trị. Nếu cặp khoá-giá trị đầu tiên bằng nhau, các cặp khoá-giá trị tiếp theo sẽ được so sánh, v.v. Nếu hai bản đồ có tất cả các cặp khoá-giá trị giống nhau, thì độ dài bản đồ sẽ được xem xét. Ví dụ: các bản đồ sau đây theo thứ tự tăng dần:
|
| NaN (Không phải số) | Không có | — |
| Null | Không có | — |
| Tham khảo | Theo các phần tử đường dẫn (bộ sưu tập, mã tài liệu, bộ sưu tập, mã tài liệu...) | Ví dụ: projects/[PROJECT_ID]/databases/[DATABASE_ID]/documents/[DOCUMENT_PATH]. |
| Chuỗi văn bản | Thứ tự byte được mã hoá UTF-8 | Lên đến 1.048.487 byte (1 MiB – 89 byte). Các truy vấn chỉ xem xét 1.500 byte đầu tiên của bản trình bày UTF-8. |
| Vectơ | Theo phương diện, sau đó theo giá trị của từng phần tử | Phương diện nhúng được hỗ trợ tối đa là 2048. Để lưu trữ vectơ có kích thước lớn hơn, hãy dùng tính năng giảm kích thước. |
Sắp xếp loại giá trị
Khi một truy vấn liên quan đến một trường có các giá trị thuộc nhiều loại, Cloud Firestore sẽ sử dụng thứ tự xác định dựa trên các bản trình bày nội bộ. Danh sách sau đây cho thấy thứ tự:
- Giá trị rỗng
- Giá trị boolean
- Giá trị NaN
- Giá trị số nguyên và dấu phẩy động, được sắp xếp theo thứ tự số
- Giá trị ngày
- Giá trị chuỗi văn bản
- Giá trị byte
- Tham chiếu Cloud Firestore
- Giá trị điểm địa lý
- Giá trị mảng
- Nhúng vectơ
- Ánh xạ giá trị