Дата-час за замовчуванням SQLAlchemy

Це моя декларативна модель:

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)

Однак, коли я намагаюся імпортувати цей модуль, я отримую цю помилку:

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'

Якщо я використовую тип Integer, я можу встановити значення за замовчуванням. Що відбувається?

DateTimeне містить ключ за замовчуванням як вхід. Клавіша за замовчуванням повинна бути входом до Columnфункції. Спробуйте це:

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)

Обчисліть часові позначки у вашій БД, а не у клієнта

Для розуму ви, мабуть, хочете мати всіх datetimes обчислено вашим сервером БД, а не сервером додатків. Обчислення часової позначки в додатку може призвести до проблем, оскільки затримка в мережі мінлива, клієнти відчувають дещо інший рух годинника, а різні мови програмування час від часу обчислюють час дещо інакше.

SQLAlchemy дозволяє зробити це шляхом передачі func.now()або func.current_timestamp()(вони є псевдонімами один одного), що повідомляє БД обчислити саму часову марку.

Використовуйте SQLALchemy server_default

Крім того, для дефолту, де ви вже говорите БД для обчислення значення, його краще використовувати server_defaultзамість цього default. Це вказує SQLAlchemy передавати значення за замовчуванням як частину CREATE TABLEоператора.

Наприклад, якщо ви пишете спеціальний сценарій проти цієї таблиці, використовуючи server_default засоби, вам не потрібно буде турбуватися про те, що вручну додавати виклик часової мітки до вашого сценарію - база даних встановить його автоматично.

Розуміння SQLAlchemy's onupdate/server_onupdate

SQLAlchemy також підтримує onupdateтак, що коли б оновлення рядка було вставлено нову часову позначку. Знову ж таки, краще сказати БД для розрахунку самої часової позначки:

from sqlalchemy.sql import func

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

Є server_onupdateпараметр, але на відміну від цього server_default, він насправді не встановлює нічого серверного. Він просто говорить SQLalchemy, що ваша база даних змінить стовпчик, коли відбудеться оновлення (можливо, ви створили тригер на стовпчику ), тому SQLAlchemy попросить повернути значення, щоб він міг оновити відповідний об'єкт.

Ще один потенційний готч:

Ви можете бути здивовані, помітивши, що якщо ви внесете купу змін в рамках однієї транзакції, всі вони мають однакову мітку часу. Це тому, що стандарт SQL вказує, що CURRENT_TIMESTAMPповертає значення на основі початку транзакції.

PostgreSQL надає не-SQL стандарту statement_timestamp()і clock_timestamp()які роблять зміни в рамках транзакції. Документи тут: https://www.postgresql.org/docs/current/static/functions-datetime.html#FUNCTIONS-DATETIME-CURRENT

UTC часова мітка

Якщо ви хочете використовувати часові позначки UTC, в документаціїfunc.utcnow() на SQLAlchemy міститься заголовок реалізації . Вам потрібно забезпечити відповідні функції, характерні для драйвера, самостійно.

Ви також можете використовувати функцію вбудованої sqlalchemy за замовчуванням DateTime

from sqlalchemy.sql import func

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

Ви, ймовірно, хочете використовувати onupdate=datetime.nowтак, щоб оновлення також змінювали last_updatedполе.

SQLAlchemy має два параметри за замовчуванням для виконуваних функцій python.

• default встановлює значення на INSERT лише один раз
• onupdateвстановлює значення для результату дзвінка також у UPDATE.

Параметр defaultключового слова повинен бути заданий об'єкту "Стовпець".

Приклад:

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

Значенням за замовчуванням може бути дзвінок, який тут я визначив так.

from pytz import timezone
from datetime import datetime

UTC = timezone('UTC')

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

Відповідно до документації PostgreSQL, https://www.postgresql.org/docs/9.6/static/functions-datetime.html

now, CURRENT_TIMESTAMP, LOCALTIMESTAMP return the time of transaction.

Це вважається особливістю: намір дозволити одній транзакції мати послідовне поняття "поточного" часу, так що кілька модифікацій в межах однієї транзакції мають однакову позначку часу.

Якщо ви не хочете позначити часові позначки транзакцій, ви можете використовувати команду statement_timestamp або clock_timestamp .

statement_timestamp ()

повертає час початку поточного оператора (точніше, час отримання останнього повідомлення команди від клієнта). statement_timestamp

clock_timestamp ()

повертає фактичний поточний час, і тому його значення змінюється навіть у межах однієї команди SQL.