django-multidb-router 0.10

django-multidb-router

multidb提供了两个Django数据库路由器，在主从数据库部署中非常有用。

DATABASES = {
    'default': {...},
    'shadow-1': {...},
    'shadow-2': {...},
}
REPLICA_DATABASES = ['shadow-1', 'shadow-2']

DATABASE_ROUTERS = ('multidb.ReplicaRouter',)

from django.db import connections
import multidb

connection = connections[multidb.get_replica()]

注意事项

PinningRouterMiddleware主要根据请求类型识别数据库写入，假设不是GET、TRACE、HEAD或OPTIONS的HTTP方法都是写入。您可以使用multidb.db_write装饰器来指示任何视图写入数据库。这将导致与请求为POST等相同的结果。

您还可以手动设置response._db_write = True以指示发生了写入。这将不会导致在此请求中使用default数据库，但只会在下一个请求中。

配置

要使用PinningReplicaRouter，将其放入您的设置中的DATABASE_ROUTERS。

DATABASE_ROUTERS = ('multidb.PinningReplicaRouter',)

然后，安装中间件。它必须排在任何其他执行数据库写入的中间件之前。

MIDDLEWARE_CLASSES = (
    'multidb.middleware.PinningRouterMiddleware',
    ...more middleware here...
)

PinningRouterMiddleware将一个cookie附加到刚刚写入的任何用户代理。cookie应该设置为在复制延迟时间之后过期。默认情况下，其值为保守的15秒，但可以调整如下

MULTIDB_PINNING_SECONDS = 5

如果您需要更改cookie的名称，请使用MULTIDB_PINNING_COOKIE设置。

MULTIDB_PINNING_COOKIE = 'multidb_pin_writes'

您还可以通过使用以下设置来设置cookie的“Secure”、“HttpOnly”和“SameSite”属性。这些设置基于Django对会话和CSRFcookie的设置。

MULTIDB_PINNING_COOKIE_SECURE = False
MULTIDB_PINNING_COOKIE_HTTPONLY = False
MULTIDB_PINNING_COOKIE_SAMESITE = 'Lax'

注意：“SameSite”属性仅在django 2.1及以上版本中可用。

use_primary_db

multidb.pinning.use_primary_db是用于包装代码以使用主数据库的上下文管理器和装饰器。您可以使用它作为上下文管理器

from multidb.pinning import use_primary_db

with use_primary_db:
    touch_the_database()
touch_another_database()

或作为装饰器

from multidb.pinning import use_primary_db

@use_primary_db
def func(*args, **kw):
    """Touches the primary database."""

pip install -r requirements.txt
./run.sh test