Các loại dữ liệu được hỗ trợ

Trang này mô tả các loại dữ liệu mà Cloud Firestore hỗ trợ.

Kiểu dữ liệu

Bảng sau đây liệt kê các loại dữ liệu được 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í đã chỉ định cho chúng. Khi sắp xếp 2 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 các mả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 số phần tử cần so sánh nhưng vẫn bằng đ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ụ: [1, 2, 3] < [1, 2, 3, 1] < [2]. Mảng [2] có giá trị phần tử đầu tiên lớn nhất. Mảng [1, 2, 3] có các phần tử bằng 3 phần tử đầu tiên của [1, 2, 3, 1] nhưng có độ dài ngắn hơn.

Boolean false < true
Byte Thứ tự byte Lên đến 1.048.487 byte (1 MiB – 89 byte). Chỉ có 1.500 byte đầu tiên được xem xét bởi các truy vấn.
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 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 những hạn chế đối với việc truy vấn. Thường thì 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 truy vấn địa lý dựa trên khoảng cách đơn giản, 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 lập chỉ mục, bạn có thể truy vấn trên các trường phụ. Nếu bạn loại trừ giá trị này khỏi quá trình lập chỉ mục, thì tất cả các trường phụ cũng sẽ bị loại trừ khỏi quá trình lập chỉ mục.

Thứ tự khoá luôn được sắp xếp. Ví dụ: nếu bạn viết {c: "foo", a: "bar", b: "qux"}, bản đồ sẽ được sắp xếp theo khoá và được lưu dưới dạng {a: "bar", b: "qux", c: "foo"}.

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 đó so sánh các 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ì chiều dài bản đồ sẽ được xem xét. Ví dụ: các bản đồ sau đây theo thứ tự tăng dần:

{a: "aaa", b: "baz"}
{a: "foo", b: "bar"}
{a: "foo", b: "bar", c: "qux"}
{a: "foo", b: "baz"}
{b: "aaa", c: "baz"}
{c: "aaa"}

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 giá trị biểu diễn UTF-8.
Vectơ Theo phương diện, sau đó theo từng giá trị 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.

Thứ tự loại giá trị

Khi một truy vấn liên quan đến một trường có giá trị thuộc các kiểu kết hợp, Cloud Firestore sẽ sử dụng thứ tự tất định dựa trên cách trình bày nội bộ. Danh sách sau đây hiển thị thứ tự:

  1. Giá trị rỗng
  2. Giá trị boolean
  3. Giá trị NaN
  4. Giá trị số nguyên và dấu phẩy động, được sắp xếp theo thứ tự số
  5. Giá trị ngày
  6. Giá trị chuỗi văn bản
  7. Giá trị byte
  8. Tài liệu tham khảo về Cloud Firestore
  9. Giá trị điểm địa lý
  10. Giá trị mảng
  11. Nhúng vectơ
  12. Giá trị bản đồ