使用 pgbouncer 时的 Django 设置

Question

我有一个带有 Postgresql 后端的 Django 网站，为此我使用 pgbouncer 进行数据库连接池（事务模式）。

应用程序和数据库位于不同的服务器上（每台服务器 1 台）。我已经在应用服务器上安装了pgbouncer。我的问题是：settings.py 中的配置应该是什么？请注意，我使用 Unix 套接字 连接到 pgbouncer。

---

我当前的settings.py 包含：

DATABASE_URL = 'postgres://user1:pass1@xx.xxx.xxx.xxx:5432/db1'
DATABASES = {
'default': dj_database_url.config(default=DATABASE_URL)
}

pgbouncer.ini的相关部分是：

[databases]
db1 = host=xx.xxx.xxx.xxx port=5432 dbname=db1

listen_addr = *
listen_port = 6432
auth_type = md5
unix_socket_dir = /var/run/postgresql
pool_mode = transaction
max_client_conn = 200
default_pool_size = 300

userlist.txt 包含：

"user1" "pass1"

---

注意：一个答案is here，但对我不起作用，因为数据库在我的情况下在本地不可用。我需要设置 DATABASE_URL 环境变量，而不是使用default = '...'。

一个建议似乎是将pgbouncer 视为settings.py 中的数据库。在那种情况下，类似以下的工作吗？

if PRODUCTION == '1':
    #PRODUCTION is set to '1' if in production environment
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.postgresql_psycopg2',
            'NAME': 'pgbouncer',
            'USER': 'user1',
            'PASSWORD': 'pass1',
            'HOST': '/var/run/postgresql',
            'PORT': '6432',
        }

Answer 1

settings.py 中的所有数据库设置都应该与 pgbouncer 配置中的设置相同，除了 settings.py 中的主机将指向 pgbouncer。您可能需要将'NAME': 'pgbouncer' 更改为'NAME': 'db1'。由于您使用的是 unix 套接字，因此端口无关紧要。

Answer 2

来自docs：

pgbouncer 是一个 PostgreSQL 连接池。任何目标应用程序 可以像 PostgreSQL 服务器一样连接到 pgbouncer，并且 pgbouncer 将创建一个到实际服务器的连接，或者它会 重用其现有连接之一。

还有，

让您的应用程序（或 psql 客户端）连接到 pgbouncer 而不是直接到 PostgreSQL 服务器。

---

配置：

pgbouncer.ini：pgbouncer.ini 的示例，其中包含有关默认值的 cmets

[databases]
db1 = host=xx.xxx.xxx.xxx port=5432 dbname=db1

[pgbouncer]
listen_addr = *
listen_port = 6432
auth_type = md5
auth_file = userlist.txt
unix_socket_dir = /var/run/postgresql
pool_mode = transaction
max_client_conn = 100
default_pool_size = 20

userlist.txt：

"user1" "pass1"

放入settings.py：

if PRODUCTION == '1':
    #PRODUCTION is set to '1' if in production environment
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.postgresql_psycopg2',
            'NAME': 'db1',
            'USER': 'user1',
            'PASSWORD': 'pass1',
            'HOST': '/var/run/postgresql',
            # 'PORT': '6432',
        }

---

额外：

如果不使用 unix 套接字 - 如果 pgbouncer 在本地运行，您可以设置 HOST : '127.0.0.1' 或 'localhost'，或者任何服务器 pgbouncer 的 IP 将在其上运行。 来自docs：

如果您使用的是 PostgreSQL，默认情况下（空主机），连接到 数据库是通过 UNIX 域套接字完成的（在 pg_hba.conf)。如果您的 UNIX 域套接字不在标准中 位置，使用相同的 unix_socket_directory 值 postgresql.conf。如果要通过 TCP 套接字连接，请设置 HOST 到“localhost”或“127.0.0.1”（pg_hba.conf 中的“host”行）。在 Windows，您应该始终定义 HOST，因为 UNIX 域套接字不是 可用。

---

对于 ENGINE 的 postgreSQL，您可以使用 postgresql 或 postgresql_psycopg2 - 鉴于您的 Django 版本，两者之间存在差异 - postgresql_psycopg2 vs posgresql。