<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >ALTER DATABASE</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 8.0.11 Documentation" HREF="index.html"><LINK REL="UP" TITLE="SQL Commands" HREF="sql-commands.html"><LINK REL="PREVIOUS" TITLE="ALTER CONVERSION" HREF="sql-alterconversion.html"><LINK REL="NEXT" TITLE="ALTER DOMAIN" HREF="sql-alterdomain.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="2007-02-02T03:57:22"></HEAD ><BODY CLASS="REFENTRY" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="5" ALIGN="center" VALIGN="bottom" >PostgreSQL 8.0.11 Documentation</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="top" ><A HREF="sql-alterconversion.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="10%" ALIGN="left" VALIGN="top" ><A HREF="sql-alterconversion.html" >Fast Backward</A ></TD ><TD WIDTH="60%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="top" ><A HREF="sql-alterdomain.html" >Fast Forward</A ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="top" ><A HREF="sql-alterdomain.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="SQL-ALTERDATABASE" ></A >ALTER DATABASE</H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN36408" ></A ><H2 >Name</H2 >ALTER DATABASE -- change a database</DIV ><A NAME="AEN36411" ></A ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN36413" ></A ><H2 >Synopsis</H2 ><PRE CLASS="SYNOPSIS" >ALTER DATABASE <TT CLASS="REPLACEABLE" ><I >name</I ></TT > SET <TT CLASS="REPLACEABLE" ><I >parameter</I ></TT > { TO | = } { <TT CLASS="REPLACEABLE" ><I >value</I ></TT > | DEFAULT } ALTER DATABASE <TT CLASS="REPLACEABLE" ><I >name</I ></TT > RESET <TT CLASS="REPLACEABLE" ><I >parameter</I ></TT > ALTER DATABASE <TT CLASS="REPLACEABLE" ><I >name</I ></TT > RENAME TO <TT CLASS="REPLACEABLE" ><I >newname</I ></TT > ALTER DATABASE <TT CLASS="REPLACEABLE" ><I >name</I ></TT > OWNER TO <TT CLASS="REPLACEABLE" ><I >new_owner</I ></TT ></PRE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN36424" ></A ><H2 >Description</H2 ><P > <TT CLASS="COMMAND" >ALTER DATABASE</TT > changes the attributes of a database. </P ><P > The first two forms change the session default for a run-time configuration variable for a <SPAN CLASS="PRODUCTNAME" >PostgreSQL</SPAN > database. Whenever a new session is subsequently started in that database, the specified value becomes the session default value. The database-specific default overrides whatever setting is present in <TT CLASS="FILENAME" >postgresql.conf</TT > or has been received from the <TT CLASS="COMMAND" >postmaster</TT > command line. Only the database owner or a superuser can change the session defaults for a database. Certain variables cannot be set this way, or can only be set by a superuser. </P ><P > The third form changes the name of the database. Only the database owner or a superuser can rename a database; non-superuser owners must also have the <TT CLASS="LITERAL" >CREATEDB</TT > privilege. The current database cannot be renamed. (Connect to a different database if you need to do that.) </P ><P > The fourth form changes the owner of the database. Only a superuser can change the database's owner. </P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN36435" ></A ><H2 >Parameters</H2 ><P ></P ><DIV CLASS="VARIABLELIST" ><DL ><DT ><TT CLASS="REPLACEABLE" ><I >name</I ></TT ></DT ><DD ><P > The name of the database whose attributes are to be altered. </P ></DD ><DT ><TT CLASS="REPLACEABLE" ><I >parameter</I ></TT ><BR><TT CLASS="REPLACEABLE" ><I >value</I ></TT ></DT ><DD ><P > Set this database's session default for the specified configuration parameter to the given value. If <TT CLASS="REPLACEABLE" ><I >value</I ></TT > is <TT CLASS="LITERAL" >DEFAULT</TT > or, equivalently, <TT CLASS="LITERAL" >RESET</TT > is used, the database-specific setting is removed, so the system-wide default setting will be inherited in new sessions. Use <TT CLASS="LITERAL" >RESET ALL</TT > to clear all database-specific settings. </P ><P > See <A HREF="sql-set.html" ><I >SET</I ></A > and <A HREF="runtime-config.html" >Section 16.4</A > for more information about allowed parameter names and values. </P ></DD ><DT ><TT CLASS="REPLACEABLE" ><I >newname</I ></TT ></DT ><DD ><P > The new name of the database. </P ></DD ><DT ><TT CLASS="REPLACEABLE" ><I >new_owner</I ></TT ></DT ><DD ><P > The new owner of the database. </P ></DD ></DL ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN36467" ></A ><H2 >Notes</H2 ><P > It is also possible to tie a session default to a specific user rather than to a database; see <A HREF="sql-alteruser.html" ><I >ALTER USER</I ></A >. User-specific settings override database-specific ones if there is a conflict. </P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN36471" ></A ><H2 >Examples</H2 ><P > To disable index scans by default in the database <TT CLASS="LITERAL" >test</TT >: </P><PRE CLASS="PROGRAMLISTING" >ALTER DATABASE test SET enable_indexscan TO off;</PRE ><P> </P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN36476" ></A ><H2 >Compatibility</H2 ><P > The <TT CLASS="COMMAND" >ALTER DATABASE</TT > statement is a <SPAN CLASS="PRODUCTNAME" >PostgreSQL</SPAN > extension. </P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN36481" ></A ><H2 >See Also</H2 ><A HREF="sql-createdatabase.html" ><I >CREATE DATABASE</I ></A >, <A HREF="sql-dropdatabase.html" ><I >DROP DATABASE</I ></A >, <A HREF="sql-set.html" ><I >SET</I ></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-alterconversion.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-alterdomain.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >ALTER CONVERSION</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 DOMAIN</TD ></TR ></TABLE ></DIV ></BODY ></HTML >