Tài liệu về nhà → Hướng dẫn sử dụng MongoDB → MongoDB Manual
Ghi chú
Trang này mô tả giai đoạn $merge
, đưa ra kết quả đường ống tổng hợp cho một bộ sưu tập. Đối với toán tử $mergeObjects
, hợp nhất các tài liệu vào một tài liệu, xem $mergeObjects
$merge
stage, which outputs the
aggregation pipeline results to a collection. For the $mergeObjects
operator, which merges documents into a single document, see $mergeObjects
$merge
Viết kết quả của đường ống tổng hợp cho một bộ sưu tập được chỉ định. Nhà điều hành $merge
phải là giai đoạn cuối cùng trong đường ống.Writes the results of the aggregation pipeline to a specified collection. The
$merge
operator must be the last stage in the pipeline.
Giai đoạn $merge
:$merge
stage:
Có thể xuất vào một bộ sưu tập trong cùng một cơ sở dữ liệu hoặc khác nhau.
Bắt đầu từ MongoDB 4.4:
$merge
có thể đầu ra vào cùng một bộ sưu tập đang được tổng hợp. Để biết thêm thông tin, hãy xem đầu ra cho cùng một bộ sưu tập đang được tổng hợp. can output to the same collection that is being aggregated. For more information, see Output to the Same Collection that is Being Aggregated.Các đường ống với giai đoạn
$merge
có thể chạy trên các nút thứ cấp đặt bản sao nếu tất cả các nút trong cụm có tính năng tương tự featureCompitionVersion thành
1 hoặc cao hơn và sở thích đọc cho phép đọc thứ cấp.{ $merge: { into: "myOutput", on: "_id", whenMatched: "replace", whenNotMatched: "insert" } }
$merge
stage can run on replica set secondary nodes if all the nodes in cluster have featureCompatibilityVersion set to
1 or higher and the Read Preference allows secondary reads.{ $merge: { into: "myOutput", on: "_id", whenMatched: "replace", whenNotMatched: "insert" } }
Đọc các hoạt động của câu lệnh
$merge
được gửi đến các nút thứ cấp, trong khi các hoạt động ghi chỉ xảy ra trên nút chính.$merge
statement are sent to secondary nodes, while the write operations occur only on the primary node.Không phải tất cả các phiên bản trình điều khiển đều hỗ trợ nhắm mục tiêu các hoạt động
$merge
để bản sao đặt các nút thứ cấp. Kiểm tra tài liệu trình điều khiển của bạn để xem khi trình điều khiển của bạn thêm hỗ trợ cho các hoạt động đọc$merge
chạy trên các nút thứ cấp.$merge
operations to replica set secondary nodes. Check your driver documentation to see when your driver added support for$merge
read operations running on secondary nodes.
Tạo một bộ sưu tập mới nếu bộ sưu tập đầu ra chưa tồn tại.
Có thể kết hợp kết quả [chèn các tài liệu mới, hợp nhất tài liệu, thay thế tài liệu, giữ các tài liệu hiện có, không thành công hoạt động, xử lý tài liệu bằng đường ống cập nhật tùy chỉnh] vào một bộ sưu tập hiện có.
Có thể đầu ra vào một bộ sưu tập Sharded. Bộ sưu tập đầu vào cũng có thể được chia cắt.
Để so sánh với giai đoạn
{ $merge: { into: "myOutput", on: "_id", whenMatched: "replace", whenNotMatched: "insert" } }
5 cũng đưa ra kết quả tổng hợp vào một bộ sưu tập, xem so sánh $merge
và { $merge: { into: "myOutput", on: "_id", whenMatched: "replace", whenNotMatched: "insert" } }
5.$merge
and { $merge: { into: "myOutput", on: "_id", whenMatched: "replace", whenNotMatched: "insert" } }
5 Comparison.Ghi chú
Quan điểm cụ thể theo yêu cầu
$merge
có thể kết hợp các kết quả đường ống vào một bộ sưu tập đầu ra hiện có thay vì thực hiện thay thế đầy đủ bộ sưu tập. Chức năng này cho phép người dùng tạo các chế độ xem cụ thể hóa theo yêu cầu, trong đó nội dung của bộ sưu tập đầu ra được cập nhật dần dần khi đường ống được chạy. can incorporate the pipeline results into an existing
output collection rather than perform a full replacement of the collection. This functionality allows users to create on-demand materialized views, where the content of the output collection is incrementally updated when the pipeline is run.
Để biết thêm thông tin về trường hợp sử dụng này, hãy xem các chế độ xem cụ thể hóa theo yêu cầu cũng như các ví dụ trên trang này.
Quan điểm vật chất là tách biệt với các quan điểm chỉ đọc. Để biết thông tin về việc tạo các chế độ xem chỉ đọc, hãy xem các chế độ xem chỉ đọc.
$merge
có cú pháp sau: has the following syntax:
{ $merge: { into: -or- { db: , coll: }, on: -or- [ , ...], // Optional let: , // Optional whenMatched: , // Optional whenNotMatched: // Optional } }
Ví dụ:
{ $merge: { into: "myOutput", on: "_id", whenMatched: "replace", whenNotMatched: "insert" } }
Nếu sử dụng tất cả các tùy chọn mặc định cho $merge
, bao gồm ghi vào bộ sưu tập trong cùng một cơ sở dữ liệu, bạn có thể sử dụng biểu mẫu đơn giản hóa:$merge
, including writing to a collection in the same database, you can use the simplified form:
{ $merge: } // Output collection is in the same database
$merge
lấy một tài liệu với các trường sau:$merge
takes a document with the following fields:
vào trong | Bộ sưu tập đầu ra. Chỉ định một trong hai:
Ghi chú
|
trên
Không bắt buộc. Trường hoặc các trường hoạt động như một định danh duy nhất cho một tài liệu. Mã định danh xác định xem tài liệu kết quả có khớp với một tài liệu hiện có trong bộ sưu tập đầu ra hay không. Chỉ định một trong hai:matches an existing document in the output collection. Specify either:
Một tên trường duy nhất dưới dạng chuỗi. Ví dụ:
6{ $merge: } // Output collection is in the same database
Một sự kết hợp của các trường trong một mảng. Ví dụ:
7{ $merge: } // Output collection is in the same database
Thứ tự của các trường trong mảng không quan trọng và bạn không thể chỉ định cùng một trường nhiều lần.
Đối với trường hoặc trường được chỉ định:
Các tài liệu kết quả tổng hợp phải chứa [các] trường được chỉ định trong
8, trừ khi trường{ $merge: } // Output collection is in the same database
8 là trường{ $merge: } // Output collection is in the same database
$merge
0. Nếu trường$merge
0 bị thiếu trong tài liệu kết quả, MongoDB sẽ tự động thêm nó.Trường hoặc trường được chỉ định không thể chứa giá trị null hoặc mảng.
{ $merge: } // Output collection is in the same database$merge
yêu cầu một chỉ mục duy nhất với các khóa tương ứng với các trường Định danh trên. Mặc dù thứ tự của đặc tả khóa chỉ mục không quan trọng, nhưng chỉ mục duy nhất chỉ phải chứa các trường
8 làm khóa của nó. requires a unique, index with keys that correspond to the
on identifier fields. Although the order of the index key specification does not matter, the unique index must only contain the
{ $merge: } // Output collection is in the same database
8 fields as its keys.Chỉ số cũng phải có sự đối chiếu giống như đối chiếu của tổng hợp.
Chỉ số duy nhất có thể là một chỉ số thưa thớt.
Chỉ số duy nhất không thể là một chỉ số một phần.
Đối với các bộ sưu tập đầu ra đã tồn tại, chỉ mục tương ứng phải tồn tại.
Giá trị mặc định cho trên phụ thuộc vào bộ sưu tập đầu ra:on depends on the output collection:
Nếu bộ sưu tập đầu ra không tồn tại, định danh BẬT phải và mặc định cho trường
$merge
0. Chỉ số$merge
0 duy nhất tương ứng được tự động tạo.on identifier must be and defaults to the$merge
0 field. The corresponding unique$merge
0 index is automatically created.Mẹo
Để sử dụng [các] trường định danh khác cho một bộ sưu tập không tồn tại, bạn có thể tạo bộ sưu tập trước bằng cách tạo một chỉ mục duy nhất trên [các] trường mong muốn. Xem phần về bộ sưu tập đầu ra không tồn tại để biết ví dụ.on identifier field[s] for a collection that does not exist, you can create the collection first by creating a unique index on the desired field[s]. See the section on non-existent output collection for an example.
Nếu bộ sưu tập đầu ra hiện có không được đặt, định danh
{ $merge: } // Output collection is in the same database
8 mặc định cho trường $merge
0.Nếu bộ sưu tập đầu ra hiện có là một bộ sưu tập Sharded, định danh trên mặc định cho tất cả các trường khóa Shard và trường $merge
0. Nếu chỉ định một định danh
{ $merge: } // Output collection is in the same database
8 khác nhau, { $merge: } // Output collection is in the same database
8 phải chứa tất cả các trường khóa Shard.on identifier defaults to all the shard key fields and the $merge
0 field. If specifying a different { $merge: } // Output collection is in the same database
8 identifier, the { $merge: } // Output collection is in the same database
8 must
contain all the shard key fields.khi nào
Không bắt buộc. Hành vi của $merge
nếu một tài liệu kết quả và tài liệu hiện có trong bộ sưu tập có cùng giá trị cho [các] trường được chỉ định.$merge
if a result document and an existing document in the collection have the same value for the specified on field[s].
Bạn có thể chỉ định:
Một trong những chuỗi hành động được xác định trước:
Hoạt động
Sự mô tả
"replace"
Thay thế tài liệu hiện có trong bộ sưu tập đầu ra bằng tài liệu kết quả phù hợp.output collection with the matching results document.
Khi thực hiện thay thế, tài liệu thay thế không thể dẫn đến việc sửa đổi giá trị
$merge
0 hoặc, nếu bộ sưu tập đầu ra bị chia cắt, giá trị khóa của Shard. Nếu không, thao tác tạo ra một lỗi.Mẹo
Để tránh lỗi này, nếu trường trên không bao gồm trường
$merge
0, hãy xóa trường$merge
0 trong kết quả tổng hợp để tránh lỗi, chẳng hạn như với giai đoạn$mergeObjects
5 trước đó, v.v.on field does not include the$merge
0 field, remove the$merge
0 field in the aggregation results to avoid the error, such as with a preceding$mergeObjects
5 stage, and so on.
"keepExisting"
Giữ tài liệu hiện có trong bộ sưu tập đầu ra.output collection.
"Hợp nhất" [mặc định] [Default]
Hợp nhất các tài liệu phù hợp [tương tự như toán tử $mergeObjects
].
Nếu tài liệu kết quả chứa các trường không có trong tài liệu hiện có, hãy thêm các trường mới này vào tài liệu hiện có.
Nếu tài liệu kết quả chứa các trường trong tài liệu hiện có, hãy thay thế các giá trị trường hiện có bằng các giá trị từ tài liệu kết quả.
Ví dụ: nếu bộ sưu tập đầu ra có tài liệu:
$mergeObjects
7
Và kết quả tổng hợp có tài liệu:
$mergeObjects
8
Sau đó, tài liệu được hợp nhất là:
$mergeObjects
9
Khi thực hiện hợp nhất, tài liệu được hợp nhất không thể dẫn đến việc sửa đổi giá trị $merge
0 hoặc, nếu bộ sưu tập đầu ra bị chia cắt, giá trị khóa của Shard. Nếu không, thao tác tạo ra một lỗi.
Mẹo
Để tránh lỗi này, nếu trường trên không bao gồm trường $merge
0, hãy xóa trường $merge
0 trong kết quả tổng hợp để tránh lỗi, chẳng hạn như với giai đoạn $mergeObjects
5 trước đó, v.v.on field does not include the $merge
0 field, remove the $merge
0 field in the aggregation results to avoid the error, such as with a preceding $mergeObjects
5 stage, and so on.