/ /

누락된 샤드 키 필드 설정

이 버전의 문서는 보관되어 더 이상 지원되지 않습니다. 6.0 배포서버 업그레이드 하려면 MongoDB 7.0 업그레이드 절차를 참조하세요.

샤드 키 필드가 누락된 경우 샤드 키 필드 를 null 으)로 설정하다 수 있습니다. 누락된 샤드 키 필드 를null 이 아닌 값으로 설정하다 하려면 문서의 샤드 키 값 변경을 참조하세요.

업데이트를 수행하려면 mongos에서 다음 작업을 사용할 수 있습니다.

명령	메서드	설명
update with `multi: true`	db.collection.updateMany()	누락된 키 값을 `null`로만 설정하는 데 사용할 수 있습니다. 트랜잭션 내부 또는 외부에서 수행할 수 있습니다. 재시도 가능한 쓰기로 수행될 수도 있고 그렇지 않을 수도 있습니다. 추가 요구 사항은 특정 명령어/메서드를 참조하세요.
update with `multi: false`	db.collection.replaceOne() db.collection.updateOne()	누락된 키 값을 `null` 또는 다른 값으로 설정하는 데 사용할 수 있습니다. 누락된 샤드 키 필드를 설정하는 업데이트는 다음 요구 사항 중 하나를 반드시 충족해야 합니다 . 쿼리 필터에 쿼리의 전체 샤드 키에 대한 동등 조건이 포함되어 있음 쿼리 필터에 _id와 정확히 일치하는 항목이 포함되어 있습니다. 업데이트는 단일 샤드를 대상으로 합니다 `null` 이외의 값으로 설정하려면 문서의 샤드 키 값 변경을 참조하세요. 추가 요구 사항은 특정 명령어/메서드를 참조하세요.
찾기 및 수정	db.collection.findOneAndReplace() db.collection.findOneAndUpdate() db.collection.findAndModify()	누락된 키 값을 `null` 또는 다른 값으로 설정하는 데 사용할 수 있습니다. 누락된 샤드 키 필드를 하나의 문서만 명시적으로 업데이트하는 메서드로 설정하는 경우, 업데이트는 반드시 다음 요구 사항 중 하나를 충족해야 합니다. 쿼리 필터에 쿼리의 전체 샤드 키에 대한 동등 조건이 포함되어 있음 쿼리 필터에 _id와 정확히 일치하는 항목이 포함되어 있습니다. 업데이트는 단일 샤드를 대상으로 합니다 `null`에서 일치하는 경우 누락된 키 값이 반환됩니다. `null`인 키 값이 업데이트되지 않도록 하려면 추가 쿼리 조건을 적절하게 포함합니다. `null` 이외의 값으로 설정하려면 문서의 샤드 키 값 변경을 참조하세요. 추가 요구 사항은 특정 명령어/메서드를 참조하세요.
	`db.collection.bulkWrite()` `Bulk.find.replaceOne()` `Bulk.find.updateOne()` `Bulk.find.update()`	`null` 값으로 설정하려면 대량 작업에서 여러 개의 샤드 키 수정을 지정할 수 있습니다. 누락된 샤드 키 필드를 하나의 문서만 명시적으로 업데이트하는 메서드로 설정하는 경우, 업데이트는 반드시 다음 요구 사항 중 하나를 충족해야 합니다. 쿼리 필터에 쿼리의 전체 샤드 키에 대한 동등 조건이 포함되어 있음 쿼리 필터에 _id와 정확히 일치하는 항목이 포함되어 있습니다. 업데이트는 단일 샤드를 대상으로 합니다 `null` 이외의 값으로 설정하려면 문서의 샤드 키 값 변경을 참조하세요. 추가 요구 사항은 기본 명령어/메서드를 참조하세요.

예시

location 필드에 샤딩된 sales 컬렉션을 생각해 보세요. 컬렉션의 일부 문서에는 location 필드가 없습니다. 누락된 필드는 해당 필드의 null 값과 동일한 것으로 간주됩니다. 이러한 필드를 명시적으로 null로 설정하려면 다음 명령을 실행합니다.

db.sales.updateOne(
  { _id: 12345, location: null },
  { $set: { location: null } }
)

누락된 샤드 키 필드를 db.collection.updateOne() 또는 하나의 문서만 명시적으로 업데이트하는 메서드로 설정하는 경우, 업데이트는 반드시 다음 요구 사항 중 하나를 충족해야 합니다.

쿼리 필터에 쿼리의 전체 샤드 키에 대한 동등 조건이 포함되어 있음
쿼리 필터에 _id와 정확히 일치하는 항목이 포함되어 있습니다.
업데이트는 단일 샤드를 대상으로 합니다.

돌아가기

문서의 샤드 키 값 변경

샤드 키 찾기