RE: [16Beta1][doc] pgstat: Track time of the last scan of a relation

From: "Shinoda, Noriyoshi (PN Japan FSIP)" <noriyoshi(dot)shinoda(at)hpe(dot)com>
To: David Rowley <dgrowleyml(at)gmail(dot)com>
Cc: PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>, "dpage(at)pgadmin(dot)org" <dpage(at)pgadmin(dot)org>, "andres(at)anarazel(dot)de" <andres(at)anarazel(dot)de>, "bruce(at)momjian(dot)us" <bruce(at)momjian(dot)us>, "vik(at)postgresfriends(dot)org" <vik(at)postgresfriends(dot)org>
Subject: RE: [16Beta1][doc] pgstat: Track time of the last scan of a relation
Date: 2023-06-01 09:38:18
Message-ID: DM4PR84MB1734F413279B051DA0599E64EE499@DM4PR84MB1734.NAMPRD84.PROD.OUTLOOK.COM
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Hi, Thanks for your comment.
As you say, it would be difficult to unify the data types in all documents right now.
The patch I attached the other day unifies only the newly added columns in monitoring.sgml to "timestamp with time zone".

Regards,
Noriyoshi Shinoda
-----Original Message-----
From: David Rowley <dgrowleyml(at)gmail(dot)com>
Sent: Wednesday, May 31, 2023 3:14 PM
To: Shinoda, Noriyoshi (PN Japan FSIP) <noriyoshi(dot)shinoda(at)hpe(dot)com>
Cc: PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>; dpage(at)pgadmin(dot)org; andres(at)anarazel(dot)de; bruce(at)momjian(dot)us; vik(at)postgresfriends(dot)org
Subject: Re: [16Beta1][doc] pgstat: Track time of the last scan of a relation

On Wed, 31 May 2023 at 15:57, Shinoda, Noriyoshi (PN Japan FSIP) <noriyoshi(dot)shinoda(at)hpe(dot)com> wrote:
> According to the documentation [2], the data type of the columns added to these views is 'timestamptz'.
> However, columns of the same data type in pg_stat_all_tables.last_vacuum, last_analyze and other tables are unified to 'timestamp with time zone'. The attached patch changes the data type of the added column from timestamptz to timestamp with time zone.

I agree that it would be good to make those consistently use timestamp with time zone for all columns of that type in the docs for pg_stat_all_tables.

More generally, it might be good if we did it for the entire docs:

doc $ git grep "<type>timestamptz</type>" | wc -l
17
doc $ git grep "<type>timestamp with time zone</type>" | wc -l
74

Clearly "timestamp with time zone" is much more commonly used.

The bar is probably set a bit higher for changing the longer-established ones, however.

David

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Greg Stark 2023-06-01 10:47:40 Re: Avoiding another needless ERROR during nbtree page deletion
Previous Message Daniel Gustafsson 2023-06-01 08:22:28 Re: Docs: Encourage strong server verification with SCRAM