please define 'statement' in the glossary

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: petermittere(at)gmail(dot)com
Subject: please define 'statement' in the glossary
Date: 2025-07-11 10:34:28
Message-ID: 175223006802.3157505.14764328206246105568@wrigleys.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/17/glossary.html
Description:

Hello,
the glossary (https://www.postgresql.org/docs/current/glossary.html) does
not define 'statement' but a definition would be important to understand
other chapters such as this sentence: "statement_timestamp() returns the
start time of the current statement (more specifically, the time of receipt
of the latest command message from the client)." The sentence is from
https://www.postgresql.org/docs/17/functions-datetime.html#FUNCTIONS-DATETIME-CURRENT.
From the same page is this snippet: "start of current statement", in Table
9.33. Date/Time Functions.
It seems 'statement' can mean different things such as 'one operation, such
as a SELECT statement', but it can also mean 'all operations since the last
command message from the client, which can be several SELECTs'.
Thank you
Peter

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2025-07-11 16:12:11 Unclear wording
Previous Message PG Doc comments form 2025-07-11 08:41:21 the docs for NOTIFY do not mention the global lock that NOTIFY takes