MongoDB에서 고유 인덱스(Unique Index) 설정하는 방법

MongoDB에서 고유 인덱스(Unique Index)를 설정하면 특정 필드에 중복된 값이 저장되는 것을 방지할 수 있습니다. 인덱스를 생성할 때 옵션에 unique:true를 지정하면 되는데, 이렇게 하면 해당 필드에 이미 존재하는 값과 동일한 값을 가진 문서를 삽입하려 할 때 에러가 발생합니다.

고유 인덱스 생성하기

먼저 컬렉션을 생성하면서 Name 필드에 고유 인덱스를 설정해 보겠습니다.

> db.demo257.ensureIndex({Name:1},{unique:true});
{
    "createdCollectionAutomatically" : true,
    "numIndexesBefore" : 1,
    "numIndexesAfter" : 2,
    "ok" : 1
}

인덱스가 정상적으로 생성되었습니다. 이제 컬렉션에 문서를 삽입해 보겠습니다.

> db.demo257.insertOne({Name:"Chris"});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e47a5e51627c0c63e7dba91")
}
> db.demo257.insertOne({Name:"Bob"});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e47a5e81627c0c63e7dba92")
}

"Chris"와 "Bob"은 서로 다른 값이므로 아무 문제 없이 삽입됩니다.

중복 값 삽입 시 발생하는 오류

이번에는 이미 존재하는 값인 "Chris"를 한 번 더 삽입해 보겠습니다.

> db.demo257.insertOne({Name:"Chris"});
2020-02-15T13:33:54.064+0530 E QUERY    [js] WriteError: E11000 duplicate key error collection: test.demo257 index: Name_1 dup key: { : "Chris" } :
WriteError({
    "index" : 0,
    "code" : 11000,
    "errmsg" : "E11000 duplicate key error collection: test.demo257 index: Name_1 dup key: { : \"Chris\" }",
    "op" : {
        "_id" : ObjectId("5e47a5ea1627c0c63e7dba93"),
        "Name" : "Chris"
    }
})
WriteError@src/mongo/shell/bulk_api.js:461:48
Bulk/mergeBatchResults@src/mongo/shell/bulk_api.js:841:49
Bulk/executeBatch@src/mongo/shell/bulk_api.js:906:13
Bulk/this.execute@src/mongo/shell/bulk_api.js:1150:21
DBCollection.prototype.insertOne@src/mongo/shell/crud_api.js:252:9
@(shell):1:1

위와 같이 E11000 duplicate key error(중복 키 오류)가 발생하며 삽입이 거부됩니다. 이는 고유 인덱스가 정상적으로 동작하고 있다는 증거입니다.

저장된 문서 확인하기

find() 메서드를 사용하여 컬렉션의 모든 문서를 조회해 보겠습니다.

> db.demo257.find();

실행 결과는 다음과 같습니다.

{ "_id" : ObjectId("5e47a5e51627c0c63e7dba91"), "Name" : "Chris" }
{ "_id" : ObjectId("5e47a5e81627c0c63e7dba92"), "Name" : "Bob" }

중복으로 삽입하려던 두 번째 "Chris" 문서는 저장되지 않고, 처음 삽입한 두 개의 문서만 남아 있는 것을 확인할 수 있습니다.

참고: 최신 버전에서는 createIndex 사용 권장

MongoDB 4.2부터 ensureIndex() 메서드는 더 이상 사용되지 않습니다(deprecated). 최신 버전의 MongoDB에서는 동일한 기능을 수행하는 createIndex() 메서드를 사용하는 것이 좋습니다.

> db.demo257.createIndex({Name:1},{unique:true});

사용법과 결과는 ensureIndex()와 완전히 동일하므로, 새 프로젝트에서는 createIndex()를 사용하는 습관을 들이는 것이 좋습니다.