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