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 được Cloud Firestore hỗ trợ. Bảng 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 | Ghi chú |
|---|---|---|
| Hàm TOCOL | Theo giá trị phần tử |
Trong cơ sở dữ liệu phiên bản Standard, một mảng không được chứa một giá trị mảng khác dưới dạng một trong các phần tử của mảng đó. Trong cơ sở dữ liệu phiên bản Enterprise, một mảng có thể chứa giá trị mảng dưới dạng 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, 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 | Trong cơ sở dữ liệu phiên bản Standard, giá trị không được vượt quá 1.048.487 byte (1 MiB – 89 byte) và các truy vấn chỉ xem xét 1.500 byte đầu tiên. Trong cơ sở dữ liệu phiên bản Enterprise, không có giới hạn về kích thước của giá trị (ngoài giới hạn kích thước mục nhập chỉ mục và tài liệu) và toàn bộ giá trị được các truy vấn xem xét. |
| Ngày và giờ | Theo trình tự thời gian | Khi được lưu trữ trong Cloud Firestore, chỉ chính xác đến micro 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 kép 64 bit theo IEEE 754, bao gồm cả NaN và +/-Infinity (đã chuẩn hoá). |
| Điểm địa lý | Theo vĩ độ, sau đó theo kinh độ | Để tìm kiếm dựa trên khoảng cách, hãy xem phần Tìm kiếm không gian đị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 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 bản đồ được sắp xếp theo khoá và so sánh theo cặp khoá-giá trị, trước tiên so sánh các khoá rồi đến 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à cứ tiếp tục như vậy. 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ó | — |
| Tài liệu 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á theo UTF-8 | Trong cơ sở dữ liệu phiên bản Standard, giá trị không được vượt quá 1.048.487 byte (1 MiB – 89 byte) và các truy vấn chỉ xem xét 1.500 byte đầu tiên. Trong cơ sở dữ liệu phiên bản Enterprise, không có giới hạn về kích thước của giá trị (ngoài giới hạn kích thước mục nhập chỉ mục và tài liệu) và toàn bộ giá trị được các truy vấn xem xét. |
| 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ữ vectơ có kích thước lớn hơn, hãy sử dụng tính năng giảm kích thước. |
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 thứ tự tất định dựa trên các giá trị đại diện 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 số
Cloud Firestore sắp xếp tất cả giá trị số (Integer và Floating point) xen kẽ với nhau. Phép so sánh dấu phẩy động tuân theo thứ tự tổng thể của IEEE 754, ngoại trừ trường hợp đáng chú ý là Cloud Firestore chuẩn hoá tất cả giá trị NaN và coi giá trị đó nhỏ hơn -Infinity.