Ngày giờ mặc định của SQLAlchemy

Đây là mô hình khai báo của tôi:

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)

Tuy nhiên, khi tôi cố gắng nhập mô-đun này, tôi gặp lỗi này:

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'

Nếu tôi sử dụng loại Số nguyên, tôi có thể đặt giá trị mặc định. Chuyện gì đang xảy ra vậy?

DateTimekhông có khóa mặc định làm đầu vào. Khóa mặc định phải là đầu vào cho Columnhàm. Thử cái này:

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)

Tính toán dấu thời gian trong DB của bạn, không phải máy khách của bạn

Đối với sự tỉnh táo, có lẽ bạn muốn tất cả được datetimestính toán bởi máy chủ DB của mình, thay vì máy chủ ứng dụng. Tính toán dấu thời gian trong ứng dụng có thể dẫn đến các vấn đề vì độ trễ của mạng là khác nhau, khách hàng trải nghiệm sự trôi dạt đồng hồ hơi khác nhau và các ngôn ngữ lập trình khác nhau đôi khi tính thời gian hơi khác nhau.

SQLAlchemy cho phép bạn thực hiện điều này bằng cách chuyển func.now()hoặc func.current_timestamp()(chúng là bí danh của nhau) cho DB biết để tự tính toán dấu thời gian.

Sử dụng SQLALchemy server_default

Ngoài ra, đối với một mặc định mà bạn đã yêu cầu DB tính toán giá trị, nói chung nên sử dụng server_defaultthay vì tốt hơn default. Điều này báo cho SQLAlchemy vượt qua giá trị mặc định như một phần của CREATE TABLEcâu lệnh.

Ví dụ: nếu bạn viết một tập lệnh ad hoc dựa vào bảng này, sử dụng server_defaultcó nghĩa là bạn sẽ không cần phải lo lắng về việc thêm thủ công cuộc gọi dấu thời gian vào tập lệnh của mình - cơ sở dữ liệu sẽ tự động đặt nó.

Hiểu về SQLAlchemy onupdate/server_onupdate

SQLAlchemy cũng hỗ trợ onupdateđể bất cứ khi nào hàng được cập nhật, nó sẽ chèn dấu thời gian mới. Một lần nữa, tốt nhất là nói với DB để tự tính toán dấu thời gian:

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ó một server_onupdatetham số, nhưng không giống như server_default, nó không thực sự đặt bất kỳ máy chủ nào. Nó chỉ cho SQLalchemy biết rằng cơ sở dữ liệu của bạn sẽ thay đổi cột khi có cập nhật (có lẽ bạn đã tạo một kích hoạt trên cột ), vì vậy SQLAlchemy sẽ yêu cầu giá trị trả về để nó có thể cập nhật đối tượng tương ứng.

Một Gotcha tiềm năng khác:

Bạn có thể ngạc nhiên khi nhận thấy rằng nếu bạn thực hiện một loạt các thay đổi trong một giao dịch, tất cả chúng đều có cùng dấu thời gian. Đó là bởi vì tiêu chuẩn SQL chỉ định CURRENT_TIMESTAMPtrả về các giá trị dựa trên thời điểm bắt đầu giao dịch.

PostgreSQL cung cấp phi SQL chuẩn statement_timestamp()và clock_timestamp()đó làm thay đổi trong một giao dịch. Tài liệu ở đây: https://www.postgresql.org/docs/civerse/static/fifts-datetime.html#FUNCTIONS-DATETIME-CURRENT

Dấu thời gian UTC

Nếu bạn muốn sử dụng dấu thời gian UTC, một sơ khai thực hiện func.utcnow()được cung cấp trong tài liệu SQLAlchemy . Bạn cần phải tự cung cấp các chức năng cụ thể cho trình điều khiển phù hợp.

Bạn cũng có thể sử dụng hàm dựng sẵn sqlalchemy DateTime

from sqlalchemy.sql import func

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

Bạn có thể muốn sử dụng onupdate=datetime.nowđể CẬP NHẬT cũng thay đổi last_updatedtrường.

SQLAlchemy có hai mặc định cho các hàm thực thi python.

• default đặt giá trị trên INSERT, chỉ một lần
• onupdatecũng đặt giá trị cho kết quả có thể gọi được trên CẬP NHẬT.

Các defaulttham số từ khóa nên được trao cho các đối tượng Cột.

Thí dụ:

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

Giá trị mặc định có thể là một cuộc gọi, mà ở đây tôi đã định nghĩa như sau.

from pytz import timezone
from datetime import datetime

UTC = timezone('UTC')

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

Theo tài liệu PostgreSQL, https://www.postgresql.org/docs/9.6/static/fifts-datetime.html

now, CURRENT_TIMESTAMP, LOCALTIMESTAMP return the time of transaction.

Đây được coi là một tính năng: mục đích là cho phép một giao dịch duy nhất có một khái niệm nhất quán về thời gian "hiện tại", để nhiều sửa đổi trong cùng một giao dịch có cùng dấu thời gian.

Bạn có thể muốn sử dụng statement_timestamp hoặc clock_timestamp nếu bạn không muốn dấu thời gian giao dịch.

statement_timestamp ()

trả về thời gian bắt đầu của câu lệnh hiện tại (cụ thể hơn là thời gian nhận thông báo lệnh mới nhất từ ​​máy khách). statement_timestamp

clock_timestamp ()

trả về thời gian hiện tại thực tế và do đó giá trị của nó thay đổi ngay cả trong một lệnh SQL.