合并请求差异存储

合并请求差异（diffs）是与合并请求相关联的差异的有大小限制的副本。在查看合并请求时，会尽可能从这些副本获取差异，以优化性能。

默认情况下，极狐GitLab 将合并请求差异存储在数据库中，表名为 merge_request_diff_files。较大规模的安装可能会发现该表变得过大，此时应切换到外部存储。

合并请求差异可以存储于：

• 完全在磁盘上。
• 完全在对象存储上。
• 当前差异在数据库中，过时差异在对象存储中。

使用外部存储#

使用对象存储#

不应将外部差异存储在磁盘上，而应使用类似 AWS S3 的对象存储。此配置依赖于有效且已预配置的 AWS 凭证。

要配置外部差异的对象存储：

重新配置或重启极狐GitLab 后，现有合并请求差异即迁移至外部存储。

有关更多信息，请参阅对象存储。

替代的数据库内存储#

启用外部差异可能会降低合并请求的性能，因为必须通过单独的操作来检索它们与其他数据。一个折衷方案是仅将过时的差异存储在外部，而将当前差异保留在数据库中。

要启用此功能，请执行以下步骤：

启用此功能后，差异最初会存储在数据库中，而非外部。当满足以下任一条件时，它们会被移至外部存储：

• 存在更新版本的合并请求差异
• 合并请求在七天前被合并
• 合并请求在七天前被关闭

这些规则通过在数据库中仅存储经常访问的差异来平衡空间和性能。不太可能被访问的差异将被移至外部存储。

从外部存储切换到对象存储#

自动迁移会移动数据库中存储的差异，但不会在存储类型之间移动差异。要从外部存储切换到对象存储：

1. 手动将本地或 NFS 存储上的文件移动到对象存储。

2. 运行此 Rake 任务以更改其在数据库中的位置。

   对于 Linux 安装包：

   shell
   sudo gitlab-rake gitlab:external_diffs:force_object_storage

   对于自行编译安装：

   shell
   sudo -u git -H bundle exec rake gitlab:external_diffs:force_object_storage RAILS_ENV=production

   默认情况下，sudo 不会保留现有环境变量。你应该将它们追加，而不是前置，像这样：

   shell
   sudo gitlab-rake gitlab:external_diffs:force_object_storage START_ID=59946109 END_ID=59946109 UPDATE_DELAY=5

这些环境变量会修改 Rake 任务的行为：

• START_ID 和 END_ID 可用于并行运行更新，通过将不同进程分配给表的不同部分来实现。
• BATCH 和 UPDATE_DELAY 允许在迁移速度与并发访问表之间进行权衡。
• 如果您的终端不支持 ANSI 转义码，应将 ANSI 设置为 false。

要检查外部差异在对象存储和本地存储之间的分布，请使用以下 SQL 查询：

shell
1gitlabhq_production=# SELECT count(*) AS total,
2  SUM(CASE
3    WHEN external_diff_store = '1' THEN 1
4    ELSE 0
5  END) AS filesystem,
6  SUM(CASE
7    WHEN external_diff_store = '2' THEN 1
8    ELSE 0
9  END) AS objectstg
10FROM merge_request_diffs;