root/traduc/branches/bv747/manuel/ref/alter_database.sgml

<!--
$Header: /var/lib/cvs/pgsql-fr/sgml/ref/alter_database.sgml,v 1.6.2.1 2005/03/14 06:03:01 guillaume Exp $
PostgreSQL documentation
-->

<refentry id="SQL-ALTERDATABASE">
 <refmeta>
  <refentrytitle id="sql-alterdatabase-title">ALTER DATABASE</refentrytitle>
  <refmiscinfo>SQL - Instructions du langage</refmiscinfo>
 </refmeta>

 <refnamediv>
  <refname>ALTER DATABASE</refname>
  <refpurpose>modifie une base de données</refpurpose>
 </refnamediv>

 <indexterm zone="sql-alterdatabase">
  <primary>ALTER DATABASE</primary>
 </indexterm>

 <refsynopsisdiv>
<synopsis>
ALTER DATABASE <replaceable class="PARAMETER">nom</replaceable> SET
<replaceable>paramètre</replaceable> { TO | = } {
<replaceable>valeur</replaceable> | DEFAULT }
ALTER DATABASE <replaceable class="PARAMETER">nom</replaceable> RESET
<replaceable>paramètre</replaceable>
ALTER DATABASE <replaceable class="PARAMETER">nom</replaceable> RENAME TO
<replaceable>nouveau nom</replaceable>
</synopsis>
 </refsynopsisdiv>

 <refsect1>
  <title>Description</title>

  <para>
   <command>ALTER DATABASE</command> est utilisé pour modifier les attributs
   d'une base de données.
  </para>

  <para>
   Les deux premières formes modifient la session par défaut de la variable 
   de configuration de lancement d'une base PostgreSQL. Chaque fois qu'une
   nouvelle session est démarrée ultérieurement dans cette base, la valeur
   spécifiée devient la valeur de session par défaut. La valeur par défaut de la
   base prend le pas sur la configuration présente dans le fichier
   <filename>postgresql.conf</> ou sur celle qui a été reçue de la ligne de commande du
   <command>postmaster</command>.  Seul le propriétaire de la base ou le
   superutilisateur peut changer les valeurs par défaut de la session d'une
   base.
  </para>

  <para>
   La troisième forme modifie le nom de la base. Seul le propriétaire peut
   renommer une base, et seulement si il possède le privilège
   <literal>CREATEDB</literal>. La base utilisée ne peut pas être renommée.
   (Connectez-vous à une base différente si vous voulez faire ça).
  </para>
 </refsect1>

 <refsect1>
  <title>Paramètres</title>

    <variablelist>
     <varlistentry>
      <term><replaceable class="PARAMETER">nom</replaceable></term>
      <listitem>
       <para>
        Le nom d'une base dont les paramètres par défaut de la session seront
        modifiés.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><replaceable>paramètre</replaceable></term>
      <term><replaceable>valeur</replaceable></term>
      <listitem>
       <para>
        Place les paramètres par défaut de la session pour cette base à la
        valeur donnée. Si <replaceable>valeur</replaceable> est
        <literal>DEFAULT</literal> ou, de façon équivalente,
        <literal>RESET</literal> est utilisé, la variable de configuration de la
        base est supprimée et la configuration par défaut du système sera
        récupérée lors des nouvelles sessions. Utilisez <literal>RESET
        ALL</literal> pour rafraîchir toutes les configurations.
       </para>

       <para>
        Voir <xref linkend="sql-set" endterm="sql-set-title"> et <xref
        linkend="runtime-config"> pour plus d'informations sur les paramètres de
        nom et de valeur admis.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><replaceable>nouveau nom</replaceable></term>
      <listitem>
       <para>
        Le nouveau nom d'une base.
       </para>
      </listitem>
     </varlistentry>
  </variablelist>
 </refsect1>

 <refsect1>
  <title>Notes</title>

  <para>
   L'utilisation de <xref linkend="sql-alteruser"
   endterm="sql-alteruser-title">, est également possible pour lier une session
   par défaut à un utilisateur plutôt qu'à une base. Les configurations
   spécifiques à l'utilisateur prennent le pas sur celles spécifiques à la base
   s'il y a conflit.
  </para>
 </refsect1>

 <refsect1>
  <title>Exemples</title>

  <para>
   Pour désactiver les parcours d'index par défaut de la base
   <literal>test</literal>&nbsp;:

<programlisting>
ALTER DATABASE test SET enable_indexscan TO off;
</programlisting>
  </para>
 </refsect1>

 <refsect1>
  <title>Compatibilité</title>
    
  <para>
   La relation <command>ALTER DATABASE</command> est une extension 
   <productname>PostgreSQL</productname>.
  </para>
 </refsect1>

 <refsect1>
  <title>Voir aussi</title>

  <simplelist type="inline">
   <member><xref linkend="sql-alteruser" endterm="sql-alteruser-title"></member>
   <member><xref linkend="sql-createdatabase" endterm="sql-createdatabase-title"></member>
   <member><xref linkend="sql-dropdatabase" endterm="sql-dropdatabase-title"></member>
   <member><xref linkend="sql-set" endterm="sql-set-title"></member>
  </simplelist>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil
End:
-->