Como sei se posso desativar o SQLALCHEMY_TRACK_MODIFICATIONS?

Sempre que executo meu aplicativo que usa Flask-SQLAlchemy, recebo o seguinte aviso de que a SQLALCHEMY_TRACK_MODIFICATIONSopção será desativada.

/home/david/.virtualenvs/flask-sqlalchemy/lib/python3.5/site-packages/flask_sqlalchemy/__init__.py:800: UserWarning: SQLALCHEMY_TRACK_MODIFICATIONS adds significant overhead and will be disabled by default in the future.  Set it to True to suppress this warning.
  warnings.warn('SQLALCHEMY_TRACK_MODIFICATIONS adds significant overhead and will be disabled by default in the future.  Set it to True to suppress this warning.')

Tentei descobrir o que essa opção faz, mas a documentação do Flask-SQLAlchemy não está clara sobre o que usa esse rastreamento.

SQLALCHEMY_TRACK_MODIFICATIONS

Se definido como True (o padrão), o Flask-SQLAlchemy rastreará modificações de objetos e emitirá sinais. Isso requer memória extra e pode ser desativado se não for necessário.

Como descubro se meu projeto exige SQLALCHEMY_TRACK_MODIFICATIONS = Trueou se posso desativar com segurança esse recurso e economizar memória no meu servidor?

Provavelmente, seu aplicativo não usa o sistema de eventos Flask-SQLAlchemy, portanto você provavelmente está seguro para desativar. Você precisará auditar o código para verificar. Você está procurando algo que se encaixe models_committedoubefore_models_committed . Se você achar que está usando o sistema de eventos Flask-SQLAlchemy, provavelmente deverá atualizar o código para usar o sistema de eventos interno do SQLAlchemy.

Para desligar o sistema de eventos Flask-SQLAlchemy (e desativar o aviso), basta adicionar:

SQLALCHEMY_TRACK_MODIFICATIONS = False

à configuração do seu aplicativo até que o padrão seja alterado (provavelmente no Flask-SQLAlchemy v3).

Plano de fundo - eis o que o aviso está dizendo:

O Flask-SQLAlchemy possui seu próprio sistema de notificação de eventos que é colocado sobre o SQLAlchemy. Para fazer isso, ele controla as modificações na sessão SQLAlchemy. Isso requer recursos extras; portanto, a opção SQLALCHEMY_TRACK_MODIFICATIONSpermite desativar o sistema de rastreamento de modificações. Atualmente, a opção padrão é True, mas no futuro, esse padrão será alterado para False, desativando o sistema de eventos.

Pelo que entendi, a lógica da mudança é tripla:

1. Muitas pessoas não usam o sistema de eventos do Flask-SQLAlchemy, mas muitas pessoas não percebem que podem economizar recursos do sistema desativando-o. Portanto, um padrão mais prudente é desativá-lo e quem quiser pode ativá-lo.

2. O sistema de eventos no Flask-SQLAlchemy tem sido bastante complicado (consulte os problemas vinculados à solicitação de solicitação mencionada abaixo), exigindo manutenção adicional para um recurso que poucas pessoas usam.

3. Na v0.7, o próprio SQLAlchemy adicionou um poderoso sistema de eventos, incluindo a capacidade de criar eventos personalizados. Idealmente, o sistema de eventos Flask-SQLAlchemy não deve fazer nada além de criar alguns ganchos e ouvintes personalizados de eventos SQLAlchemy e, em seguida, deixar o próprio SQLAlchemy gerenciar o acionador de eventos.

Você pode ver mais na discussão sobre a solicitação pull que começou a acionar esse aviso .

A explicação detalhada de Jeff Widman é simplesmente perfeita.

Desde que eu tive algumas brigas de copiar e colar antes de acertar, eu gostaria de facilitar para a próxima que estará no meu lugar.

No seu código, imediatamente após :

app = Flask(__name__)

Se você deseja ativar as modificações de faixa, basta adicionar:

app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = True

Caso contrário, se você não estiver usando esse recurso, convém alterar o valor para False para não desperdiçar recursos do sistema. Isso ainda silenciará o aviso, pois você estará definindo explicitamente a configuração.

Aqui está o mesmo trecho com valor False:

app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

Agradecemos a Jeff Widman por esta sugestão e detalhes adicionais.

As respostas acima parecem boas. No entanto, eu queria apontar essa linha na documentação do Flask-SQLAlchemy porque ainda estava recebendo esses avisos depois de definir SQLALCHEMY_TRACK_MODIFICATIONS = Falsena configuração do aplicativo.

Nesta página: http://flask-sqlalchemy.pocoo.org/2.3/config/

Os seguintes valores de configuração existem para Flask-SQLAlchemy. O Flask-SQLAlchemy carrega esses valores da sua configuração principal do Flask, que pode ser preenchida de várias maneiras. Observe que alguns deles não podem ser modificados após a criação do mecanismo, portanto, configure-o o mais cedo possível e não modifique-os em tempo de execução.

Em outras palavras, certifique-se de configurar o seu app.config antes de criar seu banco de dados Flask-SQLAlchemy.

Por exemplo, se você estiver configurando seu aplicativo para definir SQLALCHEMY_TRACK_MODIFICATIONS = False:

from flask import Flask
app = Flask(__name__)
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

db = SQLAlchemy(app)