Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# \$1mergeObjects
<a name="mergeObjects"></a>

`$mergeObjects`Operator di Amazon DocumentDB digunakan untuk menggabungkan beberapa dokumen atau objek ke dalam satu dokumen. Operator ini sangat berguna ketika Anda perlu menggabungkan konten dari dua atau lebih dokumen atau objek, berpotensi menimpa nilai dari satu objek dengan yang dari yang lain.

**Parameter**
+ `expression1`: Objek pertama yang akan digabungkan.
+ `expression2`: (opsional) Objek kedua yang akan digabungkan.
+ `expression3`: (opsional) Objek tambahan yang akan digabungkan.

## Contoh (MongoDB Shell)
<a name="mergeObjects-examples"></a>

Contoh berikut menunjukkan bagaimana menggunakan `$mergeObjects` operator untuk menggabungkan dua objek.

**Buat dokumen sampel**

```
db.collection.insertMany([
  { "_id": 1, "name": "John", "address": { "city": "New York", "state": "NY" } },
  { "_id": 2, "name": "Jane", "address": { "city": "Los Angeles", "state": "CA" } }
]);
```

**Contoh kueri**

```
db.collection.aggregate([
  {
    $project: {
      "combinedAddress": {
        $mergeObjects: ["$address", { "country": "USA" }]
      }
    }
  }
])
```

**Keluaran**

```
[
  {
    "_id": 1,
    "combinedAddress": {
      "city": "New York",
      "state": "NY",
      "country": "USA"
    }
  },
  {
    "_id": 2,
    "combinedAddress": {
      "city": "Los Angeles",
      "state": "CA",
      "country": "USA"
    }
  }
]
```

## Contoh kode
<a name="mergeObjects-code"></a>

Untuk melihat contoh kode untuk menggunakan `$mergeObjects` perintah, pilih tab untuk bahasa yang ingin Anda gunakan:

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

async function example() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const collection = db.collection('collection');

  const result = await collection.aggregate([
    {
      $project: {
        "combinedAddress": {
          $mergeObjects: ["$address", { "country": "USA" }]
        }
      }
    }
  ]).toArray();

  console.log(result);
  await client.close();
}

example();
```

------
#### [ Python ]

```
from pymongo import MongoClient

def example():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client['test']
    collection = db['collection']

    result = list(collection.aggregate([
        {
            '$project': {
                "combinedAddress": {
                    "$mergeObjects": ["$address", { "country": "USA" }]
                }
            }
        }
    ]))

    print(result)
    client.close()

example()
```

------