agora inbox for [email protected]  

help / color / mirror / Atom feed

[PATCH] Rework warning about column list combining
1288+ messages / 3 participants
[nested] [flat]

* [PATCH] Rework warning about column list combining
@ 2022-12-19 15:33  Alvaro Herrera <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Alvaro Herrera @ 2022-12-19 15:33 UTC (permalink / raw)

---
 doc/src/sgml/logical-replication.sgml | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/doc/src/sgml/logical-replication.sgml b/doc/src/sgml/logical-replication.sgml
index 7fdf08b59d..e5692531c2 100644
--- a/doc/src/sgml/logical-replication.sgml
+++ b/doc/src/sgml/logical-replication.sgml
@@ -1303,40 +1303,36 @@ test_sub=# SELECT * FROM child ORDER BY a;
    Column lists have no effect for the <literal>TRUNCATE</literal> command.
   </para>
 
   <para>
    During initial data synchronization, only the published columns are
    copied.  However, if the subscriber is from a release prior to 15, then
    all the columns in the table are copied during initial data synchronization,
    ignoring any column lists.
   </para>
 
-  <sect2 id="logical-replication-col-list-combining">
-   <title>Combining Multiple Column Lists</title>
-
-   <warning>
+   <warning id="logical-replication-col-list-combining">
+    <title>Combining Column Lists from Multiple Subscriptions</title>
     <para>
      It is not supported to have a subscription comprising several publications
      where the same table has been published with different column lists.
      This means changing the column lists of the tables being subscribed could
      cause inconsistency of column lists among publications, in which case
      the <xref linkend="sql-alterpublication"/> will be successful but later
      the walsender on the publisher, or the subscriber may throw an error. In
      this scenario, the user needs to recreate the subscription after adjusting
      the column list or drop the problematic publication using
      <literal>ALTER SUBSCRIPTION ... DROP PUBLICATION</literal> and then add it
      back after adjusting the column list.
     </para>
    </warning>
 
-  </sect2>
-
   <sect2 id="logical-replication-col-list-examples">
    <title>Examples</title>
 
    <para>
     Create a table <literal>t1</literal> to be used in the following example.
 <programlisting>
 test_pub=# CREATE TABLE t1(id int, a text, b text, c text, d text, e text, PRIMARY KEY(id));
 CREATE TABLE
 </programlisting></para>
 
-- 
2.30.2


--auwwwptwfs2pqkb5
Content-Type: image/png
Content-Disposition: attachment; filename="combining.png"
Content-Transfer-Encoding: base64

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
GEw2C07EMHSxm3RuJ0dFua6kIufiHem0Yv99Oa4STOFwlWAKk/1Pk6vIzH0WcYbJZk34ayse
ZQAA6Nlbuu1dRcozNzmluabeyN3eyG1oc0193vVHUqkkrW4QBpPJUVHu1sdgUNAUv5sRHJ5y
RsyV3KsPyWL0zKtp1Sc9OrG5pl6kYv86V0g3+Ee/CDRzYzCZo7d/BwC4/Ut4c+3/K9ZcU39n
40EAgMuO7xnM/6/ea9eubWlp2bBhAy0ri6ekpAQA0JVnwxKRYc45n8+fPXu2mpqaHNW4fv16
Y2OjcLqzs/OIESPkeKGOp4tY+D8Cg8Hg/Q38RkBJSQkeKioqkoStrKxevXpF8QXByRMnAABr
1qzBowwAAD6f/+23y6dNmyYszxMFk/mvDpTJZLLZbAUFBSMjox9/XA0/izhy+DD8VVlZWfhc
xb+LAOmyT+DS8pm2enFqdwW6sm5fMObm5lOnTqXv6pOSktpVn88X4b6vi9uqA5yVtLWrPaiu
rn7w4IFwOqn44sQQCIl05vaWRBhMZq+RtiVPX1e9KZBLhjw9Ta2BZoV3nlW+zpVLhiReRp3H
BAKTcU4aZpIfO3MSbgEAjN2HYQJBWuT57IRbxmOGtYdW4lA30rOaPf7x3pPP/zhr6GInQw4D
F0y8/M2W9OiL1gu60MvYno7Wfae6ZZy6nLLjmMPaeQCAh9uj6koq+k0fg0+ZAQD069dv+PDh
MTExu3bt0tCQMHdGJHV1dcnJyXC62okTJ54+fQoAWLZsmbGxsbAwhmE3btyIj4/PzMxsamoy
MDCYOnWqu7s7Rf537949derUpk2bGhsbd+7c+fDhQwaDYW1tvWjRImJcIyMjIywszMvLy83N
jXj6w4cPo6Ojp02bZk94aoJPX7GxsWfOnCkpKdHW1vb19fX19ZWoxqxZs0gTxS9fvhwXF/f2
7Vv44ZyXlxd8kwwAKC0tPXny5L1790pLS7lcrp2dXWBgIFyyqLW1NT4+Pjg4GACwd+/eM2fO
AADs7Oz8/PwAAOvWrVNWVv7xxx+JFyoqKjp06NCTJ0+qq6sNDAwmTZrk4eFB7IahhqGhoQ0N
Dfv3709JSfn06ZOpqemcOXPs7KgqdmRk5Pv371etWpWenr579+6srCwej+fk5BQYGKiiooKL
JSQkXLlyRfjORkdHP3z4cM2aNT169CBauK6u7o8//rh58yZUY/bs2cRp+XQsXF9fHx0dfePG
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
Rp06dapr165Tp061trbW0NDIz89PTk7OyMggN9aMjY137ty5cOFCd3f3JUuWmJmZpaen79q1
6+XLl7/88ovYSf6I2bNnHzhwYMGCBWlpaU5OTqWlpdHR0Q8ePOjRo4cCMzu0poMHD0ZERIwa
NYp6O92ePXtqamrmzp1LMvTs2dPQ0PDYsWNubm5ubm65ublTpkyRupRiHBwcLC0t4+LiVq9e
PWTIkKKiori4uHPnzvn4+MTHM2/Mzp49+4svvigoKPj0008Z74DYtm1bfHz8d999l5SUNGbM
GC0trby8vKdPn54+fVrC7X0Zbdq06dKlS4GBgUlJST4+PgBw+fLloKAgCwuLrVu3NrWUqanp
rl27AgMDnZycFi9ebGdnV1FRkZmZefHixSFDhijwvMnEiRNnzJgRFhbm7u4+Z84cExOTwsLC
1NTUU6dOBQUFkfdEBgQEREVFRUZG5uTkTJ06VVtbOysr68qVK9u2bXNycgIAb2/v06dPz5kz
Z+3atQDQuXNnki6LcePGTZkyJSQk5P379zNmzNDR0UlKStqxYwebzT506JDYiQ+lak55lL6H
ZbFy5cq//rq8e/euz5cs0dXV9fPzc3Z2TkpK6uXmOnnyFG0d7aSHD2NiYlgs1voNGyWsZ+Zn
M9evW1dTU8NI/27Nmrv37ibcuOHo6Dh50mSLbhaFBYUXL154/Phx3rt8AIiLjRMKhX369hWN
Ygz9dOhvv+08Gxe3e/ceeQ9HdXV1P/e+oulr1q4VnbSS+OWXX+Lj4xctWnTnzp3BgwcLhcLU
1NSrV6+SMSYtUVuURa5mRyp3d/dp06ZFREQMGTIkMDBQX18/OTl5x44drq6u9LXl5uYOHz5c
KBQaGBgMHjxYqV8IIYQQQuij1DZv1RQKhUJhZWXl9u3bGRP16+jozJ49m57t+PHjZC50onv3
7pGRkfQML1++BIC5c+fSE8PDw+lzmw8fPvzNmzf+/v4mJiZUHvImdsbayIPNkydPZpTW29ub
w+FIXlYoFK5fvx4AyKBlsciC1PvbSeEDAwPJn7dv33ZxcaHvEEtLyyNHjtDXcO3aNeqr6enp
ybgUw+TJkwEgNzeXke7l5UX/ms+ePaNfW3p4eDx+/PjgwYP0PERhYSGZ+C0mJkZ0c6WlpYsW
LaJffXXo0IFxoBkMDQ2tra1F0wHA29ubsWl/f39qdjcyhiIvL0/CyomzZ8+6ubnR91uvXr0u
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
3f369etpaWmrV69Wb7xflSmE3uA9PT1lR7wn8u64bHIHwDcyMlLZaqNoBUWhFYvFynfIaNeu
3YMHD86dOxcaGrp3795du3b5+vru2bOHPaq2Rq6JogJKZZ5VnrWVpy4ik55VknupdXR05K7M
Z0YDPkl69OjRycnJYWFhu3fv/uabbzZt2rR06dINGzbITcO0y/r58+fd3NyGDx/u6Ohoamr6
+vVr+qU0m9xyjEbW6NGj+d9kq6urq6qqlMRUrfK4olxAZBp8maNXVlZaWlrKfl1FWNOSq53A
6ojnuVtbW3fs2JF+0XDnzp3MzEza2XvMmDGrV6+Ojo5u37791atXRSIR00LKM6ZmzZq1fPny
M2fOTJw4saCg4Ny5c97e3syXffyjm396qG88C5y2bdtyPnygOB8fsSmviigit0xQWfYaGRkd
O3bs4cOHv/7665EjR06fPt25c+dDhw7RpzueNRb+kaIyPPWdEpSfb63UvQImt8RWYwIatWvm
mip7eSZ1PvVD5fd6NcLGkL2wcstzPnuu1a2kLkWWxmsOKpmbm48bNy40NDQuLk7t7+waUVNs
aPjvf/9LCJk4caLy1Wr1zZJ6zMzMzp4926NHj1u3bt27d6958+aLFi1asmQJMylXo7t169a6
devoMxJTK63V5wyEENqwl5WVJftTUVER89hQVlY2depUkUh0584ddvvizz//XK/htLa2Xrdu
3Zo1a6KiopYsWeLn52dra0s/KrGwsPD19f3tt9/evn1bXV198+bN6dOny83/StCvNhS9ytAI
mmCys7M5r8jevn3LBKCOoqOj9+7du3DhwmHDhrGX1yXWOHR0dExMTOj81RwaPBE25rrJPaKh
oaHy6Rj5mDdv3vbt2w8ePOju7h4ZGSkQCJgXehpHe8QMHTpU7ttO5fLy8mQXvn37VuUstorK
yfz8fE7TBn2HwGmlUk4gEIwaNWrUqFEpKSlfffVVZGRkaWnppUuX+O+BzzVRVEDRV/FKMFmb
PQsXQ3nqIrVPzw1wS5LLwMAgMDAwMDDwzp07n3766ebNm5s1a8aZwY4KCQk5f/58YGDgzp07
mReGv//+O88D0cgKCgpS8ukNh7a2tomJiZLStVZ5XG4uoAlDbrqlg4oTQuhUMoowCYxpeqBU
JrA64n/uQ4cODQkJef78eXR0tEAgoDMOdO7c2dHR8cyZM6tWrYqJienduzfTTYlnTE2fPn3V
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
jIwSEhIaOyDASxMp3gGgCaINDWFhYdOmTWvssLxn3r17Z2FhsWnTplWrVjV2WHhpQoNBNjV0
fJr09HTO8pycnGvXrtnY2PB5dwT1raio6LvvvrOyslLZux6alIqKCiMjo2XLljV2QMiOHTve
vn376aefNnZAAAD+DZpO8Q4A8G/y6tUrDw8PTY2G3gAaczDIJm7mzJkHDhzw9/dfsWJFt27d
DAwMcnNz7969u3v37ry8vKioqEb8VhYyMjIeP36cnZ29bdu2rKys//73vw3QmwY0SE9PLzY2
thEDcO3atYqKiuvXr2/btq19+/Z0dEAAAKijRi/eAQD+lTw8PN6v0hUNDQr17dv3woULX3/9
9eeff84sbNas2dChQ1etWsUZ9QQaWFxc3OjRowkhRkZGISEh9TFBEfy7rVixgs7h3KdPn8jI
SDRUAQAAAABoCsZoUK2oqCgjI0MikZiamlpbW9f3nJrAR01NTVJSUlVVVevWrTU4BAt8OPLy
8tLT083MzOpprDJNqaqqevnypZmZGUaEgQ/ZixcvhEKhetOeAQBA05Gfn5+RkWFnZyd3XFX4
N0FDAwAAAAAAAABoDEYZAAAAAAAAAACNQUMDAAAAAAAAAGgMGhoAAAAAAAAAQGPQ0AAAAAAA
AAAAGoOGBgAAAAAAAADQGDQ0AAAAAAAAAIDGoKEBAAAAAAAAADQGDQ0AAAAAAAAAoDGitWvX
NnYY/r9Dhw49f/68Y8eOjR0QFX7//ffLly+3b99eR0eHEBIfH3/8+HETE5MWLVrUaj90w+bN
m5uZmdVPSOuqoKDg4MGDpaWljo6OjR2Wpq7JxiZNrm5ubtra2kpWUzsZg9rCw8OfPn3aqVOn
Wm1VWXLlxAAAIABJREFUVFR04MAB5EoNUruge/78+W+//YZc877cuwGarPerusWpBgMAyNW0
vmhYsWLFN99809ihUG3v3r1BQUH5+fn03z/++CMoKOju3bu13Q/d8N69e5oOoMZkZWUFBQWF
hYU1dkA04PLly506dYqJiamn/TfZ2KTJtbCwUPlqaifjD0pGRkaPHj1++OEHjext1apVq1ev
ru1W2dnZGs+VmzZt6tWr19u3bzW4T0XUzonjxo2bNGmSytXUOBe1C7o///wTuYY0vXt3g6Xn
+r6tNP0AKKHZ0vJf7/2qbnGqwYhrAJCr0RoaHjx4oPLJ598kNzf38ePHjR2KD9qtW7eePHly
69atuu+qUWIzMTExNTW1gQ8KHC9fvrx///7FixcbOyAadunSpXv37r169aoBjqVeTqyqqjp3
7tzp06dramqYhXIzRUOei3qqq6v//PPPxg7Fv1l9pAG5xb4GbyvqafQAKPFvLS1BlhpxjSoN
wIdAq1GOWlZW1qdPn4sXLw4cOLBRAtDwfvzxxz///PP69euNHZAP15IlS5ycnMaPH1/3XTVK
bM6YMcPHx6dJ9XX6AHl5eR0+fLhHjx6NHRAN271796NHj/r27dsAx1IvJ+ro6Fy+fFlLS0sk
EjEL5WaKhjwX9dy4cWPIkCFSqbSxA/KvVR9pQG6xr8HbinoaPQBK/FtLS5ClRlyjSgPwIWic
hobr169XVlY2yqEby+XLlw0MDBo7FB80U1PTmTNnamRXDR+bRUVFd+/e9fHxUXsPAoFAg+H5
YAmFwilTpjR2KDSvXbt27dq1a5hjqZ0TBw0axP5XUaZoyHNRz+XLlxs7CP9y9ZEG5Bb7Gryt
qKfRA6DEv7W0BFm1jeu6V2kA4L3Q0A0NNTU1Z86c2bBhAyHkl19+OXXqFCGkV69e/v7+dAWh
UEgIuXbt2tGjR1NSUkxNTQcOHDhr1ixdXV3Oru7du/ff//43ISHB0NCwT58+AQEBJiYmzK+H
Dh3Kzs5evnz5q1evQkND4+PjBQJBt27dgoKCbG1tlQcyJyfn6NGjt2/fzsnJMTAw6NWrV2Bg
oNpjfaWmpu7Zs+f+/futWrX6/PPP6cI1a9YwQwYKhcL8/PzQ0NAHDx6UlZW1bdt25syZXbt2
5ewnLS2NvqWpqanp2LFjYGBg69atVR796dOnYWFh8fHxlZWV1tbWffr0mTlzJjMoYGlp6eHD
h2NiYt6+fduyZcvBgwdPnTpVX19fyQ5//PHHtLS0bdu2cZZ/++23EomEaZyOjY2NiorasmVL
fn7+zz///PDhQ21t7X79+gUFBRkZGRUWFu7Zs+fmzZtisdjV1fWzzz5jj37EP+4eP3588ODB
xMTE8vJya2vrrl27+vr62tvbyw05DdKMGTO6detGl6xZs6Z79+7jxo2LiYmJjIxMTk42Njb2
8vKaO3euonYETcVmSUnJwYMHb968mZ+f7+jo+Mknn/Tr10/RNb937973338vFosvXrxYUFBA
CDEzM1uzZg39lWdy1dXVvXfv3sGDB5OSkgwMDAYNGjRnzhzlcV3bcFIVFRXR0dFXr15NTU0V
CoXt27cPCAho3749swKNiE2bNmlpaW3bti0mJkYkEv36669Meq6PpJ6ZmXngwIG4uLiioiJ7
e/sJEyYMGzaM3fhCQ7Vx48bKysrt27f/9ddfAoGgS5cuCxYscHBwYFbLzs7etGlT3759OYMF
KC+OCCFSqfS33347efJkTk6Oo6Ojr6/viBEj2C/nFSkrK9u9e3dMTExVVVW7du3kJs5a5Uq5
V/7QoUMPHjxYv359s2bNmNMMCAhwdXUNDw+/cuVKVlZWq1atxo4dKztKwpUrV44cOZKcnCwQ
CBwdHZlE5ePjM27cONkz4uRE/sdas2aNvr7+l19+SZRmCs650It/48aNM2fOvHjxoqqqyt7e
fvLkyUOHDlV58TnS0tL+85//xMXF6evrd+3adeHChXJj8Pnz51FRUY8ePSoqKjI3N/f29p45
c6aWlhYhpLi4OCws7NChQ4QQpgDx9/fv1auXeuGUSqWXLl06efJkamqqlpaWjY1N//79R40a
JZFI1q1b17Zt24ULF3I2uXXr1rFjx8aOHTto0KBa3Sjfvn0bHh5+586d/Pz8li1bdurUac6c
OS1btqS/8rl3Hzp0KCsra8WKFVlZWRs3boyPjzc3Nz969Cj9VSKRXLhwgZ6LkZGRu7v7nDlz
rKys2GHgWWhz0sAvv/ySkJAge/WYolv5lVdS7MveVjR7IirJBkAsFh86dOjixYtZWVmGhoZO
Tk40agghQUFBbm5uzN25oqJi586d9+7dKy4ubtOmzaxZs2g6ZFNZSaD5d/bs2Z07dz5y5Mjh
w4dLS0sXL148evRo2dKS/1k/e/Zs3759jx8/Li8vt7Oza968OV3u4ODwxRdfyL0UKrMPn6Lm
8OHDd+/e/eyzz5ydnTn7X716dXV19ebNmxW12jdWdYvJxQ8ePNizZ09iYmLz5s3Hjh3r5+cn
EAgSExPp/dTIyKh79+6LFy82NDRkdlWXqjKbbFyXl5dHRkbeuHEjMzPTxMTEwcFh2LBhgwYN
0tbWVlJ6K9mKf2AAoAmRNqzk5OQuXbpYWloSQpydnbt06dKlS5fVq1fTXy0tLd3d3T/99FOR
SOTu7j5o0CBaienZs2dFRQV7P3TcqRYtWvj4+Hh4eAgEAicnp1evXjErfPzxxy1atDh69KiW
llaHDh18fHzatGlDCDE1NX369KmSEGZlZeno6GhpafXs2XP06NH0Acne3j47O5u9c0JIWloa
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
pVJdXV25HxBqUB1jc+rUqXp6emvXrpUdI03JDuVmmVol19DQUPZFS0xMPHHihKOjY69evTQV
Trnh+fXXX2X3oEh9JHU62xzn2/WnT59GRES4uLjQqTcYJ06cSExMZP4tLi7evn27SCSSHUuS
4lMcGRsb+/j4vHjxgjPoF+02rwSdDj0iIoI9QoRYLKaDxrM1Yq48f/68iYlJ/XV8UILnfURf
X7+8vJzdEvTw4cPaDsBGZ+ALCQlhdzXKzMw8fvw4ezXZLFBcXBwSEsIn5GqEU7bfk0gkqqmp
YUdHs2bN/Pz8Ll68eOTIEYFAQOdDqS06JOrKlSvr6eM+T0/Pzp07R0RExMfHs5fTyXrpnHx1
QZ+3J0yYILebPZ8rz7PY1/iJnD17Njg4+M6dOzzXT01Nffr0qew4CGpQu5JQd+fPnxcIBJzR
c5XTSDZnCwgIEIlEkZGRly9fnjRpkpIi7l9f3VKDbNFEiw7mMsotA1VulZubu3PnzqSkpHoI
MgDUi8bpOjF48GCBQLBu3TpjY2MrKyuxWCw7JL4SW7ZsiYmJ+frrr+Pi4saOHdusWbOsrKzH
jx9HR0fX8ZXLqFGjVqxYsWHDBl1dXTc3t9TU1L1795aXl7du3bouuyWEeHt7nzhxYt68eVOn
Ti0oKOjTpw9n3GMlJk2aNG3atPDwcE9Pz9mzZ9vY2OTm5iYlJZ06dSo0NFTRF2Xbtm2LiYlZ
sGDB7du3Bw8eLJVKk5KSrl27RpvVra2tf/zxx6CgIE9Pz88++8zBwSElJWXHjh3Pnj3btm2y
SeXAAAAgAElEQVSbg4ODosDMmjVr79698+fPT05O7tq1a2FhYVRU1P37911cXOpvYg5Zr169
Gjt27KRJk3r16mVmZpabmxsVFXXr1q358+fLHRdas+oSm/b29jt27AgMDOzatevChQvd3NxK
SkrS0tIuXbo0ZMgQ5oNnjo4dO1paWv722289evTo0aPHmzdvpkyZwj+5NmvWrLS01MfHZ86c
OZaWli9evNiyZUtNTc3PP/+s6HKpEc7OnTs7OzufPXv2yy+/HDJkSF5e3tmzZ8+fP+/j4xMT
E8Pn4tRHUh8/fvyUKVMOHTr07t27adOmmZiYxMXFhYSE0HHFOW93O3fuPGDAgKVLl7q5uWVl
ZW3fvj0hIWHFihVK+gbzKY62bt168+bNadOmffHFFx4eHiUlJadPn46JiVFesOjr62/dunXe
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
71ZiSQ6NBAAFfQ3LMR5iI/ODu2ZgN7Kam7Yiq+BL3GsAaOflaNTLmi7DZNXVv+NyavhDkf72
xpt2//mPLqvmm31BQV+TeOk1ReXpD14AQIchrgI9RIqFLicNLeoaAJDXVce+YHtqWkxFVkFB
0icAsBjZm8fKgNFtxmDMgvAxnPexhC4r7bx2GgBkPX2beP42f1oEAvHbgVY0IP50vLdupVKp
iY8eGeh/XaZYWFSUl/+vxyYPN7fTR44MHzQI8z9fV18/aPTo2/fuxT5+zO3Y/1pYmFXnzp9e
v8YmlhMSE3v26zd3yRISiRQWGoqtLi4rL/cYMuTqrVvxCQnWVl/3QK7dvPn2vXub1679e/Fi
7M1q+7593lu3bt61a+u6dfwCb/P23rR6NVNDo7uVFb+Phh0bNuhoaVmYf932eTcy0mvkyM27
dt29epU72qadO3dt2rRg1iwymQwAMY8eDRw9etz06cnPn8vKCHa21Fw5cU4HBHj16XP78mVs
Ki83P7/XgAGHT5yYN2MGvpZYbCMfPn48LT092N9/6DcnArV1dQmvX+vp8PrZ5iY+IaGyqir1
xQssWm1d3bR580KvXbM/dmzxvK8rXa+FhW3etWuIl9fpI0ewuj+IjfUcMWLynDmxd+4Qj4Mx
YebMLWvXLl2wAGuiJ8+f9xo48G9v77EjRpCFz8+XlpX9tWJF+KVL2MJ+DoezZffuTTt3zl60
6BbXyxhxTp07N2Lw4EcREdika1ZOTr9hw1asW+dgZ4crnmgINvhKb+/rFy/26dUL++lz+PBK
b+8N27cHnDiBhWTl5IyfMUNXR+fGxYvYQSeZ2dm9Bg6cOm/em6dPMcd4j589W7Vxo7GhYcS1
a1j+NbW1k2bNOhcUJEw8CoXi1rPn1Vu3snNzdbS++hW7euuWmYnJx8+fb9y+3cXSEguMjI7m
cDi4hNzcuXLlfnR0v2HDZk2dKtDLgNja8TPzr78+fPq0dd26lYsXYyFRMTFDRO5J2bt1KwBM
njMnMCQkLDQUXzIwaujQsxcuTF+wYMOqVdy7Wohr45R586QYjNT4eO5VMASTF5eUzF2yBNdJ
vPobd+zAzuwQ23o8LXn11q2pEybs2bJFXk4OAErLyvC37qDLl7fu2dPfw+Pc8ePYworikpKx
06at27LFvF07gUuQmkuLr88AcD083MTIKOX5c2wPS31Dw6RZsy7fuOEfGDh3+vSWySPivjN8
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
UN9qRo8YwVtoM3Kkl49PeGQk38KLnJ2XrFp1MihogbPz1wjm26Sro+Ps4ODl4+MXEDDc0rKh
xepterF2Lx/JNr1ka+M7syROrBOwmd8tv94p0+hlUqMfcwDQZOjRAD+64uJiLx+fhEePlq5e
7TB//qOkpLdpaZUfP1L/vRYe3tvUdM++fYVFRbW1tft9fY0GD74SGspbw9vUVNNhw5wXL6a+
n99/+HDXP//cu3+f+u9hf/+LV6+eCAoaMnp0SEREZnZ2bl4evWJ/C4sVv/+e8vq1tLT0lZAQ
yzFjNm7bxlv5hatXe5uZ7fbyKiwuZrFYd2JiFq5YMfHTwFrhkZGHAgKovP7tmBjqJ/f9e9Hr
5+Xi5vYwOZkQkv7uHVVVXEIC/V8Fefnl69aNnjz5YWJiTU3NraiopatXW9rY8PWodNuxY+Dw
4UHnz9fV1WXn5q7buNHY0vJNampDG83Lz+9jbr5g+fKnL17Iy8unvXt36OjRcVOn0q8iJi7O
y8cnKyeHb8XrN296+fiUfvjAW1hVXT1oxIi//v77fUFBRWXlv8ePDxw+/J+DB+kFbsfE9OjX
b7O7e+7797KysslPn27bvdth/nzeSrZ7ePT9+ec9+/a9fvs2Jy/vzIULm93dmUwmIeTx06de
Pj6v37wZMnq069atb9PTE5OT5RUUCCGhERFePj4Vn64RqeMq9Pp1Cxsbl82bS0pLq2tq/E+e
HDJ6tLunZ6PNR63O+2hrRWXlxJkzbadPD42I4HK56RkZG7dtMzAx4bsIO+zvfzIoaMXvv9vY
2T1++pTD4cTGxf22fv2Q0aPpo1pEV0JDDUxMNm3f/i4zk81mXw0NHTd16hRHx49VVfQyQnYI
H3ZdnZePz7nLl/nKy8rKeC8lORzOxJkzx9rb37h9m8lkFpeUnL982WnRopCICHoVUc5KQVwu
91pYGIPBsLKwGG5pyWAwroaGfrNjm1PPePMO5SAKBoPRQVOTENK0+6siioqNJYT07NFD3I1S
Kw6zsGjCRpu2Q4Rgs9nk6/SBel9QkF9QQHh2EaWXvj4hJC8/v6CwkLd86uTJqioqP8jTE7yo
gQBj7t0Tvhhf04u7ewVJtuklWBvfmSVxop+Azfxu+VVPGeGXSaJ8zAFAk6FHAwAhhHj5+ubn
54edP887BnJmdvbMefO0Ona8fPo0NYJ0RlbWsHHjnJcseRIXR43PVFtba+/snPLq1T/u7gtm
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
Bvheqa3dzVBpVRkbXuSxDv0aAAAAAOBHx+EUeayrjA1nqLRSW7u7paOBH5oUl8tt6RgAmqjq
8f33rvM4H0pYnXu2mrOW1cOopSMCAAAAAGgBNSmJJf+617x9zlBppeF2WM5wQEtHBD80JBrg
+1aTmlLgvqrm5WNCiNLIKUo2M6Q76rZ0UAAAAAAAzYSdlVZ+7SQ1+iOru6Ha2t0YmgFaHBIN
8F9Q5LP1Q5Av9bvcT2Zyfc1Z3XpLt9dhKKkSBp4PAgAAAID/EA6HU17KzkmvefWk6lFMVfI9
qljFfgHGZYBvBBIN8B9Rk5ry4dy/5aFBGK8BAAAAAH4gDIbSKHuVSXPQkQG+HUg0wH8Kp7K8
MjaiKulezeun7NwMTvkH5B0AAAAA4D+FwWAoqUhrdmJ1NZDrY6YwaARDQamlYwL4DBINAAAA
AAAAACAxeHwdAAAAAAAAACQGiQYAAAAAAAAAkBgkGgAAAAAAAABAYpBoAAAAAAAAAACJQaIB
AAAAAAAAACQGiQYAAAAAAAAAkBgkGgAAAAAAAABAYpBoAAAAAAAAAACJQaIBAAAAAAAAACQG
iQYAAAAAAAAAkBgkGgAAAAAAAABAYpBoAAAAAAAAAACJQaIBAAAAAAAAACQGiQYAAAAAAAAA
kBgkGgAAAAAAAABAYpBoAAAAAAAAAACJQaIBAAAAAAAAACQGiQYAAAAAAAAAkBgkGgAAAAAA
AABAYpBoAAAAAAAAAACJQaIBAAAAAAAAACQGiQYAAAAAAAAAkBgkGgAAAAAAAABAYpBoAAAA
AAAAAACJQaIBAAAAAAAAACQGiQYAAAAAAAAAkBgkGgAAAAAAAABAYpBoAAAAAAAAAACJQaIB
AAAAAAAAACQGiQYAAAAAAAAAkBgkGgAAAAAAAABAYpBoAAAAAAAAAACJQaIBAAAAAAAAACQG
iQYAAAAAAAAAkBgkGgAAAAAAAABAYpBoAAAAAAAAAACJQaIBAAAAAAAAACQGiQYAAAAAAAAA
kBgkGgAAAAAAAABAYpBoAAAAAAAAAACJQaIBAAAAAAAAACQGiQYAAAAAAAAAkBgkGgAAAAAA
AABAYpBoAAAAAAAAAACJQaIBAAAAAAAAACQGiQYAAAAAAAAAkBgkGgAAAAAAAABAYpBoAAAA
AAAAAACJQaIBAAAAAAAAACQGiQYAAAAAAAAAkBgkGgAAAAAAAAD+r737DIvi2v8A/ttGWaog
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
vgKenp4uLi6RkZErVqwICQkpKSmJjIw8c+ZMcHDwlStXFHbv2bNnQEDARx995ObmVlBQsGXL
lmfPni1btkxhBj5569evv3LlysqVK+Pj48eNG2dkZJSXl/fo0aOTJ08qv+lV0NHCYvDgIVev
XvH18Q4OCTEyNCKij5cvl58ifszo0cXFRUSUkZlJRHv27Dl//hwRefToER6+U2WxPXr0sLKy
OnLkiLe3t7e3d25uLtPtZe3atefPn1+0aFF8fHxwcDARXbhwYdu2bc7Ozl999ZX6qgYEBEyZ
MuXDDz/08/Orr68/dOjQgQMH+vfvP2fOHDbP3r17AwMDQ0NDFy5cyLydzs7Ojo2NrampOXHi
hMpibW1thw8ffvbs2ZEjR86dO9fY2PjRo0c//PBDQEAAswwBY/78+SKRKDQ01NXVVSqVPn36
9OuvvxYKhWwXG03OwuLFi3fv3v3DDz9UVlaOHz+ey+XGxsb+5z//8ff3j42NVf/1taKx86Kh
FlxHjZk4ceLUqVMjIiKKi4tnzpxpYmISHx///fffc7ncXbt2MT2DtFvOsGHD1qxZc+TIkWnT
psnPBTN27NgVK1ZIJJIlS5ZoXv/GODk5jRo1au/evSdOnGDCOvr6+o6OjpMnT541axazjqmy
Jn88OTk5CxcudHJy2rRpE7PLpEmTZs6cuXPnzhEjRkycOLFZN5nW8PT0HDRo0EcffeTh4ZGX
l7dx48aUlJTW36A+/fTT7du3Dxw48Nq1a1qsLQAAAABox+tfUZMlEom++eYbhT83TUxM2OXr
lddXV3D69Gl2yDHDx8fnwoULzNby8vIJEyawy1I4OjoeOXKEebcWExPDFpKVleXr68vk4XA4
CQkJTDrzJll+UQMdHZ2RI0cyE+mrdPToUXZ6di6XO2PGjOLi4rfeeisoKEhNO6iswOPHj+XH
PgQEBDx48OCnn37i8Xjsjlu3bhUKhWKxeNmyZUx/fiIyMzP78ssvpVIpm01lM5aXl7/77rvy
Ew126NCBbXkFNbV18v8ys7Jmz5ljY2PDvoNNSn4un8HS8k9rKP737Pj61tTWNdYOV69eZeer
MzMzY9OLiopmz57NvjpmXnjm5eWpaVLmK8fGxkZERLBzOuro6MyePbuiokIhc1JS0pgxY+Sf
6JydnTdt2qSm/MLCwokTJ7K7WFpabty48cWLF0QUHh7O5AkPD3dwcGDL5HK5/v7+N2/ebO5Z
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

--auwwwptwfs2pqkb5
Content-Type: image/png
Content-Disposition: attachment; filename="ref-combining.png"
Content-Transfer-Encoding: base64

iVBORw0KGgoAAAANSUhEUgAABUYAAAHQCAIAAADiUyd7AAAAA3NCSVQICAjb4U/gAAAAGXRF
WHRTb2Z0d2FyZQBnbm9tZS1zY3JlZW5zaG907wO/PgAAIABJREFUeJzs3WdcFEcfB/C5Qkfp
NkAE7A0rsSSKJXbsxhZNEI1ij71EjRprLEnsRmNFUaOxRgkYRVBExIaCNBvSpIO04459Xkzc
7HONu+MOOPP7fnhx7M3tzrbZ+e/OzvAYhiEAAAAAAAAAoG/4VZ0BAAAAAAAAANAEQnoAAAAA
AAAAvYSQHgAAAAAAAEAvIaQHAAAAAAAA0EsI6QEAAAAAAAD0EkJ6AAAAAAAAAL2EkB4AAAAA
AABALwl1NF9JWVmZpKwMg97rPz6PxxfwBXzc/QEAAAAAAKheeIy2o26GYcRiCYL5jwyfxxMK
BTwer6ozAgAAAAAAAP/QckjPMIyoVKzFGUK1YmggRFQPAAAAAABQTWi54b1YLNHuDJXYsGF9
SXEJIcTE1GTx4iXKE585c+bZ06ey07+ZOrVevXo6yd/HSCyWGBjo6mUNAAAAAAAAUIs2n9JL
ysoqLaRPT3/n6OBAP3d0dw8ODlGevtMn7o8ePZKayOPxUtPeWVhY6CSLHymhUID36gEAAAAA
AKoDbcZmZZIy2Yl9+/SxsbaysbaytbFOT3+nrWU9ePCA/dyuXTvliUtLS6Ojo2WnN27cGPG8
uuTuZQAAAAAAAKh82mxELdslXllZ2f374QUFBYSQOnXq2tnV0tayuI/c27UtJ6QvLCz8fvVq
+jk5KXnHjl/o5/YdOmgrP/8d6PgQAAAAAACgmtDte9FxcXE0nicqPEtXy6OHD9nPbdq2VZ7Y
wsLi22/n0c8nfH3Z6R07dtRilgAAAAAAAAAqk25fin78+DH7WfWQPjs7OykpKSszU0mahx9C
eiMjo+bNm9PP6envioqKlM/83r177OcO7VV9Sk+zVFJSomJ6jWVmZIhEonKTiUSi1NSU1NSU
4uJiVWabl5f3/v179t+SkpLsrCzlPykoKEhMTOT+CgAAAAAAAKoV7Yf0N2/e6NHDg/6t+G45
O93P7yQ7vUcPj6Cgm9xfPXz4cM3q1Z9/3rt2Lbu6dWq7ujjXq1fX1sZ6sKenv/81qUXk5OS8
evWKfm7VqlVZWdmqlSvr1a3j6OBgZ2szZvQXSl7av38/nH4wMDBo7eamfF3u37/v5fU1myUb
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
SolEsmnTJm6Pg3Xq1Nm4cWPFt56SkJ5hmBcvXowePZrbd6yVldXcuXNlz3RVQnpGtdJbubNn
z3J7Mmev7JqF9IyaR5qsnJyckSNHckeUvHPnDv2qmhetcmkQoGqrJqBuSM8uvUOHDtw15fF4
nTp12rt3L5umpKSE3ory9/dXvvqsmzdvdu3alftQ2tnZ+ZdffhGLxVIptRvSi8Vi2tPb559/
rmJWKSXHobpVDrXqvcoXrYiiColIJFq4cCG3W/W6devu3bu3rKyMRrOyIb1axaOikJ6p2Fkj
e209d+5cu3btpBo11KpVa+nSpe/fv1c+N0bNc0rjkF7dtS73OssorWqyq1buCUu9fft27Nix
3NYZHTp0uHXrFsMw9vb2UiH9+fPnaRpVai8Mw/CYSnyZE6qVzMzMuLi40tJSBwcH+uy3MolE
otevX6ekpPD5/Dp16jg7O6vb9kYikcTExGRkZNSsWbNRo0ZaGVadYhgmOjo6PT3dzMysWbNm
WpyzKoum3Z+UlpZaW1u7urpqPOCfImVlZa9evUpNTRWJRBYWFq6urkpGdi0sLHz27FlJSYm9
vb0WD5Jt27bNnz+/Q4cOFy5cYOND1q1bt3r16iUWiy9dujRo0KBy5/bixYu3b9/WqFGjcePG
3J2l8X58+fJlcnJyzZo1XV1dNRvdJD8///Xr1xkZGcbGxo6Ojvb29lIJSktL//zzT1dXV7Yp
je6UiKRfxHr27FlCQoJIJHJ0cGjfoYPUla8aMjJUY1wxKiUlJTExsbCw0MzMzNHRUa2Rn8r9
7aNHj+gzH4lEwufzJRJJVFRUdnZ23bp1nZ2dy92e5R4eUolfvXqVmZlpbm7eqFEjrYxeW/GM
icXi6OjorKwsGxub5s2bcyu+6iotLY2Li8vMzKQXAu1uPSUKCwtjYmLy8/NtbW2bNGlS8caf
FSy9y8rKnj17lp2dbWtr27hxY62clRXcVunp6bGxsUKh0MXFhdsquzoXrVpUhTUBKj09/c2b
N/n5+TVq1HBxcZEapiE8PNzd3b127dpJSUlqHb3p6ekvXrwQi8X29vbKBy7VFoZhGjZs+OLF
ixMnTmjQ25Gi41AD6tZ7NVi0ogpJcXFxVFRUfn6+jY1N06ZNVTzB1S0e5dLuWZObm/vixYu8
vDwDA4PatWu7uLio/spVZZ5TWr/OKtqzLOUnrNTiYmJiCgsLHR0dlR+Ht27dKi0t7dWrl5I0
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
QEBAQEDgK6GoqOjSpUtFRUWGhobDhg2zsrL60hIJ/EcJDAxMSUnp168f8YK9/ziqbp5UQ4yr
1SOY9AICAgICAgICAgICAgIC3yTCgqeAgICAgICAgICAgICAwDeJYNILCAgICAgICAgICAgI
CHyTCCa9gICAgICAgICAgICAgMA3iWDSCwgICAgICAgICAgICAh8kwgmvYCAgICAgICAgICA
gIDAN4lg0gsICAgICAgICAgICAgIfJMIJr2AgICAgICAgICAgICAwDeJYNILCAgICAgICAgI
CAgICHyTCCa9gICAgICAgICAgICAgMA3iWDSCwgICAgICAgICAgICAh8kwgmvYCAgICAgICA
gICAgIDAN4lg0gsICAgICAgICAgICAgIfJMIJr2AgICAgICAgICAgICAwDeJYNILCAgICAgI
CAgICAgICHyTSDZu3PilZRD4P0Vubu7vv//+4MGDIUOGfGlZvj3y8vJOnjx5+vTpgICA+Ph4
dXX1tm3bqvSLDx8+PHHiRHZ2dteuXVUR//379w8fPuzv7x8WFpaenm5lZaWpqamKDymLrVu3
3rt3z9zcXF9f/0vLwpnz589funQJIWRubs4mPN5a7ezsRCKRiqUT+OaBClZfX29hYfHfFIAH
6enpO3fufPTo0eDBg7+0LI1KdHT00aNH379/36NHjy8tS8Oouiv8hviv1Vih3/yGaIQuQNWq
YMOGDffv3+/UqVOzZs2UHDUmIKBUnj17JlQtBurr62fOnNm/f//U1FTSTw8ePNDT0yM2z/nz
55eXlzs6Ojo6OpaVlalCns2bNyOERo0apfSYa2tr3dzciMkRi8U5OTlK/5Byad68OUIoNDT0
SwvChzFjxkCHwTI83lprampUKZfA/xGggq1duxZ/wqDQGiQvL8/e3t7d3b26upq3AAoSGRnZ
o0ePTZs2KStCKhEREQghbW3tRv7uF2fPnj0IocGDB39pQVihuq7wm4O2xv4fRug3FUGRLoAH
Su8CqKhaFUgkEoTQkydPlB6zsPFeQKBRycnJOXXqVFRU1PXr14nPq6qqpkyZUlJSMmzYsNDQ
0GfPnl24cGH+/PlRUVFBQUFBQUGRkZFfSmZ+7N+///r161paWvv373/+/HlYWNiJEydatWr1
peUSEBBQGvIUGhtCQkJCQ0OvXbv24sULVcjGhjNnzsTHx//xxx//ke8KCAgIKBFFugAB5SKY
9AICjcp3331na2urr69P2tIWEhKSk5PTrFmz69ev29nZdevWbdKkST/88IONjY2ZmZmZmVn3
7t2/lMz8OHv2LEJo5cqV3t7eNjY2gwcPnjFjBvx07Ngxe3v7Lyjb3Llzf/755y8oAIkvniEC
ivBfLj55Co0Nffv2NTIy6ty5c8eOHYnPGzM/HRwcmjZtOnbs2Mb53Bf5rkrVXU1NTf/+/S9c
uKCi+Jn52jS5AG94VKS4uLhevXolJyerTiqBBlGkCxBQLmpfWgABgf8Wampq0dHR1Odv3rxB
CPXp04d0usbIyOjDhw+NI5tygRQNHTqU+pO/v/8XXJerqqry8/MbMWLElxKAypfNEAEF+S8X
nzyFxgZLS8vc3Fzq88bMz3Hjxo0bN65xvvVFvqtqdRcZGRkdHT1hwgQVxc/AV6jJBXjDoyLd
uHEjLi6usrJSdVIJNIgiXYCAchFW6QUEvgqKiooQQi1btvzSgiiHqqoqqVSK6FJUXl7+ZTuA
hw8fgmxfCUrPEMFhT2Pyxevz/zGE/FQuqlZ3d+/eVV3kzHxtmlxAEXhUJOXWPaHfFPjWEVbp
v3nevHlz9erVtLS00tJSY2NjCwsLJyen77//nhgmJSXl3r17CQkJRUVFGhoaHTp0cHNzI4VB
CAUGBqakpMydO7dZs2YfPnyApZLq6mpjY2N7e3s3N7cmTZqwlEpdXR0hJJPJ/v7774cPH+bl
5enr6/fv33/ixIna2try3oqMjLxx48b79+9BSE9Pz3bt2rH8Yl1dXUBAQExMTEZGRlVV1Xff
fWdjY+Pi4kL0GA8JnDVrlp6eXlJS0rlz596+fYthmLm5uZubW//+/eVFXlJS4ufnl5CQUFBQ
YGJiYmdnN3bsWDU1+uaDYVhYWFhQUFB6enpdXZ2JiYm1tbWLiwt+jPzAgQNSqXTixImmpqYI
oZqamqioqNjYWIRQcnLyrl27IJiHh4eJicmnT5+OHDmCEFq4cGHTpk0VESw+Pv7KlSspKSn1
9fUdO3b08vKysrISi7nN67GpS1lZWTdv3oT/+/r6GhoaIoTMzMzGjx+fkpKyffv2mpqa6upq
PKUIoZkzZxoYGOB/1tbWXrt2LTIyMjMz09DQsFu3bp6enrq6uiRhiAVaUFBw9OjR+Ph4DMPG
jx/v4eFBK394ePiWLVsQQqmpqbgA2tra8+fPJwaD3v3Vq1cXLlxIS0vT0NBo166di4tLz549
5eVMWlqav79/SkqKVCpt166dm5tbv379GshNhFhmCMsmDEDrS05OPn/+fFpamkwms7S0dHd3
ZxBeiSlCCOXn5585c+aHH34YMWJEXV1dYGDgvXv3srOztbS0vv/++0mTJrVv3572RR6aKikp
6fjx46mpqVpaWp07d546dSquNN68eXPx4sWkpCSZTGZlZTVhwoTevXvLk5mf8mFZfPX19Xfu
3Ll//35GRkaTJk3atWvn7u7Oww14g0KePn26sLCwc+fOo0aNIr1bXV196NChurq6IUOGwKeh
mKytrZ2cnGpqai5fvvzgwYP8/Hw9Pb1+/fpNnjwZXEU2CEmhEamqqgoICIiKisrKytLS0jIx
MenVq5ezszOoMhAAIYTvnWaZn0BZWdmxY8cQQj/99BOtk46ioqJTp04hhDw9Pb/77jta4ePj
4x88eGBqajpx4kT8Ie+uMCsr6/z588+ePauoqGjTps348ePt7OxodSztd3GU1a2zVHec+hEc
mUx27dq1c+fOIYRCQ0Nra2vheadOnZydnfFgoEurq6svXLgQGRlZXl7eokWLvn37jh07lqrS
lZ40Wnh0hSz1A5txCA6bUmb5aahOTk5O1tbWpaWlFy9efPToUXFxsYGBQe/evadMmSLvAhf2
NRYoKCgICgqKi4vLy8tDCJmamjo4OAwdOpRkD3OSh2VFIlJUVHT69OknT54ghPz8/EJCQuD5
8OHDbWxs8GBfpN9k35qio6P/+eefjIyMoqIiPT29zp07jxw5kmW/IJVKQ0JCoqKiMjIyqqur
W7Zs2b9/f3d3d9KNQkQljxC6e/fulStXYEB+6NAhHR0dHmJToXYBvMcAiHW7wKmsrDx06BBC
aN68ecQUATk5Of7+/mKxeNmyZdR3VacKQLCLFy9GREQUFhYaGBgMGzbMw8NDIpGIxeK6ujqG
T/BH6Q73BBqNoqIikkdxwMzMDA9TVlZGa6mKRKKNGzeSIgRPko8ePTpw4AB1yGJjY8PGXTn4
Am3evHlqaqq1tTUpEhMTk6ioKOpbhYWF1EvvxGIxVUhaIiMjqaNJ4OTJk6QEhoeH//XXX+Bz
koiHh4dUKqVGfu7cOeo0RKdOnZKTk6mBX7161aVLF6oYnp6eeBiiT/W8vDx591hERERgGJaR
kQF/5ufn8xastrZ23rx5pE63SZMmGzdu3Lt3L2Ln25NlXVq5ciVtcoYOHRoUFCRvIhzmVoDn
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
9o+1/22jz6TVRS+TEUJvzgRwbdJrGHUfskLQrmS54a9r80oQQhYzbcvTcnPDXuaGvaot+Ej5
cnvAov85hoXPk3CTXkZejrPvOldCpYcrGTlZzgTY7Fz66tSNxxuOIoSKXiUXxCbS+8OLo4dV
X8r+5q16c33iKqKNzW5ty3oYM2ytuG8OKMTJIYlX7yOEEINhf3QT/oAi8ep9ygGRV1WmnCZW
fSNu0mua6LV7BilqPhSH7/TEf+sN6+f6+E/Ozx+6D7YY+N208J89n/16BSGU+ldIuuvUPrPt
6PGodO2Cv9UP2fJ7r2ljFTXFeqOOy66uXbuKE8mX7Ku5O2/fvv3w4cMRERHnz59ftWpVB22l
rq4uNjZWRUWlg+KPiIhoamrqoMj56+hd+/JBk15anTp1qry8XFVV1dPTk8/Qbh4eHnfv3i0p
KTlx4sTevXvJ5Xfv3s3MzFyxYoWWllZ6evr169dTU1MJgjA1NXV2drax+Z9v7SorKy9fvow/
1/f29g4NDcXLJ0+ejD8fffPmzZMnT4yMjObP53ILTEhIuHXrVm5ubmNjo7Gx8YQJE6ZNm0Yf
YR5H4uTkZGlpWVNTc+PGjZiYmKqqKm1t7REjRixcuLBLF+rYNgghgiCeP38eERGRnp5eX1+v
oaExePDgBQsWdOvGfZQgPpKTk4OCghQUFDZs2MA1wNu3b0NCQhQVFX/4QdCv7zhlZmY+fvw4
KSmpsrJSUVHRwsLC2dm5f//+QkWSkpJy8+bN7OzsmpoaPT09MzMzJycnSiRsNjs4ODgsLCw/
P19eXt7ExMTFxcXKykrATVy+fLmiomLatGlch1c8fvx4a2urq6urgYEBXlJWVnb16tWBAwc6
ODi0trZev349LCysrq6uR48eDg4OM2bMwPmzsbHxzp074eHhHz9+1NLSGjNmzKJFi1RV/2fY
JM6o2tra7t69+/jx46KiIhUVlf79+y9YsKB3795CHS5Onp6eTU1N8+fPNzIy4lyem5vr5+eX
k5NTUlKirKxsZmY2YcKECRMmyMvLIwEyP3+lpaX+/v5JSUmlpaXa2trGxsa2trZ2dnacLcPy
8vKgoKC4uLiPHz8ihIyMjKZMmWJvb09pPYp2gfCioKCAEIqMjLx7925+fr6iouKgQYMWLFhA
OTicsrOzfXx8MjMzm5qaTExMnJ2dR48eLfgWY2NjHzx4kJ+fX1lZqaWl1a9fv6lTp3JmS7yD
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
EycnJ0tLy5qamhs3bsTExFRVVWlra48YMWLhwoVdunShR1tbW3v79u2oqKiPHz/Kysqam5t3
69aNXKupqUmeBV5iY2MfPHiQn59fWVmppaXVr1+/qVOncp0RIDs728fHJzMzs6mpycTExNnZ
efTo0eTahISE0NBQZWXldevWcd1QXFxceHi4uro6zo2k6Ojoe/fu5eTk4APr5uZmYmJC+S0+
OPjotbS0eHt7h4WF1dfXDx48+MCBA2Sw8vLyoKCguLi4jx8/IoSMjIymTJlib28vcn3i7t27
mZmZK1as0NLSSk9Pv379empqKkEQpqamzs7ONjY2lPDp6emBgYFdunRZvnw5PbaXL19GRkb2
7Nlz3rx5lFW4iMjIyPD19c3OzmaxWObm5i4uLgKOyc81R5FKS0v9/f2TkpJKS0u1tbWNjY1t
bW0p4wkLcugyMzPd3d1bWlqam5vJKx0htGzZMm1tbdSpV7rg2ZgTzldGRkbz588nF+KTvmrV
KnV19dzcXNwrobm5WU9Pb8KECc7OzvLy8vyjPXv2bHV1tZOT06BBgziXs9ns33//va2tbcyY
MePGjaP86vjx401NTfPmzTM3N6esevTo0YMHD0pKSjQ1Nfv16zd37lxjY2NB9oWUkpJy8+bN
7OzsmpoaPT09MzMzJycnzhIM/VMwlpWVXblyJTExsa2tTU9Pz97e3sHBQVZWlv8uV1ZWXr58
+dWrVwghb2/v0NBQvHzy5MmDBw8WZxOtra23bt2Kjo4uKCjQ0dEZMmSIm5sbr4KaLjc318/P
Lycnp6SkRFlZ2czMbMKECRMmTKCcRIIgnj9/HhERkZ6eXl9fr6GhMXjw4AULFnAWpxhn/gwN
DQ0ICCguLtbR0Rk1apSrqyt5cwwLCwsMDPzw4YOCgsKgQYPc3NzoF4WYO9junRch1NTUFBoa
+uzZs/z8/Obm5q5du9rY2Li4uCgpKdEjFLaiwouYpwwJn0+E2k3RygpMtEMkyD2OxP8+i4lW
W6CTlhscr8JN8KqyCCVPdXW1t7d3UlJSeXm5gYGBnZ3d7Nmz5eS4t/IKCwt9fX3j4+MbGhoM
DQ3nzZtnZ2cnI9P+W953797dv39fQ0Nj7dq1lFUxMTFRUVEyMjJbt26lRPX69evQ0FA9Pb3F
ixdzPT6CFA4kQe4v/1GdOzofENnp06fprXSEkIKCQlpaGg5TXFyMF+bn59NjwC+vZGVlORfi
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
/N9//71u3ToXF5eRI0d269YtKSkpNDQUITR16lT8aoC3pUuXuri4pKenjxs3buzYsQYGBjU1
NREREV++fFm5cmVUVFRkZGR79v3XcfjwYScnJyMjI2Nj4x49etBotMTExICAgKampi1btjAP
Bbd48eILFy5kZmYaGhra2Ng0NDR069bN2dk5MTFx+fLlCgoKpqamenp63bp1KyoqevPmTU5O
joqKCi6htcqTJ088PDy0tbVNTEw0NDSEhYUzMzP9/Pyqq6tNTU1xJWfHcnNzs7Kyio+P19fX
Hz9+fK9evcrKyt69e1dWViYlJeXt7Y3rzwncsoLjyvnPH0NDw7lz53p5ee3atcvb29vY2JhE
IiUnJ0dERAwZMmTevHm4Fp3dyZMnt27dqqmpOW7cuB49emRmZr5584ZOp/ft25djcxV7e/ui
oqJJkyYNHz584MCBjY2NQUFB+HXG8ePHiaHssK1bt37+/NnT09PS0tLExGTAgAFUKjUiIgIP
xnb48OHWjgA/adIkTU3NnJwcc3NzBwcHSUnJtLQ04v1Cq247169fNzc3z8zMHDhw4IQJE7S0
tCorKwMDA4uLiz09PefOncuy6QcPHjQ1NWVlZX348IFHUx0qlers7Ozs7CwhIdGvXz8VFRUx
MbGSkpKYmBgcu/7ff/+1tf3vWVlJSen+/fszZsx48+aNrq6uqamplpZWY2Njfn5+VFRUdXW1
m5sbHg0RddSNmkSa/cz52ZJ9iZ5+CKEGSn3iXT/e3xh37J+qrPzUx4FNVFrkOa/Ic17Mc/Vt
zSac5vXaqEOIdBM33bbk/d7LwQeuscwa8Mek/nOsOzsB7TR617L8j5+/BUZRq2rYW/8GH7g2
Zv+KFoOiaY8b/sfrC/enb8TlrqK4NB6hsBFCstrq9g+OP5i5iVZNKYpN9V11hHmuqFS3md5H
iZp/HtSHD+g3a0Ly/TcIoaLY1OdL9xOz9CePllJRjLv5pMWV/FIYTfS0J4EcZ1k78zqZm6i0
FJ+AFJ8A9lnDnOYwN6UetHBK2PE7VHJtYz0tYMtZPLGv/XhcVK4rq/p04d6nC/dYVkISFpp4
bgv/kfPbps90i3FH/3673QUxGKmPA1MfBzLPldfXdHh4Eo8b1+X6z7Umuo3w+ZZhyAr76Cs+
FV9yEUIsB8vi3zUJbi/KUrL43Drvg9iioascoi49CDt2m2W64eKpRA08D/j6fThnW11ZVUni
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
ZzcJi4tx2xChPD077tbTwuiUmvwSUWlJeV2NfrOtek82JwmzdmzB68FZ3UCpj73+ODsoquJr
HkJIsa92/znWfaZbsB+C6vyS+NvPcj7EVucWNTU0Ssh3V+qnoz95tL6NmUg3cfblMTKZHBAQ
kJubixAKCAiorq5GCAkJCW3YsIF5sdraWm9v76ioqPz8fHl5+T59+ixYsEBDg+3gIuTi4iIq
KrpixQqEUGJi4s2bNzMyMiQkJLZt2zZkyBBuycDy8vI8PT1jYmJqa2t79uw5a9YsCwsL3oF2
v3z54uHhkZ6eXl9fr62tPXPmzFGjRjEvUF5efuvWrcjISISQq6vrmzdv8HQrKysjo//iHaSn
p79+/TohIaG8vFxcXNzAwGDmzJkDBgxg2dyTJ0/S09NNTU1NTU157wtCKCsr6+7du5mZmYWF
hd26ddPV1bW0tLS0tBQVFW3xu4jvPE9ISHj27BlCqK6u7uTJk3ji6NGjTUxMuK0Z78WyZcvk
5ORSU1Pd3d2Tk5MZDIaOjs7MmTN57Bo/SaLRaD4+Pu7u7gihd+/eNTY24ul9+/adMmUK85It
HjuEUElJyZ07dwYNGjRx4sSmpqYnT568fv06Pz9fUlJywIABc+fO7d27N/Py79+/P3ToEEIo
IyODyA0pKalVq1YRa0MIsbf8rK+vf/PmTWhoaE5ODpVK7dGjh6mpqb29vYSEBLfc4C06Ovrt
27cTJ04cNGhQeXn5nTt3IiMja2tr1dTUrKyspk+fLiwszPIVPq8dOp3u5+cXEBCQk5MjKiqq
ra1tb29vbGzMLSViYmIIobS0NE9Pzy9fvtBoND09PXt7+6FDW9c/qLKy0tXVNSEhobS0VEND
w8LCYvr06SIiPzweMB+vxsZGd3d3fFdRVVWdOHHi1KlT8fJ1dXWPHj169+5dUVGRnJycmZnZ
ggULpKRYf6TQ9+DzOTk55eXlcnJy/fr1mzRpEo+dJZPJFy9eRAitXLlSTk6OeVZOTo6HhwdC
aN68eb16/fBbU1xcfPPmTRKJtGHDBuLyxK9CqFTq3bt3P3z4UF1draSkNHLkyOnTp3fvzrV1
24cPH54+fZqZmYlvIwsXLtTW1mZZBl+AK1askJGRycrK8vDwiIuLo1KpampqlpaWM2fO5PMW
gRBiMBjh4eFBQUGpqak1NTXdu3c3MjKaO3eusrIy7y/yeWPkc4+Yz/aGhgZXV9eAgICamhoj
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
x48fb21tTaPR7OzsmAd5plAoS5YsSUpKUlBQ2LhxY5tTjhkaGuJH6iVLljB3XW5oaFi3bl1K
Sgr7VzZv3qymppaWlmZnZ0c0/MaoVOrTp09ZxirH5Rz2whUeGv3p06fMlQCVlZVz5swhmka3
wcWLF9m/HhAQEBMTIywszHFkLMLPyXPszz//ZI5sX1JSMmPGDCqVqqOjM3/+/PYkCWf4vXv3
2CPMtfbYtRbedFRUFHv7Do4L466z165dY57+/PnzdevWtT9gAUJo//79zIHlaDTamjVr4uPj
RUREtm3bxv96iCGmV69ezVzNyGAwXFxcrl69ihA6dOgQ+xcZDMaiRYuYH6PJZPK8efPIZDLL
geZo0qRJ+Ojb2tqyjFvGYDDCw8OfP3/O/17wqbi4+ObNm+yh+06dOsVgMHR0dIhG1Nz069dP
U1MzOzv78ePHIiIiuAxPwP+6u7uTyeShQ4fy3/2Bm5MnTwoJCbm5uW3atIkl3kFZWdmNGzdw
Y5AOhO9dt27dYi4xpqSkTJ8+nf/3RNxujKgr9ogf+Lg7OjpevHjRy8vLy8vL29v72bNniYmJ
/AQ03bJli7S0dFpa2pw5c5ibvtPp9MDAQCIw57p169TU1JKTkxcuXMh8B8vNzbWzs6PRaKNG
jeI4DCczKysrhFBWVtbRo0eZ0xYSEtJRN/BfxP3799lv2nl5efjlI3OEPG43Z/6v9+joaCUl
JQUFBd5NLQAA3EBfegFWX0FOexKY9iSQZbq0quLcl+eZB34be2hNZkBkE5VGb2wKP+GKO9sj
hEQkxOxu//t4/k5umxDpJm66bcn7vZeDD1xjmTXgj0nEGO8IIQadkfMhlr2VPkJIfcSAIX/9
V5Fitn1pYXRK6qN3CKHsoKjsoM7qSaVpPqS+gpwTHJMT/MNvkoR89yk39zL3sReREBuybEbE
GQ+WJOlOHCXDvSe8kIiwg88JT+vVZanfagrLiMYLhDH7VzJnUdvUlVV9unDv04V7LNNJwkIT
z21hH6WPf25ublZWVvHx8fr6+uPHj+/Vq1dZWdm7d+/KysqkpKS8vb3Zm6y3wfXr183NzTMz
MwcOHDhhwgQtLa3KysrAwMDi4mJPT8+5c+eyLK+kpHT//v0ZM2a8efNGV1fX1NRUS0ursbEx
Pz8/Kiqqurrazc0NDzWELV++fM2aNffu3cvJyRk5cmR5ebm5ufmyZctWrVp19erV/Pz8vn37
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
TQAAAABJRU5ErkJggg==

--auwwwptwfs2pqkb5--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 544dd0d6e3d..13284f1d708 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index d89be1b9533..4fd10a5e7b3 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1164,9 +1164,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3694,6 +3691,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 4b37d92a49e..8d1e8a20998 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=
Content-Type: text/x-diff
Content-Disposition: attachment;
 filename=v42-0007-Teach-snapshot-builder-to-skip-transactions-running-.patch



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v43 6/7] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index 98d38dc5229..1d28202de34 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1455,6 +1460,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1545,7 +1556,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3018,6 +3029,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3028,7 +3040,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3079,6 +3092,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3836,7 +3850,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 36950aea780..065316ee866 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3616,6 +3613,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 836eedb8ed5..1c4a887da13 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1231,6 +1231,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 144e241ebd3..6c7f0fee115 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -152,7 +153,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--nzintiedl6o4kcyp
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v43-0007-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 17118f2fe76..cb06c52c1d4 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1180,7 +1180,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index b1e05d56a1e..89aad2f7b77 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -714,6 +714,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -759,6 +762,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1275,7 +1279,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1454,6 +1459,12 @@ index_create_copy(Relation heapRelation, Oid oldIndexId, Oid tablespaceOid,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1544,7 +1555,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3017,6 +3028,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3027,7 +3039,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3078,6 +3091,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3835,7 +3849,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index fe419ef808e..9aaa8e95389 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1162,9 +1162,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3505,6 +3502,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 34209bd1393..ad5c1238e09 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1230,6 +1230,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 3426087b445..3778e9b7f07 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -65,6 +65,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -146,7 +147,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--=-=-=--





^ permalink  raw  reply  [nested|flat] 1288+ messages in thread

* [PATCH v44 09/10] Fix a few problems in index build progress reporting.
@ 2026-03-16 12:53  Antonin Houska <[email protected]>
  0 siblings, 0 replies; 1288+ messages in thread

From: Antonin Houska @ 2026-03-16 12:53 UTC (permalink / raw)

First, index_build() should not update the progress when being driven by
REPACK, because the progress reporting infractructure cannot handle status of
two commands at the same time. So far, REPACK with the CONCURRENTLY option
neglected this problem altogether, but even the existing REPACK wasn't
consistent enough: even if the 'progress' variable in repack_index() was
false, it didn't pass the value to index_build().

Second, REPACK (CONCURRENTLY) should not set PROGRESS_REPACK_PHASE to
PROGRESS_REPACK_PHASE_FINAL_CLEANUP in rebuild_relation() because it calls
finish_heap_swap() anyway (via rebuild_relation_finish_concurrent()), which
does the same thing.
---
 src/backend/bootstrap/bootstrap.c |  2 +-
 src/backend/catalog/heap.c        |  3 ++-
 src/backend/catalog/index.c       | 22 ++++++++++++++++++----
 src/backend/catalog/toasting.c    |  3 ++-
 src/backend/commands/cluster.c    |  7 ++++---
 src/backend/commands/indexcmds.c  |  1 +
 src/include/catalog/index.h       |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/src/backend/bootstrap/bootstrap.c b/src/backend/bootstrap/bootstrap.c
index 68a42de0889..1c8226c6d67 100644
--- a/src/backend/bootstrap/bootstrap.c
+++ b/src/backend/bootstrap/bootstrap.c
@@ -1181,7 +1181,7 @@ build_indices(void)
 		heap = table_open(ILHead->il_heap, NoLock);
 		ind = index_open(ILHead->il_ind, NoLock);
 
-		index_build(heap, ind, ILHead->il_info, false, false);
+		index_build(heap, ind, ILHead->il_info, false, false, false);
 
 		index_close(ind, NoLock);
 		table_close(heap, NoLock);
diff --git a/src/backend/catalog/heap.c b/src/backend/catalog/heap.c
index 5748aa9a1a9..ae6b7cda3dd 100644
--- a/src/backend/catalog/heap.c
+++ b/src/backend/catalog/heap.c
@@ -3570,7 +3570,8 @@ RelationTruncateIndexes(Relation heapRelation)
 
 		/* Initialize the index and rebuild */
 		/* Note: we do not need to re-establish pkey setting */
-		index_build(heapRelation, currentIndex, indexInfo, true, false);
+		index_build(heapRelation, currentIndex, indexInfo, true, false,
+					true);
 
 		/* We're done with this index */
 		index_close(currentIndex, NoLock);
diff --git a/src/backend/catalog/index.c b/src/backend/catalog/index.c
index de7182a85a9..cfd33f73f48 100644
--- a/src/backend/catalog/index.c
+++ b/src/backend/catalog/index.c
@@ -715,6 +715,9 @@ UpdateIndexRelation(Oid indexoid,
  *			already exists.
  *		INDEX_CREATE_PARTITIONED:
  *			create a partitioned index (table must be partitioned)
+ *		INDEX_CREATE_REPORT_PROGRESS:
+ *			update the backend's progress information during index build.
+
  * constr_flags: flags passed to index_constraint_create
  *		(only if INDEX_CREATE_ADD_CONSTRAINT is set)
  * allow_system_table_mods: allow table to be a system catalog
@@ -760,6 +763,7 @@ index_create(Relation heapRelation,
 	bool		invalid = (flags & INDEX_CREATE_INVALID) != 0;
 	bool		concurrent = (flags & INDEX_CREATE_CONCURRENT) != 0;
 	bool		partitioned = (flags & INDEX_CREATE_PARTITIONED) != 0;
+	bool		progress = (flags & INDEX_CREATE_REPORT_PROGRESS) != 0;
 	char		relkind;
 	TransactionId relfrozenxid;
 	MultiXactId relminmxid;
@@ -1276,7 +1280,8 @@ index_create(Relation heapRelation,
 	}
 	else
 	{
-		index_build(heapRelation, indexRelation, indexInfo, false, true);
+		index_build(heapRelation, indexRelation, indexInfo, false, true,
+					progress);
 	}
 
 	/*
@@ -1438,6 +1443,12 @@ index_create_copy(Relation heapRelation, bool concurrently,
 		stattargets[i].isnull = isnull;
 	}
 
+	/*
+	 * Note: The current callers do not need INDEX_CREATE_REPORT_PROGRESS. If
+	 * 'concurrently' is true, there is no build at all. Otherwise the index
+	 * build is a sub-command of REPACK. The current infrastructure does not
+	 * allow two commands to report their progress at the same time.
+	 */
 	if (concurrently)
 		flags = INDEX_CREATE_SKIP_BUILD | INDEX_CREATE_CONCURRENT;
 
@@ -1528,7 +1539,7 @@ index_concurrently_build(Oid heapRelationId,
 	indexInfo->ii_BrokenHotChain = false;
 
 	/* Now build the index */
-	index_build(heapRel, indexRelation, indexInfo, false, true);
+	index_build(heapRel, indexRelation, indexInfo, false, true, true);
 
 	/* Roll back any GUC changes executed by index functions */
 	AtEOXact_GUC(false, save_nestlevel);
@@ -3001,6 +3012,7 @@ index_update_stats(Relation rel,
  *
  * isreindex indicates we are recreating a previously-existing index.
  * parallel indicates if parallelism may be useful.
+ * progress indicates if the backend should update its progress info.
  *
  * Note: before Postgres 8.2, the passed-in heap and index Relations
  * were automatically closed by this routine.  This is no longer the case.
@@ -3011,7 +3023,8 @@ index_build(Relation heapRelation,
 			Relation indexRelation,
 			IndexInfo *indexInfo,
 			bool isreindex,
-			bool parallel)
+			bool parallel,
+			bool progress)
 {
 	IndexBuildResult *stats;
 	Oid			save_userid;
@@ -3062,6 +3075,7 @@ index_build(Relation heapRelation,
 	RestrictSearchPath();
 
 	/* Set up initial progress report status */
+	if (progress)
 	{
 		const int	progress_index[] = {
 			PROGRESS_CREATEIDX_PHASE,
@@ -3819,7 +3833,7 @@ reindex_index(const ReindexStmt *stmt, Oid indexId,
 
 	/* Initialize the index and rebuild */
 	/* Note: we do not need to re-establish pkey setting */
-	index_build(heapRelation, iRel, indexInfo, true, true);
+	index_build(heapRelation, iRel, indexInfo, true, true, progress);
 
 	/* Re-allow use of target index */
 	ResetReindexProcessing();
diff --git a/src/backend/catalog/toasting.c b/src/backend/catalog/toasting.c
index 078a1cf5127..73c41360ae9 100644
--- a/src/backend/catalog/toasting.c
+++ b/src/backend/catalog/toasting.c
@@ -331,7 +331,8 @@ create_toast_table(Relation rel, Oid toastOid, Oid toastIndexOid,
 				 BTREE_AM_OID,
 				 rel->rd_rel->reltablespace,
 				 collationIds, opclassIds, NULL, coloptions, NULL, (Datum) 0,
-				 INDEX_CREATE_IS_PRIMARY, 0, true, true, NULL);
+				 INDEX_CREATE_IS_PRIMARY | INDEX_CREATE_REPORT_PROGRESS, 0,
+				 true, true, NULL);
 
 	table_close(toast_rel, NoLock);
 
diff --git a/src/backend/commands/cluster.c b/src/backend/commands/cluster.c
index 2c3058ba10d..018e9f7b013 100644
--- a/src/backend/commands/cluster.c
+++ b/src/backend/commands/cluster.c
@@ -1153,9 +1153,6 @@ rebuild_relation(Relation OldHeap, Relation index, bool verbose,
 
 		rebuild_relation_finish_concurrent(NewHeap, OldHeap, ident_idx,
 										   frozenXid, cutoffMulti);
-
-		pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
-									 PROGRESS_REPACK_PHASE_FINAL_CLEANUP);
 	}
 	else
 	{
@@ -3582,6 +3579,10 @@ rebuild_relation_finish_concurrent(Relation NewHeap, Relation OldHeap,
 	relpersistence = OldHeap->rd_rel->relpersistence;
 	is_system_catalog = IsSystemRelation(OldHeap);
 
+	/*
+	 * finish_heap_swap() sets the phase too, but here we need some swapping
+	 * in advance.
+	 */
 	pgstat_progress_update_param(PROGRESS_REPACK_PHASE,
 								 PROGRESS_REPACK_PHASE_SWAP_REL_FILES);
 
diff --git a/src/backend/commands/indexcmds.c b/src/backend/commands/indexcmds.c
index 83edab38760..c9e22e95515 100644
--- a/src/backend/commands/indexcmds.c
+++ b/src/backend/commands/indexcmds.c
@@ -1233,6 +1233,7 @@ DefineIndex(ParseState *pstate,
 		flags |= INDEX_CREATE_PARTITIONED;
 	if (stmt->primary)
 		flags |= INDEX_CREATE_IS_PRIMARY;
+	flags |= INDEX_CREATE_REPORT_PROGRESS;
 
 	/*
 	 * If the table is partitioned, and recursion was declined but partitions
diff --git a/src/include/catalog/index.h b/src/include/catalog/index.h
index 56a064ef444..a03238304a0 100644
--- a/src/include/catalog/index.h
+++ b/src/include/catalog/index.h
@@ -71,6 +71,7 @@ extern void index_check_primary_key(Relation heapRel,
 #define	INDEX_CREATE_IF_NOT_EXISTS			(1 << 4)
 #define	INDEX_CREATE_PARTITIONED			(1 << 5)
 #define INDEX_CREATE_INVALID				(1 << 6)
+#define INDEX_CREATE_REPORT_PROGRESS		(1 << 7)
 
 extern Oid	index_create(Relation heapRelation,
 						 const char *indexRelationName,
@@ -148,7 +149,8 @@ extern void index_build(Relation heapRelation,
 						Relation indexRelation,
 						IndexInfo *indexInfo,
 						bool isreindex,
-						bool parallel);
+						bool parallel,
+						bool progress);
 
 extern void validate_index(Oid heapId, Oid indexId, Snapshot snapshot);
 
-- 
2.47.3


--gwom7bl7ogtszo4k
Content-Type: text/x-diff; charset=utf-8
Content-Disposition: attachment;
	filename="v44-0010-Teach-snapshot-builder-to-skip-transactions-runn.patch"



^ permalink  raw  reply  [nested|flat] 1288+ messages in thread