データ完全性について

この文書は次の問いに答えます：あなたのバックアップには実際に何が入っているのか、それは信頼できるのか、そしてどのような場合に完全でなくなるのか。

概要

バックアップは毎回、全量バックアップです。
バックアップには、ページ、データベースとデータソース、データベースビュー、データベースの行、ブロック、コメント（スイッチで制御できます）、ユーザー、添付ファイル、および外部メディアファイル（スイッチで制御できます）が含まれます。
同じ内容は一つだけ保存します。実データも独立したファイルも重複を除いて保存し、あるバージョンを削除しても、ほかのバージョンがまだ参照しているファイルは壊れません。
バックアップのたびに完全なバックアップレポートが出ます。ページ、データベース、データベースの行、ブロック、コメント、ビュー、ユーザーのそれぞれの件数と、警告またはエラーの情報が含まれます。
アーカイブのエクスポートとインポートには、どちらも完全性の検証が付きます。
完全性には境界があります。インテグレーションの権限の外にある内容、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 回のバックアップタスクにおけるオブジェクト数の上限、およびビュー閲覧の上限（表示できるビューは 1 つだけ）。オブジェクト数の上限はタスクごとに数えるため、複数のプロファイルを作って大きなワークスペースを複数回のバックアップに分けられます。各タスクの制限の範囲内では、データは完全にバックアップされます。
個人ライセンス（Basic と Premium）：リポジトリ全体のアーカイブのエクスポートとインポートに対応しません。

ほかの機能は特定のライセンスに紐づくもので、データの完全性には関わりません。ここでは扱いません。

5. お願いしたいこと

3-2-1 で副本を残す：リポジトリのディレクトリ全体を別の媒体（外付けドライブ、NAS、オブジェクトストレージ）にコピーするだけで、この手順はライセンスとは関係ありません。ローカルのバックアップも、ディスクの故障、ディレクトリの誤削除、ランサムウェアによって失われます。「別の場所かオフラインにある 1 つ」は、まさにそのための副本です。チームと企業の利用者は、リポジトリ全体のアーカイブ（単一ファイルのパッケージ）を保管と移行の形式として使えます。
バックアップレポートを確認する：各オブジェクトの数がワークスペースの規模と合っているかを確かめてください。数がおかしいときは、原因を先に突き止めてから、このバックアップに頼ってください。
ディスクの健康状態に注意する：リポジトリのあるディスクの不良セクタはバックアップを直接壊します。リポジトリは信頼できるストレージに置き、オフラインの副本は別の媒体に置いてください。