Package google.firestore.v1

map<string, Value>

Kết quả của các hàm tổng hợp, ví dụ: COUNT(*) AS total_docs.

Khoá là alias được gán cho hàm tổng hợp khi nhập vào và kích thước của tệp ánh xạ này bằng số hàm tổng hợp trong truy vấn.

Value

Giá trị trong mảng.

string

Bắt buộc. Tên cơ sở dữ liệu. Ở định dạng: projects/{project_id}/databases/{database_id}.

string

Tên tài liệu cần truy xuất. Ở định dạng: projects/{project_id}/databases/{database_id}/documents/{document_path}. Yêu cầu sẽ không thành công nếu bất kỳ tài liệu nào không phải là tài nguyên con của database đã cho. Những tên trùng lặp sẽ bị loại bỏ.

DocumentMask

Các trường cần trả về. Nếu bạn không đặt chính sách này, hệ thống sẽ trả về tất cả các trường.

Nếu một tài liệu có một trường không có trong mặt nạ này, thì trường đó sẽ không được trả về trong phản hồi.

bytes

Đọc tài liệu trong một giao dịch.

TransactionOptions

Bắt đầu một giao dịch mới và đọc tài liệu. Mặc định là giao dịch chỉ có thể đọc. Mã giao dịch mới sẽ được trả về dưới dạng phản hồi đầu tiên trong luồng.

Timestamp

Đọc tài liệu như tại thời điểm đã cho.

Đây phải là một dấu thời gian có độ chính xác là micrô giây trong vòng 1 giờ qua, hoặc nếu tính năng Khôi phục tại một thời điểm đang bật, thì đây cũng có thể là dấu thời gian cả phút trong vòng 7 ngày qua.

bytes

Giao dịch đã bắt đầu theo yêu cầu này. Sẽ chỉ được thiết lập trong phản hồi đầu tiên và chỉ khi BatchGetDocumentsRequest.new_transaction được thiết lập trong yêu cầu.

Timestamp

Thời gian tài liệu được đọc. Số liệu này có thể tăng lên một cách đơn điệu, trong trường hợp này, các tài liệu trước đó trong luồng kết quả được đảm bảo không thay đổi giữa thời gian đọc và thời gian đọc này.

Document

Tài liệu đã được yêu cầu.

string

Tên tài liệu đã được yêu cầu nhưng không tồn tại. Ở định dạng: projects/{project_id}/databases/{database_id}/documents/{document_path}.

string

Bắt buộc. Tên cơ sở dữ liệu. Ở định dạng: projects/{project_id}/databases/{database_id}.

Write

Các quyền cần ghi để áp dụng.

Phương thức không áp dụng cho việc ghi ở cấp độ nguyên tử và không đảm bảo thứ tự. Mỗi lượt ghi có thể thực hiện thành công hoặc không thành công một cách độc lập. Bạn không thể ghi vào cùng một tài liệu nhiều lần cho mỗi yêu cầu.

map<string, string>

Các nhãn được liên kết với thao tác ghi hàng loạt này.

WriteResult

Kết quả của việc áp dụng hoạt động ghi.

Kết quả ghi thứ i này tương ứng với lần ghi thứ i trong yêu cầu.

Status

Trạng thái áp dụng lượt ghi.

Trạng thái ghi thứ i này tương ứng với lần ghi thứ i trong yêu cầu.

string

Bắt buộc. Tên cơ sở dữ liệu. Ở định dạng: projects/{project_id}/databases/{database_id}.

TransactionOptions

Các tuỳ chọn cho giao dịch. Mặc định là giao dịch đọc-ghi.

bytes

Giao dịch đã được bắt đầu.

bytes

Các byte mã hoá chuỗi bit. Có thể có độ dài bằng 0.

int32

Số bit của byte cuối cùng trong bitmap cần bỏ qua dưới dạng "khoảng đệm". Nếu độ dài của bitmap bằng 0 thì giá trị này phải là 0. Nếu không, giá trị này phải nằm trong khoảng từ 0 đến 7.

BitSequence

Dữ liệu về bộ lọc bông hoa.

int32

Số lượng hàm băm mà thuật toán sử dụng.

string

Bắt buộc. Tên cơ sở dữ liệu. Ở định dạng: projects/{project_id}/databases/{database_id}.

Write

Các quyền cần ghi để áp dụng.

Luôn thực thi tỉ mỉ và theo thứ tự.

bytes

Nếu được đặt, sẽ áp dụng tất cả các lượt ghi trong giao dịch này và cam kết.

WriteResult

Kết quả của việc áp dụng hoạt động ghi.

Kết quả ghi thứ i này tương ứng với lần ghi thứ i trong yêu cầu.

Timestamp

Thời gian thực hiện cam kết. Bất kỳ lượt đọc nào có read_time bằng hoặc lớn hơn đều đảm bảo thấy được hiệu quả của lệnh xác nhận.

string

Bắt buộc. Tài nguyên mẹ. Ví dụ: projects/{project_id}/databases/{database_id}/documents hoặc projects/{project_id}/databases/{database_id}/documents/chatrooms/{chatroom_id}

string

Bắt buộc. Mã bộ sưu tập, so với parent, so với danh sách. Ví dụ: chatrooms.

string

Mã tài liệu do khách hàng chỉ định để sử dụng cho tài liệu này.

Không bắt buộc. Nếu bạn không chỉ định, dịch vụ sẽ gán một mã nhận dạng.

Document

Bắt buộc. Tài liệu cần tạo. Không được đặt name.

DocumentMask

Các trường cần trả về. Nếu bạn không đặt chính sách này, hệ thống sẽ trả về tất cả các trường.

Nếu tài liệu có một trường không có trong mặt nạ này, thì trường đó sẽ không được trả về trong phản hồi.

Value

Các giá trị đại diện cho một vị trí, theo thứ tự mà chúng xuất hiện theo thứ tự theo mệnh đề của truy vấn.

Có thể chứa ít giá trị hơn giá trị được chỉ định theo mệnh đề thứ tự theo.

bool

Nếu vị trí ngay trước hoặc ngay sau các giá trị đã cho, so với thứ tự sắp xếp mà truy vấn xác định.

string

Bắt buộc. Tên tài nguyên của Tài liệu cần xoá. Ở định dạng: projects/{project_id}/databases/{database_id}/documents/{document_path}.

Precondition

Điều kiện tiên quyết (không bắt buộc) trên tài liệu. Yêu cầu sẽ không thành công nếu giá trị này được thiết lập nhưng tài liệu đích không đáp ứng.

string

Tên tài nguyên của tài liệu, ví dụ: projects/{project_id}/databases/{database_id}/documents/{document_path}.

map<string, Value>

Timestamp

Chỉ có đầu ra. Thời gian tạo tài liệu.

Giá trị này tăng đơn điệu khi một tài liệu bị xoá rồi tạo lại. Giá trị này cũng có thể được so sánh với giá trị trong các tài liệu khác và read_time của truy vấn.

Timestamp

Chỉ có đầu ra. Thời điểm tài liệu được thay đổi lần gần đây nhất.

Ban đầu, giá trị này được đặt thành create_time, sau đó tăng lên đơn điệu mỗi khi thực hiện thay đổi đối với tài liệu. Giá trị này cũng có thể được so sánh với giá trị trong các tài liệu khác và read_time của truy vấn.

Document

Trạng thái mới của Document.

Nếu bạn đặt mask, thì chỉ chứa các trường đã được cập nhật hoặc thêm.

int32

Một tập hợp mã mục tiêu của các mục tiêu phù hợp với tài liệu này.

int32

Một tập hợp mã mục tiêu cho các mục tiêu không còn khớp với tài liệu này.

string

Tên tài nguyên của Document đã bị xoá.

int32

Một bộ mã mục tiêu cho các mục tiêu trước đây đã khớp với thực thể này.

Timestamp

Dấu thời gian đọc khi quan sát thấy thao tác xoá.

Lớn hơn hoặc bằng commit_time của thao tác xoá.

string

Danh sách các đường dẫn trường trong mặt nạ. Hãy xem Document.fields để tham khảo cú pháp đường dẫn trường.

string

Tên tài nguyên của Document đã bị ẩn.

int32

Một bộ mã mục tiêu cho các mục tiêu trước đây đã khớp với tài liệu này.

Timestamp

Dấu thời gian đọc khi quan sát thấy hoạt động xoá.

Lớn hơn hoặc bằng commit_time của thay đổi/xoá/xoá.

string

Tên của tài liệu cần chuyển đổi.

FieldTransform

Danh sách các phép biến đổi theo thứ tự áp dụng cho các trường trong tài liệu. Không được để trống trường này.

string

Đường dẫn của trường. Hãy xem Document.fields để tham khảo cú pháp đường dẫn trường.

ServerValue

Đặt trường này thành giá trị máy chủ đã cho.

Value

Cộng giá trị đã cho vào giá trị hiện tại của trường.

Đây phải là một số nguyên hoặc một giá trị kép. Nếu trường không phải là số nguyên hoặc giá trị kép hoặc nếu trường chưa tồn tại, phép biến đổi sẽ đặt trường này thành giá trị đã cho. Nếu một trong hai giá trị đã cho hoặc giá trị của trường hiện tại tăng gấp đôi, thì cả hai giá trị sẽ được hiểu là tăng gấp đôi. Số học kép và biểu diễn các giá trị kép tuân theo ngữ nghĩa của IEEE 754. Nếu bị tràn số nguyên dương/âm, thì trường này sẽ được phân giải thành số nguyên dương/âm có độ lớn lớn nhất.

Value

Đặt trường thành giá trị tối đa hiện tại của trường và giá trị đã cho.

Đây phải là một số nguyên hoặc một giá trị kép. Nếu trường không phải là số nguyên hoặc giá trị kép hoặc nếu trường chưa tồn tại, phép biến đổi sẽ đặt trường này thành giá trị đã cho. Nếu áp dụng phép toán tối đa khi trường và giá trị đầu vào thuộc kiểu kết hợp (nghĩa là một là số nguyên và một là số nhân đôi), thì trường sẽ nhận kiểu của toán hạng lớn hơn. Nếu các toán hạng là tương đương (ví dụ: 3 và 3.0), thì trường sẽ không thay đổi. 0, 0.0 và -0.0 đều bằng 0. Giá trị tối đa của một giá trị được lưu trữ bằng 0 và giá trị đầu vào bằng 0 luôn là giá trị được lưu trữ. Giá trị lớn nhất của giá trị số x và NaN bất kỳ là NaN.

Value

Đặt trường thành giá trị nhỏ nhất của giá trị hiện tại và giá trị đã cho.

Đây phải là một số nguyên hoặc một giá trị kép. Nếu trường không phải là số nguyên hoặc giá trị kép hoặc nếu trường chưa tồn tại, phép biến đổi sẽ đặt trường này thành giá trị đầu vào. Nếu áp dụng một phép toán tối thiểu khi trường và giá trị đầu vào thuộc kiểu hỗn hợp (nghĩa là một là số nguyên và một là số nhân đôi), thì trường sẽ nhận kiểu của toán hạng nhỏ hơn. Nếu các toán hạng là tương đương (ví dụ: 3 và 3.0), thì trường sẽ không thay đổi. 0, 0.0 và -0.0 đều bằng 0. Giá trị tối thiểu của một giá trị được lưu trữ bằng 0 và giá trị đầu vào bằng 0 luôn là giá trị được lưu trữ. Giá trị nhỏ nhất của giá trị số x và NaN bất kỳ là NaN.

ArrayValue

Thêm các phần tử đã cho theo thứ tự nếu chúng chưa có trong giá trị trường hiện tại. Nếu trường không phải là một mảng hoặc nếu trường này chưa tồn tại, thì trước tiên trường đó được đặt cho mảng trống.

Các số tương đương của các loại khác nhau (ví dụ: 3L và 3.0) được coi là bằng nhau khi kiểm tra xem có thiếu giá trị nào không. NaN bằng NaN và rỗng bằng với Null. Nếu giá trị nhập vào chứa nhiều giá trị tương đương, thì chỉ có giá trị đầu tiên được xem xét.

Biến đổi_kết_quả tương ứng sẽ là giá trị rỗng.

ArrayValue

Xoá tất cả các phần tử đã cho khỏi mảng trong trường. Nếu trường không phải là một mảng hoặc nếu trường này chưa tồn tại, thì trường sẽ được đặt thành mảng trống.

Số lượng tương đương của các loại khác nhau (ví dụ: 3L và 3.0) được coi là bằng nhau khi quyết định có nên xóa một phần tử hay không. NaN bằng NaN và rỗng bằng với Null. Thao tác này sẽ xoá tất cả các giá trị tương đương nếu có trùng lặp.

Biến đổi_kết_quả tương ứng sẽ là giá trị rỗng.

int64

Tổng số kết quả được trả về, bao gồm tài liệu, phép chiếu, kết quả tổng hợp, khoá.

Duration

Tổng thời gian thực thi truy vấn trong phần phụ trợ.

int64

Tổng số hoạt động đọc có thể tính phí.

Struct

Gỡ lỗi số liệu thống kê khỏi quá trình thực thi truy vấn. Xin lưu ý rằng số liệu thống kê gỡ lỗi có thể thay đổi khi Firestore phát triển. Thông tin này có thể bao gồm: { "indexes_entries_scanned": "1000", "documents_scanned": "20", "billing_details" : { "documents_billable": "20", "index_entries_billable": "1000", "min_query_cost": "0" }

int32

Mã mục tiêu được áp dụng bộ lọc này.

int32

Tổng số tài liệu khớp với target_id.

Nếu khác với số lượng tài liệu trong ứng dụng trùng khớp, thì khách hàng phải xác định thủ công những tài liệu nào không còn khớp với mục tiêu.

Ứng dụng có thể sử dụng bộ lọc nở hoa unchanged_names để hỗ trợ việc xác định này bằng cách kiểm tra TẤT CẢ tên tài liệu so với bộ lọc; nếu tên tài liệu KHÔNG có trong bộ lọc, thì có nghĩa là tài liệu đó không còn khớp với mục tiêu.

BloomFilter

Bộ lọc nở hoa, bất kể tên của bộ lọc, chứa mã hoá byte UTF-8 cho tên tài nguyên của TẤT CẢ các tài liệu khớp với target_id, ở dạng projects/{project_id}/databases/{database_id}/documents/{document_path}.

Bộ lọc nở có thể được bỏ qua theo quyết định của máy chủ, chẳng hạn như nếu máy khách cho rằng máy khách sẽ không sử dụng bộ lọc đó hoặc nếu việc tính toán hoặc truyền tải quá tốn kém. Ứng dụng phải xử lý linh hoạt trường này khi không có trường này bằng cách quay lại logic được sử dụng trước khi trường này tồn tại; tức là thêm lại mục tiêu mà không có mã thông báo sơ yếu lý lịch để xác định xem tài liệu nào trong bộ nhớ đệm của ứng dụng không đồng bộ hoá.

PlanSummary

Thông tin về giai đoạn lập kế hoạch cho truy vấn.

ExecutionStats

Số liệu thống kê tổng hợp từ việc thực thi truy vấn. Chỉ hiển thị khi ExplainOptions.analyze được đặt thành true.

bool

Không bắt buộc. Liệu có thực thi truy vấn này hay không.

Khi giá trị là false (mặc định), truy vấn sẽ được lập kế hoạch, chỉ trả về các chỉ số trong giai đoạn lập kế hoạch.

Khi đúng, truy vấn sẽ được lên kế hoạch và thực thi, trả về kết quả truy vấn đầy đủ cùng với cả chỉ số giai đoạn lập kế hoạch và thực thi.

string

Bắt buộc. Tên tài nguyên của Tài liệu cần tải. Ở định dạng: projects/{project_id}/databases/{database_id}/documents/{document_path}.

DocumentMask

Các trường cần trả về. Nếu bạn không đặt chính sách này, hệ thống sẽ trả về tất cả các trường.

Nếu tài liệu có một trường không có trong mặt nạ này, thì trường đó sẽ không được trả về trong phản hồi.

bytes

Đọc tài liệu trong một giao dịch.

Timestamp

Đọc phiên bản của tài liệu tại một thời điểm nhất định.

Đây phải là một dấu thời gian có độ chính xác là micrô giây trong vòng 1 giờ qua, hoặc nếu tính năng Khôi phục tại một thời điểm đang bật, thì đây cũng có thể là dấu thời gian cả phút trong vòng 7 ngày qua.

string

Bắt buộc. Tài liệu gốc. Ở định dạng: projects/{project_id}/databases/{database_id}/documents/{document_path}. Ví dụ: projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

int32

Số lượng kết quả tối đa cần trả về.

string

Mã thông báo trang. Phải là một giá trị từ ListCollectionIdsResponse.

Timestamp

Đọc tài liệu như tại thời điểm đã cho.

Đây phải là một dấu thời gian có độ chính xác là micrô giây trong vòng 1 giờ qua, hoặc nếu tính năng Khôi phục tại một thời điểm đang bật, thì đây cũng có thể là dấu thời gian cả phút trong vòng 7 ngày qua.

string

Mã bộ sưu tập.

string

Mã thông báo trang có thể được dùng để tiếp tục danh sách.

string

Bắt buộc. Tên tài nguyên mẹ. Ở định dạng: projects/{project_id}/databases/{database_id}/documents hoặc projects/{project_id}/databases/{database_id}/documents/{document_path}.

Ví dụ: projects/my-project/databases/my-database/documents hoặc projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

string

Không bắt buộc. Mã bộ sưu tập, so với parent, so với danh sách.

Ví dụ: chatrooms hoặc messages.

Đây là việc không bắt buộc và nếu không được cung cấp, Firestore sẽ liệt kê tài liệu từ mọi bộ sưu tập trong parent được cung cấp.

int32

Không bắt buộc. Số tài liệu tối đa được trả về trong một phản hồi.

Firestore có thể trả về ít hơn giá trị này.

string

Không bắt buộc. Mã thông báo trang, đã nhận được từ phản hồi trước đó của ListDocuments.

Cung cấp mã này để truy xuất trang tiếp theo. Khi phân trang, tất cả các thông số khác (ngoại trừ page_size) phải khớp với các giá trị được đặt trong yêu cầu đã tạo mã thông báo trang.

string

Không bắt buộc. Thứ tự trả lại chứng từ (không bắt buộc).

Ví dụ: priority desc, __name__ desc.

Điều này phản ánh ORDER BY được dùng trong các truy vấn Firestore nhưng ở dạng chuỗi. Khi không có, giấy tờ sẽ được sắp xếp dựa trên __name__ ASC.

DocumentMask

Không bắt buộc. Các trường cần trả về. Nếu bạn không đặt chính sách này, hệ thống sẽ trả về tất cả các trường.

Nếu một tài liệu có một trường không có trong mặt nạ này, thì trường đó sẽ không được trả về trong phản hồi.

bool

Nếu danh sách hiển thị các tài liệu còn thiếu.

Tài liệu bị thiếu nếu không tồn tại nhưng có các tài liệu phụ được lồng bên dưới. Nếu đúng, những tài liệu bị thiếu đó sẽ được trả về bằng một khoá nhưng sẽ không có các trường, create_time hoặc update_time được đặt.

Yêu cầu có show_missing không được chỉ định where hoặc order_by.

bytes

Thực hiện việc đọc như một phần của giao dịch đang hoạt động.

Timestamp

Thực hiện việc đọc tại thời gian được cung cấp.

Đây phải là một dấu thời gian có độ chính xác là micrô giây trong vòng 1 giờ qua, hoặc nếu tính năng Khôi phục tại một thời điểm đang bật, thì đây cũng có thể là dấu thời gian cả phút trong vòng 7 ngày qua.

Document

Đã tìm thấy Tài liệu.

string

Mã thông báo để truy xuất trang tiếp theo của tài liệu.

Nếu trường này bị bỏ qua thì sẽ không có trang tiếp theo.

string

Bắt buộc. Tên cơ sở dữ liệu. Ở định dạng: projects/{project_id}/databases/{database_id}.

map<string, string>

Nhãn được liên kết với thay đổi mục tiêu này.

Target

Một mục tiêu để thêm vào luồng này.

int32

Mã của mục tiêu cần xoá khỏi luồng này.

TargetChange

Các mục tiêu đã thay đổi.

DocumentChange

Document đã thay đổi.

DocumentDelete

Đã xoá một Document.

DocumentRemove

Document đã bị xoá khỏi một mục tiêu (vì không còn liên quan đến mục tiêu đó nữa).

ExistenceFilter

Một bộ lọc để áp dụng cho tập hợp các tài liệu đã được trả về trước đó cho mục tiêu đã cho.

Được trả về khi tài liệu có thể đã bị xoá khỏi mục tiêu cho trước, nhưng không xác định được chính xác tài liệu.

map<string, Value>

Các trường trên bản đồ.

Các khoá bản đồ biểu thị tên trường. Tên trường khớp với biểu thức chính quy __.*__ sẽ được dành riêng. Cấm các tên trường dành riêng ngoại trừ trong một số ngữ cảnh được ghi chép nhất định. Các khoá ánh xạ, được biểu thị dưới dạng UTF-8, không được vượt quá 1.500 byte và không được để trống.

string

Bắt buộc. Tên tài nguyên mẹ. Ở định dạng: projects/{project_id}/databases/{database_id}/documents. Tên tài nguyên tài liệu không được hỗ trợ; chỉ có thể chỉ định tên tài nguyên cơ sở dữ liệu.

int64

Số điểm phân vùng tối đa mong muốn. Các phân vùng có thể được trả về trên nhiều trang kết quả. Số phải là số dương. Số lượng phân vùng thực tế được trả về có thể ít hơn.

Ví dụ: giá trị này có thể được đặt ít hơn 1 so với số lượng truy vấn song song sẽ chạy, hoặc khi chạy một công việc quy trình dữ liệu, ít hơn một so với số lượng worker hoặc thực thể điện toán có sẵn.

string

Giá trị next_page_token được trả về từ lệnh gọi phân vùng trước đó có thể được dùng để nhận một tập hợp kết quả bổ sung. Không có sự đảm bảo về thứ tự giữa các tập hợp kết quả. Do đó, việc sử dụng nhiều tập hợp kết quả sẽ đòi hỏi phải hợp nhất các tập hợp kết quả khác nhau.

Ví dụ: hai lệnh gọi tiếp theo sử dụng page_token có thể trả về:

• con trỏ B, con trỏ M, con trỏ Q
• con trỏ A, con trỏ U, con trỏ W

Để có được tập hợp kết quả hoàn chỉnh theo thứ tự tương ứng với kết quả của truy vấn được cung cấp cho Phân vùng, các tập hợp kết quả phải được hợp nhất: con trỏ A, con trỏ B, con trỏ M, con trỏ Q, con trỏ U, con trỏ W

int32

Số lượng phân vùng tối đa cần trả về trong lệnh gọi này, tuỳ thuộc vào partition_count.

Ví dụ: nếu partition_count = 10 và page_size = 8, lệnh gọi đầu tiên đến PartitionQuery sẽ trả về tối đa 8 phân vùng và một next_page_token nếu tồn tại nhiều kết quả hơn. Lệnh gọi thứ hai đến PartitionQuery sẽ trả về tối đa 2 phân vùng để hoàn thành tổng cộng 10 phân vùng được chỉ định trong partition_count.

StructuredQuery

Truy vấn có cấu trúc. Truy vấn phải chỉ định tập hợp gồm tất cả các thành phần con và được sắp xếp theo tên tăng dần. Các bộ lọc, thứ tự by, giới hạn, độ lệch và con trỏ bắt đầu/kết thúc khác không được hỗ trợ.

Timestamp

Đọc tài liệu như tại thời điểm đã cho.

Đây phải là một dấu thời gian có độ chính xác là micrô giây trong vòng 1 giờ qua, hoặc nếu tính năng Khôi phục tại một thời điểm đang bật, thì đây cũng có thể là dấu thời gian cả phút trong vòng 7 ngày qua.

Cursor

Kết quả phân vùng. Mỗi phân vùng là một điểm phân tách có thể được RunQuery sử dụng làm điểm bắt đầu hoặc điểm kết thúc cho kết quả truy vấn. Các yêu cầu RunQuery phải được thực hiện bằng cùng một truy vấn được cung cấp cho yêu cầu Phân vùng này. Các con trỏ phân vùng sẽ được sắp xếp theo cùng thứ tự như kết quả của truy vấn được cung cấp cho PartitionQuery.

Ví dụ: nếu yêu cầu PartitionQuery trả về các con trỏ phân vùng A và B, thì việc chạy ba truy vấn sau sẽ trả về toàn bộ tập hợp kết quả của truy vấn ban đầu:

• truy vấn, end_at A
• truy vấn, bắt đầu_tại A, kết thúc_tại B
• truy vấn, bắt đầu_tại B

Kết quả trống có thể cho biết truy vấn có quá ít kết quả để phân vùng hoặc truy vấn chưa được hỗ trợ để phân vùng.

string

Mã thông báo trang có thể dùng để yêu cầu một tập hợp kết quả bổ sung, lên đến số lượng do partition_count chỉ định trong yêu cầu Phân vùng. Nếu trống thì không có kết quả nào khác.

Struct

Các chỉ mục được chọn cho truy vấn. Ví dụ: [ {"query_scope": "Collection", "properties": "(foo ASC, name ASC)"}, {"query_scope": "Collection", "properties": "(bar ASC, name ASC)"} ]

bool

Khi đặt thành true, tài liệu đích phải tồn tại. Khi đặt thành false, tài liệu đích không được tồn tại.

Timestamp

Khi được đặt, tài liệu đích phải tồn tại và được cập nhật lần gần đây nhất vào thời điểm đó. Dấu thời gian phải được căn chỉnh theo micrô giây.

string

Bắt buộc. Tên cơ sở dữ liệu. Ở định dạng: projects/{project_id}/databases/{database_id}.

bytes

Bắt buộc. Giao dịch được khôi phục.

string

Bắt buộc. Tên tài nguyên mẹ. Ở định dạng: projects/{project_id}/databases/{database_id}/documents hoặc projects/{project_id}/databases/{database_id}/documents/{document_path}. Ví dụ: projects/my-project/databases/my-database/documents hoặc projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

ExplainOptions

Không bắt buộc. Giải thích các tuỳ chọn cho truy vấn. Nếu được đặt, số liệu thống kê truy vấn bổ sung sẽ được trả về. Nếu không, hệ thống sẽ chỉ trả về kết quả truy vấn.

StructuredAggregationQuery

Truy vấn tổng hợp.

bytes

Chạy tính năng tổng hợp trong một giao dịch đang hoạt động.

Giá trị ở đây là mã giao dịch mờ để thực thi truy vấn.

TransactionOptions

Bắt đầu một giao dịch mới trong truy vấn, chế độ mặc định là chỉ có thể đọc.

Mã giao dịch mới sẽ được trả về dưới dạng phản hồi đầu tiên trong luồng.

Timestamp

Thực thi truy vấn tại dấu thời gian cụ thể.

Đây phải là một dấu thời gian có độ chính xác là micrô giây trong vòng 1 giờ qua, hoặc nếu tính năng Khôi phục tại một thời điểm đang bật, thì đây cũng có thể là dấu thời gian cả phút trong vòng 7 ngày qua.

AggregationResult

Một kết quả tổng hợp duy nhất.

Không xuất hiện khi báo cáo một phần tiến trình.

bytes

Giao dịch đã bắt đầu theo yêu cầu này.

Chỉ xuất hiện trong phản hồi đầu tiên khi yêu cầu được yêu cầu bắt đầu một giao dịch mới.

Timestamp

Thời điểm tính toán kết quả tổng hợp. Tỷ lệ này luôn tăng đơn điệu; trong trường hợp này, SyntheticResult trước đó trong luồng kết quả được đảm bảo không thay đổi giữa read_time và kết quả này.

Nếu truy vấn không trả về kết quả nào, thì phản hồi có read_time và không có result sẽ được gửi, đồng thời thể hiện thời gian chạy truy vấn.

ExplainMetrics

Truy vấn giải thích về các chỉ số. Điều này chỉ có khi RunAggregationQueryRequest.explain_options được cung cấp và chỉ được gửi một lần cùng với phản hồi cuối cùng trong luồng.

string

Bắt buộc. Tên tài nguyên mẹ. Ở định dạng: projects/{project_id}/databases/{database_id}/documents hoặc projects/{project_id}/databases/{database_id}/documents/{document_path}. Ví dụ: projects/my-project/databases/my-database/documents hoặc projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

ExplainOptions

Không bắt buộc. Giải thích các tuỳ chọn cho truy vấn. Nếu được đặt, số liệu thống kê truy vấn bổ sung sẽ được trả về. Nếu không, hệ thống sẽ chỉ trả về kết quả truy vấn.

StructuredQuery

Truy vấn có cấu trúc.

bytes

Chạy truy vấn trong một giao dịch đang hoạt động.

Giá trị ở đây là mã giao dịch mờ để thực thi truy vấn.

TransactionOptions

Bắt đầu một giao dịch mới và đọc tài liệu. Mặc định là giao dịch chỉ có thể đọc. Mã giao dịch mới sẽ được trả về dưới dạng phản hồi đầu tiên trong luồng.

Timestamp

Đọc tài liệu như tại thời điểm đã cho.

Đây phải là một dấu thời gian có độ chính xác là micrô giây trong vòng 1 giờ qua, hoặc nếu tính năng Khôi phục tại một thời điểm đang bật, thì đây cũng có thể là dấu thời gian cả phút trong vòng 7 ngày qua.

bytes

Giao dịch đã bắt đầu theo yêu cầu này. Chỉ có thể thiết lập trong phản hồi đầu tiên và chỉ khi RunQueryRequest.new_transaction được đặt trong yêu cầu. Nếu được đặt, sẽ không có trường nào khác được đặt trong phản hồi này.

Document

Kết quả truy vấn, không được đặt khi báo cáo tiến trình một phần.

Timestamp

Thời gian tài liệu được đọc. Con số này có thể tăng đơn điệu; trong trường hợp này, các tài liệu trước đó trong luồng kết quả được đảm bảo không thay đổi giữa read_time và tài liệu này.

Nếu truy vấn không trả về kết quả nào, thì phản hồi có read_time và không có document sẽ được gửi, đồng thời thể hiện thời gian chạy truy vấn.

int32

Số lượng kết quả đã bị bỏ qua do chênh lệch giữa phản hồi cuối cùng và phản hồi hiện tại.

ExplainMetrics

Truy vấn giải thích về các chỉ số. Điều này chỉ có khi RunQueryRequest.explain_options được cung cấp và chỉ được gửi một lần cùng với phản hồi cuối cùng trong luồng.

bool

Nếu có, Firestore đã hoàn tất yêu cầu và sẽ không trả lại tài liệu nào khác.

Aggregation

Không bắt buộc. Chuỗi các hàm tổng hợp cần áp dụng cho kết quả của structured_query.

Yêu cầu:

• Tối thiểu một và tối đa năm dữ liệu tổng hợp cho mỗi truy vấn.

StructuredQuery

Truy vấn có cấu trúc lồng nhau.

string

Không bắt buộc. Tên không bắt buộc của trường để lưu trữ kết quả tổng hợp.

Nếu không được cung cấp, Firestore sẽ chọn một tên mặc định theo định dạng field_<incremental_id++>. Ví dụ:

AGGREGATE
  COUNT_UP_TO(1) AS count_up_to_1,
  COUNT_UP_TO(2),
  COUNT_UP_TO(3) AS count_up_to_3,
  COUNT(*)
OVER (
  ...
);

trở thành:

AGGREGATE
  COUNT_UP_TO(1) AS count_up_to_1,
  COUNT_UP_TO(2) AS field_1,
  COUNT_UP_TO(3) AS count_up_to_3,
  COUNT(*) AS field_2
OVER (
  ...
);

Yêu cầu:

• Phải là duy nhất trên tất cả các bí danh tổng hợp.
• Tuân thủ document field name giới hạn.

Count

Đơn vị tổng hợp số lượng.

Sum

Trang web tổng hợp số liệu.

Avg

Trang web tổng hợp trung bình.

FieldReference

Trường để tổng hợp.

Int64Value

Không bắt buộc. Quy tắc ràng buộc không bắt buộc về số lượng tài liệu tối đa cần đếm.

Đây là một cách để đặt giới hạn trên cho số lượng tài liệu cần quét, hạn chế độ trễ và chi phí.

Không xác định được hiểu là không có ràng buộc.

Ví dụ ở cấp cao:

AGGREGATE COUNT_UP_TO(1000) OVER ( SELECT * FROM k );

Yêu cầu:

• Phải lớn hơn 0 khi hiển thị.

FieldReference

Trường để tổng hợp.

Projection

Tập hợp con không bắt buộc gồm các trường cần trả về.

Tham số này hoạt động như một DocumentMask trên các tài liệu được trả về từ truy vấn. Khi bạn không đặt chính sách này, hãy giả định rằng phương thức gọi muốn trả về tất cả các trường.

CollectionSelector

Các tập hợp cần truy vấn.

Filter

Bộ lọc để áp dụng.

Order

Thứ tự áp dụng cho các kết quả truy vấn.

Firestore cho phép người gọi đặt hàng đầy đủ, đặt hàng một phần hoặc không đặt hàng. Trong mọi trường hợp, Firestore đảm bảo thứ tự ổn định thông qua các quy tắc sau:

• order_by là bắt buộc để tham chiếu tất cả các trường được dùng với bộ lọc bất đẳng thức.
• Tất cả các trường bắt buộc phải có trong order_by nhưng chưa có thì sẽ được nối theo thứ tự từ điển của tên trường.
• Nếu bạn không chỉ định đơn đặt hàng trên __name__, đơn đặt hàng sẽ được thêm vào theo mặc định.

Các trường được nối với cùng hướng sắp xếp như thứ tự gần đây nhất được chỉ định hoặc "DỰA VÀO" nếu không có đơn đặt hàng nào được chỉ định. Ví dụ:

• ORDER BY a trở thành ORDER BY a ASC, __name__ ASC
• ORDER BY a DESC trở thành ORDER BY a DESC, __name__ DESC
• WHERE a > 1 trở thành WHERE a > 1 ORDER BY a ASC, __name__ ASC
• WHERE __name__ > ... AND a > 1 trở thành WHERE __name__ > ... AND a > 1 ORDER BY a ASC, __name__ ASC

Cursor

Tiền tố tiềm năng của vị trí trong tập hợp kết quả để bắt đầu truy vấn.

Thứ tự của nhóm kết quả dựa trên mệnh đề ORDER BY của truy vấn ban đầu.

SELECT * FROM k WHERE a = 1 AND b > 2 ORDER BY b ASC, __name__ ASC;

Kết quả của truy vấn này được sắp xếp theo (b ASC, __name__ ASC).

Con trỏ có thể tham chiếu thứ tự đầy đủ hoặc tiền tố của vị trí, mặc dù con trỏ không thể tham chiếu nhiều trường hơn những trường có trong ORDER BY được cung cấp.

Tiếp tục ví dụ ở trên, việc đính kèm các con trỏ bắt đầu sau đây sẽ có tác động khác nhau:

• START BEFORE (2, /k/123): bắt đầu truy vấn ngay trước a = 1 AND b > 2 AND __name__ > /k/123.
• START AFTER (10): bắt đầu truy vấn ngay sau a = 1 AND b > 10.

Không giống như OFFSET yêu cầu quét qua N kết quả đầu tiên để bỏ qua, con trỏ bắt đầu cho phép truy vấn bắt đầu tại vị trí logic. Vị trí này không bắt buộc phải khớp với kết quả thực tế, nó sẽ quét phía trước từ vị trí này để tìm tài liệu tiếp theo.

Yêu cầu:

• Số lượng giá trị không được lớn hơn số lượng trường được chỉ định trong mệnh đề ORDER BY.

Cursor

Tiền tố tiềm năng của vị trí trong kết quả được đặt để kết thúc truy vấn tại.

Hàm này tương tự như START_AT nhưng với việc kiểm soát vị trí kết thúc thay vì vị trí bắt đầu.

Yêu cầu:

• Số lượng giá trị không được lớn hơn số lượng trường được chỉ định trong mệnh đề ORDER BY.

int32

Số tài liệu cần bỏ qua trước khi trả về kết quả đầu tiên.

Điều này áp dụng sau các điều kiện ràng buộc do WHERE, START AT và END AT nhưng trước mệnh đề LIMIT.

Yêu cầu:

• Giá trị phải lớn hơn hoặc bằng 0 nếu được chỉ định.

Int32Value

Số lượng kết quả tối đa cần trả về.

Áp dụng sau mọi quy tắc ràng buộc khác.

Yêu cầu:

• Giá trị phải lớn hơn hoặc bằng 0 nếu được chỉ định.

FindNearest

Không bắt buộc. Một người hàng xóm gần nhất có thể đang tìm kiếm.

Áp dụng sau tất cả các bộ lọc và thứ tự khác.

Tìm các vectơ nhúng gần nhất với vectơ truy vấn cho trước.

string

Mã bộ sưu tập. Khi đặt giá trị này, chỉ chọn các bộ sưu tập có mã nhận dạng này.

bool

Khi đặt là false, chỉ chọn các tập hợp là con trực tiếp của parent được chỉ định trong vùng chứa RunQueryRequest. Khi giá trị là true, sẽ chọn tất cả các tập hợp con.

Operator

Toán tử để kết hợp nhiều bộ lọc.

Filter

Danh sách bộ lọc cần kết hợp.

Yêu cầu:

• Có ít nhất một bộ lọc.

FieldReference

Trường để lọc theo.

Operator

Toán tử bạn muốn lọc theo.

Value

Giá trị cần so sánh.

string

Tham chiếu đến một trường trong tài liệu.

Yêu cầu:

• PHẢI là một chuỗi phân đoạn được phân tách bằng dấu chấm (.), trong đó mỗi phân đoạn phải tuân thủ document field name giới hạn.

CompositeFilter

Bộ lọc tổng hợp.

FieldFilter

Bộ lọc trên một trường tài liệu.

UnaryFilter

Bộ lọc nhận đúng một đối số.

FieldReference

Bắt buộc. Trường vectơ được lập chỉ mục để tìm kiếm. Chỉ có thể trả về những tài liệu chứa vectơ có kích thước khớp với query_vector.

Value

Bắt buộc. Vectơ truy vấn mà chúng ta đang tìm kiếm. Phải là vectơ có không quá 2048 chiều.

DistanceMeasure

Bắt buộc. Số đo khoảng cách cần sử dụng, bắt buộc.

Int32Value

Bắt buộc. Số người lân cận gần nhất để trả về. Phải là một số nguyên dương không quá 1000.

FieldReference

Trường để sắp xếp thứ tự.

Direction

Hướng dẫn sắp xếp thứ tự. Giá trị mặc định là ASCENDING.

FieldReference

Các trường cần trả về.

Nếu trống, tất cả các trường sẽ được trả về. Để chỉ trả về tên của tài liệu, hãy sử dụng ['__name__'].

Operator

Toán tử một ngôi để áp dụng.

FieldReference

Trường mà bạn muốn áp dụng toán tử.

int32

Mã mục tiêu xác định mục tiêu trên luồng. Phải là một số dương và khác 0.

Nếu target_id là 0 (hoặc chưa được chỉ định), máy chủ sẽ gán một mã nhận dạng cho mục tiêu này và trả về mã đó trong sự kiện TargetChange::ADD. Sau khi thêm một mục tiêu có target_id=0, tất cả các mục tiêu tiếp theo cũng phải có target_id=0. Nếu một yêu cầu AddTarget có target_id != 0 được gửi đến máy chủ sau khi mục tiêu có target_id=0 được thêm, thì máy chủ sẽ ngay lập tức gửi một phản hồi có sự kiện TargetChange::Remove.

Xin lưu ý rằng nếu ứng dụng gửi nhiều yêu cầu AddTarget mà không có mã nhận dạng, thì thứ tự của các mã nhận dạng được trả về trong TargetChage.target_ids sẽ không được xác định. Do đó, ứng dụng nên cung cấp mã mục tiêu thay vì dựa vào máy chủ để chỉ định mã này.

Nếu target_id khác 0, thì không được có mục tiêu đang hoạt động nào trên luồng này có cùng mã.

bool

Liệu bạn có nên xoá mục tiêu khi mục tiêu đó hiện tại và nhất quán hay không.

Int32Value

Số tài liệu khớp với truy vấn gần đây nhất tại mã thông báo sơ yếu lý lịch hoặc thời gian đọc.

Giá trị này chỉ phù hợp khi bạn cung cấp resume_type. Giá trị này đang hiện diện và lớn hơn 0 tín hiệu cho thấy ứng dụng muốn đưa ExistenceFilter.unchanged_names vào phản hồi.

QueryTarget

Mục tiêu được xác định bởi truy vấn.

DocumentsTarget

Một mục tiêu được chỉ định bởi một nhóm tên tài liệu.

bytes

Mã thông báo tiếp tục từ TargetChange trước đó cho cùng một mục tiêu.

Việc sử dụng mã thông báo tiếp tục có mục tiêu khác không được hỗ trợ và có thể không thành công.

Timestamp

Bắt đầu nghe sau một read_time cụ thể.

Khách hàng phải biết trạng thái của các chứng từ trùng khớp vào lúc này.

string

Tên tài liệu cần truy xuất. Ở định dạng: projects/{project_id}/databases/{database_id}/documents/{document_path}. Yêu cầu sẽ không thành công nếu bất kỳ tài liệu nào không phải là tài nguyên con của database đã cho. Những tên trùng lặp sẽ bị loại bỏ.

string

Tên tài nguyên mẹ. Ở định dạng: projects/{project_id}/databases/{database_id}/documents hoặc projects/{project_id}/databases/{database_id}/documents/{document_path}. Ví dụ: projects/my-project/databases/my-database/documents hoặc projects/my-project/databases/my-database/documents/chatrooms/my-chatroom

StructuredQuery

Truy vấn có cấu trúc.

TargetChangeType

Loại thay đổi đã xảy ra.

int32

Mã mục tiêu của các mục tiêu đã thay đổi.

Nếu trống, thay đổi sẽ áp dụng cho tất cả các mục tiêu.

Không xác định được thứ tự của các mã mục tiêu.

Status

Lỗi đã dẫn đến thay đổi này, nếu có.

bytes

Có thể dùng mã thông báo để tiếp tục truyền phát cho target_ids đã cho hoặc tất cả các mục tiêu nếu target_ids trống.

Không được đặt cho mọi thay đổi về mục tiêu.

Timestamp

read_time nhất quán cho target_ids đã cho (bị bỏ qua khi target_ids không nằm trên một bản tổng quan nhanh nhất quán).

Luồng được đảm bảo sẽ gửi một read_time với target_ids trống bất cứ khi nào toàn bộ luồng đạt đến một ảnh chụp nhanh nhất quán mới. Các thông báo THÊM, HIỆN TẠI và ĐẶT LẠI được đảm bảo (cuối cùng) sẽ dẫn đến ảnh chụp nhanh nhất quán mới (trong khi thông báo NO_CHANGE và REMOVE thì không).

Đối với một luồng nhất định, read_time được đảm bảo sẽ tăng đơn điệu.

ReadOnly

Bạn chỉ có thể sử dụng giao dịch cho hoạt động đọc.

ReadWrite

Có thể dùng giao dịch cho cả thao tác đọc và ghi.

Timestamp

Đọc tài liệu tại thời điểm cụ thể.

Đây phải là một dấu thời gian có độ chính xác là micrô giây trong vòng 1 giờ qua, hoặc nếu tính năng Khôi phục tại một thời điểm đang bật, thì đây cũng có thể là dấu thời gian cả phút trong vòng 7 ngày qua.

bytes

Một giao dịch không bắt buộc để thử lại.

Document

Bắt buộc. Tài liệu đã cập nhật. Tạo tài liệu nếu tài liệu chưa tồn tại.

DocumentMask

Các trường cần cập nhật. Không có đường dẫn trường nào trong mặt nạ có thể chứa tên dành riêng.

Nếu tài liệu tồn tại trên máy chủ và có các trường không được tham chiếu trong mặt nạ, các trường này sẽ không thay đổi. Các trường được tham chiếu trong mặt nạ nhưng không có trong tài liệu nhập sẽ bị xoá khỏi tài liệu trên máy chủ.

DocumentMask

Các trường cần trả về. Nếu bạn không đặt chính sách này, hệ thống sẽ trả về tất cả các trường.

Nếu tài liệu có một trường không có trong mặt nạ này, thì trường đó sẽ không được trả về trong phản hồi.

Precondition

Điều kiện tiên quyết (không bắt buộc) trên tài liệu. Yêu cầu sẽ không thành công nếu giá trị này được đặt nhưng tài liệu đích không đáp ứng.

NullValue

Một giá trị rỗng.

bool

Một giá trị boolean.

int64

Một giá trị số nguyên.

double

Giá trị kép.

Timestamp

Một giá trị dấu thời gian.

Chỉ chính xác đến micrô giây. Khi được lưu trữ, mọi độ chính xác bổ sung sẽ được làm tròn xuống.

string

Một giá trị chuỗi.

Chuỗi (được biểu thị dưới dạng UTF-8) không được vượt quá 1 MiB – 89 byte. Chỉ 1.500 byte đầu tiên của cách biểu diễn UTF-8 được xem xét trong các truy vấn.

bytes

Một giá trị byte.

Không được vượt quá 1 MiB – 89 byte. Chỉ 1.500 byte đầu tiên được xem xét bởi các truy vấn.

string

Tham chiếu đến một tài liệu. Ví dụ: projects/{project_id}/databases/{database_id}/documents/{document_path}.

LatLng

Một giá trị điểm địa lý đại diện cho một điểm trên bề mặt Trái Đất.

ArrayValue

Một giá trị mảng.

Không thể trực tiếp chứa một giá trị mảng khác, mặc dù có thể chứa bản đồ chứa một mảng khác.

MapValue

Giá trị ánh xạ.

DocumentMask

Các trường cần cập nhật trong nội dung ghi này.

Bạn chỉ có thể đặt trường này khi thực hiện thao tác là update. Nếu bạn không đặt mặt nạ cho update và tài liệu tồn tại, thì mọi dữ liệu hiện có sẽ bị ghi đè. Nếu bạn đặt mặt nạ và tài liệu trên máy chủ có các trường không bị mặt nạ che phủ, thì các trường đó sẽ không thay đổi. Các trường được tham chiếu trong mặt nạ nhưng không có trong tài liệu nhập sẽ bị xoá khỏi tài liệu trên máy chủ. Đường dẫn trường trong mặt nạ này không được chứa tên trường dành riêng.

FieldTransform

Các biến đổi để thực hiện sau khi cập nhật.

Bạn chỉ có thể đặt trường này khi thực hiện thao tác là update. Nếu có, thao tác ghi này tương đương với việc thực hiện update và transform cho cùng một tài liệu về tỷ lệ và thứ tự.

Precondition

Điều kiện tiên quyết (không bắt buộc) trên tài liệu.

Thao tác ghi sẽ không thành công nếu bạn đặt giá trị này nhưng tài liệu đích không đáp ứng yêu cầu này.

Document

Tài liệu cần viết.

string

Tên tài liệu cần xoá. Ở định dạng: projects/{project_id}/databases/{database_id}/documents/{document_path}.

DocumentTransform

Áp dụng một phép biến đổi cho một tài liệu.

string

Bắt buộc. Tên cơ sở dữ liệu. Ở định dạng: projects/{project_id}/databases/{database_id}. Bạn chỉ phải cung cấp thông tin này trong thông báo đầu tiên.

string

Mã nhận dạng của luồng ghi cần tiếp tục. Bạn chỉ có thể đặt chế độ này trong thông báo đầu tiên. Khi để trống, một luồng ghi mới sẽ được tạo.

Write

Các quyền cần ghi để áp dụng.

Luôn thực thi tỉ mỉ và theo thứ tự. Bạn phải để trống trường này trong yêu cầu đầu tiên. Trường này có thể trống trong yêu cầu mới nhất. Không được để trống trường này trên tất cả các yêu cầu khác.

bytes

Mã thông báo luồng đã được máy chủ gửi trước đó.

Ứng dụng phải đặt trường này thành mã thông báo từ WriteResponse gần đây nhất mà ứng dụng nhận được. Điều này xác nhận rằng ứng dụng đã nhận được phản hồi đến mã thông báo này. Sau khi gửi mã thông báo này, bạn không thể dùng các mã thông báo cũ nữa.

Máy chủ có thể đóng luồng nếu có quá nhiều phản hồi không được xác nhận.

Bạn không nên đặt trường này khi tạo sự kiện phát trực tiếp mới. Để tiếp tục phát trực tiếp tại một điểm cụ thể, hãy đặt trường này và trường stream_id.

Bạn không nên đặt trường này khi tạo sự kiện phát trực tiếp mới.

map<string, string>

Các nhãn liên kết với yêu cầu ghi này.

string

Mã của luồng. Chỉ đặt cho tin nhắn đầu tiên, khi luồng mới được tạo.

bytes

Mã thông báo đại diện cho vị trí của phản hồi này trong luồng. Ứng dụng có thể sử dụng thông tin này để tiếp tục sự kiện phát trực tiếp vào thời điểm này.

Trường này luôn được đặt.

WriteResult

Kết quả của việc áp dụng hoạt động ghi.

Kết quả ghi thứ i này tương ứng với lần ghi thứ i trong yêu cầu.

Timestamp

Thời gian thực hiện cam kết. Bất kỳ lượt đọc nào có read_time bằng hoặc lớn hơn đều đảm bảo thấy được tác động của việc ghi.

Timestamp

Thời gian cập nhật tài liệu gần đây nhất sau khi áp dụng chế độ ghi. Không được đặt sau delete.

Nếu việc ghi không thực sự thay đổi tài liệu, đây sẽ là update_time trước đó.

Value

Kết quả khi áp dụng từng DocumentTransform.FieldTransform theo cùng một thứ tự.