feat: Per-migration transaction configuration by lourd · Pull Request #1671 · kysely-org/kysely

lourd · 2026-01-03T23:01:37Z

Closes #352

Creates the ability for individual migrations to opt out of being executed in a transaction, depending on the adapter's support for transactions, the Migrator configuration, and the options given to the migrate method.

Follows pretty closely to the Knex implementation as suggested by @tgriesser.

If transactions are enabled globally and an individual migration opts out, then all of the migrations before it are run in a transaction, then it is run outside of a transaction, then all the migrations after it are run in a transaction.

The behavior is the same when migrating up and down.

I decided that if a transaction is passed to the Migrator (#1480), it results in an error. And if any of the options disabling transactions are used, either globally or per migrate call (#1517), those take precedence.

Basically this feature only takes effect when transactions aren't disabled and the Migrator has responsibility over transactions.

vercel · 2026-01-03T23:01:42Z

@lourd is attempting to deploy a commit to the Kysely Team Team on Vercel.

A member of the Team first needs to authorize it.

lourd · 2026-01-11T21:17:28Z

Hey @igalklebanov, eager to hear your feedback!

Philipinho · 2026-01-11T21:53:05Z

Great work @lourd.

…sely-org#1494)

…ely-org#1517)

Co-authored-by: Eric So <56284867+ericsodev@users.noreply.github.com> Co-authored-by: Igal Klebanov <igalklebanov@gmail.com>

Co-authored-by: igalklebanov <igalklebanov@gmail.com>

…ely-org#1516) Co-authored-by: Igal Klebanov <igalklebanov@gmail.com>

Co-authored-by: Igal Klebanov <igalklebanov@gmail.com>

… `withTables`. (kysely-org#1582)

…fier (kysely-org#1615) Co-authored-by: Igal Klebanov <igalklebanov@gmail.com>

Co-authored-by: Igal Klebanov <igalklebanov@gmail.com>

Co-authored-by: igalklebanov <igalklebanov@gmail.com>

kysely-org#1453)

…functions, deprecate their `expression` functions. (kysely-org#1664)

…#1480) Co-authored-by: Igal Klebanov <igalklebanov@gmail.com> Co-authored-by: João Lucas de Oliveira Lopes <55464917+jlucaso1@users.noreply.github.com>

..

# Conflicts: # test/node/src/migration.test.ts

lourd · 2026-01-20T16:09:16Z

Hey @igalklebanov, just rebased on next, should be good to go here. Let me know if there's anything I can do to help making reviewing or merging easier

pkg-pr-new · 2026-01-25T14:55:15Z

kysely_koa_example

npm i https://pkg.pr.new/kysely-org/kysely@1671

commit: 1a9ef42

igalklebanov · 2026-01-31T17:40:31Z

+   * Note: Setting this to `true` has no effect if the dialect doesn't support
+   * transactional DDL.
+   */
+  readonly transaction?: boolean


If there wasn't such a strong case to keep knex naming and behavior - familiarity and lots of training data, I'd call this something more explicit and perhaps go beyond boolean.

e.g. transactionMode?: 'never' | 'shared' | 'file-scoped', where "never" means no matter what, never runs this file's changes in a transaction, "shared" means reuse or create "global" transaction (the default mode), "file-scoped" which means always commit previous transaction group if available and start a transaction just for this file.

Not for now. Something to consider after this effort.

I think that's a great idea, covers more use cases than a boolean can. Happy to make those changes, let me know!

Not for this iteration. Let's keep it knexy and minimal as possible.

lourd mentioned this pull request Jan 3, 2026

feature request: non-transactional migrations for concurrent index creation #352

Open

lourd changed the title ~~Per-migration transaction configuration~~ feat: Per-migration transaction configuration Jan 3, 2026

lourd force-pushed the per-migration-transaction branch from a65e02e to 58d73b0 Compare January 3, 2026 23:16

lourd changed the base branch from master to next January 3, 2026 23:17

igalklebanov force-pushed the next branch 4 times, most recently from a225c9f to ebcfe24 Compare January 17, 2026 20:28

y-hsgw and others added 19 commits January 18, 2026 09:25

fix: allow undefined values in Updateable type (kysely-org#1496)

136365c

feat(Introspect): add support for postgres & mysql foreign tables (ky…

debddfc

…sely-org#1494)

feat: add PGlite dialect. (kysely-org#1510)

a777837

feat(migrator): allow disabling transactions in migrate methods. (kys…

feec74c

…ely-org#1517)

feat: allow expressions in unique constraint (kysely-org#1518)

929d7b8

Co-authored-by: Eric So <56284867+ericsodev@users.noreply.github.com> Co-authored-by: Igal Klebanov <igalklebanov@gmail.com>

update lockfile.

db82875

chore: fix next branch rebase issues. (kysely-org#1584)

6aab324

feat: add thenRef method in eb.case (kysely-org#1531)

9bb951e

Co-authored-by: igalklebanov <igalklebanov@gmail.com>

Support dropping multiple types with schema.dropType(), cascade. (kys…

a915d84

…ely-org#1516) Co-authored-by: Igal Klebanov <igalklebanov@gmail.com>

implemented whenRef(lhs, op, rhs) in eb.case. (kysely-org#1598)

6b2e38c

Co-authored-by: Igal Klebanov <igalklebanov@gmail.com>

added elseRef in eb.case() (kysely-org#1601)

feb520b

Co-authored-by: Igal Klebanov <igalklebanov@gmail.com>

feat: add $pickTables, $omitTables and $extendTables, deprecate…

294e0eb

… `withTables`. (kysely-org#1582)

fix tests after rebase.

a3780b2

feat: Add support for dropping temporary tables with temporary() modi…

0474919

…fier (kysely-org#1615) Co-authored-by: Igal Klebanov <igalklebanov@gmail.com>

fix unique-contraint-node following rebase.

8030771

fix drop-type-node following rebase.

4d71670

fix slow types @ pglite-driver.

03015c2

feat: add SafeNullComparisonPlugin plugin (kysely-org#1338)

3fb00c1

Co-authored-by: Igal Klebanov <igalklebanov@gmail.com>

feat: add addIndex to CreateTableBuilder (kysely-org#1352)

c944930

Co-authored-by: igalklebanov <igalklebanov@gmail.com>

igalklebanov and others added 6 commits January 18, 2026 09:25

fix next branch following rebase.

10f70a2

fix next branch following rebase.

1e50479

feat: add more control through configuration @ ParseJSONResultsPlugin. (

9b04c83

kysely-org#1453)

feat: allow expressions in create/add index's column and columns …

d668720

…functions, deprecate their `expression` functions. (kysely-org#1664)

feat(Migrator): allow passing transactions to Migrator. (kysely-org…

b1bd9cc

…#1480) Co-authored-by: Igal Klebanov <igalklebanov@gmail.com> Co-authored-by: João Lucas de Oliveira Lopes <55464917+jlucaso1@users.noreply.github.com>

fix next branch following rebase.

2ef37b3

..

igalklebanov force-pushed the next branch from ebcfe24 to 2ef37b3 Compare January 18, 2026 07:25

lourd added 2 commits January 20, 2026 11:05

Per-migration transaction configuration

fc9207b

# Conflicts: # test/node/src/migration.test.ts

Let disabling options take precedence

1a9ef42

lourd force-pushed the per-migration-transaction branch from 7ba0d09 to 1a9ef42 Compare January 20, 2026 16:06

igalklebanov reviewed Jan 31, 2026

View reviewed changes

igalklebanov force-pushed the next branch 3 times, most recently from f0934fe to a859b43 Compare February 1, 2026 16:34

igalklebanov added enhancement New feature or request migrations Related to migrations labels Feb 1, 2026

mattkrick mentioned this pull request Feb 4, 2026

feat(SCIM): user endpoints ParabolInc/parabol#12530

Merged

9 tasks

igalklebanov force-pushed the next branch from a859b43 to 362a67a Compare February 8, 2026 00:13

igalklebanov force-pushed the next branch from b751905 to 93caa7b Compare March 20, 2026 22:04

igalklebanov force-pushed the next branch 3 times, most recently from 63af1a3 to 0cf6dcb Compare April 4, 2026 20:47

igalklebanov force-pushed the next branch 2 times, most recently from ca8e49a to 9f037a2 Compare April 12, 2026 08:52

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Per-migration transaction configuration#1671

feat: Per-migration transaction configuration#1671
lourd wants to merge 27 commits intokysely-org:nextfrom
lourd:per-migration-transaction

lourd commented Jan 3, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Jan 3, 2026

Uh oh!

lourd commented Jan 11, 2026

Uh oh!

Philipinho commented Jan 11, 2026

Uh oh!

lourd commented Jan 20, 2026

Uh oh!

pkg-pr-new Bot commented Jan 25, 2026

Uh oh!

igalklebanov Jan 31, 2026 •

edited

Loading

Uh oh!

lourd Feb 1, 2026

Uh oh!

igalklebanov Feb 1, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

12 participants

Conversation

lourd commented Jan 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel Bot commented Jan 3, 2026

Uh oh!

lourd commented Jan 11, 2026

Uh oh!

Philipinho commented Jan 11, 2026

Uh oh!

lourd commented Jan 20, 2026

Uh oh!

pkg-pr-new Bot commented Jan 25, 2026

Uh oh!

igalklebanov Jan 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

lourd Feb 1, 2026

Choose a reason for hiding this comment

Uh oh!

igalklebanov Feb 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

12 participants

lourd commented Jan 3, 2026 •

edited

Loading

igalklebanov Jan 31, 2026 •

edited

Loading

igalklebanov Feb 1, 2026 •

edited

Loading