Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ALTER SERVER(7)		PostgreSQL 9.6.19 Documentation	       ALTER SERVER(7)

NAME
       ALTER_SERVER - change the definition of a foreign server

SYNOPSIS
       ALTER SERVER name [ VERSION 'new_version' ]
	   [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [,	... ] )	]
       ALTER SERVER name OWNER TO { new_owner |	CURRENT_USER | SESSION_USER }
       ALTER SERVER name RENAME	TO new_name

DESCRIPTION
       ALTER SERVER changes the	definition of a	foreign	server.	The first form
       changes the server version string or the	generic	options	of the server
       (at least one clause is required). The second form changes the owner of
       the server.

       To alter	the server you must be the owner of the	server.	Additionally
       to alter	the owner, you must own	the server and also be a direct	or
       indirect	member of the new owning role, and you must have USAGE
       privilege on the	server's foreign-data wrapper. (Note that superusers
       satisfy all these criteria automatically.)

PARAMETERS
       name
	   The name of an existing server.

       new_version
	   New server version.

       OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]	)
	   Change options for the server.  ADD,	SET, and DROP specify the
	   action to be	performed.  ADD	is assumed if no operation is
	   explicitly specified. Option	names must be unique; names and	values
	   are also validated using the	server's foreign-data wrapper library.

       new_owner
	   The user name of the	new owner of the foreign server.

       new_name
	   The new name	for the	foreign	server.

EXAMPLES
       Alter server foo, add connection	options:

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

       Alter server foo, change	version, change	host option:

	   ALTER SERVER	foo VERSION '8.4' OPTIONS (SET host 'baz');

COMPATIBILITY
       ALTER SERVER conforms to	ISO/IEC	9075-9 (SQL/MED). The OWNER TO and
       RENAME forms are	PostgreSQL extensions.

SEE ALSO
       CREATE SERVER (CREATE_SERVER(7)), DROP SERVER (DROP_SERVER(7))

PostgreSQL 9.6.19		     2020		       ALTER SERVER(7)

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | EXAMPLES | COMPATIBILITY | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ALTER_SERVER&sektion=7&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help