Skip to content

PG19: use ShareUpdateExclusiveLock for REPACK CONCURRENTLY - #8805

Open
ibrahim halatci (ihalatci) wants to merge 1 commit into
mainfrom
ihalatci-pg19-repack-lock-fix
Open

ibrahim halatci (ihalatci) wants to merge 1 commit into
mainfrom
ihalatci-pg19-repack-lock-fix

Conversation

@ihalatci

@ihalatci ibrahim halatci (ihalatci) commented Aug 27, 2026 •

Copy link
Copy Markdown
Contributor

PG19 RC1: match PostgreSQL's ShareUpdateExclusiveLock for REPACK
(CONCURRENTLY), avoiding a preprocessing lock escalation that can mask the
unsupported distributed-table error or hang repack on a local table.

Native stack layer 2: #8929 -> #8805 -> #8807.

Validation (Ubuntu 22.04 WSL under /home/ihalatci/Development):

  • PG_CONFIG=.../postgresql-install/bin/pg_config ./configure && make -j8 && make install with PostgreSQL 19rc1: passed.
  • PATH=.../postgresql-install/bin:$PATH src/test/regress/citus_tests/run_test.py pg19: all 7 tests passed, including pg19.
  • PG_CONFIG=~/.pgenv/pgsql-17.10/bin/pg_config ./configure && make -j8: passed.
  • PG_CONFIG=~/.pgenv/pgsql-18.4/bin/pg_config ./configure && make -j8: passed.
  • citus_indent --check --quiet: passed.
  • git diff --check 7259ac9c94e9a6595eac092b18afc47b69197d4a..HEAD: passed.
  • make check-style: black and isort passed; flake8 reached pre-existing naming violations in unchanged Python files, unrelated to this C/SQL-only diff.

Fixes #8756

@codecov

codecov Bot commented Aug 27, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 88.81%. Comparing base (c7634e3) to head (33f3457).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #8805   +/-   ##
=======================================
  Coverage   88.81%   88.81%           
=======================================
  Files         290      290           
  Lines       65455    65456    +1     
  Branches     8255     8255           
=======================================
+ Hits        58132    58137    +5     
+ Misses       4938     4937    -1     
+ Partials     2385     2382    -3     
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@ihalatci

Copy link
Copy Markdown
Contributor Author

Beta 4 disposition: retained and still relevant. Please rebase onto current main and refresh the PG19 lock-contention regression; this PR should remain independent of the closed eager-aggregation stack.

@ihalatci
ibrahim halatci (ihalatci) changed the base branch from main to ihalatci-postgresql-19-rc1 October 16, 2026 08:38
@ihalatci
ibrahim halatci (ihalatci) added this pull request to stack #8930 October 16, 2026 08:52
Base automatically changed from ihalatci-postgresql-19-rc1 to main October 16, 2026 11:15
ibrahim halatci (ihalatci) added a commit that referenced this pull request Oct 16, 2026
DESCRIPTION: Update PostgreSQL 19 CI and regression coverage to RC1

Update build, nightly cassert, and pg_upgrade image pins to the
published PostgreSQL 19 RC1 release images from merged
citusdata/the-process#253 (image suffix `-va0a5582`). The stable image
publication succeeded for merge commit
`a0a5582b39e72cec476f7b6ba37a2cf97572b930` in [the-process
build-test-images
run](https://github.com/citusdata/the-process/actions/runs/38888435235).
Preserve the existing exclusion of PG19 from Citus upgrade coverage.

Add a distributed `ON CONFLICT` regression for PostgreSQL's fix to
inference when an index expression on a NOT NULL column simplifies to a
Var ([upstream
commit](postgres/postgres@f9ccc5e)).
No Citus source change was indicated: the regression fails on PostgreSQL
19 Beta 4 and passes on RC1.

## RC1 feature audit

The audited upstream range is `REL_19_BETA4`
(`b73d13c32c834a2c8e1c60cb92f79530376cedf1`) through `REL_19_RC1`
(`0b8bff042a997fe50fcd1c4c83b9ef1cc9ed8a89`): 132 commits and 300
changed paths, with no feature-revert commit.

The Citus umbrella features remain present in RC1:

- REPACK / REPACK CONCURRENTLY: #8756 / #8805 remain relevant.
- EXPLAIN IO: #8770 / #8807 remain relevant.
- Constraint enforceability: #8758 / #8808 remain relevant.
- JSON COPY: merged #8760 / #8765 remains compatible with RC1.
- Distributed REPACK CONCURRENTLY support: #8772 remains a design-only
exception without an implementation PR.

The approved dependent topology is:

- native stack `#8929 -> #8805 -> #8807`;
- #8808 as an independent sibling based directly on this branch after
removing unrelated DETACH changes.

Version-neutral #8759 and #8762 are no longer subissues of #8782.

PostgreSQL RC2 is scheduled for 2026-11-12 and GA for 2026-11-19. RC2
must be rechecked for the open upstream eager-aggregation and
CHECK-enforcement items before final PG19 feature completion.

## Validation

Local validation on PostgreSQL 19 RC1: `pg19` (7/7), `multi_upsert`
(7/7), `multi_insert_select_conflict` (7/7), `multi_copy` (15/15),
`multi_outer_join` (7/7), `multi_deparse_shard_query` (7/7),
`multi_deparse_function` (7/7), and `multi_join_order_additional`
(16/16, with base schedule and whole schedule line). `merge` also passed
on Beta 4 after installing the missing `postgres_fdw` test dependency.

The repartition planning/pruning/task-assignment debug task-ID output
differences reproduce on both Beta 4 and RC1; no expected output was
changed for them.

The prior Citus head `7259ac9c94e9a6595eac092b18afc47b69197d4a` passed
all automatic checks. This suffix-only update switches CI to the
successfully published stable RC1 images; checks for the current head
will run after this update.

---------

Co-authored-by: Ibrahim Halatci <ihalatci@microsoft.com>
Copilot-Session: f2aeb1f7-5872-4dc8-a288-2bdafcf80c04
PreprocessClusterStmt resolved the target relation with
AccessExclusiveLock unconditionally.  That is correct for CLUSTER and
for plain REPACK, but PostgreSQL deliberately runs REPACK
(CONCURRENTLY) under ShareUpdateExclusiveLock (RepackLockLevel() in
repack.c).  Taking the stronger lock has two consequences:

  * On a distributed table, a session holding only AccessShareLock
    makes Citus block on AccessExclusiveLock, so the intended
    "CONCURRENTLY is unsupported" error is masked by a lock wait.

  * The lock is taken before the !IsCitusTable() early return and is
    held until end of transaction, so on a plain local table the
    repack decoding worker cannot lock the relation to export its
    logical snapshot and the command waits forever on
    RepackWorkerExport.

Resolve the relation with ShareUpdateExclusiveLock when CONCURRENTLY
is requested and keep AccessExclusiveLock for every other case, so
ordinary CLUSTER and REPACK locking is unchanged.

The unsupported-feature guard for distributed tables is retained; this
commit only stops it from being masked.

Add PG19-only regression coverage for both paths: a distributed table
whose rejection must not be masked by a concurrent reader, and a plain
local table whose REPACK (CONCURRENTLY) must complete.

Fixes #8756

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 61c1aeb4-1b56-4313-a35e-d65b59a557de
@ihalatci
ibrahim halatci (ihalatci) marked this pull request as ready for review October 16, 2026 11:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

PG19: reject distributed REPACK CONCURRENTLY before exclusive lock wait

2 participants