SQLAlchemy domyślny DateTime

Oto mój deklaratywny model:

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)

Jednak gdy próbuję zaimportować ten moduł, pojawia się ten błąd:

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'

Jeśli używam typu Integer, mogę ustawić wartość domyślną. Co się dzieje?

DateTimenie ma domyślnego klucza jako wejścia. Domyślny klucz powinien być wejściem do Columnfunkcji. Spróbuj tego:

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)

Obliczaj sygnatury czasowe w swojej bazie danych, a nie w swoim kliencie

Ze względów rozsądnych prawdopodobnie chcesz, aby wszystko zostało datetimesobliczone przez serwer bazy danych, a nie przez serwer aplikacji. Obliczanie znacznika czasu w aplikacji może prowadzić do problemów, ponieważ opóźnienie sieci jest zmienne, klienci doświadczają nieco innego przesunięcia zegara, a różne języki programowania czasami obliczają czas nieco inaczej.

SQLAlchemy pozwala to zrobić, przekazując func.now()lub func.current_timestamp()(są one wzajemnymi aliasami), co mówi DB, aby obliczył sam znacznik czasu.

Użyj SQLALchemy's server_default

Dodatkowo, w przypadku domyślnego, w którym już mówisz DB, aby obliczył wartość, generalnie lepiej jest użyć server_defaultzamiast default. To mówi SQLAlchemy, aby przekazał wartość domyślną jako część CREATE TABLEinstrukcji.

Na przykład, jeśli napiszesz skrypt ad hoc na tej tabeli, użycie server_defaultoznacza, że ​​nie będziesz musiał martwić się o ręczne dodawanie wywołania znacznika czasu do skryptu - baza danych ustawi go automatycznie.

Zrozumienie SQLAlchemy onupdate/server_onupdate

SQLAlchemy obsługuje również, onupdatedzięki czemu za każdym razem, gdy wiersz jest aktualizowany, wstawia nowy znacznik czasu. Ponownie, najlepiej powiedzieć DB, aby obliczył sam znacznik czasu:

from sqlalchemy.sql import func

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

Jest server_onupdateparametr, ale w przeciwieństwie do server_defaulttego nie ustawia on niczego po stronie serwera. Po prostu mówi SQLalchemy, że twoja baza danych zmieni kolumnę, gdy nastąpi aktualizacja (być może utworzyłeś wyzwalacz w kolumnie ), więc SQLAlchemy zapyta o wartość zwracaną, aby mógł zaktualizować odpowiedni obiekt.

Jeszcze jedna potencjalna wpadka:

Możesz być zaskoczony, gdy zauważysz, że jeśli dokonasz wielu zmian w ramach jednej transakcji, wszystkie mają ten sam znacznik czasu. Dzieje się tak, ponieważ standard SQL określa, że CURRENT_TIMESTAMPzwraca wartości na podstawie początku transakcji.

PostgreSQL zapewnia non-SQL standard statement_timestamp()i clock_timestamp()które zrobić zmiany w obrębie transakcji. Dokumenty tutaj: https://www.postgresql.org/docs/current/static/functions-datetime.html#FUNCTIONS-DATETIME-CURRENT

Znacznik czasu UTC

Jeśli chcesz używać sygnatur czasowych UTC, func.utcnow()w dokumentacji SQLAlchemy znajduje się kod implementacji . Musisz jednak samodzielnie zapewnić odpowiednie funkcje specyficzne dla sterownika.

Możesz także użyć domyślnej funkcji wbudowanej sqlalchemy DateTime

from sqlalchemy.sql import func

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

Prawdopodobnie będziesz chciał użyć onupdate=datetime.now, aby UPDATEs również zmieniały last_updatedpole.

SQLAlchemy ma dwie wartości domyślne dla funkcji wykonywanych w Pythonie.

• default ustawia wartość na INSERT, tylko raz
• onupdateustawia wartość na wywoływalny wynik również w UPDATE.

defaultParametr Hasło powinno być podane do obiektu kolumnie.

Przykład:

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

Wartość domyślna może być wywoływalna, co tutaj zdefiniowałem jak poniżej.

from pytz import timezone
from datetime import datetime

UTC = timezone('UTC')

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

Zgodnie z dokumentacją PostgreSQL, https://www.postgresql.org/docs/9.6/static/functions-datetime.html

now, CURRENT_TIMESTAMP, LOCALTIMESTAMP return the time of transaction.

Jest to uważane za cechę: chodzi o to, aby pojedyncza transakcja miała spójne pojęcie „bieżącego” czasu, tak aby wiele modyfikacji w ramach tej samej transakcji nosiło ten sam znacznik czasu.

Jeśli nie chcesz, aby sygnatura czasowa transakcji była używana , możesz użyć parametru Statement_timestamp lub clock_timestamp .

Statement_timestamp ()

zwraca czas rozpoczęcia bieżącej instrukcji (a dokładniej czas odebrania ostatniego komunikatu polecenia od klienta). Statement_timestamp

clock_timestamp ()

zwraca aktualny czas, dlatego jego wartość zmienia się nawet w ramach jednego polecenia SQL.