Pool de conexões no mssql-django

Este artigo explica como o pool de conexões funciona em mssql-django e como configurá-lo para o seu aplicativo Django.

Como funciona o pool de conexões

Por padrão, mssql-django usa pool de conexões em nível de driver. O caminho padrão do pyodbc usa o pooling do pyodbc, e o caminho do mssql-python usa o pooling do mssql-python. Quando o Django fecha uma conexão, o driver ativo a retorna para um pool em vez de fechar a conexão subjacente ao banco de dados. Solicitações de conexão subsequentes reutilizam conexões em pool, o que reduz a sobrecarga de estabelecer novas conexões de banco de dados. Para detalhes sobre a seleção de drivers, veja Selecionar o driver de banco de dados para mssql-django.

Configurar o pool de conexões

O pool de conexões é controlado pela configuração DATABASE_CONNECTION_POOLING, que fica definida no nível do módulo em settings.py (fora do dicionário DATABASES):

DATABASES = {
    "default": {
        "ENGINE": "mssql",
        "NAME": "<your-database>",
        "USER": "<your-username>",
        "PASSWORD": "<your-password>",
        "HOST": "<your-server>",
        "PORT": "1433",
        "OPTIONS": {
            "driver": "ODBC Driver 18 for SQL Server",
        },
    },
}

# Set to False to disable driver-level connection pooling
DATABASE_CONNECTION_POOLING = False
Valor Behavior
True (padrão) O pool de conexões está habilitado. As conexões fechadas são devolvidas ao pool.
False O pooling de conexão no nível do driver está desativado. O caminho pyodbc define Database.pooling=False, e o caminho mssql-python chama PoolingManager.disable().

Quando desabilitar o pool de conexões

Considere desabilitar o pool de conexões nestes cenários:

  • Autenticação baseada em token: ao usar tokens de acesso que expiram, as conexões em pool podem conter tokens obsoletos.
  • Depuração de problemas de conexão: desativar o pooling simplifica a solução de problemas, ao garantir que cada solicitação crie uma nova conexão.
  • Processos de curta duração: para scripts ou comandos de gerenciamento que fazem algumas consultas e saem, o pool não adiciona nenhum benefício.

Configurações de repetição de conexão

Independentemente da configuração de pooling, você pode configurar o comportamento de novas tentativas para tentativas de conexão malsucedidas. Para obter a lista completa de opções de repetição e tempo limite, consulte a referência de configuração.

DATABASES = {
    "default": {
        "ENGINE": "mssql",
        "NAME": "<your-database>",
        "USER": "<your-username>",
        "PASSWORD": "<your-password>",
        "HOST": "<your-server>",
        "PORT": "1433",
        "OPTIONS": {
            "driver": "ODBC Driver 18 for SQL Server",
            "connection_retries": 3,
            "connection_retry_backoff_time": 10,
            "connection_timeout": 30,
        },
    },
}

CONN_MAX_AGE do Django

O Django também fornece uma CONN_MAX_AGE configuração que controla por quanto tempo o Django mantém uma conexão de banco de dados aberta antes de fechá-la. Essa configuração funciona junto com o pool de conexão em nível de motorista:

DATABASES = {
    "default": {
        "ENGINE": "mssql",
        "NAME": "<your-database>",
        "USER": "<your-username>",
        "PASSWORD": "<your-password>",
        "HOST": "<your-server>",
        "PORT": "1433",
        "CONN_MAX_AGE": 600,  # Keep connections open for 10 minutes
        "OPTIONS": {
            "driver": "ODBC Driver 18 for SQL Server",
        },
    },
}

Para obter mais informações sobre CONN_MAX_AGE, consulte a documentação de configurações do banco de dados do Django.

Pontos de partida práticos:

  • CONN_MAX_AGE=0: mais seguro para depuração e tarefas de curta duração.
  • CONN_MAX_AGE=600: bom padrão para muitos aplicativos Web.
  • CONN_MAX_AGE=3600: razoável para serviços de alta taxa de transferência constantes após o teste de carga.

Note

Quando você usa servidores ASGI (como Daphne ou Uvicorn) ou implantações com threads, conexões persistentes podem vazar de um contexto assíncrono para outro. Se você usar CONN_MAX_AGE com um servidor ASGI, configure CONN_HEALTH_CHECKS = True nas versões suportadas do Django e teste em condições realistas de concorrência. Para obter mais informações, consulte a documentação do Django sobre gerenciamento de conexões.

CONN_HEALTH_CHECKS valida conexões em pool antes da reutilização. Se o Django detectar uma conexão obsoleta, ela abrirá uma conexão nova de forma transparente. Isso adiciona um pequeno custo de verificação por solicitação e geralmente vale a pena habilitar para processos de longa duração.

Conteúdo relacionado

  • Last updated on