agora inbox for pgsql-docs@postgresql.org  
help / color / mirror / Atom feed
From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: petermittere@gmail.com
Subject: please define 'statement' in the glossary
Date: Fri, 11 Jul 2025 10:34:28 +0000
Message-ID: <175223006802.3157505.14764328206246105568@wrigleys.postgresql.org> (raw)

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


view thread (21+ messages)  latest in thread

Message-ID: <175223006802.3157505.14764328206246105568@wrigleys.postgresql.org>
Permalink:  ../175223006802.3157505.14764328206246105568@wrigleys.postgresql.org/
Also on:    postgresql.org/message-id/175223006802.3157505.14764328206246105568@wrigleys.postgresql.org

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, petermittere@gmail.com
  Subject: Re: please define 'statement' in the glossary
  In-Reply-To: <175223006802.3157505.14764328206246105568@wrigleys.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox