문서 생성, 보기, 업데이트 및 삭제
Atlas UI를 사용하여 컬렉션 문서를 관리할 수 있습니다. 문서는 MongoDB 컬렉션의 개별 기록이며 MongoDB의 기본 데이터 단위입니다.
Atlas UI에서 문서와 컬렉션을 보면 데이터베이스 스키마에 대한 대략적인 개요를 확인할 수 있습니다. Atlas UI를 사용하여 내장된 문서 및 배열 활용과 같은 MongoDB의 핵심 데이터 모델링 개념을 따르고 있는지 확인할 수 있습니다.
필수 역할
문서 삽입
Atlas UI를 통해 컬렉션에 하나 이상의 문서를 추가하려면, 처음부터 삽입할 문서를 지정하거나 기존 문서를 복제하고 필요한 경우 해당 문서 필드와 값을 수정할 수 있습니다.
컬렉션 에 문서를 삽입하려면 Atlas 에서 다음 방법 중 하나를 사용합니다.
JSON Mode :icon-lg:`CurlyBraces`: 편집기에서 JSON 문서를 쓰기 (write) 붙여넣을 수 있습니다. 이 모드 사용하면 여러 문서를 한 번에 배열 로 삽입할 수 있습니다.
필드별 편집기 :icon-log:`Menu`: 삽입된 각 문서 에 대해 개별 필드 값과 유형을 선택할 수 있습니다. 이 방법을 사용하면 한 번에 하나 문서 만 삽입할 수 있습니다.
AtlasGo Atlas 에서 프로젝트 의 Clusters 페이지로 고 (Go) 합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.
Collections 페이지로 이동합니다.
cluster의 Browse Collections 버튼을 클릭합니다.
데이터 탐색기 가 표시됩니다.
Add Data 드롭다운 메뉴를 엽니다.
드롭다운 메뉴에서 Insert Document을 선택합니다.
문서 편집기는 문서 삽입된 시점이 아니라 문서가 생성된 시점을 반영하는 ObjectId 값을 포함하는 _id 필드 와 함께 표시됩니다. 따라서 ObjectId 는 엄격한 삽입 순서를 나타내지 않습니다.
문서를 수정합니다.
컬렉션 에 삽입하려는 문서를 입력하거나 붙여넣습니다. 여러 문서를 삽입하려면 쉼표로 구분된 JSON 문서 배열 입력합니다.
예시 들어 다음 배열 5 문서를 컬렉션 에 삽입합니다.
[ { "_id" : 8752, "title" : "Divine Comedy", "author" : "Dante", "copies" : 1 }, { "_id" : 7000, "title" : "The Odyssey", "author" : "Homer", "copies" : 10 }, { "_id" : 7020, "title" : "Iliad", "author" : "Homer", "copies" : 10 }, { "_id" : 8645, "title" : "Eclogues", "author" : "Dante", "copies" : 2 }, { "_id" : 8751, "title" : "The Banquet", "author" : "Dante", "copies" : 2 } ]
AtlasGo Atlas 에서 프로젝트 의 Clusters 페이지로 고 (Go) 합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.
Collections 페이지로 이동합니다.
cluster의 Browse Collections 버튼을 클릭합니다.
데이터 탐색기 가 표시됩니다.
Add Data 드롭다운 메뉴를 엽니다.
드롭다운 메뉴에서 Insert Document을 선택합니다.
문서 편집기는 문서 삽입된 시점이 아니라 문서가 생성된 시점을 반영하는 ObjectId 값을 포함하는 _id 필드 와 함께 표시됩니다. 따라서 ObjectId 는 엄격한 삽입 순서를 나타내지 않습니다.
문서 복제
collection에 있는 기존 문서의 스키마와 값을 복제해 새 문서를 삽입할 수 있습니다.
문서를 복제하려면 원하는 문서 위에 마우스를 올리고 Clone 버튼을 클릭하세요.
문서를 복제하려면 원하는 문서 위에 마우스를 올리고 Clone 버튼을 클릭하세요.
문서를 복제하려면 원하는 문서 위에 마우스를 올리고 Clone 버튼을 클릭하세요.
Clone 버튼을 클릭하면 Atlas 복제된 문서 와 동일한 스키마 및 값을 사용하여 문서 삽입 대화 상자를 엽니다. 새 문서 삽입하기 전에 이러한 필드와 값을 편집할 수 있습니다.
문서 보기
Documents 탭 에서 다음 보기 중 하나를 사용하여 문서를 보고 관리 할 수 있습니다.
목록 보기 :icon-log:`Menu`: 기본값 문서 보기입니다. Atlas 문서를 목록으로 표시합니다. 이 보기에서는 포함된 객체와 배열을 확장할 수 있습니다.
JSON View :icon-lg:`CurlyBraces`: Atlas 문서를 올바른 형식의 JSON 객체로 표시합니다. Atlas 확장 JSON 사용하여 각 필드 의 데이터 유형을 표시합니다.
Table View :icon-log:`Table`: Atlas 문서를 테이블의 행으로 표시하고 문서 필드를 테이블 열에 표시합니다. 이 보기에서는 어떤 문서에 특정 필드 값이 포함되어 있는지 확인할 수 있습니다.
내장된 객체 및 배열 확장하기
포함된 객체 및 배열 요소를 확장하려면 문서 위로 마우스를 가져간 다음 왼쪽 상단 모서리에 있는 화살표를 클릭합니다.
포함된 객체 및 배열 요소를 확장하려면 문서 위로 마우스를 가져간 다음 문서 왼쪽에 있는 상단 화살표를 클릭합니다.
개별 객체와 배열을 확장하려면 원하는 필드 왼쪽에 있는 화살표를 클릭합니다.
중첩된 객체 필드 및 배열 요소를 보려면 값 유형이 Object 또는 Array 인 필드 위에 커서를 놓고 필드 오른쪽에 나타나는 바깥쪽을 가리키는 화살표가 있는 버튼을 클릭합니다.
Atlas 중첩된 요소에 해당하는 Table View(테이블 보기)에서 새 탭 엽니다.
다음 예시에서는 restaurants 컬렉션 문서 내에 중첩된 address 객체를 표시합니다. 새 탭에는 address 객체 의 5가지 속성이 표시됩니다.
원래 테이블 표시로 돌아가려면 컬렉션 이름이 표시되는 테이블 보기 의 첫 번째 탭 클릭합니다.
클립보드에 문서 복사
문서를 클립보드에 복사하려면 문서 위에 마우스를 갖다 대고 Copy 아이콘을 클릭합니다.
문서를 클립보드에 복사하려면 문서 위에 마우스를 갖다 대고 Copy 아이콘을 클릭합니다.
문서를 클립보드에 복사하려면 문서 위에 마우스를 갖다 대고 Copy 아이콘을 클릭합니다.
페이지당 표시되는 문서 수
Atlas UI는 페이지당 표시되는 문서의 총 바이트 크기를 제한합니다. 따라서, 특히 문서의 크기가 서로 상당히 다를 경우, 페이지마다 보이는 문서의 수가 변동될 수 있습니다.
하나의 문서 편집
목록 또는 표 보기에서 문서 편집할 때 Atlas findOneAndUpdate 작업을 수행하고 변경한 필드만 업데이트합니다.
JSON 보기에서 문서 편집할 때 Atlas findOneAndReplace 작업을 수행하여 문서 바꿉니다.
문서를 수정하려면 문서 위로 마우스를 가져간 다음 연필 아이콘을 클릭합니다.
연필 아이콘을 클릭하면 문서가 편집 모드로 전환됩니다. 이제 값의 필드, 값 또는 데이터 유형을 변경할 수 있습니다.
필드 삭제
문서에서 필드를 삭제하려면 필드 왼쪽에 있는 아이콘을 클릭합니다.
선택하면 필드 제거 대상으로 표시되고 빨간색으로 강조 표시됩니다. Atlas 필드 제거하여 문서 업데이트 할 것인지 묻는 확인 메시지가 표시됩니다.
새 필드 추가
문서에서 기존 필드 뒤에 새 필드를 추가하려면 대화 상자의 행 번호 위에 마우스를 놓고 더하기 기호를 클릭하세요. 행 번호는 문서의 일부가 아니지만 대화 상자 표시의 일부입니다.
텍스트 커서가 마지막 문서 필드 값에 있을 때 탭 키를 눌러 문서 끝에 새 필드를 추가할 수도 있습니다.
기존 필드 수정
문서를 수정하려면 기존 필드 이름이나 값을 클릭하고 변경합니다. 이 예에서는 borough이(가) Manhattan에서 Queens(으)로 변경되었습니다. 변경된 필드는 노란색으로 강조 표시됩니다.
목록 또는 표 보기에서 문서 편집할 때 Atlas findOneAndUpdate 작업을 수행하고 변경한 필드만 업데이트합니다.
Atlas 외부에서 수정된 필드를 변경한 것을 Atlas 감지하면 사용자에게 이를 알려주어 실수로 Atlas 외부에서 변경한 내용을 덮어쓰는 것을 방지합니다. 계속 진행하고 Update을 클릭하여 문서 바꾸거나 변경 사항을 취소할 수 있습니다.
변경 사항 저장
문서 편집이 끝나면 Update 버튼을 클릭하여 변경 사항을 적용합니다.
변경 내용 되돌리기
문서의 변경 사항을 되돌리려면 편집된 필드 위로 마우스를 가져간 후 필드 줄 번호 왼쪽에 표시되는 revert icon 을 클릭하세요.
문서를 수정하려면 문서 위로 마우스를 가져간 다음 연필 아이콘을 클릭합니다.
연필 아이콘을 클릭하면 문서가 편집 모드로 전환됩니다. 이제 JSON document를 수정하여 필드 값을 추가, 제거 및 편집할 수 있습니다.
기본적으로 이 보기는 포함된 객체와 배열을 숨깁니다. 내장된 객체 및 배열 요소를 확장하려면 대상 문서 위로 마우스를 가져간 다음 왼쪽 에 있는 화살표를 클릭합니다.
개별 객체와 배열을 확장하려면 원하는 필드 왼쪽에 있는 화살표를 클릭합니다.
JSON 보기에서 문서 편집할 때 Atlas findOneAndReplace 작업을 수행하여 문서 바꿉니다.
Atlas 외부에서 수정된 필드를 변경한 것을 Atlas 감지하면 사용자에게 이를 알려주어 실수로 Atlas 외부에서 변경한 내용을 덮어쓰는 것을 방지합니다. 계속 진행하고 Update을 클릭하여 문서 바꾸거나 변경 사항을 취소할 수 있습니다.
문서를 수정하려면 문서 위로 마우스를 가져간 다음 연필 아이콘을 클릭합니다.
연필 아이콘을 클릭하면 문서가 편집 모드로 전환됩니다.
목록 또는 표 보기에서 문서 편집할 때 Atlas findOneAndUpdate 작업을 수행하고 변경한 필드만 업데이트합니다.
Atlas 외부에서 수정된 필드를 변경한 것을 Atlas 감지하면 사용자에게 이를 알려주어 실수로 Atlas 외부에서 변경한 내용을 덮어쓰는 것을 방지합니다. 계속 진행하고 Update을 클릭하여 문서 바꾸거나 변경 사항을 취소할 수 있습니다.
필드 삭제
문서에서 필드를 삭제하려면:
삭제하려는 필드의 값을 클릭합니다.
아이콘을 클릭합니다.
Update을 클릭하여 변경 사항을 확인합니다.
새 필드 추가
문서에 새 필드를 추가하려면:
새 필드를 추가하려는 필드를 클릭합니다.
아이콘을 클릭합니다.
Add Field after <Field Name>를 클릭합니다.
새로 만든 필드를 채웁니다.
Update을 클릭하여 변경 사항을 확인합니다.
변경 내용 되돌리기
문서를 수정하는 동안 수정한 문서를 저장하기 전에 필드에 변경한 내용을 되돌릴 수 있는 옵션이 있습니다.
편집한 테이블 요소의 오른쪽에 나타나는 revert icon을(를) 클릭합니다.
여러 문서 편집
일괄 업데이트 작업 워크플로를 사용하여 Atlas 에서 여러 문서를 업데이트 할 수 있습니다. 자세한 내용은 여러 문서 수정을 참조하세요.
문서 하나 삭제
Atlas UI를 통해 컬렉션에서 문서를 삭제하려면 다음과 같이 하십시오:
문서를 삭제하려면 문서 위에 마우스를 갖다 대고 아이콘을 클릭합니다.
삭제 버튼을 클릭하면 문서 삭제 플래그로 지정됩니다. Atlas 문서 제거 할 것인지 묻는 확인 메시지가 표시됩니다.
문서를 삭제하려면 문서 위에 마우스를 갖다 대고 아이콘을 클릭합니다.
삭제 버튼을 클릭하면 문서 삭제 플래그로 지정됩니다. Atlas 문서 제거 할 것인지 묻는 확인 메시지가 표시됩니다.
문서를 삭제하려면 문서 위에 마우스를 갖다 대고 아이콘을 클릭합니다.
삭제 버튼을 클릭하면 문서 삭제 플래그로 지정됩니다. Atlas 문서 제거 할 것인지 묻는 확인 메시지가 표시됩니다.
확인하면 Atlas 컬렉션 에서 문서 삭제합니다.