기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

Amazon DocumentDB의 `$setOnInsert` 연산자는 문서가 삽입되는 경우 필드의 값을 설정하는 데 사용되지만 문서가 업데이트되는 경우에는 영향을 주지 않습니다.

**파라미터**
+ `field`: 설정할 필드입니다.
+ `value`: 필드에 할당할 값입니다.

## 예제(MongoDB 쉘)
<a name="setOnInsert-examples"></a>

다음 예제에서는 Amazon DocumentDB에서 `$setOnInsert` 연산자의 사용을 보여줍니다. 문서가 아직 없는 경우 새 문서를 생성하지만 문서가 업데이트되는 경우에는 영향을 미치지 않습니다.

**샘플 문서 생성**

```
db.users.insertOne({
  _id: 1,
  name: "John Doe",
  age: 30
})
```

**쿼리 예제 1 - 기존 문서 업데이트**

```
db.users.update(
  { _id: 1 },
  {
    $set: { age: 31 },
    $setOnInsert: { createdAt: new Date() }
  },
  { upsert: true }
)
```

**출력 1**

```
{
  _id: 1,
  name: "John Doe",
  age: 31
}
```

출력은 문서가 업데이트되었지만 문서가 이미 존재했기 때문에 `createdAt` 필드가 **추가되지** 않았음을 보여줍니다. 연`$setOnInsert`산자는 새 문서를 삽입할 때만 적용됩니다.

**쿼리 예제 2 - 새 문서 삽입(업서트)**

```
db.users.update(
  { _id: 2 },
  {
    $set: { name: "Jane Smith", age: 25 },
    $setOnInsert: { createdAt: new Date() }
  },
  { upsert: true }
)
```

**출력 2**

```
{
  _id: 2,
  name: "Jane Smith", 
  age: 25,
  createdAt: ISODate("2025-10-31T09:57:52.459Z")
}
}
```

## 코드 예제
<a name="setOnInsert-code"></a>

`$setOnInsert` 명령을 사용하기 위한 코드 예제를 보려면 사용하려는 언어의 탭을 선택합니다.

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

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

async function updateWithSetOnInsert() {
  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 users = db.collection('users');

  await users.updateOne(
    { _id: 1 },
    {
      $set: { age: 31 },
      $setOnInsert: { createdAt: new Date() }
    },
    { upsert: true }
  );

  const updatedUser = await users.findOne({ _id: 1 });
  console.log(updatedUser);

  await client.close();
}

updateWithSetOnInsert();
```

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

```
from pymongo import MongoClient

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

    result = users.update_one(
        {'_id': 1},
        {
            '$set': {'age': 31},
            '$setOnInsert': {'createdAt': datetime.datetime.now()}
        },
        upsert=True
    )

    updated_user = users.find_one({'_id': 1})
    print(updated_user)

    client.close()

update_with_set_on_insert()
```

------