Chỉ mục
FirestoreAdmin
(giao diện)CreateIndexRequest
(thông báo)DeleteIndexRequest
(thông báo)ExportDocumentsMetadata
(thông báo)ExportDocumentsRequest
(thông báo)ExportDocumentsResponse
(thông báo)Field
(thông báo)Field.IndexConfig
(thông báo)FieldOperationMetadata
(thông báo)FieldOperationMetadata.IndexConfigDelta
(thông báo)FieldOperationMetadata.IndexConfigDelta.ChangeType
(enum)GetFieldRequest
(thông báo)GetIndexRequest
(thông báo)ImportDocumentsMetadata
(thông báo)ImportDocumentsRequest
(thông báo)Index
(thông báo)Index.IndexField
(thông báo)Index.IndexField.ArrayConfig
(enum)Index.IndexField.Order
(enum)Index.QueryScope
(enum)Index.State
(enum)IndexOperationMetadata
(thông báo)ListFieldsRequest
(thông báo)ListFieldsResponse
(thông báo)ListIndexesRequest
(thông báo)ListIndexesResponse
(thông báo)OperationState
(enum)Progress
(thông báo)UpdateFieldRequest
(thông báo)
Quản trị viên trên Firestore
Các thao tác do dịch vụ FirestoreAdmin
tạo ra, nhưng được truy cập thông qua dịch vụ google.longrunning.Operations
.
CreateIndex |
---|
Tạo chỉ mục tổng hợp. Thao tác này sẽ trả về một
|
Xóa chỉ mục |
---|
Xóa chỉ mục tổng hợp.
|
Xuất tài liệu |
---|
Xuất bản sao của tất cả hoặc một nhóm nhỏ các tài liệu từ Google Cloud Firestore sang một hệ thống lưu trữ khác, chẳng hạn như Google Cloud Storage. Nội dung cập nhật gần đây đối với tài liệu có thể không được phản ánh trong quá trình xuất. Quá trình xuất sẽ diễn ra ở chế độ nền và bạn có thể giám sát cũng như quản lý tiến trình xuất thông qua tài nguyên Vận hành được tạo. Bạn chỉ có thể sử dụng dữ liệu xuất ra sau khi thực hiện xong thao tác liên kết. Nếu quá trình xuất dữ liệu bị huỷ trước khi hoàn tất, thì có thể để lại một phần dữ liệu trong Google Cloud Storage.
|
GetField |
---|
Lấy siêu dữ liệu và cấu hình cho một Trường.
|
GetIndex |
---|
Lấy chỉ mục tổng hợp.
|
Nhập tài liệu |
---|
Nhập tài liệu vào Google Cloud Firestore. Các tài liệu hiện có có cùng tên sẽ bị ghi đè. Quá trình nhập diễn ra ở chế độ nền và bạn có thể giám sát cũng như quản lý tiến trình nhập thông qua tài nguyên Vận hành được tạo. Nếu thao tác ImportDocuments bị huỷ, thì có thể một nhóm nhỏ dữ liệu đã được nhập vào Cloud Firestore.
|
ListField (Trường danh sách) |
---|
Liệt kê cấu hình của trường và siêu dữ liệu của cơ sở dữ liệu này. Hiện tại,
|
ListIndexes (Chỉ mục danh sách) |
---|
Liệt kê các chỉ mục tổng hợp.
|
Trường cập nhật |
---|
Cập nhật một cấu hình trường. Hiện tại, nội dung cập nhật về trường chỉ áp dụng cho cấu hình chỉ mục trường duy nhất. Tuy nhiên, các lệnh gọi đến Lệnh gọi này trả về một Để định cấu hình chế độ cài đặt trường mặc định cho cơ sở dữ liệu, hãy sử dụng
|
CreateIndexRequest (Yêu cầu chỉ mục)
Yêu cầu cho FirestoreAdmin.CreateIndex
.
Trường | |
---|---|
parent |
Tên gốc của biểu mẫu |
index |
Chỉ mục tổng hợp cần tạo. |
Yêu cầu chỉ mục
Yêu cầu cho FirestoreAdmin.DeleteIndex
.
Trường | |
---|---|
name |
Tên biểu mẫu |
Xuất siêu dữ liệu tài liệu
Siêu dữ liệu về google.longrunning.Operation
kết quả từ FirestoreAdmin.ExportDocuments
.
Trường | |
---|---|
start_time |
Thời điểm bắt đầu hoạt động này. |
end_time |
Thời gian hoạt động này hoàn tất. Giá trị này sẽ không được đặt nếu bạn vẫn đang thực hiện thao tác. |
operation_state |
Trạng thái của hoạt động xuất. |
progress_documents |
Tiến trình, trong tài liệu, của thao tác này. |
progress_bytes |
Tiến trình, tính bằng byte, của thao tác này. |
collection_ids[] |
Những mã bộ sưu tập nào đang được xuất. |
output_uri_prefix |
Nơi các thực thể đang được xuất sang. |
Xuất tài liệuRequest
Yêu cầu cho FirestoreAdmin.ExportDocuments
.
Trường | |
---|---|
name |
Cơ sở dữ liệu để xuất. Phải có dạng: |
collection_ids[] |
Những mã nhận dạng bộ sưu tập cần xuất. Không xác định có nghĩa là tất cả các bộ sưu tập. |
output_uri_prefix |
URI đầu ra. Hiện tại, chúng tôi chỉ hỗ trợ các URI của Google Cloud Storage ở dạng: |
Xuất văn bản phản hồi
Được trả về trong trường phản hồi google.longrunning.Operation
.
Trường | |
---|---|
output_uri_prefix |
Vị trí của các tệp đầu ra. Bạn có thể dùng tính năng này để bắt đầu nhập dữ liệu vào Cloud Firestore (dự án này hoặc một dự án khác) sau khi thao tác này hoàn tất thành công. |
Trường
Đại diện cho một trường duy nhất trong cơ sở dữ liệu.
Các trường được nhóm theo "Nhóm bộ sưu tập" tương ứng. Nhóm này đại diện cho tất cả các bộ sưu tập trong cơ sở dữ liệu có cùng mã nhận dạng.
Trường | |
---|---|
name |
Tên trường của biểu mẫu Đường dẫn trường có thể là một tên trường đơn giản, ví dụ: Bạn có thể trích dẫn các đường dẫn trường bằng cách dùng Ví dụ: (Lưu ý: Nhận xét ở đây được viết theo cú pháp Markdown, do đó, có thêm một lớp dấu phẩy ngược để thể hiện khối mã) Một |
index_config |
Cấu hình chỉ mục cho trường này. Nếu bạn không đặt chính sách này, việc lập chỉ mục trường sẽ chuyển về cấu hình do |
Cấu hình chỉ mục
Cấu hình chỉ mục cho trường này.
Trường | |
---|---|
indexes[] |
Các chỉ mục được hỗ trợ cho trường này. |
uses_ancestor_config |
Chỉ có đầu ra. Nếu đúng, cấu hình chỉ mục của |
ancestor_field |
Chỉ có đầu ra. Chỉ định tên tài nguyên của |
reverting |
Chỉ đầu ra Khi đúng, cấu hình chỉ mục của |
Siêu dữ liệu thực địa
Siêu dữ liệu về google.longrunning.Operation
kết quả từ FirestoreAdmin.UpdateField
.
Trường | |
---|---|
start_time |
Thời điểm bắt đầu hoạt động này. |
end_time |
Thời gian hoạt động này hoàn tất. Giá trị này sẽ không được đặt nếu bạn vẫn đang thực hiện thao tác. |
field |
Tài nguyên trường mà thao tác này đang thực hiện. Ví dụ: |
index_config_deltas[] |
Danh sách |
state |
Trạng thái của hoạt động. |
document_progress |
Tiến trình, trong tài liệu, của thao tác này. |
bytes_progress |
Tiến trình, tính bằng byte, của thao tác này. |
IndexConfigDelta
Thông tin về việc thay đổi cấu hình chỉ mục.
Trường | |
---|---|
change_type |
Chỉ định cách chỉ mục thay đổi. |
index |
Chỉ mục đang được thay đổi. |
Loại thay đổi
Chỉ định cách chỉ mục thay đổi.
Enum | |
---|---|
CHANGE_TYPE_UNSPECIFIED |
Loại thay đổi chưa được chỉ định hoặc xác định. |
ADD |
Đang thêm chỉ mục trường duy nhất. |
REMOVE |
Chỉ mục trường duy nhất sẽ bị xoá. |
Yêu cầu trường
Yêu cầu cho FirestoreAdmin.GetField
.
Trường | |
---|---|
name |
Tên biểu mẫu |
GetIndexRequest (Yêu cầu chỉ mục)
Yêu cầu cho FirestoreAdmin.GetIndex
.
Trường | |
---|---|
name |
Tên biểu mẫu |
Siêu dữ liệu ImportDocuments
Siêu dữ liệu về google.longrunning.Operation
kết quả từ FirestoreAdmin.ImportDocuments
.
Trường | |
---|---|
start_time |
Thời điểm bắt đầu hoạt động này. |
end_time |
Thời gian hoạt động này hoàn tất. Giá trị này sẽ không được đặt nếu bạn vẫn đang thực hiện thao tác. |
operation_state |
Trạng thái của thao tác nhập. |
progress_documents |
Tiến trình, trong tài liệu, của thao tác này. |
progress_bytes |
Tiến trình, tính bằng byte, của thao tác này. |
collection_ids[] |
Các mã bộ sưu tập đang được nhập. |
input_uri_prefix |
Vị trí của tài liệu đang được nhập. |
Nhập tài liệu yêu cầu
Yêu cầu cho FirestoreAdmin.ImportDocuments
.
Trường | |
---|---|
name |
Cơ sở dữ liệu để nhập vào. Phải có dạng: |
collection_ids[] |
Mã bộ sưu tập cần nhập. Chưa xác định có nghĩa là tất cả các tập hợp được đưa vào quá trình nhập. |
input_uri_prefix |
Vị trí của các tệp đã xuất. Giá trị này phải khớp với output_uri_prefix của một ExportDocumentsResponse trong một tệp xuất đã hoàn tất. Hãy xem: |
Chỉ mục
Chỉ mục trên Cloud Firestore cho phép thực hiện các truy vấn đơn giản và phức tạp dựa trên các tài liệu trong cơ sở dữ liệu.
Trường | |
---|---|
name |
Chỉ có đầu ra. Tên do máy chủ xác định cho chỉ mục này. Dạng thức của tên này cho các chỉ mục kết hợp sẽ là: |
query_scope |
Các chỉ mục có phạm vi truy vấn tập hợp được chỉ định cho phép truy vấn đối với tập hợp là con của tài liệu cụ thể, được chỉ định tại thời điểm truy vấn và có cùng mã nhận dạng tập hợp. Các chỉ mục có phạm vi truy vấn nhóm tập hợp được chỉ định cho phép truy vấn đối với tất cả các tập hợp bắt nguồn từ một tài liệu cụ thể, được chỉ định tại thời điểm truy vấn và có cùng mã nhận dạng tập hợp với chỉ mục này. |
fields[] |
Các trường mà chỉ mục này hỗ trợ. Đối với chỉ mục tổng hợp, đây luôn là 2 trường trở lên. Mục nhập trường cuối cùng luôn dành cho đường dẫn trường Đối với các chỉ mục trường đơn, đây sẽ luôn là chính xác một mục nhập có đường dẫn trường bằng đường dẫn trường của trường được liên kết. |
state |
Chỉ có đầu ra. Trạng thái phân phát của chỉ mục. |
Trường chỉ mục
Một trường trong chỉ mục. Trường_path mô tả trường nào được lập chỉ mục, value_mode mô tả cách giá trị của trường được lập chỉ mục.
Trường | |
---|---|
field_path |
Có thể là name. Đối với các chỉ mục trường đơn, tên này phải khớp với tên của trường, nếu không thì chỉ mục có thể bị bỏ qua. |
Trường kết hợp value_mode . Cách Google lập chỉ mục giá trị của trường. value_mode chỉ có thể là một trong những trạng thái sau đây: |
|
order |
Cho biết trường này hỗ trợ sắp xếp thứ tự theo đơn đặt hàng đã chỉ định hoặc so sánh bằng =, <, <=, >, >=. |
array_config |
Cho biết rằng trường này hỗ trợ các thao tác trên |
ArrayConfig
Các cấu hình giá trị mảng được hỗ trợ.
Enum | |
---|---|
ARRAY_CONFIG_UNSPECIFIED |
Chỉ mục không hỗ trợ truy vấn mảng bổ sung. |
CONTAINS |
Chỉ mục hỗ trợ các truy vấn về vùng chứa mảng. |
Gọi món
Thứ tự được hỗ trợ.
Enum | |
---|---|
ORDER_UNSPECIFIED |
Chưa xác định thứ tự. Không phải là lựa chọn hợp lệ. |
ASCENDING |
Trường này được sắp xếp theo giá trị trường tăng dần. |
DESCENDING |
Trường này được sắp xếp theo giá trị trường giảm dần. |
Phạm vi truy vấn
Phạm vi truy vấn xác định phạm vi chạy truy vấn. Thông tin này được chỉ định trên trường from
của CompositionQuery.
Enum | |
---|---|
QUERY_SCOPE_UNSPECIFIED |
Phạm vi truy vấn chưa được xác định. Không phải là lựa chọn hợp lệ. |
COLLECTION |
Các chỉ mục có phạm vi truy vấn tập hợp được chỉ định cho phép truy vấn đối với tập hợp con của một tài liệu cụ thể, được chỉ định tại thời điểm truy vấn và có mã nhận dạng tập hợp do chỉ mục chỉ định. |
COLLECTION_GROUP |
Các chỉ mục có phạm vi truy vấn nhóm bộ sưu tập được chỉ định cho phép truy vấn dựa vào tất cả các bộ sưu tập có id bộ sưu tập do chỉ mục chỉ định. |
Tiểu bang
Trạng thái của chỉ mục. Trong quá trình tạo chỉ mục, chỉ mục sẽ ở trạng thái CREATING
. Nếu được tạo thành công, chỉ mục sẽ chuyển sang trạng thái READY
. Nếu việc tạo chỉ mục gặp sự cố, chỉ mục sẽ chuyển sang trạng thái NEEDS_REPAIR
.
Enum | |
---|---|
STATE_UNSPECIFIED |
Bạn chưa xác định trạng thái. |
CREATING |
Chỉ mục đang được tạo. Chỉ mục có một hoạt động diễn ra trong thời gian dài. Chỉ mục được cập nhật khi viết tài liệu. Có thể tồn tại một số dữ liệu về chỉ mục. |
READY |
Chỉ mục đã sẵn sàng để sử dụng. Chỉ mục được cập nhật khi viết tài liệu. Chỉ mục được điền đầy đủ từ mọi tài liệu được lưu trữ có áp dụng nó. |
NEEDS_REPAIR |
Đang tạo chỉ mục nhưng đã xảy ra lỗi. Không có hoạt động dài hạn nào đang hoạt động cho chỉ mục và thao tác chạy trong thời gian dài được hoàn thành gần đây nhất cũng không thành công. Chỉ mục không được cập nhật khi viết tài liệu. Có thể tồn tại một số dữ liệu về chỉ mục. Hãy sử dụng google.longRunning.Operations API để xác định nguyên nhân khiến thao tác gần đây nhất cố gắng tạo chỉ mục này không thành công, sau đó tạo lại chỉ mục. |
Siêu dữ liệu IndexOperation
Siêu dữ liệu về google.longrunning.Operation
kết quả từ FirestoreAdmin.CreateIndex
.
Trường | |
---|---|
start_time |
Thời điểm bắt đầu hoạt động này. |
end_time |
Thời gian hoạt động này hoàn tất. Giá trị này sẽ không được đặt nếu bạn vẫn đang thực hiện thao tác. |
index |
Tài nguyên chỉ mục mà thao tác này đang thực hiện. Ví dụ: |
state |
Trạng thái của hoạt động. |
progress_documents |
Tiến trình, trong tài liệu, của thao tác này. |
progress_bytes |
Tiến trình, tính bằng byte, của thao tác này. |
Yêu cầu các trường danh sách
Yêu cầu cho FirestoreAdmin.ListFields
.
Trường | |
---|---|
parent |
Tên gốc của biểu mẫu |
filter |
Bộ lọc để áp dụng cho kết quả dạng danh sách. Hiện tại, |
page_size |
Số lượng kết quả cần trả về. |
page_token |
Mã thông báo trang (được trả về từ lệnh gọi trước đó đến |
Phản hồi ListFields
Phản hồi cho FirestoreAdmin.ListFields
.
Trường | |
---|---|
fields[] |
Các trường bắt buộc. |
next_page_token |
Mã thông báo trang có thể dùng để yêu cầu một trang kết quả khác. Nếu trống thì đây là trang cuối cùng. |
Yêu cầu chỉ mục danh sách
Yêu cầu cho FirestoreAdmin.ListIndexes
.
Trường | |
---|---|
parent |
Tên gốc của biểu mẫu |
filter |
Bộ lọc để áp dụng cho kết quả dạng danh sách. |
page_size |
Số lượng kết quả cần trả về. |
page_token |
Mã thông báo trang (được trả về từ lệnh gọi trước đó đến |
Phản hồi ListIndexes
Phản hồi cho FirestoreAdmin.ListIndexes
.
Trường | |
---|---|
indexes[] |
Các chỉ mục được yêu cầu. |
next_page_token |
Mã thông báo trang có thể dùng để yêu cầu một trang kết quả khác. Nếu trống thì đây là trang cuối cùng. |
Trạng thái hoạt động
Mô tả trạng thái của hoạt động.
Enum | |
---|---|
OPERATION_STATE_UNSPECIFIED |
Không xác định. |
INITIALIZING |
Yêu cầu đang được chuẩn bị để xử lý. |
PROCESSING |
Yêu cầu đang được xử lý. |
CANCELLING |
Yêu cầu đang bị huỷ sau khi người dùng đã gọi google.longruntime.Operations.CancelOperation. |
FINALIZING |
Yêu cầu đã được xử lý và đang trong giai đoạn kết thúc. |
SUCCESSFUL |
Yêu cầu đã hoàn tất thành công. |
FAILED |
Yêu cầu đã hoàn tất được xử lý nhưng gặp lỗi. |
CANCELLED |
Yêu cầu đã bị huỷ sau khi người dùng đã gọi google.longRunning.Operations.CancelOperation. |
Tiến trình
Mô tả tiến trình của thao tác. Đơn vị công việc mang tính chung chung và phải được diễn giải dựa vào trường hợp sử dụng Progress
.
Trường | |
---|---|
estimated_work |
Lượng công việc đã ước tính. |
completed_work |
Lượng công việc đã hoàn tất. |
Yêu cầu cập nhật trường
Yêu cầu cho FirestoreAdmin.UpdateField
.
Trường | |
---|---|
field |
Trường cần cập nhật. |
update_mask |
Một mặt nạ, so với trường. Nếu bạn chỉ định, chỉ cấu hình do trường này chỉ định mới được cập nhật trong trường. |