81 lines
3.8 KiB
Python
81 lines
3.8 KiB
Python
"""轮换文档仓储。快照、纸面账本、控制、验收证据分别保存,单条SQL单表。"""
|
||
import contextlib
|
||
import datetime as dt
|
||
import json
|
||
from sqlalchemy import text
|
||
from app.db import session as db
|
||
|
||
|
||
def encode(value):
|
||
return json.dumps(value, ensure_ascii=False, sort_keys=True, default=str, allow_nan=False)
|
||
|
||
|
||
def get(key):
|
||
row = db.fetch_one('SELECT payload_json, revision FROM pms_rotation_document WHERE doc_id=:key', {'key': key})
|
||
if row:
|
||
return json.loads(row['payload_json']), int(row['revision'])
|
||
return None, 0
|
||
|
||
|
||
def put_once(key, kind, value):
|
||
"""同键只能保存相同内容;重复快照可重试,历史版本不可覆盖。"""
|
||
body = encode(value)
|
||
db.execute('INSERT INTO pms_rotation_document (doc_id,kind,payload_json,revision,updated_at) '
|
||
'VALUES (:key,:kind,:body,1,:now) ON DUPLICATE KEY UPDATE doc_id=VALUES(doc_id)',
|
||
{'key': key, 'kind': kind, 'body': body, 'now': dt.datetime.now()})
|
||
old, _ = get(key)
|
||
if encode(old) != body:
|
||
raise ValueError('同一幂等键出现不同内容')
|
||
|
||
|
||
@contextlib.contextmanager
|
||
def locked(key, kind, initial):
|
||
"""行锁内读、修改、保存同一文档;异常整体回滚。"""
|
||
db.execute('INSERT INTO pms_rotation_document (doc_id,kind,payload_json,revision,updated_at) '
|
||
'VALUES (:key,:kind,:body,0,:now) ON DUPLICATE KEY UPDATE doc_id=VALUES(doc_id)',
|
||
{'key': key, 'kind': kind, 'body': encode(initial), 'now': dt.datetime.now()})
|
||
with db.transaction():
|
||
row = db.fetch_one('SELECT payload_json,revision FROM pms_rotation_document WHERE doc_id=:key FOR UPDATE', {'key': key})
|
||
value = json.loads(row['payload_json'])
|
||
yield value
|
||
db.execute('UPDATE pms_rotation_document SET payload_json=:body,revision=:revision,updated_at=:now WHERE doc_id=:key',
|
||
{'key': key, 'body': encode(value), 'revision': int(row['revision'])+1, 'now': dt.datetime.now()})
|
||
|
||
|
||
def recent(kind, limit=100):
|
||
rows = db.fetch_all('SELECT doc_id,payload_json,updated_at FROM pms_rotation_document '
|
||
'WHERE kind=:kind ORDER BY updated_at DESC LIMIT :n', {'kind': kind, 'n': min(1000, int(limit))})
|
||
return [{'id': r['doc_id'], 'value': json.loads(r['payload_json']), 'updated_at': str(r['updated_at'])} for r in rows]
|
||
|
||
|
||
def document_ids(kind, *, limit):
|
||
rows = db.fetch_all('SELECT doc_id FROM pms_rotation_document WHERE kind=:kind LIMIT :n',
|
||
{'kind': kind, 'n': int(limit)})
|
||
return {r['doc_id'] for r in rows}
|
||
|
||
|
||
def updated_since(kind, since, limit=6001):
|
||
rows = db.fetch_all('SELECT doc_id,payload_json FROM pms_rotation_document '
|
||
'WHERE kind=:kind AND updated_at>=:since ORDER BY updated_at DESC LIMIT :n',
|
||
{'kind': kind, 'since': since, 'n': int(limit)})
|
||
return [{'id': r['doc_id'], 'value': json.loads(r['payload_json'])} for r in rows]
|
||
|
||
|
||
def stage_locked(key, value):
|
||
"""在既有行锁事务内先发布阶段,供同事务的下发闸读取;外部仍不可见。"""
|
||
if db._TRANSACTION.get() is None:
|
||
raise RuntimeError('阶段写入必须处于持锁事务')
|
||
db.execute('UPDATE pms_rotation_document SET payload_json=:body WHERE doc_id=:key',
|
||
{'key': key, 'body': encode(value)})
|
||
|
||
|
||
@contextlib.contextmanager
|
||
def account_guard():
|
||
"""只获取账户锁,不在退出时覆盖内层更新的资金保留文档。"""
|
||
db.execute('INSERT INTO pms_rotation_document (doc_id,kind,payload_json,revision,updated_at) '
|
||
"VALUES ('account-execution','funds_reservation',:body,0,:now) ON DUPLICATE KEY UPDATE doc_id=VALUES(doc_id)",
|
||
{'body': encode({'epoch_seq': 0, 'available': 0., 'orders': {}}), 'now': dt.datetime.now()})
|
||
with db.transaction():
|
||
db.fetch_one("SELECT doc_id FROM pms_rotation_document WHERE doc_id='account-execution' FOR UPDATE")
|
||
yield
|