Skip to main content

Interface: AdvancedRunQueryOptions

For AI agents: see llms.txt for the complete documentation index. Markdown versions are available by adding .md to a page URL or requesting Accept: text/markdown.

server.AdvancedRunQueryOptions

Properties​

transactionLimits​

• Optional transactionLimits: TransactionLimits

Custom limits for a nested transaction. Each field specifies the absolute maximum allowed for the nested function call. Values are capped at the global transaction limits, so they can only lower limits, never raise them.

Defined in​

server/registration.ts:1245


useStaleSnapshot​

• Optional useStaleSnapshot: boolean

Run a query on a recent snapshot of the database that is not guaranteed to be up-to-date when this transaction commits.

This is an advanced feature which can introduce subtle race conditions, so its use is generally discouraged except for specific use-cases where database read conflicts are expected, e.g. reading from an append-only table with immutable records where the only read conflicts are from concurrent appends.

To determine the snapshot of the nested query, you can call ctx.meta.getSnapshotTs() from within the stale snapshot query. To compare to the parent mutation's snapshot timestamp, you can return that value from the query and call ctx.meta.getSnapshotTs() from the parent.

Defined in​

server/registration.ts:1261