From: Antonin Houska <ah@cybertec.at>
To: jian he <jian.universality@gmail.com>
cc: Matheus Alcantara <matheusssilv97@gmail.com>,
    Alvaro Herrera <alvherre@alvh.no-ip.org>,
    Marcos Pegoraro <marcos@f10.com.br>, Michael Banck <mbanck@gmx.net>,
    Junwang Zhao <zhjwpku@gmail.com>,
    Kirill Reshke <reshkekirill@gmail.com>,
    Pavel Stehule <pavel.stehule@gmail.com>,
    Michael Paquier <michael@paquier.xyz>,
    PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Subject: Re: why there is not VACUUM FULL CONCURRENTLY?
In-reply-to: 
 <CACJufxGE4vDVBd_KDFsTnXoMPKobx-Qqk=f8boZYKJNvUVb3AQ@mail.gmail.com>
References: <202503251432.o6obtgywjow5@alvherre.pgsql>
 <6059.1743060030@localhost> <104580.1743431185@localhost>
 <178741.1743514291@localhost>
 <CAFY6G8cQs-SY0Lkv6E7YdZaCpZF0gctKW_SvqmBXB-dTXV-h2g@mail.gmail.com>
 <97992.1744363682@localhost>
 <CACJufxFfm=E1PA80Uxj26rqaRFVrHNiTycdADD1z4F+c8nQFDw@mail.gmail.com>
 <CACJufxGE4vDVBd_KDFsTnXoMPKobx-Qqk=f8boZYKJNvUVb3AQ@mail.gmail.com>
Comments: In-reply-to jian he <jian.universality@gmail.com>
   message dated "Mon, 09 Jun 2025 00:05:59 +0800."
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <118470.1749465357.1@localhost>
Date: Mon, 09 Jun 2025 12:35:57 +0200
Message-ID: <118471.1749465357@localhost>
Archived-At: 
 <https://www.postgresql.org/message-id/118471.1749465357%40localhost>
Precedence: bulk

jian he <jian.universality@gmail.com> wrote:

> hi.
> some more minor comments about v13-0001.
> 
> GetCommandLogLevel also needs to specify LogStmtLevel for T_RepackStmt?

Fixed in [1].

> /*
>  * (CLUSTER might change the order of
>  * rows on disk, which could affect the ordering of pg_dump
>  * output, but that's not semantically significant.)
> */
> do we need adjust this comment in ClassifyUtilityCommandAsReadOnly
> for the REPACK statement?

Not sure. The current version does not mention VACUUM. (Note that VACUUM FULL
does almost the same as CLUSTER.) We can adjust the comment during the removal
of CLUSTER sometime in the future.

>   <para>
>    <productname>PostgreSQL</productname> has the ability to report the
> progress of
>    certain commands during command execution.  Currently, the only commands
>    which support progress reporting are <command>ANALYZE</command>,
>    <command>CLUSTER</command>,
>    <command>CREATE INDEX</command>, <command>VACUUM</command>,
>    <command>COPY</command>,
>    and <xref linkend="protocol-replication-base-backup"/> (i.e., replication
>    command that <xref linkend="app-pgbasebackup"/> issues to take
>    a base backup).
>    This may be expanded in the future.
>   </para>
> also need to mention <command>REPACK</command>?

Fixed in [1].

> "The CLUSTER command is deprecated",
> then do we need to say something
> in doc/src/sgml/ref/clusterdb.sgml?

I'm not convinced at the moment. The page contains a link to the documentation
of CLUSTER, which does contain the deprecation note.

It's not even clear to me whether this utility must be removed. We can adjust
it so it calls REPACK instead of CLUSTER. And while doing that, we may or may
not rename it.

[1] https://www.postgresql.org/message-id/117560.1749464355%40localhost

-- 
Antonin Houska
Web: https://www.cybertec-postgresql.com