The way attachments are stored changed significantly in Confluence 3.0.  If you are upgrading from Confluence 2.10 or earlier see Upgrading Confluence for recommended upgrade paths, and read the version of the Hierarchical File System Attachment Storage page in our Confluence 3.0 documentation which provides more detail about migrating to the new file system structure.

Confluence stores attachments, such as files and images, in a file system.  Confluence's attachment storage layout is designed to:

  1. ディレクトリ構造の任意のレベルでエントリ数を制限できること (一部のファイル システムではディレクトリに格納できるファイル数に制限があるため)。
  2. スペースごとに添付ファイルを区分し、システム管理者が特定のスペースから添付ファイルを選択的にバックアップできるようにすること。

Attachments in Confluence have a number of identifying attributes: content id of the file itself, the space id and content id of the page the file is attached to. This means the file logically belongs to a piece of content which logically belongs in a space (not all content belongs to a space). For files within a space in Confluence, the directory structure is typically 8 levels, with the name of each directory level based on the following algorithm:

レベル

由来

1 (最上位)

常に "ver003" で、Confluence バージョン 3 ストレージ フォーマットであることを示す

2

スペース ID の最下位 3 桁を 250 で剰余演算した結果

3

スペース ID の次の下位 3 桁を 250 で剰余演算した結果

4

完全なスペース ID

5

ファイルが添付されたページのコンテンツ ID の最下位 3 桁を 250 で剰余演算した結果

6

ファイルが添付されたページのコンテンツ ID の次の下位 3 桁を 250 で剰余演算した結果

7

The full content id of the page the file is attached to

8

添付ファイルの完全なコンテンツ ID

8 番目のレベル内に、その添付ファイルの各バージョンに対応するファイルが存在し、バージョン番号、たとえば 1 と一致する名前がつけられています。

例:

 

特定のスペースの添付ファイルが保存されているディレクトリを検索するには、<confluence url>/admin/findspaceattachments.jsp にアクセスして、スペース キーを入力します。そのスペースの添付ファイルが保存されているファイル システム上のディレクトリが返されます。

上図のファイル D はすこし異なる構造で保存されています。概念的にはスペース内に存在しないファイルの場合、レベル 2 から 4 のディレクトリが "nonspaced" と呼ばれる単一のディレクトリで置き換えられます。このようなファイルの例としては、グローバルのサイト ロゴや未保存のコンテンツの添付ファイルなどがあります。