SQLAlchemy DateTime padrão

Este é o meu modelo declarativo:

import datetime
from sqlalchemy import Column, Integer, DateTime
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class Test(Base):
    __tablename__ = 'test'

    id = Column(Integer, primary_key=True)
    created_date = DateTime(default=datetime.datetime.utcnow)

No entanto, quando tento importar este módulo, recebo este erro:

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "orm/models2.py", line 37, in <module>
    class Test(Base):
  File "orm/models2.py", line 41, in Test
    created_date = sqlalchemy.DateTime(default=datetime.datetime.utcnow)
TypeError: __init__() got an unexpected keyword argument 'default'

Se eu usar um tipo Inteiro, posso definir um valor padrão. O que está acontecendo?

DateTimenão possui uma chave padrão como entrada. A tecla padrão deve ser uma entrada para a Columnfunção. Tente o seguinte:

import datetime
from sqlalchemy import Column, Integer, DateTime
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class Test(Base):
    __tablename__ = 'test'

    id = Column(Integer, primary_key=True)
    created_date = Column(DateTime, default=datetime.datetime.utcnow)

Calcular carimbos de data e hora no seu banco de dados, não no seu cliente

Por questões de sanidade, você provavelmente deseja ter todos datetimescalculados pelo seu servidor de banco de dados, e não pelo servidor de aplicativos. O cálculo do registro de data e hora no aplicativo pode causar problemas, porque a latência da rede é variável, os clientes experimentam um desvio do relógio ligeiramente diferente e diferentes linguagens de programação ocasionalmente calculam o tempo de maneira ligeiramente diferente.

SQLAlchemy permite que você faça isso passando func.now()ou func.current_timestamp()(eles são aliases um do outro) que informa ao banco de dados para calcular o próprio carimbo de data / hora.

Use SQLALchemy server_default

Além disso, para um padrão em que você já está dizendo ao banco de dados para calcular o valor, geralmente é melhor usá-lo em server_defaultvez de default. Isso informa ao SQLAlchemy para passar o valor padrão como parte da CREATE TABLEinstrução.

Por exemplo, se você escrever um script ad hoc nessa tabela, usar server_defaultsignifica que não precisará se preocupar em adicionar manualmente uma chamada de carimbo de data / hora ao seu script - o banco de dados o definirá automaticamente.

Noções básicas sobre SQLAlchemy onupdate/server_onupdate

O SQLAlchemy também suporta, onupdatepara que, sempre que a linha for atualizada, ele insira um novo carimbo de data / hora. Novamente, é melhor dizer ao banco de dados para calcular o próprio carimbo de data / hora:

from sqlalchemy.sql import func

time_created = Column(DateTime(timezone=True), server_default=func.now())
time_updated = Column(DateTime(timezone=True), onupdate=func.now())

Existe um server_onupdateparâmetro, mas, ao contrário server_default, ele não define nada no servidor. Apenas informa ao SQLalchemy que seu banco de dados alterará a coluna quando uma atualização acontecer (talvez você tenha criado um gatilho na coluna ); portanto, o SQLAlchemy solicitará o valor de retorno para que ele possa atualizar o objeto correspondente.

Uma outra pegada em potencial:

Você pode se surpreender ao perceber que, se você fizer várias alterações em uma única transação, todas elas terão o mesmo carimbo de data / hora. Isso ocorre porque o padrão SQL especifica que CURRENT_TIMESTAMPretorna valores com base no início da transação.

PostgreSQL fornece o não-SQL-padrão statement_timestamp()e clock_timestamp()que fazer a mudança dentro de uma transação. Documentos aqui: https://www.postgresql.org/docs/current/static/functions-datetime.html#FUNCTIONS-DATETIME-CURRENT

Registro de data e hora UTC

Se você deseja usar registros de data e hora UTC, func.utcnow()é fornecido um stub de implementação na documentação do SQLAlchemy . Você precisa fornecer as funções específicas do driver apropriadas por conta própria.

Você também pode usar a função interna sqlalchemy por padrão DateTime

from sqlalchemy.sql import func

DT = Column(DateTime(timezone=True), default=func.now())

Você provavelmente deseja usar onupdate=datetime.nowpara que UPDATEs também alterem o last_updatedcampo.

SQLAlchemy possui dois padrões para funções executadas em python.

• default define o valor em INSERT, apenas uma vez
• onupdatedefine o valor para o resultado que pode ser chamado em UPDATE também.

O defaultparâmetro keyword deve ser fornecido ao objeto Column.

Exemplo:

Column(u'timestamp', TIMESTAMP(timezone=True), primary_key=False, nullable=False, default=time_now),

O valor padrão pode ser exigível, que aqui defini da seguinte maneira.

from pytz import timezone
from datetime import datetime

UTC = timezone('UTC')

def time_now():
    return datetime.now(UTC)

De acordo com a documentação do PostgreSQL, https://www.postgresql.org/docs/9.6/static/functions-datetime.html

now, CURRENT_TIMESTAMP, LOCALTIMESTAMP return the time of transaction.

Isso é considerado um recurso: a intenção é permitir que uma única transação tenha uma noção consistente do horário "atual", de modo que várias modificações na mesma transação tenham o mesmo carimbo de hora.

Você pode usar statement_timestamp ou clock_timestamp se não desejar o carimbo de data / hora da transação.

statement_timestamp ()

retorna a hora de início da instrução atual (mais especificamente, a hora do recebimento da última mensagem de comando do cliente). statement_timestamp

clock_timestamp ()

retorna a hora atual real e, portanto, seu valor muda mesmo dentro de um único comando SQL.