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
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 |