클라우드 백업 스냅샷 내보내기

참고

이 기능은 M0 무료 클러스터 및 Flex 클러스터에서는 사용할 수 없습니다. 사용할 수 없는 기능에 대한 자세한 내용은 Atlas M0(무료 클러스터) 제한을 참조하세요.

Atlas 사용하면 클라우드 백업 스냅샷을 객체 저장 서비스로 내보낼 수 있습니다.

자동화된 백업 정책 및 일정을 관리하는 방법을 알아보려면 백업 정책 관리를 참조하세요.

지원되는 스토리지 서비스

Atlas 현재 다음과 같은 객체 저장 서비스를 지원합니다.

AWS S3 버킷
Azure Blob 저장
Google Cloud Storage 버킷

또한 Atlas PrivateLink를 사용하여 AWS S3 버킷으로 스냅샷을 내보내는 기능을 지원합니다.

Atlas가 스냅샷을 내보내는 방법

참고

백업을 Amazon Web Services S3로 내보내는 경우 Amazon Web Services S3 객체 잠금 을 활성화하여 컴플라이언스 및 보안에 필요한 백업 파일의 불변성을 보장할 수 있습니다. 객체 잠금은 내보낸 백업 파일의 삭제 및 수정을 방지합니다.

내보내기 정책을 설정하여 개별 스냅샷을 수동으로 내보내거나 스냅샷을 자동으로 내보낼 수 있습니다. 자동 내보내기의 경우 내보내기 정책에 빈도를 지정해야 합니다.

매일
매주
월간
연간

Atlas는 내보내기 빈도와 일치하는 빈도 유형으로 모든 백업 스냅샷을 자동으로 내보냅니다. 내보낸 결과는 해당 스냅샷의 전체 백업이 됩니다.

예시

다음 사항을 고려하세요:

주별 및 월별 스냅샷 일정을 설정하는 백업 정책
월별 내보내기 빈도를 설정하는 내보내기 정책

주간 및 월간 스냅샷이 월말 같은 날에 이루어진다고 가정해 보겠습니다. 스냅샷이 총 4 개 있고 이 중 3 개는 주간 스냅샷이며, 네 번째 스냅샷은 Atlas에서 주간 스냅샷으로 처리되지만 같은 날에 발생했기 때문에 월간 스냅샷이기도 합니다. 내보내기 빈도가 해당 스냅샷의 스냅샷 빈도와 일치하기 때문에 Atlas는 월별 스냅샷만 내보냅니다. 주간 스냅샷도 내보내려면 주간 스냅샷도 내보내도록 내보내기 정책을 업데이트하세요. 내보내기 빈도를 매주로 설정하면 Atlas는 스냅샷 4 개를 모두 내보냅니다.

내보내기가 진행되는 동안 객체 저장 서비스에 부분적인 결과가 표시될 수 있습니다.

Atlas TTL(Time to Live) 설정과 관계없이 스냅샷에 문서를 유지합니다. TTL(Time to Live) 기한이 지난 스냅샷 에서 이러한 문서 액세스 할 수 있습니다.

스냅샷 내보내기 요금에 대해 학습하려면 스냅샷 내보내기 비용를 참조하세요.

Atlas가 업로드하는 파일

Atlas는 다음과 같은 경우 빈 파일을 /exported_snapshots/.permissioncheck 에 업로드합니다.

내보낼 새 객체 저장 추가
내보내기 시작

내보내기가 완료되면 Atlas는 이름이 .complete 인 메타데이터 파일과 metadata.json 인 메타데이터 파일을 각 컬렉션에 대해 업로드합니다.

Atlas 객체 저장 의 다음 경로에 .complete 이라는 메타데이터 파일 업로드합니다.

/exported_snapshots/<orgUUID>/<projectUUID>/<clusterName>/<initiationDateOfSnapshot>/<timestamp>/

참고

기본적으로 Atlas는 메타데이터 파일 경로에 조직 및 프로젝트 UUID를 사용합니다. UUID 대신 조직 및 프로젝트 이름을 사용하려면 API를 통해 useOrgAndGroupNamesInExportPrefix 플래그를 true로 설정합니다. Atlas는 모든 공백을 밑줄(_)로 바꾸고 경로의 조직 및 프로젝트 이름에서 특수 처리가 필요할 수 있는 모든 문자와 피해야 할 문자를 제거합니다.

.complete 메타데이터 파일은 JSON 형식이며 다음 필드를 포함합니다.

필드	설명
`orgId`	Atlas 조직을 식별하는 고유한 24자리 16진수 문자열.
`orgName`	Atlas 조직의 이름.
`groupId`	Atlas 조직의 프로젝트를 식별하는 고유한 24자리 16진수 문자열.
`groupName`	Atlas 프로젝트의 이름.
`clusterUniqueId`	Atlas 클러스터를 식별하는 고유한 24자리 16진수 문자열.
`clusterName`	Atlas 프로젝트의 이름.
`snapshotInitiationDate`	스냅샷을 찍은 날짜입니다.
`totalFiles`	객체 저장 에 업로드된 파일의 총 개수입니다.
`labels`	스냅샷을 내보낸 클러스터의 레이블.
`customData`	사용자 지정 데이터(해당되는 경우)를 만들 때 지정한 내보내기 작업.

예시

{
  "orgId": "60512d6f65e4047fe0842095",
  "orgName": "org1",
  "groupId": "60512dac65e4047fe084220f",
  "groupName": "group1",
  "clusterUniqueId": "60512dac65e4047fe0842212",
  "clusterName": "cluster0",
  "snapshotInitiationDate": "2020-04-03T05:50:29.321Z"
  "totalFiles": 23,
  "labels": [
    {
      "key": "key1",
      "value": "xyz"
    },
    {
      "key": "key2",
      "value": "xyzuio"
    }
  ],
  "customData": [
    {
      "key": "key1",
      "value": "xyz"
    },
    {
      "key": "key2",
      "value": "xyzuio"
    }
  ]
}

Atlas 객체 저장 의 다음 경로에 각 컬렉션 에 대한 metadata.json 파일 업로드합니다.

/exported_snapshots/<orgUUID>/<projectUUID>/<clusterName>/<initiationDateOfSnapshot>/<timestamp>/<dbName>/<collectionName>/metadata.json

참고

기본적으로 Atlas는 메타데이터 파일 경로에 조직 및 프로젝트 UUID를 사용합니다. UUID 대신 조직 및 프로젝트 이름을 사용하려면 API를 통해 useOrgAndGroupNamesInExportPrefix 플래그를 true로 설정합니다. Atlas는 모든 공백을 밑줄(_)로 바꾸고 경로의 조직 및 프로젝트 이름에서 특수 처리가 필요할 수 있는 모든 문자 와 피해야 할 문자를 제거합니다.

메타데이터 파일은 JSON 형식이며 다음 필드를 포함합니다.

필드	설명
`collectionName`	컬렉션을 식별하는 사람이 읽을 수 있는 레이블입니다.
`indexes`	db.collection.getIndexes 명령에서 반환된 형식으로 컬렉션의 모든 인덱스를 나열합니다.
`options`	컬렉션에 정의된 구성 옵션입니다. 옵션에 대한 자세한 내용은 db.createCollection() 명령을 참조하세요.
`type`	(선택 사항) 컬렉션 유형입니다. 이 필드 값이 `timeseries`인 time series 컬렉션에만 지원됩니다. 표준 컬렉션의 경우 이 필드 설정하지 않은 상태로 둡니다. Atlas `view` 유형 컬렉션 내보내기를 지원 하지 않습니다.
`uuid`	컬렉션의 UUID입니다. UUID에 대해 자세히 알아보려면 UUID를 참조하세요.

예시

{
  "options":{
    "viewOn":"othercol",
    "pipeline":[{"$project":{"namez":"$name"}}]
  },
  "indexes":[],
  "collectionName":"viewcol",
  "type":"view"
}

{
  "options":{
    "timeseries":{
      "timeField":"timestamp",
      "granularity":"seconds",
      "bucketMaxSpanSeconds":{"$numberInt":"3600"}
    }
  },
  "indexes":[],
  "collectionName":"timeseriescol",
  "type":"timeseries"
}

{
  "indexes": [
    {
      "v":{"$numberInt":"2"},
      "key":{
        "_id":{"$numberInt":"1"}
      },
      "name":"_id_"
    }
  ],
  "uuid":"342c40a937c34c478bab03de8ce44f3e",
  "collectionName":"somecol"
}

내보내기 작업이 실패한 경우:

Atlas는 자동으로 내보내기를 다시 시도하지 않습니다.
Atlas 객체 저장 에서 부분 데이터를 제거 하지 않습니다.

내보낸 데이터 형식

Atlas gzip-압축 확장 JSON2(v) 문서를 업로드합니다. Atlas 이러한 문서를 순서대로 업로드하지 않습니다. 다음은 객체 저장 에있는 파일의 경로입니다.

/exported_snapshots/<orgName>/<projectName>/<clusterName>/<initiationDateOfSnapshot>/<timestamp>/<dbName>/<collectionName>/<shardName>.<increment>.json.gz

구제척으로:

`<orgName>`	Atlas 조직의 이름
`<projectName>`	Atlas 프로젝트의 이름
`<clusterName>`	Atlas 클러스터의 이름
`<initiationDateOfSnapshot>`	스냅샷을 찍은 날짜입니다.
`<timestamp>`	내보내기 작업이 생성된 타임스탬프입니다.
`<dbName>`	Atlas 클러스터에 있는 데이터베이스의 이름
`<collectionName>`	Atlas 컬렉션의 이름
`<shardName>`	복제본 세트 의 이름입니다. 샤딩된 컬렉션의 경우 프라이머리 샤드 의 이름입니다.
`<increment>`	청크가 업로드될 때 증가하는 수. `0`에 시작합니다.

제한 사항

다음 조치는 수행할 수 없습니다.

대체 스냅샷을 내보냅니다.
스냅샷 하나 이상의 활성 내보내기가 있어야 합니다.
컬렉션을 제외하고 뷰 컬렉션 또는 시스템 <database>.system.js 컬렉션을 내보냅니다.
IP 제한 미사용 데이터 암호화가 활성화된 Atlas 프로젝트 의 클러스터에서 스냅샷을 내보냅니다.
비공개 엔드포인트용으로 구성된 프로젝트에서 Azure 또는 Google Cloud 저장에 호스팅된 클러스터의 스냅샷을 내보냅니다. 비공개 엔드포인트

필요한 액세스 권한

클라우드 백업 스냅샷을 관리하려면, 프로젝트에 대해 Project Backup Manager 또는 Project Owner 액세스 권한이 있어야 합니다.

Organization Owner 액세스 권한이 있는 사용자는 프로젝트에 자신을 Project Backup Manager 또는 Project Owner로 추가해야 클라우드 백업 스냅샷을 관리할 수 있습니다.

내보내기 관리

클라우드 제공자

연결 유형

인터페이스

돌아가기

미사용 데이터 암호화를 사용하여 복원

소스 복원