翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# \$1merge
8.0 で導入
Amazon DocumentDB の`$merge`集約ステージは、前のパイプラインステージの結果をターゲットコレクションにマージするために使用されます。これは、入力ドキュメントのデータに基づいて、ターゲットコレクション内のドキュメントを更新または挿入する場合に便利です。
`$merge` ステージでは、入力ドキュメントとターゲットコレクション間の一致条件に基づいて、次のようなさまざまなアクションを実行できます。
```
- Insert new documents
- Update existing documents
- Delete documents
- Fail the operation if there are any conflicts
```
**パラメータ**
+ `into`: (必須) 入力ドキュメントをマージするターゲットコレクションの名前。
+ `on`: (必須) 入力ドキュメントとターゲットコレクション間の一致条件として使用するフィールド (複数可）。
+ `whenMatched`: (オプション) 入力ドキュメントがターゲットコレクション内の既存のドキュメントと一致するときに実行するアクション。サポートされている値は `"merge"`、`"replace"`、`"keepExisting"`、`"fail"` です。
+ `whenNotMatched`: (オプション) 入力ドキュメントがターゲットコレクション内のドキュメントと一致しない場合に実行するアクション。サポートされている値は、 `"insert"`と です`"fail"`。
## 例 (MongoDB シェル)
次の例は、 `$merge`ステージを使用して、入力パイプラインの新しいデータで`users`コレクションを更新する方法を示しています。
**サンプルドキュメントを作成する**
```
db.users.insertMany([
{ _id: 1, name: "John Doe", email: "john@example.com" },
{ _id: 2, name: "Jane Smith", email: "jane@example.com" }
]);
db.inputData.insertMany([
{ _id: 1, name: "John Doe", email: "john@example.com", phone: "123-456-7890" },
{ _id: 3, name: "Bob Johnson", email: "bob@example.com", phone: "987-654-3210" }
]);
```
**クエリの例**
```
db.inputData.aggregate([
{
$merge: {
into: "users",
on: "_id",
whenMatched: "merge",
whenNotMatched: "insert"
}
}
])
```
**出力**
`$merge` パイプラインを実行すると、`users`コレクションには次のドキュメントが含まれます。
```
[
{ _id: 1, name: "John Doe", email: "john@example.com", phone: "123-456-7890" },
{ _id: 2, name: "Jane Smith", email: "jane@example.com" },
{ _id: 3, name: "Bob Johnson", email: "bob@example.com", phone: "987-654-3210" }
]
```
## コードの例
`$merge` コマンドを使用するコード例を表示するには、使用する言語のタブを選択します。
------
#### [ Node.js ]
Node.js アプリケーションで \$1merge 演算子を使用する例を次に示します。
```
const { MongoClient } = require('mongodb');
async function example() {
const client = await MongoClient.connect('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
const db = client.db('test');
await db.collection('inputData').aggregate([
{
$merge: {
into: 'users',
on: '_id',
whenMatched: 'merge',
whenNotMatched: 'insert'
}
}
]).toArray();
const users = await db.collection('users').find({}).toArray();
console.log(users);
await client.close();
}
example();
```
------
#### [ Python ]
Python アプリケーションで \$1merge 演算子を使用する例を次に示します。
```
from pymongo import MongoClient
def example():
client = MongoClient('mongodb://:@:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
db = client['test']
# Assumes collections 'users' and 'inputData' already exist with sample data
db.inputData.aggregate([
{
'$merge': {
'into': 'users',
'on': '_id',
'whenMatched': 'merge',
'whenNotMatched': 'insert'
}
}
])
users = list(db.users.find({}))
print(users)
client.close()
example()
```
------