온라인 아카이브 관리
이 페이지의 내용
- 필요한 액세스 권한
- 온라인 아카이브 보기
- Atlas CLI를 사용하여 온라인 아카이브 조회
- API를 사용하여 온라인 아카이브 조회
- API를 사용하여 클러스터의 모든 온라인 아카이브 조회
- UI에서 온라인 아카이브 보기
- 온라인 아카이브 지표 보기
- Atlas에서 프로젝트의 연합 데이터베이스 인스턴스로 이동합니다.
- 지표 를 검토합니다.
- 보관 규칙을 편집합니다.
- Atlas CLI를 통해 보관 규칙 편집
- API를 통해 보관 규칙 편집
- UI를 통해 보관 규칙 편집
- 클라우드 객체 저장소에서 파티션 편집
- 온라인 아카이브 쿼리
- 연결 문자열
- 성능 고려 사항
- 가격 쿼리
- 온라인 아카이브 삭제
- Atlas CLI를 통한 온라인 아카이브 삭제
- UI에서 온라인 아카이브 삭제
- API를 통해 온라인 아카이브 삭제
온라인 아카이브를 구성한 후 다음을 수행할 수 있습니다.
필요한 액세스 권한
온라인 아카이브를 보거나 쿼리하려면 프로젝트에 대한 Project Read Only 이상의 액세스 권한이 있어야 합니다.
온라인 아카이브를 편집하거나 삭제하려면 프로젝트에 대한 Project Data Access Admin 이상의 액세스 권한이 있어야 합니다.
온라인 아카이브 보기
Atlas CLI, Atlas UI 및 API를 통해 클러스터의 온라인 아카이브 목록을 볼 수 있습니다.
Atlas CLI를 사용하여 온라인 아카이브 조회
Atlas CLI를 사용하여 클러스터의 모든 온라인 아카이브를 나열하려면 다음 명령을 실행하세요.
atlas clusters onlineArchives list [options]
Atlas CLI를 사용하여 지정한 스냅샷에 대한 세부 정보를 반환하려면 다음 명령을 실행하세요.
atlas clusters onlineArchives describe <archiveId> [options]
이전 명령의 구문 및 매개 변수에 대해 자세히 알아보려면 atlas clusters onlineArchives list 및 atlas clusters onlineArchives describe에 대한 Atlas CLI 문서를 참조하세요.
API를 사용하여 온라인 아카이브 조회
를 통해 Atlas Online Archive를 API GET ID 조회하려면 조회할 Atlas Online Archive의 고유 를 사용하여 onlineArchives 엔드포인트에 요청을 보냅니다. API 구문 및 옵션에 대해 자세히 알아보려면 API를 참조하세요.
API를 사용하여 클러스터의 모든 온라인 아카이브 조회
API 를 사용하여 클러스터에 대해 구성된 모든 온라인 아카이브를 조회하려면 클러스터의 onlineArchives 엔드포인트에 GET 요청을 보냅니다. 구문 및 옵션에 대해 자세히 알아보려면 API를 참조하세요.
UI에서 온라인 아카이브 보기
Online Archive 목록을 조회합니다.
AtlasGo Atlas 에서 프로젝트 의 Clusters 페이지로 고 (Go) 합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.
이 페이지에는 클러스터의 온라인 아카이브가 표시됩니다. 각 온라인 아카이브에 대해 다음 정보를 볼 수 있습니다:
참고
6월 7 에 출시하다 와 함께 사용할 수 있는 새 지표 의 값은 2023 출시하다 이후에 생성된 온라인 아카이브에 대해서만 Date Match 필드 에 Atlas UI 에 표시됩니다. 시계열 Online 보관 를 생성하거나 출시하다 이후에 기존 온라인 아카이브가 있는 경우 Atlas 는 지표 값 대신 N/A 를 표시합니다.
열 이름 | 설명 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Status | 온라인 아카이브의 상태입니다. 값은 다음 중 하나일 수 있습니다.
| ||||||||||||||
Actions | Online Archive에서 수행할 수 있는 작업입니다. | ||||||||||||||
Archive Field | 보관되는 문서를 기준으로 하는 날짜 필드입니다. | ||||||||||||||
Custom Criteria | 사용자 지정 JSON 필터. 이 코드 구성 요소를 스크롤할 수 있습니다. 아이콘을 클릭하여 뷰를 확장하면 전체 사용자 지정 기준을 볼 수 있습니다. | ||||||||||||||
Age Limit | 문서를 보관할 자격을 부여하는 데 사용되는 일수입니다. | ||||||||||||||
Deletion Age Limit | 아카이브에서 데이터를 삭제할 일수입니다. | ||||||||||||||
Total Data Archived | 아카이브에 저장된 비압축 데이터 크기입니다. 마우스를 가져가면 아카이브의 문서 수를 볼 수 있습니다. 새 Online Archive에서만 사용할 수 있는 지표입니다. | ||||||||||||||
Last Archived Run | 보관이 마지막으로 실행된 시작 날짜와 타임스탬프입니다. 마우스를 올리면 최근 작업 5개를 볼 수 있습니다. 각 작업은 시작 날짜, 시작 시간, 보관 기간, 문서 수 및 크기와 함께 목록으로 표시됩니다. | ||||||||||||||
Partition Fields | 클라우드 객체 저장소에서 데이터를 분할하는 데 사용되는 기타 일반적으로 사용되는 쿼리 필드입니다. | ||||||||||||||
Schedule | 보관 창 케이던스. 값은 다음과 같습니다: - | ||||||||||||||
Min Date Field | 아카이브에 있는 모든 문서의 최소 날짜 값입니다. 지표는 Atlas Data Federation 의 새 Online Archive에 대해서만 사용할 수 있습니다. | ||||||||||||||
Max Date Field | 아카이브에 있는 모든 문서의 최대 날짜 값입니다. 지표는 Atlas Data Federation 의 새 Online Archive에 대해서만 사용할 수 있습니다. |
온라인 아카이브 지표 보기
Atlas UI에서 Online Archive의 지표를 보려면 다음과 같이 하세요.
Atlas에서 프로젝트의 연합 데이터베이스 인스턴스로 이동합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.
사이드바에서 Services 제목 아래의 Data Federation를 클릭합니다.
Data Federation 페이지가 표시됩니다.
보관 규칙을 편집합니다.
Atlas 클러스터에 데이터를 보관할 일수(Age Limit) 또는 Atlas UI 및 API에서 보관할 문서를 선택하는 데 사용되는 사용자 지정 JSON 쿼리를 수정할 수 있습니다. 보관 기준을 Date Match 에서 Custom Filter로, 또는 그 반대로 변경할 수 없습니다.
Atlas CLI를 통해 보관 규칙 편집
Atlas CLI를 사용하여 클러스터의 온라인 아카이브를 업데이트하려면 다음 명령을 실행하세요.
atlas clusters onlineArchives update <archiveId> [options]
명령 구문 및 매개변수에 관한 자세한 사항은 Atlas CLI 문서에서 Atlas 클러스터 onlineArchives 업데이트를 참조하세요.
API를 통해 보관 규칙 편집
를 통해 Atlas Online Archive를 편집하려면 업데이트할 API PATCH ID Atlas Online Archive의 고유 를 사용하여 onlineArchives 엔드포인트에 요청을 보냅니다. API 구문 및 옵션에 대해 자세히 알아보려면 API를 참조하세요.
UI를 통해 보관 규칙 편집
온라인 아카이브를 편집하려면 Atlas UI에서 다음과 같이 하세요.
AtlasGo Atlas 에서 프로젝트 의 Clusters 페이지로 고 (Go) 합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.
온라인 아카이브의 Actions 열에서 줄임표(...)를 클릭하면 허용된 작업의 목록이 표시됩니다. 다음을 수행할 수 있습니다.
Pause Archiving (상태가 Active인 경우에만)
Edit Archive
Delete Archive
Resume Archiving (상태가 Paused인 경우에만)
드롭다운에서 를 선택하여 보관 규칙, 보관된 데이터를 보관할 일수, 데이터 보관 작업을 실행 하는 창 을 변경합니다.Edit Archive
보관 기준과 보관된 데이터를 삭제하기까지 남은 일수를 변경할 수 있습니다.
Date Match 기준을 편집하려면 Atlas가 Archival Age Limit 섹션에서 활성 Atlas 클러스터에 데이터를 저장하는 일수를 수정하세요.
Custom Criteria을 편집하려면 유효한 JSON 필터를 입력하여 보관할 문서를 선택합니다.
참고
Atlas는 지정된 쿼리를 db.collection.find(query) 명령과 함께 사용합니다. 사용자 지정 쿼리는 JavaScript 표현식을 지원하지 않습니다. 또한 빈 문서
{}를 전달하여 모든 문서를 반환할 수 없습니다.Atlas가 보관된 데이터를 삭제하기 전까지 남은 일수를 수정하려면 Deletion Age Limit 섹션에 일수를 입력하거나 수정하세요.
7~9125일을 지정하거나 필드를 비워 두고 데이터 만료 규칙을 비활성화할 수 있습니다. 이 변경 사항이 적용되려면 24시간이 걸립니다.데이터 보관 작업의 예약된 시간을 수정하려면 다음 중 하나를 변경합니다.
빈도. 매일, 특정 요일 또는 매월 특정 날짜에 작업을 실행하도록 선택할 수 있습니다. 매월 29일, 30일 또는 31일에 보관하려는 경우 Atlas는 해당 날짜가 포함되지 않은 달에는 보관 작업을 실행하지 않습니다.
시간 창. Atlas가 데이터 보관 작업을 실행하는 기간을 선택하세요. 최소 2시간을 지정해야 합니다.
Schedule Archive Window를 전환하여 일정을 비활성화할 수도 있습니다. 일정을 비활성화하면 Atlas는 기본 일정으로 돌아가서 보관 작업을 주기적으로 실행합니다.
Atlas는 데이터 보관 일정을 변경하는 즉시 새 데이터 보관 일정을 사용하기 시작합니다. 그러나 현재 보관 작업이 실행 중인 경우 Atlas는 실행 중인 작업을 중단하지 않으며, 작업이 완료된 후에 설정이 적용됩니다.
클라우드 객체 저장소에서 파티션 편집
Atlas UI 또는 API 에서는 파티션 필드나 구조를 수정할 수 없습니다. 그러나 $merge 를 사용하여 cloud 객체 저장 에서 데이터를 수동으로 마이그레이션 하고, $merge 를 사용하여 데이터를 Atlas cluster 로 다시 수화하고, 온라인 아카이브를 삭제 한 다음 원하는 파티션 필드가 있는 컬렉션 에 대한 새 온라인 아카이브를 만들 수 있습니다. 및 구조.
온라인 아카이브 쿼리
보관된 데이터에 대해 쿼리를 실행할 수 있습니다.
참고
Atlas Data Federation은 문서 내의 필드 순서를 유지하지 않는 열 형식 저장소를 사용합니다. 따라서 Atlas Data Federation은 보관된 데이터에 대해 필드 순서를 구분하는 쿼리를 지원하지 않습니다.
연결 문자열
쿼리를 실행하려면 먼저 Online Archive에 연결해야 합니다. 클러스터 연결 문자열을 사용하면 Atlas 클러스터의 데이터만 쿼리할 수 있습니다. Online Archive를 쿼리하려면 다음 중 하나를 사용해야 합니다.
Online Archive 및 클러스터에 연결 - 이 읽기 전용 연결 문자열을 사용하면 라이브 클러스터에서 직접 데이터를 읽을 수 있습니다. 이는 IOPS 및 Online Archive에서 사용할 수 있는 리소스에 영향을 줍니다.
Online Archive에 연결 - 이 읽기 전용 연결 문자열을 사용하면 Online Archive의 데이터만 읽을 수 있으며, 클러스터 리소스에 영향을 주지 않습니다.
성능 고려 사항
일반적으로 보관된 데이터에 대한 쿼리는 Atlas 클러스터의 데이터에 대한 쿼리보다 훨씬 느립니다. 연합 연결 문자열을 통해 클러스터 및 Online Archive의 데이터를 쿼리하는 경우:
결과를 반환하기 전에 정렬 작업에 입력된 모든 문서를 소비하고 처리하는 정렬과 같은 차단 쿼리는 가장 느린 저장소인 아카이브가 쿼리되는 것과 관련된 성능 특성을 가지고 있습니다. 정렬 작업을 수행하려면 결과를 반환하기 전에 쿼리되는 소스의 모든 데이터가 필요합니다.
찾기와 같은 스트리밍 쿼리는 최고 성능의 스토리지인 Atlas 클러스터와 관련된 성능 특성을 가지고 있습니다. Atlas는 결과가 제공되는 즉시 반환합니다. 즉, 아카이브에서 결과를 반환하는 것은 Atlas 클러스터에서 결과를 반환하는 것보다 시간이 더 오래 걸립니다.
가격 쿼리
연합 및 아카이브 전용 쿼리의 경우 다음 항목에 대한 비용이 발생합니다.
데이터 스캔
데이터 스캔 중에 Atlas는 클러스터와 아카이브 모두에서 데이터를 처리합니다. Atlas는 스캔해야 하는 데이터의 양을 최소화하기 위해 클러스터에서 가능한 한 많은 쿼리를 실행합니다. 예를 들어, 특정 값을 지정하는 match 쿼리의 경우 Atlas는 클러스터에서 지정된 값을 가진 문서만 조회합니다. 그런 다음 Atlas는 조회된 문서를 보관된 데이터와 결합하여 반환합니다.
기본 클러스터에 저장된 모든 데이터에 액세스해야 하는 차단 쿼리의 경우 Atlas는 모든 데이터를 검색합니다. 예를 들어 sort(match 없음)의 경우 Atlas는 및 클러스터아카이브에서 모든 데이터를 검색하여 정렬합니다.
데이터 액세스
MongoDB는 아카이브에서 쿼리하는 각 파티션에 대해 요금을 부과합니다. 쿼리에 특정 파티션을 쿼리해야 하는 경우, MongoDB는 파티션을 다운로드하고 다운로드된 각 파티션은 단일 액세스에 해당합니다.
데이터 검색
쿼리 및 쿼리 필드를 기반으로 파티션을 찾기 위해 Atlas는 아카이브에서 작업을 실행합니다. Atlas는 이러한 작업을 실행할 때마다 최대 1,000개의 파티션을 찾습니다. Atlas는 쿼리를 충족하는 데 필요한 파티션을 찾기 위해 필요한 최소한의 연산을 실행합니다. 예를 들어 쿼리에 쿼리 필드에 포함된 100개의 파티션이 필요하면 Atlas는 쿼리를 충족하는 연산을 하나만 실행합니다.
데이터 전송
연합 인프라로 전송되는 데이터에는 데이터 전송 비용이 발생합니다.
온라인 아카이브 삭제
Atlas CLI, Atlas UI 및 API 를 통해 온라인 아카이브를 삭제 수 있습니다. 온라인 아카이브를 제거 하면 Atlas 는 5일 후에 온라인 아카이브 저장 에 있는 모든 파일과 메타데이터 를 삭제합니다. 이 데이터를 삭제 한 후에는 복원 할 수 없습니다.
온라인 아카이브용으로 구성된 데이터베이스 또는 컬렉션을 제거하는 경우, 보관된 컬렉션의 데이터는 클라우드 객체 저장소에서 계속 사용할 수 있습니다. 클라우드 객체 저장소에 저장하는 데는 비용이 발생합니다. 또는 클러스터를 삭제하면 Atlas에서 클러스터에 대해 구성된 모든 온라인 아카이브를 삭제합니다. 그러면 클라우드 객체 스토리지에서 보관된 데이터도 모두 삭제됩니다.
온라인 아카이브를 모두 삭제하면 연합 데이터베이스 인스턴스도 삭제되며 온라인 아카이브를 다시 생성할 때 연합 데이터베이스 인스턴스가 새로 생성됩니다.
온라인 아카이브를 삭제하면 해당 상태가 Deleted으로 변경됩니다. 동일한 데이터베이스, 컬렉션, 필드에 다른 온라인 아카이브가 없는 경우 삭제된 온라인 아카이브와 동일한 데이터베이스, 컬렉션, 필드에 대해 Active 상태의 다른 온라인 아카이브를 만들 수 있습니다.
Atlas CLI를 통한 온라인 아카이브 삭제
Atlas CLI를 사용하여 클러스터의 온라인 아카이브를 삭제하려면 다음 명령을 실행하세요.
atlas clusters onlineArchives delete <archiveId> [options]
명령 구문 및 매개변수에 관한 자세한 사항은 Atlas CLI 문서에서 Atlas 클러스터 온라인 아카이브 삭제를 참조하세요.
UI에서 온라인 아카이브 삭제
온라인 아카이브를 삭제하려면 Atlas UI에서 다음을 수행하세요.
AtlasGo Atlas 에서 프로젝트 의 Clusters 페이지로 고 (Go) 합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.
Clusters(클러스터) 페이지가 표시됩니다.
온라인 아카이브의 Actions 열에서 줄임표(...)를 클릭하면 허용된 작업의 목록이 표시됩니다. 다음을 수행할 수 있습니다.
Pause Archiving (상태가 Active인 경우에만)
Edit Archive
Delete Archive
Resume Archiving (상태가 Paused인 경우에만)
API를 통해 온라인 아카이브 삭제
를 통해 Atlas Online Archive를 삭제하려면 API DELETE ID 삭제할 Atlas Online Archive의 고유 를 사용하여 onlineArchives 엔드포인트에 요청을 보냅니다. 구문 및 옵션에 대해 자세히 알아보려면 API를 참조하세요.