SQLAlchemy 默认日期时间

Question

这是我的声明模型：

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'

如果我使用整数类型，我可以设置一个默认值。怎么回事？

Answer 1

在您的数据库中计算时间戳，而不是在您的客户端中

出于理智，您可能希望所有datetimes 都由您的数据库服务器而不是应用程序服务器计算。在应用程序中计算时间戳可能会导致问题，因为网络延迟是可变的，客户端会遇到稍微不同的时钟漂移，并且不同的编程语言有时会稍微不同地计算时间。

SQLAlchemy 允许您通过传递 func.now() 或 func.current_timestamp()（它们是彼此的别名）来执行此操作，这告诉数据库自己计算时间戳。

使用 SQLALchemy 的server_default

此外，对于您已经告诉数据库计算值的默认值，通常最好使用server_default 而不是default。这告诉 SQLAlchemy 将默认值作为CREATE TABLE 语句的一部分传递。

例如，如果您针对此表编写临时脚本，使用 server_default 意味着您无需担心手动向脚本添加时间戳调用 - 数据库会自动设置它。

了解 SQLAlchemy 的 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，当更新发生时，您的数据库将更改列（也许您创建了一个 trigger on the column ），因此 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 documentation 中提供。不过，您需要自己提供适当的驱动程序特定功能。

Answer 2

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)

Answer 3

您也可以使用 sqlalchemy 内置函数作为默认 DateTime

from sqlalchemy.sql import func

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

Answer 4

您可能希望使用onupdate=datetime.now，以便更新也更改last_updated 字段。

SQLAlchemy 有两个 Python 执行函数的默认值。

• default 在 INSERT 上设置值，只设置一次
• onupdate 也在 UPDATE 上将值设置为 callable 结果。

Answer 5

default 关键字参数应该给 Column 对象。

例子：

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)

Answer 6

将default 参数与datetime.now 一起使用：

from datetime import datetime
class Test(Base):
     __tablename__ = 'test'
     id = Column(Integer, primary_key=True)
     created_at = Column(DateTime, default=datetime.now)
     updated_at = Column(DateTime, default=datetime.now, onupdate=datetime.now)                                                            

Answer 7

根据PostgreSQL documentation：

now,CURRENT_TIMESTAMP,LOCALTIMESTAMP返回交易时间

这被认为是一项功能：其目的是允许单个 事务具有一致的“当前”时间概念，因此 同一事务中的多个修改具有相同的时间戳。

如果您不想要交易时间戳，您可能想要使用 statement_timestamp 或 clock_timestamp。

statement_timestamp()

返回当前语句的开始时间（更具体地说， 收到客户端最新命令消息的时间）。 statement_timestamp

clock_timestamp()

返回实际的当前时间，因此它的值甚至会改变 在单个 SQL 命令中。

Answer 8

mariadb 这对我有用：

from sqlalchemy import Column, Integer, String, DateTime, TIMESTAMP, text
from sqlalchemy.sql import func
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class Test(Base):
  __tablename__ = "test"

  id              = Column(Integer, primary_key=True, autoincrement=True)
  name            = Column(String(255), nullable=False)
  email           = Column(String(255), nullable=False)
  created_at      = Column(TIMESTAMP, nullable=False, server_default=func.now())
  updated_at      = Column(DateTime, server_default=text("CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP"))

在mariadb的sqlalchemy documentation中，建议从sqlalchemy本身导入text，并将server_default设置为text，插入自定义命令。

updated_at=Column(DateTime, server_default=text("CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP"))

要了解func.now，您可以阅读 sql alchemy 文档。

希望我能以某种方式提供帮助。

Answer 9

Jeff Widman 在 his answer 上说，您需要为 func.utcnow() 创建自己的 UTC 时间戳实现

由于我不想自己实现它，所以我搜索并找到了一个 python 包，它已经完成了这项工作并由很多人维护。

包名是spoqa/sqlalchemy-ut。

这个包的作用总结是： 长话短说，UtcDateTime 确实：

只知道datetime.datetime， 只返回知道datetime.datetime， 永远不要天真地接受或返回datetime.datetime， 确保数据库中的时间戳始终以 UTC 编码，并且 按照您的预期工作。

Answer 10

请注意，server_default=func.now() 和 func.now() 工作：

Local_modified = Column(DateTime, server_default=func.now(), onupdate=func.now())

您需要在表格 DDL 中设置DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP。

例如

create table test
(
    id int auto_increment
        primary key,
    source varchar(50) null,
    Local_modified datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
)
collate=utf8mb4_bin;

否则，server_default=func.now(), onupdate=func.now() 无效。