Thread: ALTER SERVER SYNTAX ISSUE

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/10/static/sql-alterserver.html
Description:

I found that the alter server statement below does not work:

ALTER SERVER foo OPTIONS (host 'foo', dbname 'foodb');

but this does:

ALTER SERVER foo OPTIONS (set host 'foo', set dbname 'foodb');

=?utf-8?q?PG_Doc_comments_form?= <noreply@postgresql.org> writes:
> I found that the alter server statement below does not work:
> ALTER SERVER foo OPTIONS (host 'foo', dbname 'foodb');
> but this does:
> ALTER SERVER foo OPTIONS (set host 'foo', set dbname 'foodb');

Hm, define "does not work".  Those aren't equivalent: the first
form adds options that weren't already set, while the second one
changes the values of already-set options.  (The SQL committee
were being unreasonably nitpicky in not providing an add-or-replace
choice, IMO, but that's how the spec is written.)

Is your complaint just that this is inadequately documented?
I see that it's not spelled out in so many words on that page.

            regards, tom lane