TTL Indexes

TTL 인덱스 만들기

TTL 인덱스를 생성하려면 createIndex()를 사용합니다. 날짜 유형 또는 날짜 유형 값을 포함하는 배열인 인덱스 필드를 지정합니다. expireAfterSeconds 옵션을 사용하여 TTL 값을 초 단위로 지정합니다.

TTL 인덱스 expireAfterSeconds 값은 0 과 2147483647 사이여야 합니다.

예를 들어 eventlog 컬렉션의 lastModifiedDate 필드에 TTL 값이 3600초인 TTL 인덱스를 만들려면 mongosh의 다음 연산을 사용합니다.

db.eventlog.createIndex(
   { "lastModifiedDate": 1 },
   { expireAfterSeconds: 3600 }
)

MongoDB 6.3부터는 시계열 컬렉션에 부분 TTL 인덱스를 생성할 수 있습니다. 이 인덱스는 timeField 컬렉션을 키 필드로 사용하며 metaField에 부분 필터 표현식이 필요합니다.

time series 컬렉션에는 선택 사항인 expireAfterSeconds 필드가 포함됩니다. expireAfterSeconds를 설정하지 않는 경우 partialFilterExpression이 있는 TTL 인덱스를 통해 필터와 일치하는 문서의 만료 기간을 설정할 수 있습니다. expireAfterSeconds를 설정하면 부분 TTL 인덱스를 통해 일치하는 문서에 대해 다른 짧은 만료 기간을 설정할 수 있습니다. metaField에 대해서만 partialFilterExpression을 만들 수 있습니다.

시계열 컬렉션에 1970-01-01T00:00:00.000Z 이전 또는 2038-01-19T03:14:07.000Z 이후에 timeField 타임스탬프가 있는 문서가 포함된 경우 TTL " time to live " 기능을 사용하여 컬렉션에서 문서를 삭제하지 않습니다.

이 날씨 데이터 시계열 컬렉션은 24시간 후에 문서를 삭제합니다.

db.createCollection(
   "weather24h",
   {
      timeseries: {
         timeField: "timestamp",
         metaField: "sensor",
         granularity: "hours"
      },
      expireAfterSeconds: 86400
   }
)

이 TTL 인덱스는 24시간이 아닌 1시간 후에 MongoDB NYC 본사 기상 센서에서 문서를 삭제합니다.

db.eventlog.createIndex(
  { "timestamp": 1 },
  { partialFilterExpression: { "sensor": { $eq: "40.761873, -73.984287" } } },
  { expireAfterSeconds: 3600 } )

비 TTL 단일 필드 인덱스를 TTL 인덱스로 변환하기

MongoDB 5.1부터 기존 단일 필드 인덱스에 expireAfterSeconds 옵션을 추가할 수 있습니다. TTL이 아닌 단일 필드 인덱스를 TTL 인덱스로 변경하려면 collMod 데이터베이스 명령을 사용합니다.

db.runCommand({
  "collMod": <collName>,
  "index": {
    "keyPattern": <keyPattern>,
    "expireAfterSeconds": <number>
  }
})

다음 예에서는 패턴이 { "lastModifiedDate": 1 }인 비 TTL 단일 필드 인덱스를 TTL 인덱스로 변환합니다.

db.runCommand({
  "collMod": "tickets",
  "index": {
    "keyPattern": { "lastModifiedDate": 1 },
    "expireAfterSeconds": 100
  }
})

TTL 인덱스의 expireAfterSeconds 값 변경

TTL 인덱스의 expireAfterSeconds 값을 변경하려면 collMod 데이터베이스 명령을 사용합니다.

db.runCommand({
  "collMod": <collName>,
  "index": {
    "keyPattern": <keyPattern>,
    "expireAfterSeconds": <number>
  }
})

다음 예에서는 tickets 컬렉션에서 { "lastModifiedDate": 1 } 패턴을 사용하여 색인의 expireAfterSeconds 값을 변경합니다.

db.runCommand({
  "collMod": "tickets",
  "index": {
    "keyPattern": { "lastModifiedDate": 1 },
    "expireAfterSeconds": 100
  }
})

행동

제한 사항

• TTL 인덱스는 단일 필드 인덱스입니다. 복합 인덱스는 TTL을 지원하지 않으며 expireAfterSeconds 옵션을 무시합니다.

• _id 필드는 TTL 인덱스를 지원하지 않습니다.

• MongoDB 7.0부터는 time series 컬렉션의 metaField에 대한 부분 TTL 인덱스를 만들 수 있습니다. 이전 MongoDB 버전에서는 time series 컬렉션의 timeField에 대해서만 TTL 인덱스를 만들 수 있습니다.

• 기존 인덱스의 expireAfterSeconds 값을 변경하기 위해 createIndex()를 사용할 수 없습니다. 대신 collMod 데이터베이스 명령을 사용하세요. 자세한 내용은 TTL 인덱스의 expireAfterSeconds 값 변경을 참조하세요.

• 필드에 대해 TTL이 아닌 단일 필드 인덱스가 이미 존재하는 경우 키 사양이 같고 옵션만 다른 인덱스는 만들 수 없으므로 동일한 필드에 TTL 인덱스를 만들 수 없습니다. TTL이 아닌 단일 필드 인덱스를 TTL 인덱스로 변경하려면 collMod 데이터베이스 명령을 사용하세요.