TTL을 설정하여 컬렉션에서 데이터 만료하기

MongoDB Atlas UI에 문서 삽입

Atlas UI 에서 데이터를 만료하려면 다음 단계를 따르세요.

지정된 시간(초) 후 문서 만료

터미널에서 지정된 시간(초)이 지나면 데이터가 만료될 수 있습니다. 인덱싱된 필드에서 지정된 시간(초)이 경과한 후 데이터를 만료하려면 BSON 날짜 유형의 값 또는 BSON 날짜 유형의 개체 배열이 있는 필드에 TTL 인덱스를 만들고 expireAfterSeconds 필드에 0이 아닌 양수 값을 지정합니다. 색인화된 필드에 지정된 시간 이후 expireAfterSeconds 필드의 시간(초)이 지나면 문서가 만료됩니다. [1]

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

예를 들어 다음 작업은 log_events 컬렉션의 createdAt 필드에 인덱스를 만들고 10 의 expireAfterSeconds 값을 지정하여 만료 시간을 createdAt에서 지정한 시간 10초 후로 설정합니다.

db.log_events.createIndex( { "createdAt": 1 }, { expireAfterSeconds: 10 } )

0}log_events 컬렉션에 문서를 추가할 때 createdAt 필드를 현재 시간으로 설정합니다:

db.log_events.insertOne( {
   "createdAt": new Date(),
   "logEvent": 2,
   "logMessage": "Success!"
} )

문서의 createdAt 값 [1 ]이 expireAfterSeconds에 지정된 시간(초)보다 오래되면 MongoDB는 log_events 컬렉션에서 문서를 자동으로 삭제합니다.

필터 조건으로 문서 만료

특정 필터 표현식으로 문서를 만료하려면 부분 인덱스와 TTL 인덱스를 모두 생성할 수 있습니다.

부분 TTL 인덱스를 생성합니다:

db.foo.createIndex(
   { F: 1 },
   {
      name: "Partial-TTL-Index",
      partialFilterExpression: { D : 1 },
      expireAfterSeconds: 10
   }
)

1}의 필터 표현식 과 일치하는 문서 두 개를 { D : 1 } partialFilterExpression 삽입합니다:

db.foo.insertMany( [
   { "F" : ISODate("2019-03-07T20:59:18.428Z"), "D" : 3},
   { "F" : ISODate("2019-03-07T20:59:18.428Z"), "D" : 1}
] )

10초 동안 기다린 다음 foo 컬렉션을 쿼리합니다:

db.foo.find({}, {_id: 0, F: 1, D: 1})

{ D : 1 } 의 partialFilterExpression 과(와) 일치하는 문서가 삭제(만료)되었습니다. 결과적으로 foo 컬렉션에 문서가 하나만 남게 됩니다:

{ "F" : ISODate("2019-03-07T20:59:18.428Z"), "D" : 3}

특정 시계 시간에 문서 만료하기

터미널에서 지정된 시계 시간에 데이터를 만료할 수 있습니다. 특정 시계 시간에 문서를 만료하려면 먼저 BSON 날짜 유형의 값 또는 BSON 날짜 유형 객체의 배열을 포함하는 필드에 TTL 인덱스를 만들고 expireAfterSeconds 값을 0 로 지정합니다. 컬렉션의 각 문서에 대해 인덱싱된 날짜 필드를 문서가 만료되어야 하는 시간에 해당하는 값으로 설정합니다. 인덱싱된 날짜 필드에 과거 날짜가 포함되어 있는 경우, MongoDB는 문서가 만료된 것으로 간주합니다.

예를 들어, 다음 작업은 log_events 컬렉션의 expireAt 필드에 인덱스를 만들고 0 expireAfterSeconds 값을 지정합니다.

db.log_events.createIndex( { "expireAt": 1 }, { expireAfterSeconds: 0 } )

각 문서에 대해 문서가 만료되어야 하는 시간에 해당하도록 expireAt 값을 설정합니다. 예를 들어, 다음 insertOne() 작업은 July 22, 2013 14:00:00에 만료되는 문서를 추가합니다.

db.log_events.insertOne( {
   "expireAt": new Date('July 22, 2013 14:00:00'),
   "logEvent": 2,
   "logMessage": "Success!"
} )

MongoDB는 문서의 expireAt 값이 expireAfterSeconds 지정된 시간 (예: 0 초) 보다 오래된 경우 log_events 컬렉션에서 문서를 자동으로 삭제합니다. 따라서 데이터는 지정된 expireAt 값에서 만료됩니다.

NaN을 사용하여 인덱스 구성

TTL 인덱스 구성에서 expireAfterSeconds 을 NaN 로 설정하지 마십시오.

MongoDB 5.0 이전 버전에서는 TTL 인덱스에 expireAfterSeconds 이 NaN로 설정된 경우, MongoDB는 오류를 기록하고 레코드를 제거하지 않습니다.

MongoDB 5.0.0 - 5.0.13(및 6.0.0 - 6.0.1)에서, NaN 은 0로 취급됩니다. TTL 인덱스가 로 구성되어 로 설정된 expireAfterSeconds NaN경우 모든 TTL 인덱스 문서가 즉시 만료됩니다.

MongoDB 5.0.14 (및 6.0.2) 부터 서버는 expireAfterSeconds 가 NaN 로 설정된 TTL 인덱스를 사용하지 않습니다.

그러나 여전히 예기치 않은 동작이 발생할 수 있는 몇 가지 상황이 있습니다. 문서가 만료될 수 있습니다:

• MongoDB 5.0.0 - 5.0.13(또는 6.0.0 - 6.0.1)에서 이전 버전으로 처음 동기화하는 중입니다.

• 이전 버전에서 MongoDB 5.0.0 - 5.0.13으로 업그레이드하는 경우.

• 5 이전 버전에서 컬렉션을 복원하는 경우.0 mongodump 를 MongoDB 5 로 변환합니다.0.0 - 5.0.13 (또는 6.0.0 - 6.0.1) 인스턴스.

문제를 방지하려면 잘못 구성된 TTL 인덱스를 삭제하거나 수정하세요.

function getNaNIndexes() {
   const nan_index = [];
   const dbs = db.adminCommand({ listDatabases: 1 }).databases;
   dbs.forEach((d) => {
      if (d.name != 'local') {
         const listCollCursor = db
            .getSiblingDB(d.name)
            .runCommand({ listCollections: 1 }).cursor;
         const collDetails = {
            db: listCollCursor.ns.split(".$cmd")[0],
            colls: listCollCursor.firstBatch.map((c) => c.name),
         };
         collDetails.colls.forEach((c) =>
            db
               .getSiblingDB(collDetails.db)
               .getCollection(c)
               .getIndexes()
               .forEach((entry) => {
                  if (Object.is(entry.expireAfterSeconds, NaN)) {
                     nan_index.push({ ns: `${collDetails.db}.${c}`, index: entry });
                  }
               })
         );
      }
   });
   return nan_index;
};
getNaNIndexes();