DateTime predefinito di SQLAlchemy

Questo è il mio modello dichiarativo:

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)

Tuttavia, quando provo a importare questo modulo, ottengo questo errore:

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 utilizzo un tipo intero, posso impostare un valore predefinito. Cosa sta succedendo?

DateTimenon ha una chiave predefinita come input. La chiave predefinita dovrebbe essere un input per la Columnfunzione. Prova questo:

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)

Calcola i timestamp all'interno del tuo DB, non del tuo client

Per sanità di mente, probabilmente vorrai aver datetimescalcolato tutto dal tuo server DB, piuttosto che dal server delle applicazioni. Il calcolo del timestamp nell'applicazione può causare problemi poiché la latenza della rete è variabile, i client riscontrano una deriva dell'orologio leggermente diversa e diversi linguaggi di programmazione occasionalmente calcolano il tempo in modo leggermente diverso.

SQLAlchemy ti permette di farlo passando func.now()o func.current_timestamp()(sono alias l'uno dell'altro) che dice al DB di calcolare il timestamp stesso.

Usa SQLALchemy's server_default

Inoltre, per impostazione predefinita in cui si sta già dicendo al DB di calcolare il valore, è generalmente meglio usare server_defaultinvece di default. Questo dice a SQLAlchemy di passare il valore predefinito come parte dell'istruzione CREATE TABLE.

Ad esempio, se si scrive uno script ad hoc su questa tabella, utilizzando server_default significa che non sarà necessario preoccuparsi di aggiungere manualmente una chiamata timestamp allo script: il database lo imposterà automaticamente.

Comprensione di SQLAlchemy onupdate/server_onupdate

SQLAlchemy supporta inoltre in onupdatemodo che ogni volta che la riga viene aggiornata inserisca un nuovo timestamp. Ancora una volta, è meglio dire al DB di calcolare il timestamp stesso:

from sqlalchemy.sql import func

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

C'è un server_onupdateparametro, ma a differenza server_default, in realtà non imposta nulla sul lato server. Dice solo a SQLalchemy che il tuo database cambierà la colonna quando si verifica un aggiornamento (forse hai creato un trigger sulla colonna ), quindi SQLAlchemy chiederà il valore restituito in modo che possa aggiornare l'oggetto corrispondente.

Un altro potenziale gotcha:

Potresti essere sorpreso di notare che se apporti una serie di modifiche all'interno di una singola transazione, tutte hanno lo stesso timestamp. Questo perché lo standard SQL lo specificaCURRENT_TIMESTAMP restituisce valori basati sull'inizio della transazione.

PostgreSQL fornisce la non-SQL standard statement_timestamp()e clock_timestamp()che fare il cambiamento all'interno di una transazione. Documenti qui: https://www.postgresql.org/docs/current/static/functions-datetime.html#FUNCTIONS-DATETIME-CURRENT

Timestamp UTC

Se si desidera utilizzare i timestamp UTC, func.utcnow()nella documentazione di SQLAlchemy viene fornito uno stub di implementazione . Tuttavia, è necessario fornire autonomamente funzioni appropriate specifiche del driver.

Puoi anche usare la funzione built-in sqlalchemy per impostazione predefinita DateTime

from sqlalchemy.sql import func

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

Probabilmente vuoi usarlo in onupdate=datetime.nowmodo che anche gli AGGIORNAMENTI cambino il last_updatedcampo.

SQLAlchemy ha due valori predefiniti per le funzioni eseguite da Python.

• default imposta il valore su INSERT, solo una volta
• onupdateimposta il valore sul risultato richiamabile anche su UPDATE.

Il defaultparametro della parola chiave deve essere assegnato all'oggetto Colonna.

Esempio:

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

Il valore predefinito può essere richiamabile, che qui ho definito come il seguente.

from pytz import timezone
from datetime import datetime

UTC = timezone('UTC')

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

Come da documentazione PostgreSQL, https://www.postgresql.org/docs/9.6/static/functions-datetime.html

now, CURRENT_TIMESTAMP, LOCALTIMESTAMP return the time of transaction.

Questa è considerata una caratteristica: l'intenzione è quella di consentire a una singola transazione di avere una nozione coerente del tempo "corrente", in modo che più modifiche all'interno della stessa transazione rechino lo stesso timestamp.

Potresti voler usare statement_timestamp o clock_timestamp se non vuoi il timestamp della transazione.

statement_timestamp ()

restituisce l'ora di inizio dell'istruzione corrente (in particolare, l'ora di ricezione dell'ultimo messaggio di comando dal client). statement_timestamp

clock_timestamp ()

restituisce l'ora corrente attuale e quindi il suo valore cambia anche all'interno di un singolo comando SQL.