/ /

누락된 샤드 키 필드 설정

청크 범위 및 누락된 샤드 키 필드

누락된 샤드 키 필드는 null 값을 가진 샤드 키와 동일한 청크 범위 내에 속합니다. 예시 들어 샤드 키 { x: 1, y: 1 } 필드에 있는 경우 다음과 같습니다.

샤드 키가 누락된 문서	다음과 같은 범위에 속함
`{ x: "hello" }`	`{ x: "hello", y: null }`
`{ y: "goodbye" }`	`{ x: null, y: "goodbye" }`
`{ z: "oops" }`	`{ x: null, y: null }`

읽기/쓰기 작업 및 누락된 샤드 키 필드

샤드 키 필드가 누락된 문서를 대상으로 하려면 샤드 키 필드에 { $exists: false } 필터 조건을 사용할 수 있습니다. 예시 를 들어, 샤드 키 { x: 1, y: 1 } 필드에 있는 경우 다음 쿼리 실행 하여 샤드 키 필드가 누락된 문서를 찾을 수 있습니다.

db.shardedcollection.find( { $or: [ { x: { $exists: false } }, { y: { $exists: false } } ] } )

Null 동등성 매치 필터 조건을 지정하는 경우(예: { x: null }), 필터는 샤드 키 필드가 누락된 문서 및 샤드 키 필드가 null로 설정된 문서를 모두 일치시킵니다.

upsert 사양의 쓰기와 같은 일부 쓰기 연산에는 샤드 키에 대한 동등성 매치가 요구됩니다. 이러한 경우 샤드 키가 누락된 문서를 대상으로 하려면 null 동등성 매치 외에도 다른 필터 조건을 포함합니다. 예시:

{ _id: <value>, <shardkeyfield>: null } // _id of the document missing shard key

누락된 샤드 키 필드 설정

샤드 키 필드가 누락된 경우 샤드 키 필드 를 null 으)로 설정하다 수 있습니다. If you want to set the missing shard key field to a non-null value, see Change a Document's Shard Key Value.

업데이트를 수행하려면 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와 정확히 일치하는 항목이 포함되어 있습니다.
업데이트는 단일 샤드를 대상으로 합니다.

돌아가기

샤드 키 값 변경

샤드 키 표시