• 启动数据库控制台
• 其他极狐GitLab PostgreSQL 文档
  • 程序
• 支持主题
  • 数据库死锁
  • 临时更改语句超时
  • 观察 (RE)INDEX 进度报告
• 故障排除
  • 数据库不接受命令以避免环绕数据丢失
  • 极狐GitLab 数据库要求
  • production/sidekiq 日志中的序列化错误
  • PostgreSQL 复制槽错误
  • Geo 复制错误
  • 检查 Geo 配置和常见错误
  • pg_dump 和 psql 版本不匹配
  • 扩展 btree_gist 未在允许列表中

PostgreSQL

本页面包含极狐GitLab 支持团队在故障排除时使用的有关 PostgreSQL 的信息。极狐GitLab 公开这些信息，以便任何人都可以利用支持团队收集的知识。

如果您使用的是付费版本并且不确定如何使用这些命令，请联系支持以获取您遇到的任何问题的帮助。

启动数据库控制台

::Tabs

:::TabTitle Linux package (Omnibus)

推荐用于：

• 单节点实例。
• 在 Patroni 节点上扩展或混合环境，通常是领导者。
• 在运行 PostgreSQL 服务的服务器上扩展或混合环境。

sudo gitlab-psql

在单节点实例或 Web 或 Sidekiq 节点上，您也可以使用 Rails 数据库控制台，但初始化时间较长：

sudo gitlab-rails db-console --database main

:::TabTitle Docker

docker exec -it <container-id> gitlab-psql

:::TabTitle Self-compiled (source)

使用 您的 PostgreSQL 安装 中的 psql 命令。

sudo -u git -H psql -d gitlabhq_production

:::TabTitle Helm chart (Kubernetes)

• 如果您运行混合环境，并且 PostgreSQL 运行在 Linux 打包安装 (Omnibus) 上，建议的方法是在这些服务器上本地使用数据库控制台。请参阅有关 Linux 软件包的详细信息。
• 使用您外部第三方 PostgreSQL 服务的一部分控制台。
• 在工具箱 pod 中运行 gitlab-rails db-console。
  • 有关详细信息，请参阅我们的 Kubernetes 备忘单。

::EndTabs

要退出控制台，请键入：quit。

其他极狐GitLab PostgreSQL 文档

本节用于链接到极狐GitLab 文档中其他地方的信息。

程序

• Linux 软件包安装的数据库程序，包括：
  • SSL：启用、禁用和验证。
  • 启用预写日志 (WAL) 归档。
  • 使用外部（非 Omnibus）PostgreSQL 安装；并备份它。
  • 通过 TCP/IP 监听以及或替代套接字。
  • 在其他位置存储数据。
  • 破坏性地重新播种极狐GitLab 数据库。
  • 有关更新打包 PostgreSQL 的指导，包括如何阻止其自动发生。

• 有关外部 PostgreSQL 的信息。

• 使用外部 PostgreSQL 运行 Geo。

• 在为 HA 配置的 PostgreSQL 上运行时的升级。

• 从 CI runners 中使用 PostgreSQL。

• PostgreSQL 扩展
  • 包括 故障排除 gitlab-ctl patroni check-leader 和 PgBouncer 错误。
• 开发者数据库文档，其中一些绝对不适用于生产环境。包括：
  • 理解 EXPLAIN 计划。

支持主题

数据库死锁

参考：

• 如果实例被推送淹没，可能会发生死锁。提供的上下文是关于极狐GitLab 代码如何在不寻常情况下产生这种意想不到的效果。

ERROR: deadlock detected

确定了三个适用的超时；我们推荐的设置如下：

deadlock_timeout = 5s
statement_timeout = 15s
idle_in_transaction_session_timeout = 60s

“如果遇到死锁，并且我们在短时间后通过中止事务来解决它，那么我们已经拥有的重试机制将使死锁的工作重新尝试，并且我们不太可能连续多次死锁。”

在这种情况下，我们从开发中得到的指导是降低 deadlock_timeout 或 statement_timeout，但将第三个设置保留在 60 秒。设置 idle_in_transaction 保护数据库免于会话可能挂起数天。

PostgreSQL 默认值：

• statement_timeout = 0（永不）
• idle_in_transaction_session_timeout = 0（永不）

查看当前设置：

sudo gitlab-rails runner "c = ApplicationRecord.connection ; puts c.execute('SHOW statement_timeout').to_a ;
puts c.execute('SHOW deadlock_timeout').to_a ;
puts c.execute('SHOW idle_in_transaction_session_timeout').to_a ;"

可能需要一些时间来响应。

{"statement_timeout"=>"1min"}
{"deadlock_timeout"=>"0"}
{"idle_in_transaction_session_timeout"=>"1min"}

可以在 /etc/gitlab/gitlab.rb 中更新这些设置：

postgresql['deadlock_timeout'] = '5s'
postgresql['statement_timeout'] = '15s'
postgresql['idle_in_transaction_session_timeout'] = '60s'

保存后，重新配置极狐GitLab，使更改生效。

临时更改语句超时

在某些情况下，可能希望设置不同的语句超时，而无需重新配置极狐GitLab，这在这种情况下将重新启动 Puma 和 Sidekiq。

例如，备份可能会由于语句超时过短而在备份命令的输出中出现以下错误：

pg_dump: error: Error message from server: server closed the connection unexpectedly

您可能还会在 PostgreSQL 日志 中看到错误：

canceling statement due to statement timeout

要临时更改语句超时：

1. 在编辑器中打开 /var/opt/gitlab/gitlab-rails/etc/database.yml
2. 将 statement_timeout 的值设置为 0，这将设置为无限制的语句超时。

3. 在新的 Rails 控制台会话中确认 使用了此值：

   sudo gitlab-rails runner "ActiveRecord::Base.connection_config[:variables]"
   

4. 执行需要不同超时的操作（例如备份或 Rails 命令）。
5. 恢复对 /var/opt/gitlab/gitlab-rails/etc/database.yml 的编辑。

观察 (RE)INDEX 进度报告

在某些情况下，您可能希望观察 CREATE INDEX 或 REINDEX 操作的进度。例如，您可以这样做以确认 CREATE INDEX 或 REINDEX 操作是否处于活动状态，或检查操作处于哪个阶段。

先决条件：

• 您必须使用 PostgreSQL 版本 12 或更高版本。

要观察 CREATE INDEX 或 REINDEX 操作：

• 使用内置的 pg_stat_progress_create_index 视图。

例如，从数据库控制台会话中运行以下命令：

SELECT * FROM  pg_stat_progress_create_index \watch 0.2

故障排除

数据库不接受命令以避免环绕数据丢失

此错误可能意味着 autovacuum 无法完成其运行：

ERROR:  database is not accepting commands to avoid wraparound data loss in database "gitlabhq_production"

或者

 ERROR:  failed to re-find parent key in index "XXX" for deletion target page XXX

要解决此错误，请手动运行 VACUUM：

1. 使用命令 gitlab-ctl stop 停止极狐GitLab。

2. 使用以下命令将数据库置于单用户模式：

   /opt/gitlab/embedded/bin/postgres --single -D /var/opt/gitlab/postgresql/data gitlabhq_production
   

3. 在 backend> 提示符下，运行 VACUUM;。此命令可能需要几分钟才能完成。
4. 等待命令完成，然后按 Control + D 退出。
5. 使用命令 gitlab-ctl start 启动极狐GitLab。

极狐GitLab 数据库要求

请参阅数据库要求并查看和安装所需的扩展列表。

production/sidekiq 日志中的序列化错误

如果您在 production/sidekiq 日志中收到类似此示例的错误，请阅读有关将 default_transaction_isolation 设置为已提交读取的信息，以解决问题：

ActiveRecord::StatementInvalid PG::TRSerializationFailure: ERROR:  could not serialize access due to concurrent update

PostgreSQL 复制槽错误

如果您收到类似此示例的错误，请阅读有关如何解决 PostgreSQL HA 复制槽错误的信息：

pg_basebackup: could not create temporary replication slot "pg_basebackup_12345": ERROR:  all replication slots are in use
HINT:  Free one or increase max_replication_slots.

Geo 复制错误

如果您收到类似此示例的错误，请阅读有关如何解决 Geo 复制错误的信息：

ERROR: replication slots can only be used if max_replication_slots > 0

FATAL: could not start WAL streaming: ERROR: replication slot "geo_secondary_my_domain_com" does not exist

Command exceeded allowed execution time

PANIC: could not write to file 'pg_xlog/xlogtemp.123': No space left on device

检查 Geo 配置和常见错误

在处理 Geo 问题时，您应该：

• 查看 常见的 Geo 错误。
• 检查您的 Geo 配置，包括：
  • 重新配置主机和端口。
  • 查看和修复用户和密码映射。

pg_dump 和 psql 版本不匹配

如果您收到类似此示例的错误，请阅读有关如何备份和恢复非打包的 PostgreSQL 数据库的信息：

Dumping PostgreSQL database gitlabhq_production ... pg_dump: error: server version: 13.3; pg_dump version: 14.2
pg_dump: error: aborting because of server version mismatch

扩展 btree_gist 未在允许列表中

在 Azure Database for PostgreSQL - Flexible Server 上部署 PostgreSQL 可能会导致此错误：

extension "btree_gist" is not allow-listed for "azure_pg_admin" users in Azure Database for PostgreSQL

要解决此错误，请在安装前允许列出扩展。