<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>ALTER SERVER</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REV="MADE"
HREF="mailto:pgsql-docs@postgresql.org"><LINK
REL="HOME"
TITLE="PostgreSQL 9.4.15 Documentation"
HREF="index.html"><LINK
REL="UP"
TITLE="SQL Commands"
HREF="sql-commands.html"><LINK
REL="PREVIOUS"
TITLE="ALTER SEQUENCE"
HREF="sql-altersequence.html"><LINK
REL="NEXT"
TITLE="ALTER SYSTEM"
HREF="sql-altersystem.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="stylesheet.css"><META
HTTP-EQUIV="Content-Type"
CONTENT="text/html; charset=ISO-8859-1"><META
NAME="creation"
CONTENT="2017-11-10T00:43:05"></HEAD
><BODY
CLASS="REFENTRY"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
VALIGN="bottom"
><A
HREF="index.html"
>PostgreSQL 9.4.15 Documentation</A
></TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="top"
><A
TITLE="ALTER SEQUENCE"
HREF="sql-altersequence.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="top"
><A
HREF="sql-commands.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="60%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="20%"
ALIGN="right"
VALIGN="top"
><A
TITLE="ALTER SYSTEM"
HREF="sql-altersystem.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="SQL-ALTERSERVER"
></A
>ALTER SERVER</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN69787"
></A
><H2
>Name</H2
>ALTER SERVER -- change the definition of a foreign server</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN69790"
></A
><H2
>Synopsis</H2
><PRE
CLASS="SYNOPSIS"
>ALTER SERVER <TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
> [ VERSION '<TT
CLASS="REPLACEABLE"
><I
>new_version</I
></TT
>' ]
[ OPTIONS ( [ ADD | SET | DROP ] <TT
CLASS="REPLACEABLE"
><I
>option</I
></TT
> ['<TT
CLASS="REPLACEABLE"
><I
>value</I
></TT
>'] [, ... ] ) ]
ALTER SERVER <TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
> OWNER TO <TT
CLASS="REPLACEABLE"
><I
>new_owner</I
></TT
>
ALTER SERVER <TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
> RENAME TO <TT
CLASS="REPLACEABLE"
><I
>new_name</I
></TT
></PRE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN69800"
></A
><H2
>Description</H2
><P
> <TT
CLASS="COMMAND"
>ALTER SERVER</TT
> 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.
</P
><P
> 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 <TT
CLASS="LITERAL"
>USAGE</TT
> privilege on the server's foreign-data
wrapper. (Note that superusers satisfy all these criteria
automatically.)
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN69806"
></A
><H2
>Parameters</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="REPLACEABLE"
><I
>name</I
></TT
></DT
><DD
><P
> The name of an existing server.
</P
></DD
><DT
><TT
CLASS="REPLACEABLE"
><I
>new_version</I
></TT
></DT
><DD
><P
> New server version.
</P
></DD
><DT
><TT
CLASS="LITERAL"
>OPTIONS ( [ ADD | SET | DROP ] <TT
CLASS="REPLACEABLE"
><I
>option</I
></TT
> ['<TT
CLASS="REPLACEABLE"
><I
>value</I
></TT
>'] [, ... ] )</TT
></DT
><DD
><P
> Change options for the
server. <TT
CLASS="LITERAL"
>ADD</TT
>, <TT
CLASS="LITERAL"
>SET</TT
>, and <TT
CLASS="LITERAL"
>DROP</TT
>
specify the action to be performed. <TT
CLASS="LITERAL"
>ADD</TT
> 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.
</P
></DD
><DT
><TT
CLASS="REPLACEABLE"
><I
>new_owner</I
></TT
></DT
><DD
><P
> The user name of the new owner of the foreign server.
</P
></DD
><DT
><TT
CLASS="REPLACEABLE"
><I
>new_name</I
></TT
></DT
><DD
><P
> The new name for the foreign server.
</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN69840"
></A
><H2
>Examples</H2
><P
> Alter server <TT
CLASS="LITERAL"
>foo</TT
>, add connection options:
</P><PRE
CLASS="PROGRAMLISTING"
>ALTER SERVER foo OPTIONS (host 'foo', dbname 'foodb');</PRE
><P>
</P
><P
> Alter server <TT
CLASS="LITERAL"
>foo</TT
>, change version,
change <TT
CLASS="LITERAL"
>host</TT
> option:
</P><PRE
CLASS="PROGRAMLISTING"
>ALTER SERVER foo VERSION '8.4' OPTIONS (SET host 'baz');</PRE
><P></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN69849"
></A
><H2
>Compatibility</H2
><P
> <TT
CLASS="COMMAND"
>ALTER SERVER</TT
> conforms to ISO/IEC 9075-9 (SQL/MED).
The <TT
CLASS="LITERAL"
>OWNER TO</TT
> and <TT
CLASS="LITERAL"
>RENAME</TT
> forms are
PostgreSQL extensions.
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN69855"
></A
><H2
>See Also</H2
><A
HREF="sql-createserver.html"
>CREATE SERVER</A
>, <A
HREF="sql-dropserver.html"
>DROP SERVER</A
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="sql-altersequence.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="sql-altersystem.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>ALTER SEQUENCE</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="sql-commands.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>ALTER SYSTEM</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
distrib
>
Mageia
>
6
>
armv7hl
>
media
>
core-updates
>
by-pkgid
>
a8985c53237f42e0cfdfd17da0a53df3
>
files
>
1039
