# ALTER_SERVER - change the definition of a foreign server - man(7) - [phpMan]

_ALTER_ [_SERVER_(7)](https://www.chedong.com/phpMan.php/man/SERVER/7/markdown)                    PostgreSQL 16.14 Documentation                    _ALTER_ [_SERVER_(7)](https://www.chedong.com/phpMan.php/man/SERVER/7/markdown)

## 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_ROLE | 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 be able to SET ROLE to 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)](https://www.chedong.com/phpMan.php/man/CREATESERVER/7/markdown)), DROP SERVER ([**DROP_SERVER**(7)](https://www.chedong.com/phpMan.php/man/DROPSERVER/7/markdown))

PostgreSQL 16.14                                2026                                 _ALTER_ [_SERVER_(7)](https://www.chedong.com/phpMan.php/man/SERVER/7/markdown)