Skip to main content

Transactions

Group writes atomically — all succeed or all roll back.

Context manager (idiomatic)​

# Auto-commit on success, auto-rollback on exception
with db.transactions.begin() as tx:
    leo = db.records.create(label="ACTOR", data={"name": "Leonardo DiCaprio"}, transaction=tx)
    inception = db.records.create(label="MOVIE", data={"title": "Inception"}, transaction=tx)
    db.records.attach(source=leo, target=inception, options={"type": "ACTED_IN"}, transaction=tx)
# committed automatically — no explicit commit() call needed

Manual commit / rollback​

tx = db.transactions.begin()
try:
    movie = db.records.create(label="MOVIE", data={"title": "Inception"}, transaction=tx)
    actor = db.records.create(label="ACTOR", data={"name": "Leonardo DiCaprio"}, transaction=tx)
    db.records.attach(source=movie, target=actor, options={"type": "STARS_IN"}, transaction=tx)
    tx.commit()
except Exception:
    tx.rollback()
    raise

API​

MethodDescription
db.transactions.begin(ttl?)Start a new transaction
tx.commit()Persist all operations
tx.rollback()Discard all operations

Timeouts​

SettingValue
Default TTL5000 ms
Maximum TTL30000 ms
tx = db.transactions.begin(ttl=15000)   # 15 s timeout

Supported operations​

create · create_many · update · set · delete · delete_by_id · attach · detach · find