데이터 무결성 안내

이 문서는 다음 질문에 답합니다: 백업 안에 실제로 무엇이 들어 있는지, 그것을 신뢰할 수 있는지, 그리고 어떤 경우에 완전하지 않게 되는지.

요약

• 모든 백업은 전체 백업입니다.
• 백업에는 페이지, 데이터베이스와 데이터 소스, 데이터베이스 뷰, 데이터베이스 행, 블록, 댓글(켜고 끌 수 있음), 사용자, 파일 첨부, 그리고 외부 미디어 파일(켜고 끌 수 있음)이 포함됩니다.
• 같은 내용은 한 번만 저장합니다. 실제 데이터와 개별 파일 모두 중복을 제거해 저장하며, 어떤 버전을 삭제해도 다른 버전이 아직 참조하는 파일은 깨지지 않습니다.
• 백업마다 전체 백업 보고서가 나오며, 페이지, 데이터베이스, 데이터베이스 행, 블록, 댓글, 뷰, 사용자의 각각의 개수와 경고 또는 오류 정보가 담깁니다.
• 아카이브의 내보내기와 가져오기에는 모두 무결성 검증이 붙습니다.
• 무결성에는 경계가 있습니다. 통합 권한 밖의 내용, Notion API가 반환하지 않는 필드, Notion 쪽의 몇 가지 알려진 문제, 그리고 무료 버전의 작업 1회당 객체 수 상한입니다.

1. 백업에 포함되는 것

백업 1회에는 다음이 포함됩니다:

• 페이지: 본문, 속성, 아이콘, 커버, 계층 관계
• 데이터베이스와 데이터 소스: 속성 구조, 옵션, 관계
• 데이터베이스 뷰: 표, 보드, 캘린더, 타임라인, 갤러리, 목록 등 각 뷰의 설정과 필터·정렬·그룹 조건
• 데이터베이스 행: 각 행의 속성 값
• 블록(본문 내용): 인라인 서식과 중첩 구조
• 댓글: 파일이나 블록에 달린 미해결 댓글. 해결된 댓글은 Notion API가 반환하지 않으므로 백업할 수 없습니다. 댓글 백업 여부는 켜고 끌 수 있습니다
• 사용자: 콘텐츠에 나타나는 협업자 정보로, "누가 썼는지"를 복원하는 데 사용합니다
• 첨부 파일: Notion이 호스팅하는 이미지와 파일
• 외부 미디어 파일: 페이지에 연결된 외부 파일(예: PDF, 이미지, 동영상). 이 파일을 내려받을지 여부는 켜고 끌 수 있습니다

기기에 내려받은 파일은 모두 리포지토리 안의 상대 참조로 갱신되므로, 리포지토리 디렉터리를 옮기거나 기기를 바꿔도 참조가 끊기지 않습니다.

이 내용은 사용자가 지정한 리포지토리 디렉터리에 저장됩니다. 구조화된 스냅숏은 리포지토리 안의 로컬 데이터베이스 파일에, 내려받은 파일은 리포지토리의 attachments 디렉터리에 있습니다.

2. 무결성은 어떻게 보장되는가

전체 수집. 백업마다 통합에 공유한 범위 전체를 빠짐없이 순회하며, 각 객체의 현재 상태를 하나씩 다시 확인합니다. Notion API는 신뢰할 수 있는 변경 스트림을 제공하지 않으므로, 완전성을 보장하는 증분 백업은 원리상 만들 수 없습니다.

쓰기 단계에서의 건너뛰기. 전체 수집은 전체 재작성이 아닙니다. 내용이 바뀌지 않은 스냅숏은 다시 쓸 필요가 없고, 같은 내용도 중복 저장하지 않습니다. 보고서의 "변경 / 건너뜀" 개수가 바로 이 차이를 나타냅니다.

충돌 안전성. 백업 도중 전원이 끊기거나 프로그램이 비정상 종료되어도 작업을 안전하게 다시 시작할 수 있으며, 기존 데이터의 무결성을 깨뜨리지 않습니다.

콘텐츠 주소 기반 중복 제거. 블록 내용은 내용의 해시 값으로 저장하고 참조 수를 셉니다.

개별 파일 중복 제거. 첨부 파일은 안정적인 파일 식별자로 중복을 제거합니다.

백업 보고서. 백업이 끝나면 통계를 제공합니다. 페이지, 데이터베이스, 데이터베이스 행, 블록, 댓글, 뷰, 사용자의 각각의 수량과, 변경과 건너뜀, 실패와 경고입니다.

아카이브 내보내기와 가져오기. 전체 리포지토리 아카이브(콜드 백업용 단일 파일 내보내기)는 내보내기 전에 리포지토리 데이터베이스에 대한 쓰기를 디스크에 확정해, 아카이브가 완전하고 일관된 상태가 되도록 합니다. 가져올 때는 먼저 아카이브 안의 데이터베이스에 대한 무결성 검증을 수행하고, 검증에 실패하면 오류를 내고 가져오기를 거부합니다.

3. 무결성의 경계

백업 범위 제한. NotionManager는 더 세밀한 제어를 제공하므로 무엇을 백업할지 선택할 수 있습니다. 통합에 공유하지 않았거나 백업 범위에 선택하지 않은 내용은 순회 대상에 들어가지 않습니다.

Notion API의 알려진 제한:

• 지원되지 않는 블록 유형. Notion API 문서는 일부 블록 유형을 지원하지 않는다고 명시하고 있으며, 그런 블록의 데이터는 Notion API에 의존하는 모든 앱에서 사용할 수 없습니다.
• 뷰 스타일과 표시 가능한 속성 등: 이는 로컬 탐색의 표시 방식에만 영향을 줍니다.

Notion 쪽 관리 정보. Notion 쪽의 버전 기록(페이지 기록), 휴지통 데이터 등은 Notion API가 제공하는 기능의 범위 밖이므로 백업 범위에도 들어가지 않습니다.

4. 라이선스 제한

NotionManager는 무료로 사용할 수 있지만 기능에 제한이 있습니다. 데이터 무결성과 관련된 제한은 다음과 같습니다.

• 무료 버전: 백업 작업 1회당 객체 수 상한, 뷰 탐색 상한(뷰 하나만 볼 수 있음). 객체 수 상한은 작업마다 계산되므로, 프로필을 여러 개 만들어 큰 워크스페이스를 여러 번의 백업으로 나눌 수 있습니다. 각 작업의 한도 안에서는 데이터가 완전하게 백업됩니다. 무료 버전도 다른 사람이 내보낸 백업을 가져올 수 있으며, 가져온 뒤에는 읽기 전용으로 탐색합니다. 객체 수 상한은 사용자가 실행하는 백업에 적용되고, 가져온 백업에 이미 들어 있는 내용에는 적용되지 않습니다.
• 개인 라이선스(Basic 및 Premium): 전체 리포지토리를 하나의 아카이브로 내보내는 것은 지원하지 않습니다.
• 팀 및 기업 라이선스: 전체 리포지토리를 하나의 아카이브로 내보낼 수 있고, 그런 아카이브를 다시 가져올 수도 있습니다.

그 밖의 기능은 특정 라이선스에 묶여 있으며 데이터 무결성과는 관계가 없으므로 여기서 다루지 않습니다.

5. 사용자에게 부탁드리는 부분

• 3-2-1로 사본 보관: 리포지토리 디렉터리 전체를 다른 매체(외장 하드, NAS, 오브젝트 스토리지)로 복사하면 되며, 이 단계는 라이선스와 무관합니다. 로컬 백업도 디스크 고장, 디렉터리 실수 삭제, 랜섬웨어로 사라집니다. "다른 장소에 있거나 오프라인인 사본"은 바로 그런 상황을 위한 것입니다. 팀 및 기업 라이선스는 전체 리포지토리 아카이브(단일 파일 패키지)를 보관 및 기기 이전 형식으로 내보낼 수 있고, 무료 버전도 다른 사람이 내보낸 백업을 가져와 읽기 전용으로 볼 수 있습니다.
• 백업 보고서를 확인하십시오. 각 객체 유형의 수량이 워크스페이스 규모와 맞는지 확인하고, 수치가 이상하면 원인을 먼저 밝힌 뒤에 이 백업에 의존하십시오.
• 디스크 상태를 살피십시오. 백업 리포지토리가 있는 디스크의 불량 섹터는 백업을 직접 손상시킵니다. 리포지토리는 신뢰할 수 있는 저장소에 두고, 오프라인 사본은 다른 매체에 두십시오.