本文档提供了 Confluence 的数据结构视图（schema ）和数据模型概念上的的概述。 备注： Hibernate 的映射文件是针对 Confluence 数据模型的直接描述。在系统中的 Confluence 主 JRA 中你可以找到 *.hbm.xml 文件，JRA 位于（）<CONFLUENCE-INSTALLATION>\confluence\WEB-INF\lib\confluence-5.1.1.jar）。 数据库的表，列和其他的属性可能随着 Confluence 的主要发行版本的变化而有所变化。希望找到你 Confluence 站点的数据库定义语言（DDL），请在 Confluence 安装后运行查询。 https://www.cwiki.us/display/CONFLUENCEWIKI/Confluence+Data+Model
当基于文本的文件上传到 Confluence（例如，Word，PowerPoint 等），这些文件中的文本是可以提取并且添加到索引中的，用户可以通过索引来搜索这些文件中的文本内容，不仅仅是搜索文件名。当文件需要被重新索引的时候，我们存储提取后的文本，我们不需要对文本中的内容重新进行索引。 提取后的文本文件，通常是以版本号进行命名的，例如 2.extracted_text, 同时还会存储文件自己的版本（如上面第八级目录中描述的）。我们只保存提取后文件的最新的版本，而不是和文件一样同时还保存了早期的版本。 https://www.cwiki.us/display/CONF6ZH/Hierarchical+File+System+Attachment+Storage
从 Confluence 3.0 开始，附件的存储方式有了重大的改变和升级。如果你是从 Confluence 2.10 及其早期版本升级上来的，请参考 Upgrading Confluence 页面中推荐的升级路径，同时请阅读 Confluence 3.0 文档中 Hierarchical File System Attachment Storage 页面来获得新系统文件存储结构的相关信息。 Confluence 存储附件，例如文件和图片在文件系统中。Confluence 的附件存储布局设计基于以下的考虑： 限制任何单一目录级别结构中的文件数量（在一些文件系统中，可能有限制每一个目录中可以存储的文件数量）。 针对空间对附件进行分区，这样能够让系统管理对空间进行备份的时候能够针对特定的空间备份附件。 Confluence 的附件有一个数字用来定义属性：文件自己的内容 id 和 文件所在页面中的内容 id 。这个意思是文件在逻辑上是属于内容的，通常内容又是属于空间（不是所有的内容都属于空间）。Confluence 中的空间文件，目录结构通常有 8 个级别，每一个目录级别的名字通常基于下面的算法。 1 (top) 总是为 'ver003' 这个定义为 Confluence 版本 3 的文件存储格式 2 最小的 3 个数字，这个数字为 空间 id 取模 250 3 下一个最小的 3 个数字，这个数字为 空间 id 取模 250 4 完整的 空间 id 5 附件所附加在页面的 ID 取模 250 后的最小 3 个数字 6 附件所附加在页面的 ID 取模 250 后的下一个最小 3 个数字 7 附件所在页面的完整的 content id 8 附件所在完整的 content id 9 这个是文件，这个文件是按照版本号进行命名的，例如：1, 2, 6。 modulo 计算被用来计算整除后的余数，例如 800 modulo 250 = 50. 例如： 希望找到一个特定空间中所有附件存储的目录，进入 <confluence url>/admin/findspaceattachments.jsp 然后输入空间的 Key，这个将会返回这个空间所存储文件系统中的目录附件。 上面图中文件 D 存储的的位置与其他的文件结构不同。这个文件没有空间级别（ 2 到 4 级别），这个文件目录被称为 'nonspaced'。这个地方通常存储的文件为全局站点的标志（logo）和没有保存的内容。 https://www.cwiki.us/display/CONF6ZH/Hierarchical+File+System+Attachment+Storage
当一个文件被上传到 Confluence 后，Confluence 将会尝试对文件进行解压，然后对文件中的内容进行索引。这样系统就能够允许用户对文件中的内容进行搜索，而不仅仅是搜索文件名。这个过程对系统的内存要求比较高，如果你上传的附件比较大的时候还会导致内存溢出。Confluence 有下面的一些配置被用来避免出现内存溢出的错误： 如果你上传的文件大小大于 100 MB，Confluence 将不会尝试对文件进行解压和内容进行索引。你只能在 Confluence 中对文件名进行查找。 如果你上传的文件为下面的一些文件类型，Confluence 仅仅对不超过大小的文件类型进行解压： 1 MB Excel 的文本（.xlsx） 8 MB PDF 的文本（.pdf） 10 MB Text 文件的文本（包括 .txt, .xml, .html, .rtf 等） 16 MB Word 的文本（.docx） 当从上面的文件类型中解压出来的文件超过 1MB，那这个内容就是可以在系统中进行查找，但是 Confluence 将不会在快速查找中显示结果。 如果 Confluence 停止解压文本，那么这个文本文件中只有部分内容可以进行查找。 Confluence 只会对文件进行解压和索引一次，如果在这个过程中失败了，Confluence 不会再出尝试进行解压和索引。 一些变量是可以通过 system properties 的参数进行配置的。如果你在附近进行索引的过程中遇到内存错误，你可能希望对系统进行调整，调整可以使用的参数如下： atlassian.indexing.attachment.maxsize officeconnector.excel.extractor.maxlength officeconnector.textextract.word.docxmaxsize atlassian.indexing.contentbody.maxsize https://www.cwiki.us/display/CONF6ZH/Configuring+Attachment+Size
你可以限制上传到 Confluence 的附件的大小。 配置可以上传到 Confluence 的附件所允许的大小： 进入 > 基本配置（General Configuration）. 选择 编辑（Edit）。 在 最大附件允许大小（Attachment Maximum Size）的边上输入你允许上传的附件最大的大小。 默认的值为 100MB。 选择 保存（Save）。 https://www.cwiki.us/display/CONF6ZH/Configuring+Attachment+Size
如果你现在正在存储附件到 WebDav 或者你的数据库中。你可以整合附件的存储到文件系统中。当你的附件从数据库中被合并到文件系统后，你存储在数据库中的附件数据就可以从数据库中删除了。 当附件合并进行的时候，所有使用 Confluence 的用户将会被禁止访问 Confluence 实例。这样配置的原因是避免在合并的时候出现数据库错误。当合并完成后，用户就可以继续使用 Confluence 了。 希望让日志在数据库合并的时候能够输出更多的内容，添加 com.atlassian.confluence.pages.persistence.dao 为 DEBUG 级别。请参考 Configuring Logging 页面中的内容。 希望对附件进行合并，请按照下面的步骤进行： 进入 > 基本配置（General Configuration） > 附件存储（Attachment storage）。 单击 编辑（Edit ）来修改配置。 选择 Confluence home 目录中的本地存储（Locally in Confluence home directory）。 单击 保存（Save ）来保存修改。 下面的界面将会出现，询问你确定你的修改。单击 'Migrate' 将会带你进入到修改合并进程显示的界面中。 屏幕截图：合并警告 下面的外部链接提供了有关从数据库中合并附件到本地文件系统中的一些有用的信息，这些信息可能能帮到你，请参考 - https://www.scandio.de/blog/de/2013/05/confluence-attachment-migration-the-safe-way-2. https://www.cwiki.us/display/CONF6ZH/Attachment+Storage+Configuration
在早期的 Confluence 版本中，我们允许存储附件到 WebDav 或者 Confluence 数据库中。针对新的 Confluence 安装，我们不再支持这 2 种存储了。 本地文件系统 在默认的情况下，Confluence 存储附件到 Confluence 配置的 home 目录下的 attachments 目录中。 数据库（已弃用） 在 Confluence 5.4 及其早期的版本，我们给了系统管理员存储附件到数据库中的选项，系统管理员可以在这些版本中配置附件的存储。 存储附件到数据库中可以带来一些好处（例如，可以更加容易的进行备份，避免文件系统中出现的字符集不支持的错误），但是请注意这种存储方式将会大大加大数据库空间的使用，随着时间的推移，你的数据库可能需要更多的存储空间。 WebDav（已弃用） WebDav 在现在的存储中已经不是一个存储选项了，已经完全启用了。 这个对你使用 WebDav 访问 Confluence 的空间，页面或者附件不会产生影响，请参考页面 Configuring a WebDAV client for Confluence 中的具体配置内容。 https://www.cwiki.us/display/CONF6ZH/Attachment+Storage+Configuration
在默认的情况下 Confluence 的附件存储在 home 目录中（例如，在文件系统）。 希望对 Confluence 的附件存储进行配置： 在屏幕的右上角单击 控制台按钮 ，然后选择 General Configuration 链接。 选择 附件存储（Attachment Storage）。 https://www.cwiki.us/display/CONF6ZH/Attachment+Storage+Configuration
如果你遇到了下面的错误信息，例如： ERROR [Importing data task] [confluence.importexport.impl.ReverseDatabinder] endElement net.sf.hibernate.PropertyValueException: not-null property references a null or transient value: com.atlassian.user.impl.hibernate.DefaultHibernateUser.name 这个意思是在表中有一个不因为为 null 的地方的值为 null 了。在上面的例子中，这个在 USERS 表中的 name 列有记录为 null。有时候这个问题也会出现在 ATTACHMENTS 表中。 删除上面为 null 的记录，然后重新进行 xml 导出和导入。 https://www.cwiki.us/display/CONFLUENCEWIKI/Troubleshooting+XML+backups+that+fail+on+restore
如果你遇到了下面的错误信息，例如： could not insert: [bucket.user.propertyset.BucketPropertySetItem#bucket.user.propertyset.BucketPropertySetItem@a70067d3]; SQL []; Violation of PRIMARY KEY constraint 'PK_OS_PROPERTYENTRY314D4EA8'. Cannot insert duplicate key in object 'OS_PROPERTYENTRY'.; nested exception is java.sql.SQLException: Violation of PRIMARY KEY constraint 'PKOS_PROPERTYENTRY_314D4EA8'. Cannot insert duplicate key in object 'OS_PROPERTYENTRY'. 这个错误信息说的是定义为'PK_OS_PROPERTYENTRY_314D4EA8' 的主键在表 'OS_PROPERTYENTRY' 中重复了。 你可以在 'OS_PROPERTYENTRY' 表中找到 'PK_OS_PROPERTYENTRY_314D4EA8' 中定义的主键，然后找到重复的值后删除重复的值。需要确定 "PRIMARY KEY" 必须保持不重复。一个可以找到 'OS_PROPERTYENTRY' 表中是否有重复主键的 SQL 如下： SELECT ENTITY_NAME,ENTITY_ID,ENTITY_KEY,COUNT(*) FROM OS_PROPERTYENTRY GROUP BY ENTITY_NAME,ENTITY_ID,ENTITY_KEY HAVING COUNT(*)>1 https://www.cwiki.us/display/CONFLUENCEWIKI/Troubleshooting+XML+backups+that+fail+on+restore