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ợ. Phần này cũng mô tả thứ tự sắp xếp được 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 thể chứa giá trị mảng khác làm một trong các phần tử của nó. 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 mảng trở lên, các mảng sẽ được sắp xếp theo 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.v. cho đến khi tìm thấy sự khác biệt. Nếu một mảng hết các 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 phần triệu giây; mọi độ chính xác bổ sung đều được làm tròn xuống. |
| Số dấu phẩy động | Số | Độ chính xác gấp đôi 64 bit theo IEEE 754, bao gồm cả NaN và +/-Infinity (đã chuẩn hoá). |
| Điểm địa lý | Theo vĩ độ, sau đó theo kinh độ | Hiện tại, bạn không nên sử dụng loại dữ liệu này do những hạn chế về việc truy vấn. Thông thường, 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ả các trường con 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 các khoá rồi sau đó là các giá trị. Nếu các cặp khoá-giá trị đầu tiên bằng nhau, thì 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 được sắp xếp theo thứ tự tăng dần:
|
| Null | Không có | — |
| Tham khảo | Theo các phần tử đường dẫn (bộ sưu tập, mã nhận dạng tài liệu, bộ sưu tập, mã nhận dạng 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 | 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 của biểu thức UTF-8. |
| Vectơ | Theo phương diện, sau đó theo giá trị của từng phần tử | Kích thước nhúng tối đa được hỗ trợ là 2048. Để lưu trữ các vectơ có kích thước lớn hơn, hãy sử dụng giảm chiều. |
Thứ tự 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 một thứ tự xác định dựa trên các biểu thị nội bộ. Danh sách sau đây cho thấy thứ tự:
- Giá trị rỗng
- Giá trị boolean
- 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
- Cloud Firestore tệp đối chiếu
- Giá trị điểm địa lý
- Giá trị mảng
- Vectơ nhúng
- Giá trị bản đồ
Sắp xếp theo thứ tự số
Cloud Firestore sắp xếp tất cả các giá trị bằng số (Integer và Floating point) xen kẽ với nhau. Việc so sánh dấu phẩy động tuân theo thứ tự tổng của IEEE 754, ngoại trừ trường hợp đáng chú ý là Cloud Firestore chuẩn hoá tất cả các giá trị NaN và coi giá trị này nhỏ hơn -Infinity.