Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs Menu
Docs Home
/ /

$unset (업데이트 연산자)

참고

명확화

다음 페이지는 업데이트 연산자 $unset을 참조합니다. 집계 단계에 대해서는 $unset을 참조하세요.

$unset

$unset 연산자는 특정 필드를 삭제합니다.

다음 환경에서 호스팅되는 배포에 $unset 사용할 수 있습니다.

  • MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

다음 구문을 고려하세요.

{ $unset: { <field1>: "", ... } }

표현식 $unset 에 지정된"" 값(즉,)은 작업에 영향 않습니다.

내장된 문서나 배열에 <field> 기호를 지정하려면 점 표기법을사용하십시오.

MongoDB 5.0부터 업데이트 연산자는 문자열 기반 이름이 있는 문서 필드를 사전순으로 처리합니다. 숫자 이름이 있는 필드는 숫자 순서대로 처리됩니다. 자세한 내용은 업데이트 운영자 동작을 참조하십시오.

필드 존재하지 않으면 은 아무 작업도 수행하지 않습니다(즉, 작업을 수행하지 $unset 않음).

배열 요소를 일치시키기 위해 $와 함께 사용할 경우 $unset은 배열에서 일치하는 요소를 제거하는 대신 일치하는 요소를 null로 바꿉니다. 이 동작은 배열 크기와 요소 위치를 일관되게 유지합니다.

MongoDB 5.0부터 빈 피연산자 표현식( { } )과 함께 $unset과 같은 업데이트 연산자를 사용할 때 mongod에서 더 이상 오류가 발생하지 않습니다. 업데이트가 비어 있으면 변경 사항이 없으며 oplog 항목이 생성되지 않습니다(즉, 작업이 작동하지 않음을 의미합니다).

이 페이지의 예시에서는 sample_mflix 샘플 데이터 세트의 데이터를 사용합니다. 이 데이터 세트를 자체 관리형 MongoDB 배포서버에 로드하는 방법에 대한 자세한 내용은 샘플 데이터 세트 로드를 참조하세요. 샘플 데이터베이스를 수정한 경우 이 페이지의 예시를 실행 하려면 데이터베이스를 제거하고 다시 만들어야 할 수 있습니다.

다음 예시 $unset 연산자 사용하여 label status 일치하는 영화 문서 에서 및 필드를 제거 .

db.movies.updateOne(
{ title: "The Dark Knight" },
{ $unset: { label: "", status: "" } }
)

이 연산은 다음과 같은 결과를 반환합니다.

{
acknowledged: true,
insertedId: null,
matchedCount: 1,
modifiedCount: 1,
upsertedCount: 0
}

돌아가기

$setOnInsert

이 페이지의 내용