[Trad] [svn:pgfr] r1293 - traduc/trunk/postgresql/ref
admin at listes.postgresql.fr
admin at listes.postgresql.fr
Lun 13 Avr 17:20:18 CEST 2009
Author: gleu
Date: 2009-04-13 17:20:17 +0200 (Mon, 13 Apr 2009)
New Revision: 1293
Added:
traduc/trunk/postgresql/ref/alter_foreign_data_wrapper.xml
traduc/trunk/postgresql/ref/alter_server.xml
traduc/trunk/postgresql/ref/alter_user_mapping.xml
traduc/trunk/postgresql/ref/create_foreign_data_wrapper.xml
traduc/trunk/postgresql/ref/create_server.xml
traduc/trunk/postgresql/ref/create_user_mapping.xml
traduc/trunk/postgresql/ref/drop_foreign_data_wrapper.xml
traduc/trunk/postgresql/ref/drop_server.xml
traduc/trunk/postgresql/ref/drop_user_mapping.xml
Modified:
traduc/trunk/postgresql/ref/abort.xml
traduc/trunk/postgresql/ref/allfiles.xml
traduc/trunk/postgresql/ref/alter_aggregate.xml
traduc/trunk/postgresql/ref/alter_conversion.xml
traduc/trunk/postgresql/ref/alter_database.xml
traduc/trunk/postgresql/ref/alter_domain.xml
traduc/trunk/postgresql/ref/alter_function.xml
traduc/trunk/postgresql/ref/alter_group.xml
traduc/trunk/postgresql/ref/alter_index.xml
traduc/trunk/postgresql/ref/alter_language.xml
traduc/trunk/postgresql/ref/alter_opclass.xml
traduc/trunk/postgresql/ref/alter_operator.xml
traduc/trunk/postgresql/ref/alter_opfamily.xml
traduc/trunk/postgresql/ref/alter_role.xml
traduc/trunk/postgresql/ref/alter_schema.xml
traduc/trunk/postgresql/ref/alter_sequence.xml
traduc/trunk/postgresql/ref/alter_table.xml
traduc/trunk/postgresql/ref/alter_tablespace.xml
traduc/trunk/postgresql/ref/alter_trigger.xml
traduc/trunk/postgresql/ref/alter_tsconfig.xml
traduc/trunk/postgresql/ref/alter_tsdictionary.xml
traduc/trunk/postgresql/ref/alter_tsparser.xml
traduc/trunk/postgresql/ref/alter_tstemplate.xml
traduc/trunk/postgresql/ref/alter_type.xml
traduc/trunk/postgresql/ref/alter_user.xml
traduc/trunk/postgresql/ref/alter_view.xml
traduc/trunk/postgresql/ref/analyze.xml
traduc/trunk/postgresql/ref/begin.xml
traduc/trunk/postgresql/ref/checkpoint.xml
traduc/trunk/postgresql/ref/close.xml
traduc/trunk/postgresql/ref/cluster.xml
traduc/trunk/postgresql/ref/clusterdb.xml
traduc/trunk/postgresql/ref/comment.xml
traduc/trunk/postgresql/ref/commit.xml
traduc/trunk/postgresql/ref/commit_prepared.xml
traduc/trunk/postgresql/ref/copy.xml
traduc/trunk/postgresql/ref/create_aggregate.xml
traduc/trunk/postgresql/ref/create_cast.xml
traduc/trunk/postgresql/ref/create_constraint.xml
traduc/trunk/postgresql/ref/create_conversion.xml
traduc/trunk/postgresql/ref/create_database.xml
traduc/trunk/postgresql/ref/create_domain.xml
traduc/trunk/postgresql/ref/create_function.xml
traduc/trunk/postgresql/ref/create_group.xml
traduc/trunk/postgresql/ref/create_index.xml
traduc/trunk/postgresql/ref/create_language.xml
traduc/trunk/postgresql/ref/create_opclass.xml
traduc/trunk/postgresql/ref/create_operator.xml
traduc/trunk/postgresql/ref/create_opfamily.xml
traduc/trunk/postgresql/ref/create_role.xml
traduc/trunk/postgresql/ref/create_rule.xml
traduc/trunk/postgresql/ref/create_schema.xml
traduc/trunk/postgresql/ref/create_sequence.xml
traduc/trunk/postgresql/ref/create_table.xml
traduc/trunk/postgresql/ref/create_table_as.xml
traduc/trunk/postgresql/ref/create_tablespace.xml
traduc/trunk/postgresql/ref/create_trigger.xml
traduc/trunk/postgresql/ref/create_tsconfig.xml
traduc/trunk/postgresql/ref/create_tsdictionary.xml
traduc/trunk/postgresql/ref/create_tsparser.xml
traduc/trunk/postgresql/ref/create_tstemplate.xml
traduc/trunk/postgresql/ref/create_type.xml
traduc/trunk/postgresql/ref/create_user.xml
traduc/trunk/postgresql/ref/create_view.xml
traduc/trunk/postgresql/ref/createdb.xml
traduc/trunk/postgresql/ref/createlang.xml
traduc/trunk/postgresql/ref/createuser.xml
traduc/trunk/postgresql/ref/deallocate.xml
traduc/trunk/postgresql/ref/declare.xml
traduc/trunk/postgresql/ref/delete.xml
traduc/trunk/postgresql/ref/discard.xml
traduc/trunk/postgresql/ref/drop_aggregate.xml
traduc/trunk/postgresql/ref/drop_cast.xml
traduc/trunk/postgresql/ref/drop_conversion.xml
traduc/trunk/postgresql/ref/drop_database.xml
traduc/trunk/postgresql/ref/drop_domain.xml
traduc/trunk/postgresql/ref/drop_function.xml
traduc/trunk/postgresql/ref/drop_group.xml
traduc/trunk/postgresql/ref/drop_index.xml
traduc/trunk/postgresql/ref/drop_language.xml
traduc/trunk/postgresql/ref/drop_opclass.xml
traduc/trunk/postgresql/ref/drop_operator.xml
traduc/trunk/postgresql/ref/drop_opfamily.xml
traduc/trunk/postgresql/ref/drop_owned.xml
traduc/trunk/postgresql/ref/drop_role.xml
traduc/trunk/postgresql/ref/drop_rule.xml
traduc/trunk/postgresql/ref/drop_schema.xml
traduc/trunk/postgresql/ref/drop_sequence.xml
traduc/trunk/postgresql/ref/drop_table.xml
traduc/trunk/postgresql/ref/drop_tablespace.xml
traduc/trunk/postgresql/ref/drop_trigger.xml
traduc/trunk/postgresql/ref/drop_tsconfig.xml
traduc/trunk/postgresql/ref/drop_tsdictionary.xml
traduc/trunk/postgresql/ref/drop_tsparser.xml
traduc/trunk/postgresql/ref/drop_tstemplate.xml
traduc/trunk/postgresql/ref/drop_type.xml
traduc/trunk/postgresql/ref/drop_user.xml
traduc/trunk/postgresql/ref/drop_view.xml
traduc/trunk/postgresql/ref/dropdb.xml
traduc/trunk/postgresql/ref/droplang.xml
traduc/trunk/postgresql/ref/dropuser.xml
traduc/trunk/postgresql/ref/end.xml
traduc/trunk/postgresql/ref/execute.xml
traduc/trunk/postgresql/ref/explain.xml
traduc/trunk/postgresql/ref/fetch.xml
traduc/trunk/postgresql/ref/grant.xml
traduc/trunk/postgresql/ref/initdb.xml
traduc/trunk/postgresql/ref/insert.xml
traduc/trunk/postgresql/ref/listen.xml
traduc/trunk/postgresql/ref/load.xml
traduc/trunk/postgresql/ref/lock.xml
traduc/trunk/postgresql/ref/move.xml
traduc/trunk/postgresql/ref/notify.xml
traduc/trunk/postgresql/ref/pg_config-ref.xml
traduc/trunk/postgresql/ref/pg_controldata.xml
traduc/trunk/postgresql/ref/pg_ctl-ref.xml
traduc/trunk/postgresql/ref/pg_dump.xml
traduc/trunk/postgresql/ref/pg_dumpall.xml
traduc/trunk/postgresql/ref/pg_resetxlog.xml
traduc/trunk/postgresql/ref/pg_restore.xml
traduc/trunk/postgresql/ref/prepare.xml
traduc/trunk/postgresql/ref/prepare_transaction.xml
traduc/trunk/postgresql/ref/psql-ref.xml
traduc/trunk/postgresql/ref/reassign_owned.xml
traduc/trunk/postgresql/ref/reindex.xml
traduc/trunk/postgresql/ref/reindexdb.xml
traduc/trunk/postgresql/ref/release_savepoint.xml
traduc/trunk/postgresql/ref/reset.xml
traduc/trunk/postgresql/ref/revoke.xml
traduc/trunk/postgresql/ref/rollback.xml
traduc/trunk/postgresql/ref/rollback_prepared.xml
traduc/trunk/postgresql/ref/rollback_to.xml
traduc/trunk/postgresql/ref/savepoint.xml
traduc/trunk/postgresql/ref/select.xml
traduc/trunk/postgresql/ref/select_into.xml
traduc/trunk/postgresql/ref/set.xml
traduc/trunk/postgresql/ref/set_constraints.xml
traduc/trunk/postgresql/ref/set_role.xml
traduc/trunk/postgresql/ref/set_session_auth.xml
traduc/trunk/postgresql/ref/set_transaction.xml
traduc/trunk/postgresql/ref/show.xml
traduc/trunk/postgresql/ref/start_transaction.xml
traduc/trunk/postgresql/ref/truncate.xml
traduc/trunk/postgresql/ref/unlisten.xml
traduc/trunk/postgresql/ref/update.xml
traduc/trunk/postgresql/ref/vacuum.xml
traduc/trunk/postgresql/ref/vacuumdb.xml
traduc/trunk/postgresql/ref/values.xml
Log:
Merge 8.4 : ?\195?\169tape 3.
Modified: traduc/trunk/postgresql/ref/abort.xml
===================================================================
--- traduc/trunk/postgresql/ref/abort.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/abort.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-abort">
<refmeta>
<refentrytitle id="sql-abort-title">ABORT</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/allfiles.xml
===================================================================
--- traduc/trunk/postgresql/ref/allfiles.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/allfiles.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -10,6 +10,7 @@
<!ENTITY alterConversion SYSTEM "alter_conversion.xml">
<!ENTITY alterDatabase SYSTEM "alter_database.xml">
<!ENTITY alterDomain SYSTEM "alter_domain.xml">
+<!entity alterForeignDataWrapper system "alter_foreign_data_wrapper.sgml">
<!ENTITY alterFunction SYSTEM "alter_function.xml">
<!ENTITY alterGroup SYSTEM "alter_group.xml">
<!ENTITY alterIndex SYSTEM "alter_index.xml">
@@ -19,6 +20,7 @@
<!ENTITY alterOperatorFamily SYSTEM "alter_opfamily.xml">
<!ENTITY alterRole SYSTEM "alter_role.xml">
<!ENTITY alterSchema SYSTEM "alter_schema.xml">
+<!entity alterServer system "alter_server.sgml">
<!ENTITY alterSequence SYSTEM "alter_sequence.xml">
<!ENTITY alterTable SYSTEM "alter_table.xml">
<!ENTITY alterTableSpace SYSTEM "alter_tablespace.xml">
@@ -29,6 +31,7 @@
<!ENTITY alterTrigger SYSTEM "alter_trigger.xml">
<!ENTITY alterType SYSTEM "alter_type.xml">
<!ENTITY alterUser SYSTEM "alter_user.xml">
+<!entity alterUserMapping system "alter_user_mapping.sgml">
<!ENTITY alterView SYSTEM "alter_view.xml">
<!ENTITY analyze SYSTEM "analyze.xml">
<!ENTITY begin SYSTEM "begin.xml">
@@ -45,6 +48,7 @@
<!ENTITY createConversion SYSTEM "create_conversion.xml">
<!ENTITY createDatabase SYSTEM "create_database.xml">
<!ENTITY createDomain SYSTEM "create_domain.xml">
+<!entity createForeignDataWrapper system "create_foreign_data_wrapper.sgml">
<!ENTITY createFunction SYSTEM "create_function.xml">
<!ENTITY createGroup SYSTEM "create_group.xml">
<!ENTITY createIndex SYSTEM "create_index.xml">
@@ -56,6 +60,7 @@
<!ENTITY createRule SYSTEM "create_rule.xml">
<!ENTITY createSchema SYSTEM "create_schema.xml">
<!ENTITY createSequence SYSTEM "create_sequence.xml">
+<!entity createServer system "create_server.sgml">
<!ENTITY createTable SYSTEM "create_table.xml">
<!ENTITY createTableAs SYSTEM "create_table_as.xml">
<!ENTITY createTableSpace SYSTEM "create_tablespace.xml">
@@ -66,6 +71,7 @@
<!ENTITY createTSTemplate SYSTEM "create_tstemplate.xml">
<!ENTITY createType SYSTEM "create_type.xml">
<!ENTITY createUser SYSTEM "create_user.xml">
+<!entity createUserMapping system "create_user_mapping.sgml">
<!ENTITY createView SYSTEM "create_view.xml">
<!ENTITY deallocate SYSTEM "deallocate.xml">
<!ENTITY declare SYSTEM "declare.xml">
@@ -76,6 +82,7 @@
<!ENTITY dropConversion SYSTEM "drop_conversion.xml">
<!ENTITY dropDatabase SYSTEM "drop_database.xml">
<!ENTITY dropDomain SYSTEM "drop_domain.xml">
+<!entity dropForeignDataWrapper system "drop_foreign_data_wrapper.sgml">
<!ENTITY dropFunction SYSTEM "drop_function.xml">
<!ENTITY dropGroup SYSTEM "drop_group.xml">
<!ENTITY dropIndex SYSTEM "drop_index.xml">
@@ -88,6 +95,7 @@
<!ENTITY dropRule SYSTEM "drop_rule.xml">
<!ENTITY dropSchema SYSTEM "drop_schema.xml">
<!ENTITY dropSequence SYSTEM "drop_sequence.xml">
+<!entity dropServer system "drop_server.sgml">
<!ENTITY dropTable SYSTEM "drop_table.xml">
<!ENTITY dropTableSpace SYSTEM "drop_tablespace.xml">
<!ENTITY dropTrigger SYSTEM "drop_trigger.xml">
@@ -97,6 +105,7 @@
<!ENTITY dropTSTemplate SYSTEM "drop_tstemplate.xml">
<!ENTITY dropType SYSTEM "drop_type.xml">
<!ENTITY dropUser SYSTEM "drop_user.xml">
+<!entity dropUserMapping system "drop_user_mapping.sgml">
<!ENTITY dropView SYSTEM "drop_view.xml">
<!ENTITY end SYSTEM "end.xml">
<!ENTITY execute SYSTEM "execute.xml">
@@ -145,7 +154,6 @@
<!ENTITY dropuser SYSTEM "dropuser.xml">
<!ENTITY ecpgRef SYSTEM "ecpg-ref.xml">
<!ENTITY initdb SYSTEM "initdb.xml">
-<!ENTITY ipcclean SYSTEM "ipcclean.xml">
<!ENTITY pgConfig SYSTEM "pg_config-ref.xml">
<!ENTITY pgControldata SYSTEM "pg_controldata.xml">
<!ENTITY pgCtl SYSTEM "pg_ctl-ref.xml">
Modified: traduc/trunk/postgresql/ref/alter_aggregate.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_aggregate.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_aggregate.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alteraggregate">
<refmeta>
<refentrytitle id="sql-alteraggregate-title">ALTER AGGREGATE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_conversion.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_conversion.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_conversion.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alterconversion">
<refmeta>
<refentrytitle id="sql-alterconversion-title">ALTER CONVERSION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_database.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_database.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_database.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alterdatabase">
<refmeta>
<refentrytitle id="sql-alterdatabase-title">ALTER DATABASE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -26,6 +27,8 @@
ALTER DATABASE <replaceable class="parameter">nom</replaceable> RENAME TO <replaceable>nouveau_nom</replaceable>
ALTER DATABASE <replaceable class="parameter">nom</replaceable> OWNER TO <replaceable>nouveau_propriétaire</replaceable>
+ALTER DATABASE <replaceable class="PARAMETER">name</replaceable> SET TABLESPACE <replaceable class="PARAMETER">new_tablespace</replaceable>
+
ALTER DATABASE <replaceable class="parameter">nom</replaceable> SET <replaceable>paramètre</replaceable> { TO | = } { <replaceable>valeur</replaceable> | DEFAULT }
ALTER DATABASE <replaceable class="parameter">nom</replaceable> SET <replaceable>paramètre</replaceable> FROM CURRENT
ALTER DATABASE <replaceable class="parameter">nom</replaceable> RESET <replaceable>paramètre</replaceable>
@@ -68,6 +71,15 @@
</para>
<para>
+ The fourth form changes the default tablespace of the database.
+ Only the database owner or a superuser can do this; you must also have
+ create privilege for the new tablespace.
+ This command physically moves any tables or indexes in the database's old
+ default tablespace to the new tablespace. Note that tables and indexes
+ in non-default tablespaces are not affected.
+ </para>
+
+ <para>
Les formes restantes modifient la valeur par défaut d'un paramètre de
configuration pour une base <productname>PostgreSQL</productname>. Par la
suite, à chaque fois qu'une nouvelle session est lancée, la valeur
@@ -124,6 +136,15 @@
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><replaceable class="parameter">new_tablespace</replaceable></term>
+ <listitem>
+ <para>
+ The new default tablespace of the database.
+ </para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term><replaceable>paramètre</replaceable></term>
<term><replaceable>valeur</replaceable></term>
@@ -188,6 +209,7 @@
<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>
+ <member><xref linkend="sql-createtablespace" endterm="sql-createtablespace-title"></member>
</simplelist>
</refsect1>
</refentry>
Modified: traduc/trunk/postgresql/ref/alter_domain.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_domain.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_domain.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alterdomain">
<refmeta>
<refentrytitle id="sql-alterdomain-title">ALTER DOMAIN</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Added: traduc/trunk/postgresql/ref/alter_foreign_data_wrapper.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_foreign_data_wrapper.xml (rev 0)
+++ traduc/trunk/postgresql/ref/alter_foreign_data_wrapper.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -0,0 +1,143 @@
+<!--
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_foreign_data_wrapper.sgml,v 1.2 2009-02-24 10:06:32 petere Exp $
+PostgreSQL documentation
+-->
+
+<refentry id="SQL-ALTERFOREIGNDATAWRAPPER">
+ <refmeta>
+ <refentrytitle id="sql-alterforeigndatawrapper-title">ALTER FOREIGN DATA WRAPPER</refentrytitle>
+ <refmiscinfo>SQL - Language Statements</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>ALTER FOREIGN DATA WRAPPER</refname>
+ <refpurpose>change the definition of a foreign-data wrapper</refpurpose>
+ </refnamediv>
+
+ <indexterm zone="sql-alterforeigndatawrapper">
+ <primary>ALTER FOREIGN DATA WRAPPER</primary>
+ </indexterm>
+
+ <refsynopsisdiv>
+<synopsis>
+ALTER FOREIGN DATA WRAPPER <replaceable class="parameter">name</replaceable>
+ [ VALIDATOR <replaceable class="parameter">valfunction</replaceable> | NO VALIDATOR ]
+ [ OPTIONS ( [ ADD | SET | DROP ] <replaceable class="PARAMETER">option</replaceable> ['<replaceable class="PARAMETER">value</replaceable>'] [, ... ]) ]
+ALTER FOREIGN DATA WRAPPER <replaceable class="parameter">name</replaceable> OWNER TO <replaceable>new_owner</replaceable>
+</synopsis>
+ </refsynopsisdiv>
+
+ <refsect1>
+ <title>Description</title>
+
+ <para>
+ <command>ALTER FOREIGN DATA WRAPPER</command> changes the
+ definition of a foreign-data wrapper. The first form of the
+ command changes the library or the generic options of the
+ foreign-data wrapper (at least one clause is required). The second
+ form changes the owner of the foreign-data wrapper.
+ </para>
+
+ <para>
+ Only superusers can alter foreign-data wrappers. Additionally,
+ only superusers can own foreign-data wrappers.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Parameters</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><replaceable class="parameter">name</replaceable></term>
+ <listitem>
+ <para>
+ The name of an existing foreign-data wrapper.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>VALIDATOR <replaceable class="parameter">valfunction</replaceable></literal></term>
+ <listitem>
+ <para>
+ Specifies a new foreign-data wrapper validator function.
+ </para>
+
+ <para>
+ Note that it is possible that after changing the validator the
+ options to the foreign-data wrapper, servers, and user mappings
+ have become invalid. It is up to the user to make sure that
+ these options are correct before using the foreign-data
+ wrapper.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>NO VALIDATOR</literal></term>
+ <listitem>
+ <para>
+ This is used to specify that the foreign-data wrapper should no
+ longer have a validator function.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>OPTIONS ( [ ADD | SET | DROP ] <replaceable class="PARAMETER">option</replaceable> ['<replaceable class="PARAMETER">value</replaceable>'] [, ... ] )</literal></term>
+ <listitem>
+ <para>
+ Change options for the foreign-data
+ wrapper. <literal>ADD</>, <literal>SET</>, and <literal>DROP</>
+ specify the action to be performed. <literal>ADD</> is assumed
+ if no operation is explicitly specified. Option names must be
+ unique; names and values are also validated using the foreign
+ data wrapper library.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>
+ Change a foreign-data wrapper <literal>dbi</>, add
+ option <literal>foo</>, drop <literal>bar</>:
+<programlisting>
+ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP 'bar');
+</programlisting>
+ </para>
+
+ <para>
+ Change the foreign-data wrapper <literal>dbi</> validator
+ to <literal>bob.myvalidator</>:
+<programlisting>
+ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob.myvalidator;
+</programlisting>
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Compatibility</title>
+
+ <para>
+ <command>ALTER FOREIGN DATA WRAPPER</command> conforms to ISO/IEC
+ 9075-9 (SQL/MED). The standard does not specify the <literal>
+ VALIDATOR</literal> and <literal>OWNER TO</> variants of the
+ command.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-createforeigndatawrapper" endterm="sql-createforeigndatawrapper-title"></member>
+ <member><xref linkend="sql-dropforeigndatawrapper" endterm="sql-dropforeigndatawrapper-title"></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
Modified: traduc/trunk/postgresql/ref/alter_function.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_function.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_function.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alterfunction">
<refmeta>
<refentrytitle id="sql-alterfunction-title">ALTER FUNCTION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -82,12 +83,14 @@
<listitem>
<para>
- Le mode d'un argument : <literal>IN</literal>, <literal>OUT</literal>
- ou <literal>INOUT</literal>. En cas d'omission, la valeur par défaut est
- <literal>IN</literal>. <command>ALTER FUNCTION</command> ne tient pas compte
- des arguments <literal>OUT</literal>, car seuls les arguments en entrée
- sont nécessaire pour déterminer l'identité de la fonction. Les arguments
- <literal>IN</literal> et <literal>INOUT</literal> sont donc suffisants.
+ Le mode d'un argument : <literal>IN</literal>, <literal>OUT</literal>,
+ <literal>INOUT</literal> ou <literal>VARIADIC</>. En cas d'omission, la
+ valeur par défaut est <literal>IN</literal>. <command>ALTER
+ FUNCTION</command> ne tient pas compte des arguments <literal>OUT</literal>,
+ car seuls les arguments en entrée sont nécessaire pour déterminer
+ l'identité de la fonction. Les arguments <literal>IN</literal>,
+ <literal>INOUT</literal> et <literal>VARIADIC</literal> sont donc
+ suffisants.
</para>
</listitem>
</varlistentry>
Modified: traduc/trunk/postgresql/ref/alter_group.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_group.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_group.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-altergroup">
<refmeta>
<refentrytitle id="sql-altergroup-title">ALTER GROUP</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_index.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_index.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_index.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alterindex">
<refmeta>
<refentrytitle id="sql-alterindex-title">ALTER INDEX</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_language.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_language.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_language.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alterlanguage">
<refmeta>
<refentrytitle id="sql-alterlanguage-title">ALTER LANGUAGE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_opclass.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_opclass.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_opclass.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alteropclass">
<refmeta>
<refentrytitle id="sql-alteropclass-title">ALTER OPERATOR CLASS</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_operator.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_operator.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_operator.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alteroperator">
<refmeta>
<refentrytitle id="sql-alteroperator-title">ALTER OPERATOR</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instruction du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_opfamily.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_opfamily.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_opfamily.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -6,6 +6,7 @@
<refentry id="sql-alteropfamily">
<refmeta>
<refentrytitle id="sql-alteropfamily-title">ALTER OPERATOR FAMILY</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage SQL</refmiscinfo>
</refmeta>
@@ -22,7 +23,7 @@
<synopsis>
ALTER OPERATOR FAMILY <replaceable>nom</replaceable> USING <replaceable class="parameter">methode_indexage</replaceable> ADD
- { OPERATOR <replaceable class="parameter">numero_strategie</replaceable> <replaceable class="parameter">nom_operateur</replaceable> ( <replaceable class="parameter">tpe_op</replaceable>, <replaceable class="parameter">type_op</replaceable> ) [ RECHECK ]
+ { OPERATOR <replaceable class="parameter">numero_strategie</replaceable> <replaceable class="parameter">nom_operateur</replaceable> ( <replaceable class="parameter">tpe_op</replaceable>, <replaceable class="parameter">type_op</replaceable> )
| FUNCTION <replaceable class="parameter">numero_support</replaceable> [ ( <replaceable class="parameter">type_op</replaceable> [ , <replaceable class="parameter">type_op</replaceable> ] ) ] <replaceable class="parameter">nom_fonction</replaceable> ( <replaceable class="parameter">type_argument</replaceable> [, ...] )
} [, ... ]
ALTER OPERATOR FAMILY <replaceable>nom</replaceable> USING <replaceable class="parameter">methode_indexage</replaceable> DROP
@@ -156,18 +157,6 @@
</varlistentry>
<varlistentry>
- <term><literal>RECHECK</literal></term>
- <listitem>
- <para>
- Si présent, l'index est « à perte » (<quote>lossy</quote>) pour cet
- opérateur et, du coup, les lignes récupérées utilisant l'index doivent
- être de nouveau vérifiées pour s'assurer qu'elles vérifient bien la clause
- de qualification impliquant cet opérateur.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
<term><replaceable class="parameter">numero_support</replaceable></term>
<listitem>
<para>
@@ -250,6 +239,14 @@
fonction SQL risque d'être remplacée dans la requête appelante, ce qui
empêchera l'optimiseur de savoir si la requête peut utiliser un index.
</para>
+
+ <para>
+ Before <productname>PostgreSQL</productname> 8.4, the <literal>OPERATOR</>
+ clause could include a <literal>RECHECK</> option. This is no longer
+ supported because whether an index operator is <quote>lossy</> is now
+ determined on-the-fly at runtime. This allows efficient handling of
+ cases where an operator might or might not be lossy.
+ </para>
</refsect1>
<refsect1>
Modified: traduc/trunk/postgresql/ref/alter_role.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_role.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_role.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alterrole">
<refmeta>
<refentrytitle id="sql-alterrole-title">ALTER ROLE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -86,9 +87,9 @@
lance une nouvelle session après cela, la valeur spécifiée devient la valeur
par défaut de la session, surchargeant tout paramètrage présent dans
<filename>postgresql.conf</filename> ou provenant de la ligne de
- commande de <command>postgres</command>. (Pour un rôle privé du droit
- <literal>LOGIN</literal>, les valeurs par défaut de la session n'ont aucun effet.)
- Les rôles ordinaires peuvent changer leurs valeurs de sesion par défaut.
+ commande de postgres. This only happens at login time, so configuration
+ settings associated with a role to which you've <xref
+ linkend="sql-set-role" endterm="sql-set-role-title"> will be ignored.
Les superutilisateurs peuvent modifier les valeurs de session de
n'importe quel utilisateur. Les rôles disposant du droit <literal>CREATEROLE</literal>
peuvent modifier les valeurs par défaut pour les rôles ordinaires (non
@@ -165,6 +166,12 @@
</para>
<para>
+ Role-specific variable setting take effect only at login;
+ <xref linkend="sql-set-role" endterm="sql-set-role-title">
+ does not process role-specific variable settings.
+ </para>
+
+ <para>
Voir <xref linkend="sql-set" endterm="sql-set-title"/> et <xref linkend="runtime-config"/>
pour plus d'informations sur les noms et les valeurs autorisés pour les paramètres.
</para>
@@ -217,6 +224,14 @@
</para>
<para>
+ Remove a role's password:
+
+<programlisting>
+ALTER ROLE davide WITH PASSWORD NULL;
+</programlisting>
+ </para>
+
+ <para>
Modifier la date d'expiration d'un mot de passe, en spécifiant que le mot de
passe doit expirer à midi le 4 mai 2015 fuseau horaire
<acronym>UTC</acronym> plus 1 heure :
Modified: traduc/trunk/postgresql/ref/alter_schema.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_schema.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_schema.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alterschema">
<refmeta>
<refentrytitle id="sql-alterschema-title">ALTER SCHEMA</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_sequence.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_sequence.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_sequence.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-altersequence">
<refmeta>
<refentrytitle id="sql-altersequence-title">ALTER SEQUENCE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -23,8 +24,11 @@
<refsynopsisdiv>
<synopsis>ALTER SEQUENCE <replaceable class="parameter">nom</replaceable> [ INCREMENT [ BY ] <replaceable class="parameter">increment</replaceable> ]
[ MINVALUE <replaceable class="parameter">valeurmin</replaceable> | NO MINVALUE ] [ MAXVALUE <replaceable class="parameter">valeurmax</replaceable> | NO MAXVALUE ]
- [ RESTART [ WITH ] <replaceable class="parameter">debut</replaceable> ] [ CACHE <replaceable class="parameter">cache</replaceable> ] [ [ NO ] CYCLE ]
+ [ START [ WITH ] <replaceable class="parameter">début</replaceable> ]
+ [ RESTART [ [ WITH ] <replaceable class="parameter">nouveau_début</replaceable> ] ]
+ [ CACHE <replaceable class="parameter">cache</replaceable> ] [ [ NO ] CYCLE ]
[ OWNED BY { <replaceable class="parameter">table</replaceable>.<replaceable class="parameter">colonne</replaceable> | NONE } ]
+ALTER SEQUENCE <replaceable class="parameter">nom</replaceable> OWNER TO <replaceable class="PARAMETER">nouveau_propriétaire</replaceable>
ALTER SEQUENCE <replaceable class="parameter">nom</replaceable> RENAME TO <replaceable class="parameter">nouveau_nom</replaceable>
ALTER SEQUENCE <replaceable class="parameter">nom</replaceable> SET SCHEMA <replaceable class="parameter">nouveau_schema</replaceable>
</synopsis>
@@ -40,6 +44,11 @@
<command>ALTER SEQUENCE</command> modifie les paramètres d'un générateur de
séquence. Tout paramètre non précisé dans la commande <command>ALTER SEQUENCE</command>
conserve sa valeur précédente.
+ To alter the owner, you must also be a direct or indirect member of the new
+ owning role, and that role must have <literal>CREATE</literal> privilege on
+ the sequence's schema. (These restrictions enforce that altering the owner
+ doesn't do anything you couldn't do by dropping and recreating the sequence.
+ However, a superuser can alter ownership of any sequence anyway.)
</para>
<para>
@@ -107,20 +116,37 @@
</varlistentry>
<varlistentry>
- <term><replaceable class="parameter">debut</replaceable></term>
+ <term><replaceable class="parameter">start</replaceable></term>
<listitem>
<para>
- La clause optionnelle <literal>RESTART WITH <replaceable class="parameter">start</replaceable></literal> modifie la
- valeur courante de la séquence. Appeler la fonction
- <function>setval</function> avec <literal>is_called</literal> =
- <literal>false</literal> a le même résultat : la valeur
- indiquée sera renvoyée par le <emphasis>prochain</emphasis> appel à
- <function>nextval</function>.
+ The optional clause <literal>START WITH <replaceable
+ class="parameter">start</replaceable></literal> changes the
+ recorded start value of the sequence. This has no effect on the
+ <emphasis>current</> sequence value; it simply sets the value
+ that future <command>ALTER SEQUENCE RESTART</> commands will use.
</para>
</listitem>
</varlistentry>
<varlistentry>
+ <term><replaceable class="parameter">restart</replaceable></term>
+ <listitem>
+ <para>
+ The optional clause <literal>RESTART [ WITH <replaceable
+ class="parameter">restart</replaceable> ]</literal> changes the
+ current value of the sequence. This is equivalent to calling the
+ <function>setval</> function with <literal>is_called</literal> =
+ <literal>false</>: the specified value will be returned by the
+ <emphasis>next</> call of <function>nextval</>.
+ Writing <literal>RESTART</> with no <replaceable
+ class="parameter">restart</> value is equivalent to supplying
+ the start value that was recorded by <command>CREATE SEQUENCE</>
+ or last set by <command>ALTER SEQUENCE START WITH</>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><replaceable class="parameter">cache</replaceable></term>
<listitem>
<para>
@@ -179,6 +205,15 @@
</varlistentry>
<varlistentry>
+ <term><replaceable class="PARAMETER">new_owner</replaceable></term>
+ <listitem>
+ <para>
+ The user name of the new owner of the sequence.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><replaceable class="parameter">nouveau_nom</replaceable></term>
<listitem>
<para>
@@ -207,7 +242,8 @@
numéros issus de la même séquence, les effets d'<command>ALTER SEQUENCE</command>
sur les paramètres de génération de la séquence ne sont jamais annulables.
Ces changements prennent effet immédiatement et ne sont pas réversibles.
- Néanmoins, les clauses <literal>OWNED BY</literal>, <literal>RENAME</literal> et
+ Néanmoins, les clauses <literal>OWNED BY</literal>, <literal>OWNER TO</>,
+ <literal>RENAME TO</> et
<literal>SET SCHEMA</literal> sont des modifications ordinaires du catalogue
et, de ce fait, peuvent être annulées.
</para>
@@ -228,9 +264,9 @@
</para>
<para>
- Certaines variantes d'<command>ALTER TABLE</command> peuvent aussi être
- utilisées avec les séquences. Ainsi, pour renommer une séquence, il est aussi
- possible d'utiliser <command>ALTER TABLE RENAME</command>.
+ For historical reasons, <command>ALTER TABLE</command> peut aussi être
+ utilisé avec les séquences. But the only variants of <command>ALTER TABLE</command>
+ that are allowed with sequences are equivalent to the forms shown above.
</para>
</refsect1>
@@ -251,9 +287,10 @@
<para>
<command>ALTER SEQUENCE</command> est conforme au standard
- <acronym>SQL</acronym>, à l'exception des variantes <literal>OWNED BY</literal>,
- <literal>RENAME</literal> et <literal>SET SCHEMA</literal> qui sont une extension
- <productname>PostgreSQL</productname>.
+ <acronym>SQL</acronym>, à l'exception des variantes <literal>START
+ WITH</literal>, <literal>OWNED BY</literal>, <literal>OWNER TO</literal>,
+ <literal>RENAME TO</literal> et <literal>SET SCHEMA</literal> qui sont une
+ extension <productname>PostgreSQL</productname>.
</para>
</refsect1>
Added: traduc/trunk/postgresql/ref/alter_server.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_server.xml (rev 0)
+++ traduc/trunk/postgresql/ref/alter_server.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -0,0 +1,123 @@
+<!--
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_server.sgml,v 1.1 2008-12-19 16:25:16 petere Exp $
+PostgreSQL documentation
+-->
+
+<refentry id="SQL-ALTERSERVER">
+ <refmeta>
+ <refentrytitle id="sql-alterserver-title">ALTER SERVER</refentrytitle>
+ <refmiscinfo>SQL - Language Statements</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>ALTER SERVER</refname>
+ <refpurpose>change the definition of a foreign server</refpurpose>
+ </refnamediv>
+
+ <indexterm zone="sql-alterserver">
+ <primary>ALTER SERVER</primary>
+ </indexterm>
+
+ <refsynopsisdiv>
+<synopsis>
+ALTER SERVER <replaceable class="parameter">servername</replaceable> [ VERSION 'newversion' ]
+ [ OPTIONS ( [ ADD | SET | DROP ] <replaceable class="PARAMETER">option</replaceable> ['<replaceable class="PARAMETER">value</replaceable>'] [, ... ] ) ]
+ALTER SERVER <replaceable class="PARAMETER">servername</replaceable> OWNER TO <replaceable>new_owner</replaceable>
+</synopsis>
+ </refsynopsisdiv>
+
+ <refsect1>
+ <title>Description</title>
+
+ <para>
+ <command>ALTER SERVER</command> 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.
+ </para>
+
+ <para>
+ 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 <literal>USAGE</> privilege on the server's foreign-data
+ wrapper. (Note that superusers satisfy all these criteria
+ automatically.)
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Parameters</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><replaceable class="parameter">servername</replaceable></term>
+ <listitem>
+ <para>
+ The name of an existing server.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">serverversion</replaceable></term>
+ <listitem>
+ <para>
+ New server version.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>OPTIONS ( [ ADD | SET | DROP ] <replaceable class="PARAMETER">option</replaceable> ['<replaceable class="PARAMETER">value</replaceable>'] [, ... ] )</literal></term>
+ <listitem>
+ <para>
+ Change options for the
+ server. <literal>ADD</>, <literal>SET</>, and <literal>DROP</>
+ specify the action to be performed. <literal>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.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>
+ Alter server <literal>foo</>, add connection options:
+<programlisting>
+ALTER SERVER foo OPTIONS (host 'foo', dbname 'foodb');
+</programlisting>
+ </para>
+
+ <para>
+ Alter server <literal>foo</>, change version,
+ change <literal>host</> option:
+<programlisting>
+ALTER SERVER foo VERSION '8.4' OPTIONS (SET host 'baz');
+</programlisting>
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Compatibility</title>
+
+ <para>
+ <command>ALTER SERVER</command> conforms to ISO/IEC 9075-9 (SQL/MED).
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-createserver" endterm="sql-createserver-title"></member>
+ <member><xref linkend="sql-dropserver" endterm="sql-dropserver-title"></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
Modified: traduc/trunk/postgresql/ref/alter_table.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_table.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_table.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-altertable">
<refmeta>
<refentrytitle id="sql-altertable-title">ALTER TABLE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Commandes du langage</refmiscinfo>
</refmeta>
@@ -30,7 +31,7 @@
ADD [ COLUMN ] <replaceable class="parameter">colonne</replaceable> <replaceable class="parameter">type</replaceable> [ <replaceable class="parameter">contrainte_colonne</replaceable> [ ... ] ]
DROP [ COLUMN ] <replaceable class="parameter">colonne</replaceable> [ RESTRICT | CASCADE ]
- ALTER [ COLUMN ] <replaceable class="parameter">colonne</replaceable> TYPE <replaceable class="parameter">type</replaceable> [ USING <replaceable class="parameter">expression</replaceable> ]
+ ALTER [ COLUMN ] <replaceable class="parameter">colonne</replaceable> [ SET DATA ] TYPE <replaceable class="parameter">type</replaceable> [ USING <replaceable class="parameter">expression</replaceable> ]
ALTER [ COLUMN ] <replaceable class="parameter">colonne</replaceable> SET DEFAULT <replaceable class="parameter">expression</replaceable>
ALTER [ COLUMN ] <replaceable class="parameter">colonne</replaceable> DROP DEFAULT
ALTER [ COLUMN ] <replaceable class="parameter">colonne</replaceable> { SET | DROP } NOT NULL
@@ -48,6 +49,7 @@
ENABLE ALWAYS RULE <replaceable class="parameter">nom_regle_reecriture</replaceable>
CLUSTER ON <replaceable class="parameter">nom_index</replaceable>
SET WITHOUT CLUSTER
+ SET WITH OIDS
SET WITHOUT OIDS
SET ( <replaceable class="parameter">paramètre_stockage</replaceable> = <replaceable class="parameter">valeur</replaceable> [, ... ] )
RESET ( <replaceable class="parameter">paramètre_stockage</replaceable> [, ... ] )
@@ -93,7 +95,7 @@
</varlistentry>
<varlistentry>
- <term><literal>ALTER COLUMN TYPE</literal></term>
+ <term><literal>SET DATA TYPE</literal></term>
<listitem>
<para>
Change le type d'une colonne de la table. Les index et
@@ -142,7 +144,7 @@
Permet de modifier l'objectif de collecte de statistiques
par colonne pour les opérations d'analyse
(<xref linkend="sql-analyze" endterm="sql-analyze-title"/>) ultérieures.
- L'objectif prend une valeur entre 0 et 1000. il est positionné à -1 pour utiliser
+ L'objectif prend une valeur entre 0 et 10000. il est positionné à -1 pour utiliser
l'objectif de statistiques par défaut du système
(<xref linkend="guc-default-statistics-target"/>). Pour plus d'informations sur
l'utilisation des statistiques par le planificateur de requêtes de
@@ -270,6 +272,23 @@
</varlistentry>
<varlistentry>
+ <term><literal>SET WITH OIDS</literal></term>
+ <listitem>
+ <para>
+ This form adds an <literal>oid</literal> system column to the
+ table (see <xref linkend="ddl-system-columns">).
+ It does nothing if the table already has OIDs.
+ </para>
+
+ <para>
+ Note that this is not equivalent to <literal>ADD COLUMN oid oid</>;
+ that would add a normal column that happened to be named
+ <literal>oid</>, not a system column.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><literal>SET WITHOUT OIDS</literal></term>
<listitem>
<para>
@@ -277,11 +296,6 @@
table. Cela est strictement équivalent à <literal>DROP COLUMN oid RESTRICT</literal>,
à ceci près qu'aucun avertissement n'est émis si la colonne <literal>oid</literal> n'existe plus.
</para>
-
- <para>
- Il n'existe pas de variante d'<command>ALTER TABLE</command>
- qui autorise la restauration des OID d'une table après leur suppression.
- </para>
</listitem>
</varlistentry>
@@ -290,7 +304,8 @@
<listitem>
<para>
Cette forme modifie un ou plusieurs paramètres de stockage pour la table.
- Voir <xref linkend="sql-createtable" endterm="sql-createtable-title"/>
+ Voir <xref linkend="sql-createtable-storage-parameters"
+ endterm="sql-createtable-title-storage-parameters"/>
pour les détails sur les paramètres disponibles. Notez que le contenu de
la table ne sera pas modifié immédiatement par cette commande ;
suivant le paramètre, vous aurez besoin de réécrire la table pour
@@ -305,7 +320,8 @@
<literal>OIDS</literal> avec la syntaxe <literal>WITH (<replaceable
class="parameter">paramètre_stockage</replaceable>)</literal>,
<command>ALTER TABLE</command> ne traite pas les <literal>OIDS</literal>
- comme un paramètre de stockage.
+ comme un paramètre de stockage. Instead use the <literal>SET WITH OIDS</>
+ and <literal>SET WITHOUT OIDS</> forms to change OID status.
</para>
</note>
</listitem>
@@ -652,6 +668,8 @@
modifier le type d'une colonne existante requiert que la table entière soit
réécrite. Cela peut prendre un temps considérable pour une grande
table ; et cela demande temporairement le double d'espace disque.
+ Adding or removing a system
+ <literal>oid</> column likewise requires rewriting the entire table.
</para>
<para>
@@ -674,7 +692,9 @@
Ainsi, supprimer une colonne ne réduit pas immédiatement la taille de la
table sur disque car l'espace occupé par la colonne n'est pas
récupéré. Cet espace est récupéré au fur et à mesure des
- mises à jour des lignes de la table.
+ mises à jour des lignes de la table. (These statements do
+ not apply when dropping the system <literal>oid</> column; that is done
+ with an immediate rewrite.)
</para>
<para>
@@ -735,7 +755,8 @@
et <literal>TABLESPACE</literal> ne sont jamais propagées aux tables
descendantes ; c'est-à-dire qu'elles agissent comme si
<literal>ONLY</literal> est spécifié.
- Seules les ajouts de contraintes <literal>CHECK</literal> peuvent être propagés.
+ Seules les ajouts de contraintes <literal>CHECK</literal> peuvent être propagés,
+ and is required to do so for such constraints.
</para>
<para>
@@ -777,7 +798,7 @@
temporelle UNIX en <type>timestamp with time zone</type> à l'aide d'une clause
<literal>USING</literal> :
<programlisting>ALTER TABLE foo
- ALTER COLUMN foo_timestamp TYPE timestamp with time zone
+ ALTER COLUMN foo_timestamp SET DATA TYPE timestamp with time zone
USING
timestamp with time zone 'epoch' + foo_timestamp * interval '1 second';
</programlisting>
@@ -817,7 +838,7 @@
</para>
<para>
- Ajouter une contrainte de vérification sur une table :
+ Ajouter une contrainte de vérification sur une table and all its children :
<programlisting>ALTER TABLE distributeurs ADD CONSTRAINT verif_cp CHECK (char_length(code_postal) = 5);
</programlisting>
</para>
@@ -829,6 +850,14 @@
</programlisting>
</para>
+ <para>
+ To remove a check constraint from a table only:
+<programlisting>
+ALTER TABLE ONLY distributors DROP CONSTRAINT zipchk;
+</programlisting>
+ (The check constraint remains in place for any child tables.)
+ </para>
+
<para>
Ajouter une contrainte de clé étrangère à une table :
<programlisting>ALTER TABLE distributeurs ADD CONSTRAINT dist_fk FOREIGN KEY (adresse) REFERENCES adresses (adresse) MATCH FULL;
@@ -866,8 +895,10 @@
<title>Compatibilité</title>
<para>
- Les formes <literal>ADD</literal>, <literal>DROP</literal> et
- <literal>SET DEFAULT</literal> se conforment au standard SQL. Les autres formes sont des
+ Les formes <literal>ADD</literal>, <literal>DROP</literal>,
+ <literal>SET DEFAULT</literal> et and <literal>SET DATA TYPE</literal>
+ (without <literal>USING</literal>) se conforment au standard SQL. Les autres
+ formes sont des
extensions <productname>PostgreSQL</productname>, tout comme
la possibilité de spécifier plusieurs manipulations en une seule commande
<command>ALTER TABLE</command>.
Modified: traduc/trunk/postgresql/ref/alter_tablespace.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_tablespace.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_tablespace.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-altertablespace">
<refmeta>
<refentrytitle id="sql-altertablespace-title">ALTER TABLESPACE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_trigger.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_trigger.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_trigger.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-altertrigger">
<refmeta>
<refentrytitle id="sql-altertrigger-title">ALTER TRIGGER</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_tsconfig.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_tsconfig.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_tsconfig.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-altertsconfig">
<refmeta>
<refentrytitle id="sql-altertsconfig-title">ALTER TEXT SEARCH CONFIGURATION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_tsdictionary.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_tsdictionary.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_tsdictionary.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-altertsdictionary">
<refmeta>
<refentrytitle id="sql-altertsdictionary-title">ALTER TEXT SEARCH DICTIONARY</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_tsparser.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_tsparser.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_tsparser.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-altertsparser">
<refmeta>
<refentrytitle id="sql-altertsparser-title">ALTER TEXT SEARCH PARSER</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_tstemplate.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_tstemplate.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_tstemplate.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-altertstemplate">
<refmeta>
<refentrytitle id="sql-altertstemplate-title">ALTER TEXT SEARCH TEMPLATE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/alter_type.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_type.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_type.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-altertype">
<refmeta>
<refentrytitle id="sql-altertype-title">ALTER TYPE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -21,7 +22,8 @@
</refnamediv>
<refsynopsisdiv>
- <synopsis>ALTER TYPE <replaceable class="parameter">nom</replaceable> OWNER TO <replaceable class="parameter">nouveau_nom</replaceable>
+ <synopsis>ALTER TYPE <replaceable class="PARAMETER">name</replaceable> RENAME TO <replaceable class="PARAMETER">new_name</replaceable>
+ALTER TYPE <replaceable class="parameter">nom</replaceable> OWNER TO <replaceable class="parameter">nouveau_nom</replaceable>
ALTER TYPE <replaceable class="parameter">nom</replaceable> SET SCHEMA <replaceable class="parameter">nouveau_schema</replaceable></synopsis>
</refsynopsisdiv>
@@ -33,8 +35,6 @@
<para>
<command>ALTER TYPE</command> modifie la définition d'un type existant.
- Les seules fonctionnalités actuellement disponibles sont de modifier le
- propriétaire et le schéma d'un type.
</para>
<para>
@@ -65,6 +65,15 @@
</varlistentry>
<varlistentry>
+ <term><replaceable class="PARAMETER">new_name</replaceable></term>
+ <listitem>
+ <para>
+ The new name for the type.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><replaceable class="parameter">nouveau_propriétaire</replaceable></term>
<listitem>
<para>
@@ -90,14 +99,21 @@
<refsect1>
<title>Exemples</title>
+ <para>
+ To rename a data type:
+ <programlisting>
+ALTER TYPE electronic_mail RENAME TO email;
+ </programlisting>
+ </para>
+
<para>
- Donner la propriété du type utilisateur <literal>courriel</literal>
+ Donner la propriété du type <literal>courriel</literal>
à <literal>joe</literal> :
<programlisting>ALTER TYPE courriel OWNER TO joe;</programlisting>
</para>
<para>
- Changer le schéma du type utilisateur <literal>courriel</literal>
+ Changer le schéma du type <literal>courriel</literal>
en <literal>clients</literal> :
<programlisting>ALTER TYPE courriel SET SCHEMA clients;</programlisting>
</para>
Modified: traduc/trunk/postgresql/ref/alter_user.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_user.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_user.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-alteruser">
<refmeta>
<refentrytitle id="sql-alteruser-title">ALTER USER</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Commandes du langage</refmiscinfo>
</refmeta>
Added: traduc/trunk/postgresql/ref/alter_user_mapping.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_user_mapping.xml (rev 0)
+++ traduc/trunk/postgresql/ref/alter_user_mapping.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -0,0 +1,124 @@
+<!--
+$PostgreSQL: pgsql/doc/src/sgml/ref/alter_user_mapping.sgml,v 1.2 2009-01-20 09:10:20 petere Exp $
+PostgreSQL documentation
+-->
+
+<refentry id="SQL-ALTERUSERMAPPING">
+ <refmeta>
+ <refentrytitle id="sql-alterusermapping-title">ALTER USER MAPPING</refentrytitle>
+ <refmiscinfo>SQL - Language Statements</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>ALTER USER MAPPING</refname>
+ <refpurpose>change the definition of a user mapping</refpurpose>
+ </refnamediv>
+
+ <indexterm zone="sql-alterusermapping">
+ <primary>ALTER USER MAPPING</primary>
+ </indexterm>
+
+ <refsynopsisdiv>
+<synopsis>
+ALTER USER MAPPING FOR { <replaceable class="parameter">username</replaceable> | USER | CURRENT_USER | PUBLIC }
+ SERVER <replaceable class="parameter">servername</replaceable>
+ OPTIONS ( [ ADD | SET | DROP ] <replaceable class="PARAMETER">option</replaceable> ['<replaceable class="PARAMETER">value</replaceable>'] [, ... ] )
+</synopsis>
+ </refsynopsisdiv>
+
+ <refsect1>
+ <title>Description</title>
+
+ <para>
+ <command>ALTER USER MAPPING</command> changes the definition of a
+ user mapping.
+ </para>
+
+ <para>
+ The owner of a foreign server can alter user mappings for that
+ server for any user. Also, a user can alter a user mapping for
+ his own user name if <literal>USAGE</> privilege on the server has
+ been granted to the user.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Parameters</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><replaceable class="parameter">username</replaceable></term>
+ <listitem>
+ <para>
+ User name of the mapping. <literal>CURRENT_USER</>
+ and <literal>USER</> match the name of the current
+ user. <literal>PUBLIC</> is used to match all present and future
+ user names in the system.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">servername</replaceable></term>
+ <listitem>
+ <para>
+ Server name of the user mapping.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>OPTIONS ( [ ADD | SET | DROP ] <replaceable class="PARAMETER">option</replaceable> ['<replaceable class="PARAMETER">value</replaceable>'] [, ... ] )</literal></term>
+ <listitem>
+ <para>
+ Change options for the user mapping. The new options override
+ any previously specified
+ options. <literal>ADD</>, <literal>SET</>, and <literal>DROP</>
+ specify the action to be performed. <literal>ADD</> is assumed
+ if no operation is explicitly specified. Option names must be
+ unique; options are also validated by the server's foreign-data
+ wrapper.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>
+ Change the password for user mapping <literal>bob</>, server<literal> foo</>:
+<programlisting>
+ALTER USER MAPPING FOR bob SERVER foo OPTIONS (user 'bob', password 'public');
+</programlisting>
+ </para>
+
+ </refsect1>
+
+ <refsect1>
+ <title>Compatibility</title>
+
+ <para>
+ <command>ALTER USER MAPPING</command> conforms to ISO/IEC 9075-9
+ (SQL/MED). There is a subtle syntax issue: The standard omits
+ the <literal>FOR</literal> key word. Since both <literal>CREATE
+ USER MAPPING</literal> and <literal>DROP USER MAPPING</literal> use
+ <literal>FOR</literal> in analogous positions, and IBM DB2 (being
+ the other major SQL/MED implementation) also requires it
+ for <literal>ALTER USER MAPPING</literal>, PostgreSQL diverges from
+ the standard here in the interest of consistency and
+ interoperability.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-createusermapping" endterm="sql-createusermapping-title"></member>
+ <member><xref linkend="sql-dropusermapping" endterm="sql-dropusermapping-title"></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
Modified: traduc/trunk/postgresql/ref/alter_view.xml
===================================================================
--- traduc/trunk/postgresql/ref/alter_view.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/alter_view.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-alterview">
<refmeta>
<refentrytitle id="sql-alterview-title">ALTER VIEW</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -21,8 +22,11 @@
<primary>ALTER VIEW</primary>
</indexterm>
-<synopsis>
-ALTER VIEW <replaceable>nom</replaceable> RENAME TO <replaceable>nouveau_nom</replaceable>
+<synopsis>ALTER VIEW <replaceable class="parameter">name</replaceable> ALTER [ COLUMN ] <replaceable class="PARAMETER">column</replaceable> SET DEFAULT <replaceable class="PARAMETER">expression</replaceable>
+ALTER VIEW <replaceable class="parameter">name</replaceable> ALTER [ COLUMN ] <replaceable class="PARAMETER">column</replaceable> DROP DEFAULT
+ALTER VIEW <replaceable class="parameter">name</replaceable> OWNER TO <replaceable class="PARAMETER">new_owner</replaceable>
+ALTER VIEW <replaceable class="parameter">name</replaceable> RENAME TO <replaceable class="parameter">new_name</replaceable>
+ALTER VIEW <replaceable class="parameter">name</replaceable> SET SCHEMA <replaceable class="parameter">new_schema</replaceable>
</synopsis>
</refsynopsisdiv>
@@ -30,10 +34,21 @@
<title>Description</title>
<para>
- <command>ALTER VIEW</command> modifie la définition d'une vue. Actuellement,
- la seule fonctionnalité supportée est la modification du nom de la vue. Pour
- exécuter cette commande, vous devez être le propriétaire de la vue.
+ <command>ALTER VIEW</command> modifie various auxiliary properties
+ of a view. (If you want to modify the view's defining query,
+ use <command>CREATE OR REPLACE VIEW</>.)
</para>
+
+ <para>
+ You must own the view to use <command>ALTER VIEW</>.
+ To change a view's schema, you must also have <literal>CREATE</>
+ privilege on the new schema.
+ To alter the owner, you must also be a direct or indirect member of the new
+ owning role, and that role must have <literal>CREATE</literal> privilege on
+ the view's schema. (These restrictions enforce that altering the owner
+ doesn't do anything you couldn't do by dropping and recreating the view.
+ However, a superuser can alter ownership of any view anyway.)
+ </para>
</refsect1>
<refsect1>
@@ -50,13 +65,44 @@
</varlistentry>
<varlistentry>
- <term><replaceable class="parameter">nouveau_nom</replaceable></term>
+ <term><literal>SET</literal>/<literal>DROP DEFAULT</literal></term>
<listitem>
<para>
- Le nouveau nom de la vue.
+ These forms set or remove the default value for a column.
+ A default value associated with a view column is
+ inserted into <command>INSERT</> statements on the view before
+ the view's <literal>ON INSERT</literal> rule is applied, if
+ the <command>INSERT</> does not specify a value for the column.
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="PARAMETER">new_owner</replaceable></term>
+ <listitem>
+ <para>
+ The user name of the new owner of the view.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">new_name</replaceable></term>
+ <listitem>
+ <para>
+ The new name for the view.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">new_schema</replaceable></term>
+ <listitem>
+ <para>
+ The new schema for the view.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</refsect1>
@@ -64,11 +110,9 @@
<title>Notes</title>
<para>
- Quelques variantes de <command>ALTER TABLE</command> peuvent aussi être
- utilisées avec les vues ; par exemple, pour renommer une vue, il
- est aussi possible d'utiliser <command>ALTER TABLE RENAME</command>. Pour
- modifier le schéma ou le propriétaire d'une vue, vous devez actuellement
- utiliser <command>ALTER TABLE</command>.
+ For historical reasons, <command>ALTER TABLE</command> can be used with
+ views too; but the only variants of <command>ALTER TABLE</command>
+ that are allowed with views are equivalent to the ones shown above.
</para>
</refsect1>
Modified: traduc/trunk/postgresql/ref/analyze.xml
===================================================================
--- traduc/trunk/postgresql/ref/analyze.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/analyze.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-analyze">
<refmeta>
<refentrytitle id="sql-analyze-title">ANALYZE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -151,7 +152,7 @@
<xref linkend="sql-altertable" endterm="sql-altertable-title"/>). Cette valeur
cible initialise le nombre maximum d'entrées dans la liste des valeurs les
plus communes et le nombre maximum de points dans l'histogramme. La valeur
- cible par défaut est fixée à 10 mais elle peut être ajustée vers le haut
+ cible par défaut est fixée à 100 mais elle peut être ajustée vers le haut
ou vers le bas afin d'obtenir un bon compromis entre la précision des estimations
de l'optimiseur, le temps pris par <command>ANALYZE</command> et l'espace total occupé dans
<literal>pg_statistic</literal>. En particulier, initialiser la cible des
Modified: traduc/trunk/postgresql/ref/begin.xml
===================================================================
--- traduc/trunk/postgresql/ref/begin.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/begin.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-begin">
<refmeta>
<refentrytitle id="sql-begin-title">BEGIN</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/checkpoint.xml
===================================================================
--- traduc/trunk/postgresql/ref/checkpoint.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/checkpoint.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-checkpoint">
<refmeta>
<refentrytitle id="sql-checkpoint-title">CHECKPOINT</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/close.xml
===================================================================
--- traduc/trunk/postgresql/ref/close.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/close.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-close">
<refmeta>
<refentrytitle id="sql-close-title">CLOSE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -90,6 +91,12 @@
la vue système <link
linkend="view-pg-cursors"><structname>pg_cursors</structname></link>.
</para>
+
+ <para>
+ If a cursor is closed after a savepoint which is later rolled back,
+ the <command>CLOSE</command> is not rolled back; that is, the cursor
+ remains closed.
+ </para>
</refsect1>
<refsect1>
Modified: traduc/trunk/postgresql/ref/cluster.xml
===================================================================
--- traduc/trunk/postgresql/ref/cluster.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/cluster.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-cluster">
<refmeta>
<refentrytitle id="sql-cluster-title">CLUSTER</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -17,8 +18,8 @@
</refnamediv>
<refsynopsisdiv>
-<synopsis>CLUSTER <replaceable class="PARAMETER">nomtable</replaceable> [ USING <replaceable class="PARAMETER">nomindex</replaceable> ]
-CLUSTER
+<synopsis>CLUSTER [VERBOSE] <replaceable class="PARAMETER">nomtable</replaceable> [ USING <replaceable class="PARAMETER">nomindex</replaceable> ]
+CLUSTER [VERBOSE]
</synopsis>
</refsynopsisdiv>
@@ -91,6 +92,15 @@
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><literal>VERBOSE</literal></term>
+ <listitem>
+ <para>
+ Prints a progress report as each table is clustered.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</refsect1>
Modified: traduc/trunk/postgresql/ref/clusterdb.xml
===================================================================
--- traduc/trunk/postgresql/ref/clusterdb.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/clusterdb.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -22,12 +22,14 @@
<cmdsynopsis>
<command>clusterdb</command>
<arg rep="repeat"><replaceable>options_connexion</replaceable></arg>
+ <group><arg>--verbose</arg><arg>-v</arg></group>
<arg>--table | -t <replaceable>table</replaceable> </arg>
<arg><replaceable>nom_bd</replaceable></arg>
<sbr/>
<command>clusterdb</command>
<arg rep="repeat"><replaceable>options_connexion</replaceable></arg>
<group><arg>--all</arg><arg>-a</arg></group>
+ <group><arg>--verbose</arg><arg>-v</arg></group>
</cmdsynopsis>
</refsynopsisdiv>
@@ -119,6 +121,16 @@
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><option>-v</></term>
+ <term><option>--verbose</></term>
+ <listitem>
+ <para>
+ Print detailed information during processing.
+ </para>
+ </listitem>
+ </varlistentry>
+
</variablelist>
</para>
@@ -161,6 +173,21 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
Modified: traduc/trunk/postgresql/ref/comment.xml
===================================================================
--- traduc/trunk/postgresql/ref/comment.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/comment.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-comment">
<refmeta>
<refentrytitle id="sql-comment-title">COMMENT</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -139,12 +140,14 @@
<listitem>
<para>
Le mode d'un argument de la fonction : <literal>IN</literal>,
- <literal>OUT</literal> ou <literal>INOUT</literal>. En cas d'omission, la valeur par
+ <literal>OUT</literal>, <literal>INOUT</literal> ou
+ <literal>VARIADIC</literal>. En cas d'omission, la valeur par
défaut est <literal>IN</literal>. <command>COMMENT ON FUNCTION</command>
ne tient pas compte, à l'heure actuelle, des arguments
<literal>OUT</literal> car seuls ceux en entrée sont nécessaires pour
déterminer l'identité de la fonction. Lister les
- arguments <literal>IN</literal> et <literal>INOUT</literal> est ainsi suffisant.
+ arguments <literal>IN</literal>, <literal>INOUT</literal> et
+ <literal>VARIADIC</literal> est ainsi suffisant.
</para>
</listitem>
</varlistentry>
Modified: traduc/trunk/postgresql/ref/commit.xml
===================================================================
--- traduc/trunk/postgresql/ref/commit.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/commit.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-commit">
<refmeta>
<refentrytitle id="sql-commit-title">COMMIT</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/commit_prepared.xml
===================================================================
--- traduc/trunk/postgresql/ref/commit_prepared.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/commit_prepared.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-commit-prepared">
<refmeta>
<refentrytitle id="sql-commit-prepared-title">COMMIT PREPARED</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/copy.xml
===================================================================
--- traduc/trunk/postgresql/ref/copy.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/copy.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-copy">
<refmeta>
<refentrytitle id="sql-copy-title">COPY</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -302,7 +303,8 @@
<para>
Le droit SELECT est requis sur la table dont les valeurs sont
lues par <command>COPY TO</command> et le droit INSERT sur la table dont les
- valeurs sont insérées par <command>COPY FROM</command>.
+ valeurs sont insérées par <command>COPY FROM</command>. It is sufficient
+ to have column privileges on the column(s) listed in the command.
</para>
<para>
@@ -351,7 +353,11 @@
d'autres installations de <productname>PostgreSQL</productname> qui
éventuellement utilisent des paramétrages <varname>datestyle</varname> différents de ceux
par défaut, il est préférable de configurer <varname>datestyle</varname> en
- <literal>ISO</literal> avant d'utiliser <command>COPY TO</command>.
+ <literal>ISO</literal> avant d'utiliser <command>COPY TO</command>. It is also a good idea to avoid dumping
+ data with <varname>IntervalStyle</varname> set to
+ <literal>sql_standard</>, because negative interval values might be
+ misinterpreted by a server that has a different setting for
+ <varname>IntervalStyle</varname>.
</para>
<para>
Modified: traduc/trunk/postgresql/ref/create_aggregate.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_aggregate.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_aggregate.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createaggregate">
<refmeta>
<refentrytitle id="sql-createaggregate-title">CREATE AGGREGATE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_cast.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_cast.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_cast.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createcast">
<refmeta>
<refentrytitle id="sql-createcast-title">CREATE CAST</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -24,6 +25,10 @@
CREATE CAST (<replaceable>typesource</replaceable> AS <replaceable>typecible</replaceable>)
WITHOUT FUNCTION
[ AS ASSIGNMENT | AS IMPLICIT ]
+
+CREATE CAST (<replaceable>sourcetype</replaceable> AS <replaceable>targettype</replaceable>)
+ WITH INOUT
+ [ AS ASSIGNMENT | AS IMPLICIT ]
</synopsis>
</refsynopsisdiv>
@@ -45,14 +50,28 @@
</para>
<para>
- Deux types peuvent être <firstterm>binairement compatibles</firstterm>,
- ce qui signifie que la conversion d'un type en l'autre est
- <quote>gratuite</quote> et ne nécessite pas d'appel de fonction. Les
- valeurs correspondantes doivent pour cela utiliser la même représentation interne.
- Les types <type>text</type> et <type>varchar</type>, par exemple, sont binairement compatibles.
+ Two types can be <firstterm>binary coercible</firstterm>, which
+ means that the conversion can be performed <quote>for free</quote>
+ without invoking any function. This requires that corresponding
+ values use the same internal representation. For instance, the
+ types <type>text</type> and <type>varchar</type> are binary
+ coercible both ways. Binary coercibility is not necessarily a
+ symmetric relationship. For example, the cast
+ from <type>xml</type> to <type>text</type> can be performed for
+ free in the present implementation, but the reverse direction
+ requires a function that performs at least a syntax check. (Two
+ types that are binary coercible both ways are also referred to as
+ binary compatible.)
</para>
<para>
+ You can define a cast as an <firstterm>I/O conversion cast</> using
+ the <literal>WITH INOUT</literal> syntax. An I/O conversion cast is
+ performed by invoking the output function of the source data type, and
+ passing the result to the input function of the target data type.
+ </para>
+
+ <para>
Un transtypage peut être appelé explicitement.
Par exemple : <literal>CAST(<replaceable>x</replaceable> AS
<replaceable>nomtype</replaceable>)</literal> ou
@@ -128,6 +147,18 @@
sont préférablement exécutés dans le seul mode explicite.
</para>
+ <note>
+ <para>
+ Sometimes it is necessary for usability or standards-compliance reasons
+ to provide multiple implicit casts among a set of types, resulting in
+ ambiguity that cannot be avoided as above. The parser has a fallback
+ heuristic based on <firstterm>type categories</> and <firstterm>preferred
+ types</> that can help to provide desired behavior in such cases. See
+ <xref linkend="sql-createtype" endterm="sql-createtype-title"> for
+ more information.
+ </para>
+ </note>
+
<para>
Pour créer un transtypage, il faut être propriétaire
du type source ou destination. Seul le superutilisateur peut créer
@@ -180,13 +211,25 @@
<listitem>
<para>
- Indication d'une compatibilité binaire des types source et cible.
- Aucune fonction n'est ainsi requise pour effectuer la conversion.
+ Indication d'une compatibilité binaire entre le type source et le type
+ cible pour qu'aucune fonction ne soit requise pour effectuer la
+ conversion.
</para>
</listitem>
</varlistentry>
<varlistentry>
+ <term><literal>WITH INOUT</literal></term>
+
+ <listitem>
+ <para>
+ Indicates that the cast is an I/O conversion cast, performed by
+ invoking the output function of the source data type, and passing the
+ result to the input function of the target data type.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
<term><literal>AS ASSIGNMENT</literal></term>
<listitem>
@@ -209,12 +252,13 @@
<para>
Les fonctions de transtypage ont un à trois arguments. Le
- premier argument est du même type que le type source. Le deuxième argument, si fourni,
+ premier argument est du même type que le type source ou doit être compatible
+ avec ce type. Le deuxième argument, si fourni,
doit être de type <type>integer</type>. Il stocke le modificateur de type associé au type de
destination, ou <literal>-1</literal> en l'absence de modificateur. Le troisième
argument, si fourni, doit être de type <type>boolean</type>. Il vaut
<literal>true</literal> si la conversion est explicite, <literal>false</literal> dans le
- cas contraire. Bizarrement, les spécifications SQL appellent des comportements
+ cas contraire. Bizarrement, le standard SQL appelle des comportements
différents pour les transtypages explicites et implicites dans certains
cas. Ce paramètre est fourni pour les fonctions qui implémentent
de tel transtypages. Il n'est pas recommandé de concevoir des types de
@@ -222,6 +266,11 @@
</para>
<para>
+ The return type of a cast function must be identical to or
+ binary-coercible to the cast's target type.
+ </para>
+
+ <para>
En général, un transtypage correspond à des type source et destination
différents. Cependant, il est permis de déclarer un transtypage entre
types source et destination identiques si la fonction de transtypage a
@@ -263,16 +312,14 @@
<para>
Il est habituellement nécessaire de créer des conversions entre des types
définis par l'utilisateur et des types de chaîne standards (<type>text</type>,
- <type>varchar</type> et<type>char(<replaceable>n</replaceable>)</type>).
- <productname>PostgreSQL</productname> gèrera automatiquement une conversion
- vers un type chaîne à l'appel d'une autre fonction en sortie d'un type ou
- gèrera une conversion vers un type chaîne en appelent l'autre fonction en
- entrée du type. Ces conversions automatiques sont connues sous le nom de
- <firstterm>conversions I/O</firstterm>. Ces conversions vers des types
- chaîne sont traitées comme des conversions d'affectation, alors que ces
- conversions à partir de type chaîne sont seulement explicites. Vous
+ <type>varchar</type> et<type>char(<replaceable>n</replaceable>)</type>), as well as user-defined types that
+ are defined to be in the string category).
+ <productname>PostgreSQL</productname> provides automatic I/O conversion casts for that. The automatic casts to
+ string types are treated as assignment casts, while the automatic casts
+ from string types are
+ explicit-only. Vous
pouvez changer ce comportement en déclarant votre propre conversion
- pour rempalcer une conversion I/O mais, habituellement, la seule
+ pour rempalcer une conversion automatique mais, habituellement, la seule
raison de le faire est si vous voulez que la conversion soit plus facilement
appelable que la forme standard de conversion par affectation ou le
paramètre pour ue conversion explicite seulement. Une autre raison possible
@@ -338,10 +385,10 @@
<title>Exemples</title>
<para>
- Création d'un transtypage du type <type>bigint</type> vers le type
+ Création d'un transtypage d'affectation du type <type>bigint</type> vers le type
<type>int4</type> à l'aide de la fonction
<literal>int4(bigint)</literal> :
-<programlisting>CREATE CAST (bigint AS int4) WITH FUNCTION int4(bigint);
+<programlisting>CREATE CAST (bigint AS int4) WITH FUNCTION int4(bigint) AS ASSIGNMENT;
</programlisting>
(Ce transtypage est déjà prédéfini dans le système.)
</para>
Modified: traduc/trunk/postgresql/ref/create_constraint.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_constraint.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_constraint.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createconstraint">
<refmeta>
<refentrytitle id="sql-createconstraint-title">CREATE CONSTRAINT TRIGGER</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_conversion.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_conversion.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_conversion.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createconversion">
<refmeta>
<refentrytitle id="sql-createconversion-title">CREATE CONVERSION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_database.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_database.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_database.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createdatabase">
<refmeta>
<refentrytitle id="sql-createdatabase-title">CREATE DATABASE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -21,6 +22,8 @@
[ [ WITH ] [ OWNER [=] <replaceable class="parameter">propriétaire</replaceable> ]
[ TEMPLATE [=] <replaceable class="parameter">modèle</replaceable> ]
[ ENCODING [=] <replaceable class="parameter">codage</replaceable> ]
+ [ LC_COLLATE [=] <replaceable class="parameter">lc_collate</replaceable> ]
+ [ LC_CTYPE [=] <replaceable class="parameter">lc_ctype</replaceable> ]
[ TABLESPACE [=] <replaceable class="parameter">tablespace</replaceable> ]
[ CONNECTION LIMIT [=] <replaceable class="parameter">limite_connexion</replaceable> ] ]
</synopsis>
@@ -115,6 +118,29 @@
</listitem>
</varlistentry>
<varlistentry>
+ <term><replaceable class="parameter">collate</replaceable></term>
+ <listitem>
+ <para>
+ Collation order (<literal>LC_COLLATE</>) to use in the new database.
+ This affects the sort order applied to strings, e.g in queries with
+ ORDER BY, as well as the order used in indexes on text columns.
+ The default is to use the collation order of the template database.
+ See below for additional restrictions.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><replaceable class="parameter">ctype</replaceable></term>
+ <listitem>
+ <para>
+ Character classification (<literal>LC_CTYPE</>) to use in the new
+ database. This affects the categorization of characters, e.g. lower,
+ upper and digit. The default is to use the character classification of
+ the template database. See below for additional restrictions.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
<term><replaceable class="parameter">tablespace</replaceable></term>
<listitem>
<para>
@@ -186,14 +212,12 @@
</para>
<para>
- Tout encodage du jeu de caractère spécifié pour la nouvelle base de données
- doit être compatible avec le paramètre <envar>LC_CTYPE</envar> du serveur.
+ L'encodage du jeu de caractère spécifié pour la nouvelle base de données
+ doit être compatible avec les paramètre LC_COLLATE et LC_CTYPE choisis.
Si <envar>LC_CTYPE</envar> est <literal>C</literal> (ou de la même façon
<literal>POSIX</literal>), alors tous les encodages sont autorisés. Pour
d'autres paramètres de locale, il n'y a qu'un encodage qui fonctionnera
- correctement. Donc, l'apparente liberté dans le choix d'un encodage est
- illusoire si vous n'avez pas initialisé le cluster de bases de données
- dans la locale <literal>C</literal>. <command>CREATE DATABASE</command>
+ correctement. <command>CREATE DATABASE</command>
autorisera les superutilisateurs à spécifier l'encodage
<literal>SQL_ASCII</literal> quelque soit le paramètre locale mais ce
choix devient obsolète et peut occasionner un mauvais comportement des
@@ -202,6 +226,16 @@
</para>
<para>
+ The <literal>LC_COLLATE</> and <literal>LC_CTYPE</> settings must match
+ those of the template database, except when template0 is used as
+ template. This is because <literal>LC_COLLATE</> and <literal>LC_CTYPE</>
+ affects the ordering in indexes, so that any indexes copied from the
+ template database would be invalid in the new database with different
+ settings. <literal>template0</literal>, however, is known to not
+ contain any indexes that would be affected.
+ </para>
+
+ <para>
L'option <literal>CONNECTION LIMIT</literal> n'est qu'approximativement contraignante ;
si deux nouvelles sessions commencent sensiblement en même
temps alors qu'un seul <quote>connecteur</quote> à la base est disponible,
Modified: traduc/trunk/postgresql/ref/create_domain.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_domain.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_domain.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createdomain">
<refmeta>
<refentrytitle id="sql-createdomain-title">CREATE DOMAIN</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Added: traduc/trunk/postgresql/ref/create_foreign_data_wrapper.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_foreign_data_wrapper.xml (rev 0)
+++ traduc/trunk/postgresql/ref/create_foreign_data_wrapper.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -0,0 +1,175 @@
+<!--
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_foreign_data_wrapper.sgml,v 1.3 2009-02-27 07:20:00 petere Exp $
+PostgreSQL documentation
+-->
+
+<refentry id="SQL-CREATEFOREIGNDATAWRAPPER">
+ <refmeta>
+ <refentrytitle id="sql-createforeigndatawrapper-title">CREATE FOREIGN DATA WRAPPER</refentrytitle>
+ <refmiscinfo>SQL - Language Statements</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>CREATE FOREIGN DATA WRAPPER</refname>
+ <refpurpose>define a new foreign-data wrapper</refpurpose>
+ </refnamediv>
+
+ <indexterm zone="sql-createforeigndatawrapper">
+ <primary>CREATE FOREIGN DATA WRAPPER</primary>
+ </indexterm>
+
+ <refsynopsisdiv>
+<synopsis>
+CREATE FOREIGN DATA WRAPPER <replaceable class="parameter">name</replaceable>
+ [ VALIDATOR <replaceable class="parameter">valfunction</replaceable> | NO VALIDATOR ]
+ [ OPTIONS ( <replaceable class="PARAMETER">option</replaceable> '<replaceable class="PARAMETER">value</replaceable>' [, ... ] ) ]
+</synopsis>
+ </refsynopsisdiv>
+
+ <refsect1>
+ <title>Description</title>
+
+ <para>
+ <command>CREATE FOREIGN DATA WRAPPER</command> creates a new
+ foreign-data wrapper. The user who defines a foreign-data wrapper
+ becomes its owner.
+ </para>
+
+ <para>
+ The foreign-data wrapper name must be unique within the database.
+ </para>
+
+ <para>
+ Only superusers can create foreign-data wrappers.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Parameters</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><replaceable class="parameter">name</replaceable></term>
+ <listitem>
+ <para>
+ The name of the foreign-data wrapper to be created.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>VALIDATOR <replaceable class="parameter">valfunction</replaceable></literal></term>
+ <listitem>
+ <para>
+ <replaceable class="parameter">valfunction</replaceable> is the
+ name of a previously registered function that will be called to
+ check the generic options given to the foreign-data wrapper, as
+ well as to foreign servers and user mappings using the
+ foreign-data wrapper. If no validator function or <literal>NO
+ VALIDATOR</literal> is specified, then options will not be
+ checked at creation time. (Foreign-data wrappers will possibly
+ ignore or reject invalid option specifications at run time,
+ depending on the implementation.) The validator function must
+ take two arguments: one of type <type>text[]</type>, which will
+ contain the array of options as stored in the system catalogs,
+ and one of type <type>oid</type>, which will be the OID of the
+ system catalog containing the options, or zero if the context is
+ not known. The return type is ignored; the function should
+ indicate invalid options using
+ the <function>ereport()</function> function.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>OPTIONS ( <replaceable class="PARAMETER">option</replaceable> '<replaceable class="PARAMETER">value</replaceable>' [, ... ] )</literal></term>
+ <listitem>
+ <para>
+ This clause specifies options for the new foreign-data wrapper.
+ The allowed option names and values are specific to each foreign
+ data wrapper and are validated using the foreign-data wrapper
+ library. Option names must be unique.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
+ <title>Notes</title>
+
+ <para>
+ At the moment, the foreign-data wrapper functionality is very
+ rudimentary. The purpose of foreign-data wrappers, foreign
+ servers, and user mappings is to store this information in a
+ standard way so that it can be queried by interested applications.
+ The functionality to actually query external data does not exist
+ yet.
+ </para>
+
+ <para>
+ There is currently one foreign-data wrapper validator function
+ provided:
+ <filename>postgresql_fdw_validator</filename>, which accepts
+ options corresponding to <application>libpq</> connection
+ parameters.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>
+ Create a foreign-data wrapper <literal>dummy</>:
+<programlisting>
+CREATE FOREIGN DATA WRAPPER dummy;
+</programlisting>
+ </para>
+
+ <para>
+ Create a foreign-data wrapper <literal>postgresql</> with
+ validator function <literal>postgresql_fdw_validator</>:
+<programlisting>
+CREATE FOREIGN DATA WRAPPER postgresql VALIDATOR postgresql_fdw_validator;
+</programlisting>
+ </para>
+
+ <para>
+ Create a foreign-data wrapper <literal>mywrapper</> with some
+ options:
+<programlisting>
+CREATE FOREIGN DATA WRAPPER mywrapper
+ OPTIONS (debug 'true');
+</programlisting>
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Compatibility</title>
+
+ <para>
+ <command>CREATE FOREIGN DATA WRAPPER</command> conforms to ISO/IEC
+ 9075-9 (SQL/MED), with the exception that
+ the <literal>VALIDATOR</literal> clause is an extension and the
+ clauses <literal>LIBRARY</literal> and <literal>LANGUAGE</literal>
+ are not yet implemented in PostgreSQL.
+ </para>
+
+ <para>
+ Note, however, that the SQL/MED functionality as a whole is not yet
+ conforming.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-alterforeigndatawrapper" endterm="sql-alterforeigndatawrapper-title"></member>
+ <member><xref linkend="sql-dropforeigndatawrapper" endterm="sql-dropforeigndatawrapper-title"></member>
+ <member><xref linkend="sql-createserver" endterm="sql-createserver-title"></member>
+ <member><xref linkend="sql-createusermapping" endterm="sql-createusermapping-title"></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
Modified: traduc/trunk/postgresql/ref/create_function.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_function.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_function.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createfunction">
<refmeta>
<refentrytitle id="sql-createfunction-title">CREATE FUNCTION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -18,9 +19,11 @@
<refsynopsisdiv>
<synopsis>CREATE [ OR REPLACE ] FUNCTION
- <replaceable class="parameter">nom</replaceable> ( [ [ <replaceable class="parameter">modearg</replaceable> ] [ <replaceable class="parameter">nomarg</replaceable> ] <replaceable class="parameter">typearg</replaceable> [, ...] ] )
- [ RETURNS <replaceable class="parameter">type_ret</replaceable> ]
+ <replaceable class="parameter">nom</replaceable> ( [ [ <replaceable class="parameter">modearg</replaceable> ] [ <replaceable class="parameter">nomarg</replaceable> ] <replaceable class="parameter">typearg</replaceable> [ { DEFAULT | = } <replaceable class="parameter">defexpr</replaceable> ] [, ...] ] ) ] )
+ [ RETURNS <replaceable class="parameter">type_ret</replaceable>
+ | RETURNS TABLE ( <replaceable class="parameter">colname</replaceable> <replaceable class="parameter">coltype</replaceable> [, ...] ) ]
{ LANGUAGE <replaceable class="parameter">nomlang</replaceable>
+ | WINDOW
| IMMUTABLE | STABLE | VOLATILE
| CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT
| [EXTERNAL] SECURITY INVOKER | [EXTERNAL] SECURITY DEFINER
@@ -50,7 +53,7 @@
Si un nom de schéma est précisé, la fonction est créée dans le schéma
indiqué. Sinon, elle est créée dans le schéma courant. Le nom de la nouvelle
fonction ne peut pas correspondre à celui d'une fonction existant avec les
- mêmes types d'arguments dans le même schéma. Toutefois, les fonctions de types
+ mêmes types d'arguments en entrée dans le même schéma. Toutefois, les fonctions de types
d'arguments différents peuvent partager le même nom (ceci est appelé
<firstterm>surcharge</firstterm>).
</para>
@@ -104,8 +107,12 @@
<listitem>
<para>
Le mode d'un argument : <literal>IN</literal>,
- <literal>OUT</literal> ou <literal>INOUT</literal>. En cas d'omission, la valeur par défaut est
+ <literal>OUT</literal>, <literal>INOUT</literal> ou
+ <literal>VARIADIC</literal>. En cas d'omission, la valeur par défaut est
<literal>IN</literal>.
+ Only <literal>OUT</> arguments can follow a <literal>VARIADIC</> one.
+ Also, <literal>OUT</> and <literal>INOUT</> arguments cannot be used
+ together with the <literal>RETURNS TABLE</> notation.
</para>
</listitem>
</varlistentry>
@@ -153,6 +160,21 @@
</varlistentry>
<varlistentry>
+ <term><replaceable class="parameter">defexpr</replaceable></term>
+
+ <listitem>
+ <para>
+ An expression to be used as default value if the parameter is
+ not specified. The expression has to be coercible to the
+ argument type of the parameter.
+ Only input (including <literal>INOUT</>) parameters can have a default
+ value. All input parameters following a
+ parameter with a default value must have default values as well.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><replaceable class="parameter">type_ret</replaceable></term>
<listitem>
@@ -184,6 +206,30 @@
</varlistentry>
<varlistentry>
+ <term><replaceable class="parameter">colname</replaceable></term>
+
+ <listitem>
+ <para>
+ The name of an output column in the <literal>RETURNS TABLE</>
+ syntax. This is effectively another way of declaring a named
+ <literal>OUT</> parameter, except that <literal>RETURNS TABLE</>
+ also implies <literal>RETURNS SETOF</>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">coltype</replaceable></term>
+
+ <listitem>
+ <para>
+ The data type of an output column in the <literal>RETURNS TABLE</>
+ syntax.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><replaceable class="parameter">nomlang</replaceable></term>
<listitem>
@@ -198,6 +244,20 @@
</varlistentry>
<varlistentry>
+ <term><literal>WINDOW</literal></term>
+
+ <listitem>
+ <para>
+ <literal>WINDOW</literal> indicates that the function is a
+ <firstterm>window function</> rather than a plain function.
+ This is currently only useful for functions written in C.
+ The <literal>WINDOW</> attribute cannot be changed when
+ replacing an existing function definition.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><literal>IMMUTABLE</literal></term>
<term><literal>STABLE</literal></term>
<term><literal>VOLATILE</literal></term>
@@ -435,7 +495,7 @@
<productname>PostgreSQL</productname> autorise la
<firstterm>surcharge</firstterm> des fonctions ; c'est-à-dire que
le même nom peut être utilisé pour des fonctions différentes si tant
- est qu'elles aient des types d'arguments distincts. Néanmoins, les noms C de
+ est qu'elles aient des types d'arguments en entrée distincts. Néanmoins, les noms C de
toutes les fonctions doivent être différents. Il est donc nécessaire de donner des
noms différents aux fonctions C suchargées (on peut, par exemple, utiliser le type
des arguments dans le nom de la fonction).
@@ -451,6 +511,18 @@
</para>
<para>
+ Functions that have different argument type lists will not be considered
+ to conflict at creation time, but if defaults are provided they might
+ conflict in use. For example, consider
+<programlisting>
+CREATE FUNCTION foo(int) ...
+CREATE FUNCTION foo(int, int default 42) ...
+</programlisting>
+ A call <literal>foo(10)</> will fail due to the ambiguity about which
+ function should be called.
+ </para>
+
+ <para>
Lors d'appels répétés à <command>CREATE FUNCTION</command> faisant référence
au même fichier objet, le fichier est chargé une seule fois par session.
Pour décharger
@@ -534,6 +606,18 @@
SELECT * FROM dup(42);
</programlisting>
+ Another way to return multiple columns is to use a <literal>TABLE</>
+ function:
+<programlisting>
+CREATE FUNCTION dup(int) RETURNS TABLE(f1 int, f2 text)
+ AS $$ SELECT $1, CAST($1 AS text) || ' is text' $$
+ LANGUAGE SQL;
+
+SELECT * FROM dup(42);
+</programlisting>
+ However, a <literal>TABLE</> function is different from the
+ preceding examples, because it actually returns a <emphasis>set</>
+ of records, not just one record.
</para>
</refsect1>
@@ -622,9 +706,16 @@
avant ou après <replaceable class="parameter">nomarg</replaceable>. Mais
seule la première façon est compatible avec le standard.
</para>
+
+ <para>
+ The SQL standard does not specify parameter defaults. The syntax
+ with the <literal>DEFAULT</literal> key word is from Oracle, and it
+ is somewhat in the spirit of the standard: SQL/PSM uses it for
+ variable default values. The syntax with <literal>=</literal> is
+ used in T-SQL and Firebird.
+ </para>
</refsect1>
-
-
+
<refsect1>
<title>Voir aussi</title>
Modified: traduc/trunk/postgresql/ref/create_group.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_group.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_group.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-creategroup">
<refmeta>
<refentrytitle id="sql-creategroup-title">CREATE GROUP</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_index.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_index.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_index.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createindex">
<refmeta>
<refentrytitle id="sql-createindex-title">CREATE INDEX</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -237,7 +238,8 @@
<listitem>
<para>
Le nom d'un paramètre de stockage spécifique à la méthode d'indexage.
- Voir ci-dessous pour les détails.
+ Voir <xref linkend="sql-createindex-storage-parameters"
+ endterm="sql-createindex-storage-parameters-title"> pour les détails.
</para>
</listitem>
</varlistentry>
@@ -271,7 +273,8 @@
La clause <literal>WITH</literal> peut spécifier des <firstterm>paramètres
de stockage</firstterm> pour les index. Chaque méthode d'indexage peut avoir
son propre ensemble de paramètres de stockage. Les méthodes d'indexage
- intégrées acceptent toutes un seul paramètre :
+ <literal>B-tree</literal>, <literal>hash</literal> et <literal>GiST</literal>
+ acceptent toutes un seul paramètre :
</para>
<variablelist>
@@ -298,7 +301,36 @@
</para>
</listitem>
</varlistentry>
+ <para>
+ <literal>GIN</literal> indexes accept a different parameter:
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><literal>FASTUPDATE</></term>
+ <listitem>
+ <para>
+ This setting controls usage of the fast update technique described in
+ <xref linkend="gin-fast-update">. It is a Boolean parameter:
+ <literal>ON</> enables fast update, <literal>OFF</> disables it.
+ (Alternative spellings of <literal>ON</> and <literal>OFF</> are
+ allowed as described in <xref linkend="config-setting">.) The
+ default is <literal>ON</>.
+ </para>
+
+ <note>
+ <para>
+ Turning <literal>FASTUPDATE</> off via <command>ALTER INDEX</> prevents
+ future insertions from going into the list of pending index entries,
+ but does not in itself flush previous entries. You might want to
+ <command>VACUUM</> the table afterward to ensure the pending list is
+ emptied.
+ </para>
+ </note>
+ </listitem>
+ </varlistentry>
+
</variablelist>
</refsect2>
@@ -413,7 +445,7 @@
</para>
<para>
- Actuellement, seules les méthodes d'indexation B-tree et GiST supportent les
+ Actuellement, seules les méthodes d'indexation B-tree, GiST et GIN supportent les
index multi-colonnes. Jusqu'à 32 champs peuvent être spécifiés par défaut.
(Cette limite peut être modifiée à la compilation de
<productname>PostgreSQL</productname>.) Seul B-tree supporte actuellement les
@@ -462,6 +494,23 @@
</para>
<para>
+ For most index methods, the speed of creating an index is
+ dependent on the setting of <xref linkend="guc-maintenance-work-mem">.
+ Larger values will reduce the time needed for index creation, so long
+ as you don't make it larger than the amount of memory really available,
+ which would drive the machine into swapping. For hash indexes, the
+ value of <xref linkend="guc-effective-cache-size"> is also relevant to
+ index creation time: <productname>PostgreSQL</productname> will use one
+ of two different hash index creation methods depending on whether the
+ estimated index size is more or less than <varname>effective_cache_size</>.
+ For best results, make sure that this parameter is also set to something
+ reflective of available memory, and be careful that the sum of
+ <varname>maintenance_work_mem</> and <varname>effective_cache_size</> is
+ less than the machine's RAM less whatever space is needed by other
+ programs.
+ </para>
+
+ <para>
<xref linkend="sql-dropindex" endterm="sql-dropindex-title"/> est utilisé
pour supprimer un index.
</para>
@@ -508,6 +557,13 @@
</para>
<para>
+ To create a <acronym>GIN</> index with fast updates disabled:
+<programlisting>
+CREATE INDEX gin_idx ON documents_table (locations) WITH (fastupdate = off);
+</programlisting>
+ </para>
+
+ <para>
Créer un index sur la colonne <literal>code</literal> de la table
<literal>films</literal> et donner à l'index l'emplacement du tablespace
<literal>espaceindex</literal> :
Modified: traduc/trunk/postgresql/ref/create_language.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_language.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_language.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createlanguage">
<refmeta>
<refentrytitle id="sql-createlanguage-title">CREATE LANGUAGE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_opclass.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_opclass.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_opclass.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createopclass">
<refmeta>
<refentrytitle id="sql-createopclass-title">CREATE OPERATOR CLASS</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -19,7 +20,7 @@
<refsynopsisdiv>
<synopsis>CREATE OPERATOR CLASS <replaceable class="parameter">nom</replaceable> [ DEFAULT ] FOR TYPE <replaceable class="parameter">type_donnee</replaceable>
USING <replaceable class="parameter">methode_indexage</replaceable> [ FAMILY <replaceable class="parameter">nom_famille</replaceable> ] AS
- { OPERATOR <replaceable class="parameter">numero_strategie</replaceable> <replaceable class="parameter">nom_operateur</replaceable> [ ( <replaceable class="parameter">type_op</replaceable>, <replaceable class="parameter">type_op</replaceable> ) ] [ RECHECK ]
+ { OPERATOR <replaceable class="parameter">numero_strategie</replaceable> <replaceable class="parameter">nom_operateur</replaceable> [ ( <replaceable class="parameter">type_op</replaceable>, <replaceable class="parameter">type_op</replaceable> ) ]
| FUNCTION <replaceable class="parameter">numero_support</replaceable> [ ( <replaceable class="parameter">type_op</replaceable> [ , <replaceable class="parameter">type_op</replaceable> ] ) ] <replaceable class="parameter">nom_fonction</replaceable> ( <replaceable class="parameter">type_argument</replaceable> [, ...] )
| STORAGE <replaceable class="parameter">type_stockage</replaceable>
} [, ... ]
@@ -179,17 +180,6 @@
</varlistentry>
<varlistentry>
- <term><literal>RECHECK</literal></term>
- <listitem>
- <para>
- L'indexation de cet opérateur est <quote>faible</quote>. Dans ce cas,
- il faut recontrôler la validité de chaque ligne chargée par rapport à
- l'opérateur.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
<term><replaceable class="parameter">numéro_support</replaceable></term>
<listitem>
<para>
@@ -257,6 +247,14 @@
fonction SQL peut être intégrée dans la requête appelante, ce qui
empêche l'optimiseur de faire la correspondance avec un index.
</para>
+
+ <para>
+ Before <productname>PostgreSQL</productname> 8.4, the <literal>OPERATOR</>
+ clause could include a <literal>RECHECK</> option. This is no longer
+ supported because whether an index operator is <quote>lossy</> is now
+ determined on-the-fly at runtime. This allows efficient handling of
+ cases where an operator might or might not be lossy.
+ </para>
</refsect1>
<refsect1>
@@ -272,12 +270,12 @@
<programlisting>CREATE OPERATOR CLASS gist__int_ops
DEFAULT FOR TYPE _int4 USING gist AS
OPERATOR 3 &&,
- OPERATOR 6 = RECHECK,
+ OPERATOR 6 = (anyarray, anyarray),
OPERATOR 7 @>,
OPERATOR 8 <@,
OPERATOR 20 @@ (_int4, query_int),
- FUNCTION 1 g_int_consistent (internal, _int4, int4),
- FUNCTION 2 g_int_union (bytea, internal),
+ FUNCTION 1 g_int_consistent (internal, _int4, int, oid, internal),
+ FUNCTION 2 g_int_union (internal, internal),
FUNCTION 3 g_int_compress (internal),
FUNCTION 4 g_int_decompress (internal),
FUNCTION 5 g_int_penalty (internal, internal, internal),
Modified: traduc/trunk/postgresql/ref/create_operator.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_operator.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_operator.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createoperator">
<refmeta>
<refentrytitle id="sql-createoperator-title">CREATE OPERATOR</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_opfamily.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_opfamily.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_opfamily.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-createopfamily">
<refmeta>
<refentrytitle id="sql-createopfamily-title">CREATE OPERATOR FAMILY</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_role.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_role.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_role.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createrole">
<refmeta>
<refentrytitle id="sql-createrole-title">CREATE ROLE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_rule.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_rule.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_rule.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createrule">
<refmeta>
<refentrytitle id="sql-createrule-title">CREATE RULE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_schema.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_schema.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_schema.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createschema">
<refmeta>
<refentrytitle id="sql-createschema-title">CREATE SCHEMA</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_sequence.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_sequence.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_sequence.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createsequence">
<refmeta>
<refentrytitle id="sql-createsequence-title">CREATE SEQUENCE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Added: traduc/trunk/postgresql/ref/create_server.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_server.xml (rev 0)
+++ traduc/trunk/postgresql/ref/create_server.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -0,0 +1,140 @@
+<!--
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_server.sgml,v 1.3 2009-02-27 07:20:00 petere Exp $
+PostgreSQL documentation
+-->
+
+<refentry id="SQL-CREATESERVER">
+ <refmeta>
+ <refentrytitle id="sql-createserver-title">CREATE SERVER</refentrytitle>
+ <refmiscinfo>SQL - Language Statements</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>CREATE SERVER</refname>
+ <refpurpose>define a new foreign server</refpurpose>
+ </refnamediv>
+
+ <indexterm zone="sql-createserver">
+ <primary>CREATE SERVER</primary>
+ </indexterm>
+
+ <refsynopsisdiv>
+<synopsis>
+CREATE SERVER <replaceable class="parameter">servername</replaceable> [ TYPE 'servertype' ] [ VERSION 'serverversion' ]
+ FOREIGN DATA WRAPPER <replaceable class="parameter">fdwname</replaceable>
+ [ OPTIONS ( <replaceable class="PARAMETER">option</replaceable> '<replaceable class="PARAMETER">value</replaceable>' [, ... ] ) ]
+</synopsis>
+ </refsynopsisdiv>
+
+ <refsect1>
+ <title>Description</title>
+
+ <para>
+ <command>CREATE SERVER</command> defines a new foreign server. The
+ user who defines the server becomes its owner.
+ </para>
+
+ <para>
+ The server name must be unique within the database.
+ </para>
+
+ <para>
+ Creating a server requires <literal>USAGE</> privilege on the
+ foreign-data wrapper being used.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Parameters</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><replaceable class="parameter">servername</replaceable></term>
+ <listitem>
+ <para>
+ The name of the foreign server to be created.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">servertype</replaceable></term>
+ <listitem>
+ <para>
+ Optional server type.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">serverversion</replaceable></term>
+ <listitem>
+ <para>
+ Optional server version.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">fdwname</replaceable></term>
+ <listitem>
+ <para>
+ The name of the foreign-data wrapper that manages the server.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>OPTIONS ( <replaceable class="PARAMETER">option</replaceable> '<replaceable class="PARAMETER">value</replaceable>' [, ... ] )</literal></term>
+ <listitem>
+ <para>
+ This clause specifies the options for the server. The options
+ typically define the connection details of the server, but the
+ actual names and values are dependent on the server's
+ foreign-data wrapper.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>
+ Create a server <literal>foo</> that uses the built-in foreign-data
+ wrapper <literal>default</>:
+<programlisting>
+CREATE SERVER foo FOREIGN DATA WRAPPER "default";
+</programlisting>
+ </para>
+
+ <para>
+ Create a server <literal>myserver</> that uses the
+ foreign-data wrapper <literal>pgsql</>:
+<programlisting>
+CREATE SERVER myserver FOREIGN DATA WRAPPER pgsql OPTIONS (host 'foo', dbname 'foodb', port '5432');
+</programlisting>
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Compatibility</title>
+
+ <para>
+ <command>CREATE SERVER</command> conforms to ISO/IEC 9075-9 (SQL/MED).
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-alterserver" endterm="sql-alterserver-title"></member>
+ <member><xref linkend="sql-dropserver" endterm="sql-dropserver-title"></member>
+ <member><xref linkend="sql-createforeigndatawrapper" endterm="sql-createforeigndatawrapper-title"></member>
+ <member><xref linkend="sql-createusermapping" endterm="sql-createusermapping-title"></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
Modified: traduc/trunk/postgresql/ref/create_table.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_table.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_table.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createtable">
<refmeta>
<refentrytitle id="sql-createtable-title">CREATE TABLE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -211,14 +212,23 @@
colonne dans la nouvelle table. Si la liste des noms de colonnes de la
nouvelle table contient un nom de colonne hérité, le type
de données doit correspondre à celui des colonnes héritées et les définitions des
- colonnes sont fusionnées. Néanmoins, les déclarations des
- colonnes héritées et des nouvelles de même nom n'ont pas l'obligation de spécifier
- des contraintes identiques : toutes les contraintes sont assemblées et appliquées à la nouvelle
- table. Si la nouvelle table spécifie explicitement une valeur par défaut
+ colonnes sont fusionnées. Si la nouvelle table spécifie explicitement une valeur par défaut
pour la colonne, cette valeur surcharge toute valeur par défaut héritée.
Dans le cas contraire, les parents qui spécifient une valeur par défaut doivent
tous spécifier la même, sans quoi une erreur est rapportée.
</para>
+
+ <para>
+ <literal>CHECK</> constraints are merged in essentially the same way as
+ columns: if multiple parent tables and/or the new table definition
+ contain identically-named <literal>CHECK</> constraints, these
+ constraints must all have the same check expression, or an error will be
+ reported. Constraints having the same name and expression will
+ be merged into one copy. Notice that an unnamed <literal>CHECK</>
+ constraint in the new table will never be merged, since a unique name
+ will always be chosen for it.
+ </para>
+
<!--
<para>
<productname>PostgreSQL</productname> automatically allows the
@@ -678,19 +688,29 @@
<refsect2 id="sql-createtable-storage-parameters">
<title id="sql-createtable-storage-parameters-title">Paramètres de stockage</title>
+ <indexterm zone="sql-createtable-storage-parameters">
+ <primary>storage parameters</primary>
+ </indexterm>
+
<para>
La clause <literal>WITH</literal> spécifie des <firstterm>paramètres de
stockage</firstterm> pour les tables ainsi que pour les index associés
avec une contrainte <literal>UNIQUE</literal> ou <literal>PRIMARY
KEY</literal>. Les paramètres de stockage des index sont documentés dans
- <xref linkend="sql-createindex" endterm="sql-createindex-title"/>. Le seul
- paramètre de stockage actuellement disponible pour les tables est :
+ <xref linkend="sql-createindex" endterm="sql-createindex-title"/>. The storage parameters currently
+ available for tables are listed below. For each parameter, there is an
+ additional, identically named parameter, prefixed with
+ <literal>toast.</literal> which can be used to control the behavior of the
+ supplementary storage table, if any; see <xref linkend="storage-toast">.
+ Note that the supplementary storage table inherits the
+ <literal>autovacuum</literal> values from its parent table, if there are
+ no <literal>toast.autovacuum_*</literal> settings set.
</para>
<variablelist>
<varlistentry>
- <term><literal>FILLFACTOR</literal></term>
+ <term><literal>fillfactor</>, <literal>toast.fillfactor</literal> (<type>integer</>)</term>
<listitem>
<para>
Le facteur de remplissage d'une table est un pourcentage entre 10 et 100.
@@ -708,6 +728,122 @@
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><literal>autovacuum_enabled</>, <literal>toast.autovacuum_enabled</literal> (<type>boolean</>)</term>
+ <listitem>
+ <para>
+ Enables or disables the autovacuum daemon on a particular table.
+ If true, the autovacuum daemon will initiate a <command>VACUUM</> operation
+ on a particular table when the number of updated or deleted tuples exceeds
+ <literal>autovacuum_vacuum_threshold</> plus
+ <literal>autovacuum_vacuum_scale_factor</> times the number of live tuples
+ currently estimated to be in the relation.
+ Similarly, it will initiate an <command>ANALYZE</> operation when the
+ number of inserted, updated or deleted tuples exceeds
+ <literal>autovacuum_analyze_threshold</> plus
+ <literal>autovacuum_analyze_scale_factor</> times the number of live tuples
+ currently estimated to be in the relation.
+ If false, this table will not be autovacuumed, except to prevent
+ transaction Id wraparound. See <xref linkend="vacuum-for-wraparound"> for
+ more about wraparound prevention.
+ Observe that this variable inherits its value from the <xref
+ linkend="guc-autovacuum"> setting.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>autovacuum_vacuum_threshold</>, <literal>toast.autovacuum_vacuum_threshold</literal> (<type>integer</>)</term>
+ <listitem>
+ <para>
+ Minimum number of updated or deleted tuples before initiate a
+ <command>VACUUM</> operation on a particular table.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>autovacuum_vacuum_scale_factor</>, <literal>toast.autovacuum_vacuum_scale_factor</literal> (<type>float4</>)</term>
+ <listitem>
+ <para>
+ Multiplier for <structfield>reltuples</> to add to
+ <literal>autovacuum_vacuum_threshold</>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>autovacuum_analyze_threshold</>, <literal>toast.autovacuum_analyze_threshold</literal> (<type>integer</>)</term>
+ <listitem>
+ <para>
+ Minimum number of inserted, updated, or deleted tuples before initiate an
+ <command>ANALYZE</> operation on a particular table.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>autovacuum_analyze_scale_factor</>, <literal>toast.autovacuum_analyze_scale_factor</literal> (<type>float4</>)</term>
+ <listitem>
+ <para>
+ Multiplier for <structfield>reltuples</> to add to
+ <literal>autovacuum_analyze_threshold</>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>autovacuum_vacuum_cost_delay</>, <literal>toast.autovacuum_vacuum_cost_delay</literal> (<type>integer</>)</term>
+ <listitem>
+ <para>
+ Custom <xref linkend="guc-autovacuum-vacuum-cost-delay"> parameter.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>autovacuum_vacuum_cost_limit</>, <literal>toast.autovacuum_vacuum_cost_limit</literal> (<type>integer</>)</term>
+ <listitem>
+ <para>
+ Custom <xref linkend="guc-autovacuum-vacuum-cost-limit"> parameter.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>autovacuum_freeze_min_age</>, <literal>toast.autovacuum_freeze_min_age</literal> (<type>integer</>)</term>
+ <listitem>
+ <para>
+ Custom <xref linkend="guc-vacuum-freeze-min-age"> parameter. Note that
+ autovacuum will ignore attempts to set a per-table
+ <literal>autovacuum_freeze_min_age</> larger than the half system-wide
+ <xref linkend="guc-autovacuum-freeze-max-age"> setting.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>autovacuum_freeze_max_age</>, <literal>toast.autovacuum_freeze_max_age</literal> (<type>integer</>)</term>
+ <listitem>
+ <para>
+ Custom <xref linkend="guc-autovacuum-freeze-max-age"> parameter. Note that
+ autovacuum will ignore attempts to set a per-table
+ <literal>autovacuum_freeze_max_age</> larger than the system-wide setting
+ (it can only be set smaller). Note that while you can set
+ <literal>autovacuum_freeze_max_age</> very small, or even zero, this is
+ usually unwise since it will force frequent vacuuming.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>autovacuum_freeze_table_age</literal> (<type>integer</type>)</term>
+ <listitem>
+ <para>
+ Custom <xref linkend="guc-vacuum-freeze-table-age"> parameter.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</refsect2>
Modified: traduc/trunk/postgresql/ref/create_table_as.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_table_as.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_table_as.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createtableas">
<refmeta>
<refentrytitle id="sql-createtableas-title">CREATE TABLE AS</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -24,6 +25,7 @@
[ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ]
[ TABLESPACE <replaceable class="parameter">espace_logique</replaceable> ]
AS <replaceable>requête</replaceable>
+ [ WITH [ NO ] DATA ]
</synopsis>
</refsynopsisdiv>
@@ -188,13 +190,25 @@
<term><replaceable>requête</replaceable></term>
<listitem>
<para>
- Une commande <xref linkend="sql-select" endterm="sql-select-title"/> ou
+ Une commande <xref linkend="sql-select" endterm="sql-select-title"/>,
+ <link linkend="sql-table">TABLE</link> ou
<xref linkend="sql-values" endterm="sql-values-title"/>, voire une commande
<xref linkend="sql-execute" endterm="sql-execute-title"/> qui exécute un
- <command>SELECT</command> préparé ou une requête <command>VALUES</command>.
+ <command>SELECT</command> préparé, <command>TABLE</> ou une requête <command>VALUES</command>.
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><literal>WITH [ NO ] DATA</></term>
+ <listitem>
+ <para>
+ This clause specifies whether or not the data produced by the query
+ should be copied into the new table. If not, only the table structure
+ is copied. The default is to copy the data.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</refsect1>
@@ -238,6 +252,16 @@
</para>
<para>
+ To copy a table completely, the short form using
+ the <literal>TABLE</literal> command can also be used:
+
+<programlisting>
+CREATE TABLE films2 AS
+ TABLE films;
+</programlisting>
+ </para>
+
+ <para>
Créer une nouvelle table temporaire <literal>films_recents</literal> consistant
des seules entrées récentes provenant de la table <literal>films</literal> en
utilisant une instruction préparée. La nouvelle table a des OID et sera
@@ -258,7 +282,7 @@
<para>
<command>CREATE TABLE AS</command> est conforme au standard
- <acronym>SQL</acronym>, avec les exceptions suivantes :
+ <acronym>SQL</acronym>. The following are nonstandard extensions :
<itemizedlist spacing="compact">
<listitem>
@@ -270,12 +294,8 @@
<listitem>
<para>
- Le standard définit une clause <literal>WITH [ NO ] DATA</literal> ;
- ceci n'est pas encore implémenté dans <productname>PostgreSQL</productname>.
- Le comportement proposé par <productname>PostgreSQL</productname> est
- équivalent au cas standard <literal>WITH DATA</literal>.
- <literal>WITH NO DATA</literal> peut être simulé en ajoutant
- <literal>LIMIT 0</literal> à la requête.
+ In the standard, the <literal>WITH [ NO ] DATA</literal> clause
+ is required; in PostgreSQL it is optional.
</para>
</listitem>
Modified: traduc/trunk/postgresql/ref/create_tablespace.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_tablespace.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_tablespace.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createtablespace">
<refmeta>
<refentrytitle id="sql-createtablespace-title">CREATE TABLESPACE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_trigger.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_trigger.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_trigger.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createtrigger">
<refmeta>
<refentrytitle id="sql-createtrigger-title">CREATE TRIGGER</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -65,6 +66,12 @@
</para>
<para>
+ In addition, triggers may be defined to fire for a
+ <command>TRUNCATE</command>, though only
+ <literal>FOR EACH STATEMENT</literal>.
+ </para>
+
+ <para>
Si plusieurs déclencheurs du même genre sont définis pour le même événement,
ils sont déclenchés suivant l'ordre alphabétique de leur nom.
</para>
@@ -110,7 +117,8 @@
<listitem>
<para>
Peut-être <command>INSERT</command>, <command>UPDATE</command> ou
- <command>DELETE</command> ; précise l'événement qui active le
+ <command>DELETE</command> ou <command>TRUNCATE</command> ;
+ précise l'événement qui active le
déclencheur. Plusieurs événements peuvent être précisés en les séparant par
<literal>OR</literal>.
</para>
@@ -178,6 +186,11 @@
</para>
<para>
+ <xref linkend="sql-droptrigger" endterm="sql-droptrigger-title"/>
+ est utilisé pour supprimer un déclencheur.
+ </para>
+
+ <para>
Dans les versions de <productname>PostgreSQL</productname> antérieures à la
7.3, il était nécessaire de déclarer un type <type>opaque</type> de
retour pour les fonctions déclencheur, plutôt que <type>trigger</type>. Pour
@@ -186,11 +199,6 @@
<type>opaque</type>, mais il affiche un message d'avertissement et change le
type de retour déclaré en <type>trigger</type>.
</para>
-
- <para>
- <xref linkend="sql-droptrigger" endterm="sql-droptrigger-title"/>
- est utilisé pour supprimer un déclencheur.
- </para>
</refsect1>
<refsect1 id="r1-sql-createtrigger-2">
@@ -266,6 +274,11 @@
La capacité à préciser plusieurs actions pour un seul déclencheur avec
<literal>OR</literal> est une extension <productname>PostgreSQL</productname>.
</para>
+
+ <para>
+ The ability to fire triggers for <command>TRUNCATE</command> is a
+ <productname>PostgreSQL</> extension of the SQL standard.
+ </para>
</refsect1>
<refsect1>
Modified: traduc/trunk/postgresql/ref/create_tsconfig.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_tsconfig.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_tsconfig.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-createtsconfig">
<refmeta>
<refentrytitle id="sql-createtsconfig-title">CREATE TEXT SEARCH CONFIGURATION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_tsdictionary.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_tsdictionary.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_tsdictionary.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-createtsdictionary">
<refmeta>
<refentrytitle id="sql-createtsdictionary-title">CREATE TEXT SEARCH DICTIONARY</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_tsparser.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_tsparser.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_tsparser.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-createtsparser">
<refmeta>
<refentrytitle id="sql-createtsparser-title">CREATE TEXT SEARCH PARSER</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_tstemplate.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_tstemplate.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_tstemplate.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-createtstemplate">
<refmeta>
<refentrytitle id="sql-createtstemplate-title">CREATE TEXT SEARCH TEMPLATE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/create_type.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_type.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_type.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createtype">
<refmeta>
<refentrytitle id="sql-createtype-title">CREATE TYPE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -35,6 +36,9 @@
[ , PASSEDBYVALUE ]
[ , ALIGNMENT = <replaceable class="parameter">alignement</replaceable> ]
[ , STORAGE = <replaceable class="parameter">stockage</replaceable> ]
+ [ , LIKE = <replaceable class="parameter">like_type</replaceable> ]
+ [ , CATEGORY = <replaceable class="parameter">category</replaceable> ]
+ [ , PREFERRED = <replaceable class="parameter">preferred</replaceable> ]
[ , DEFAULT = <replaceable class="parameter">défaut</replaceable> ]
[ , ELEMENT = <replaceable class="parameter">élément</replaceable> ]
[ , DELIMITER = <replaceable class="parameter">délimiteur</replaceable> ]
@@ -96,7 +100,13 @@
<para>
La troisième forme de <command>CREATE TYPE</command> crée un nouveau type de base
- (type scalaire). L'ordre des paramètres, dont la plupart sont optionnels, n'a aucune
+ (type scalaire). To create a new base type, you must be a superuser.
+ (This restriction is made because an erroneous type definition could
+ confuse or even crash the server.)
+ </para>
+
+ <para>
+ L'ordre des paramètres, dont la plupart sont optionnels, n'a aucune
d'importance. Avant de définir le type, il est nécessaire de définir au moins
deux fonctions (à l'aide de la commande <command>CREATE FUNCTION</command>).
Les fonctions de support <replaceable class="parameter">fonction_entrée</replaceable>
@@ -284,6 +294,42 @@
</para>
<para>
+ The <replaceable class="parameter">like_type</replaceable> parameter
+ provides an alternative method for specifying the basic representation
+ properties of a data type: copy them from some existing type. The values of
+ <replaceable class="parameter">internallength</replaceable>,
+ <replaceable class="parameter">passedbyvalue</replaceable>,
+ <replaceable class="parameter">alignment</replaceable>, and
+ <replaceable class="parameter">storage</replaceable> are copied from the
+ named type. (It is possible, though usually undesirable, to override
+ some of these values by specifying them along with the <literal>LIKE</>
+ clause.) Specifying representation this way is especially useful when
+ the low-level implementation of the new type <quote>piggybacks</> on an
+ existing type in some fashion.
+ </para>
+
+ <para>
+ The <replaceable class="parameter">category</replaceable> and
+ <replaceable class="parameter">preferred</replaceable> parameters can be
+ used to help control which implicit cast will be applied in ambiguous
+ situations. Each data type belongs to a category named by a single ASCII
+ character, and each type is either <quote>preferred</> or not within its
+ category. The parser will prefer casting to preferred types (but only from
+ other types within the same category) when this rule is helpful in
+ resolving overloaded functions or operators. For more details see <xref
+ linkend="typeconv">. For types that have no implicit casts to or from any
+ other types, it is sufficient to leave these settings at the defaults.
+ However, for a group of related types that have implicit casts, it is often
+ helpful to mark them all as belonging to a category and select one or two
+ of the <quote>most general</> types as being preferred within the category.
+ The <replaceable class="parameter">category</replaceable> parameter is
+ especially useful when adding a user-defined type to an existing built-in
+ category, such as the numeric or string types. However, it is also
+ possible to create new entirely-user-defined type categories. Select any
+ ASCII character other than an upper-case letter to name such a category.
+ </para>
+
+ <para>
Une valeur par défaut peut être spécifiée dans le cas où l'utilisateur
souhaite que cette valeur soit différente de NULL pour les colonnes de ce type.
La valeur par défaut est précisée à l'aide du mot clé
@@ -499,6 +545,47 @@
</varlistentry>
<varlistentry>
+ <term><replaceable class="parameter">like_type</replaceable></term>
+ <listitem>
+ <para>
+ The name of an existing data type that the new type will have the
+ same representation as. The values of
+ <replaceable class="parameter">internallength</replaceable>,
+ <replaceable class="parameter">passedbyvalue</replaceable>,
+ <replaceable class="parameter">alignment</replaceable>, and
+ <replaceable class="parameter">storage</replaceable>
+ are copied from that type, unless overridden by explicit
+ specification elsewhere in this <command>CREATE TYPE</> command.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">category</replaceable></term>
+ <listitem>
+ <para>
+ The category code (a single ASCII character) for this type.
+ The default is <literal>'U'</> for <quote>user-defined type</>.
+ Other standard category codes can be found in
+ <xref linkend="catalog-typcategory-table">. You may also choose
+ other ASCII characters in order to create custom categories.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">preferred</replaceable></term>
+ <listitem>
+ <para>
+ True if this type is a preferred type within its type category,
+ else false. The default is false. Be very careful about creating
+ a new preferred type within an existing type category, as this
+ could cause surprising changes in behavior.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><replaceable class="parameter">défaut</replaceable></term>
<listitem>
<para>
@@ -534,7 +621,7 @@
Comme il n'y a pas de restrictions à l'utilisation d'un type de données
une fois qu'il a été créé, créer un type de base est équivalent à donner les
droits d'exécution ssur les fonctions mentionnées dans la définition du
- type. (Le créateur du type a donc besoin de posséder ces fonctions.) Ce
+ type. Ce
n'est pas un problème habituellement pour le genre de fonctions utiles
dans la définition d'un type mais réfléchissez bien avant de concevoir
un type d'une façon qui nécessiterait que des informations
Modified: traduc/trunk/postgresql/ref/create_user.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_user.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_user.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createuser">
<refmeta>
<refentrytitle id="sql-createuser-title">CREATE USER</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Added: traduc/trunk/postgresql/ref/create_user_mapping.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_user_mapping.xml (rev 0)
+++ traduc/trunk/postgresql/ref/create_user_mapping.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -0,0 +1,116 @@
+<!--
+$PostgreSQL: pgsql/doc/src/sgml/ref/create_user_mapping.sgml,v 1.4 2009-02-27 07:20:00 petere Exp $
+PostgreSQL documentation
+-->
+
+<refentry id="SQL-CREATEUSERMAPPING">
+ <refmeta>
+ <refentrytitle id="sql-createusermapping-title">CREATE USER MAPPING</refentrytitle>
+ <refmiscinfo>SQL - Language Statements</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>CREATE USER MAPPING</refname>
+ <refpurpose>define a new mapping of a user to a foreign server</refpurpose>
+ </refnamediv>
+
+ <indexterm zone="sql-createusermapping">
+ <primary>CREATE USER MAPPING</primary>
+ </indexterm>
+
+ <refsynopsisdiv>
+<synopsis>
+CREATE USER MAPPING FOR { <replaceable class="parameter">username</replaceable> | USER | CURRENT_USER | PUBLIC }
+ SERVER <replaceable class="parameter">servername</replaceable>
+ [ OPTIONS ( <replaceable class="PARAMETER">option</replaceable> '<replaceable class="PARAMETER">value</replaceable>' [ , ... ] ) ]
+</synopsis>
+ </refsynopsisdiv>
+
+ <refsect1>
+ <title>Description</title>
+
+ <para>
+ <command>CREATE USER MAPPING</command> defines a mapping of a user
+ to a foreign server.
+ </para>
+
+ <para>
+ The owner of a foreign server can create user mappings for that
+ server for any user. Also, a user can create a user mapping for
+ his own user name if <literal>USAGE</> privilege on the server has
+ been granted to the user.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Parameters</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><replaceable class="parameter">username</replaceable></term>
+ <listitem>
+ <para>
+ The name of an existing user that is mapped to foreign server.
+ <literal>CURRENT_USER</> and <literal>USER</> match the name of
+ the current user. <literal>PUBLIC</> is used to match all
+ present and future user names in the system.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">servername</replaceable></term>
+ <listitem>
+ <para>
+ The name of an existing server for which the user mapping is
+ to be created.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>OPTIONS ( <replaceable class="PARAMETER">option</replaceable> '<replaceable class="PARAMETER">value</replaceable>' [, ... ] )</literal></term>
+ <listitem>
+ <para>
+ This clause specifies the options of the user mapping. The
+ options typically define the actual user name and password of
+ the mapping. Option names must be unique. The allowed option
+ names and values are specific to the server's foreign-data wrapper.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>
+ Create a user mapping for user <literal>bob</>, server <literal>foo</>:
+<programlisting>
+CREATE USER MAPPING FOR bob SERVER foo OPTIONS (user 'bob', password 'secret');
+</programlisting>
+ </para>
+
+ </refsect1>
+
+ <refsect1>
+ <title>Compatibility</title>
+
+ <para>
+ <command>CREATE USER MAPPING</command> conforms to ISO/IEC 9075-9 (SQL/MED).
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-alterusermapping" endterm="sql-alterusermapping-title"></member>
+ <member><xref linkend="sql-dropusermapping" endterm="sql-dropusermapping-title"></member>
+ <member><xref linkend="sql-createforeigndatawrapper" endterm="sql-createforeigndatawrapper-title"></member>
+ <member><xref linkend="sql-createserver" endterm="sql-createserver-title"></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
Modified: traduc/trunk/postgresql/ref/create_view.xml
===================================================================
--- traduc/trunk/postgresql/ref/create_view.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/create_view.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-createview">
<refmeta>
<refentrytitle id="sql-createview-title">CREATE VIEW</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -36,10 +37,11 @@
<para>
<command>CREATE OR REPLACE VIEW</command> a la même finalité, mais
- si une vue du même nom existe déjà, elle est remplacée. Une vue ne
- peut être remplacée que par une requête engendrant le même
- ensemble de colonnes (c'est-à-dire avec les mêmes noms de colonnes
- et les même types de données).
+ si une vue du même nom existe déjà, elle est remplacée. The new query must
+ generate the same columns that were generated by the existing view query
+ (that is, the same column names in the same order and with the same data
+ types), but it may add additional columns to the end of the list. The
+ calculations giving rise to the output columns may be completely different.
</para>
<para>
Modified: traduc/trunk/postgresql/ref/createdb.xml
===================================================================
--- traduc/trunk/postgresql/ref/createdb.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/createdb.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -106,6 +106,35 @@
</varlistentry>
<varlistentry>
+ <term><option>-l <replaceable class="parameter">locale</replaceable></></term>
+ <term><option>--locale <replaceable class="parameter">locale</replaceable></></term>
+ <listitem>
+ <para>
+ Specifies the locale to be used in this database. This is equivalent
+ to specifying both <option>--lc-collate</option> and <option>--lc-ctype</option>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lc-collate <replaceable class="parameter">locale</replaceable></></term>
+ <listitem>
+ <para>
+ Specifies the LC_COLLATE setting to be used in this database.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lc-ctype <replaceable class="parameter">locale</replaceable></></term>
+ <listitem>
+ <para>
+ Specifies the LC_CTYPE setting to be used in this database.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-E <replaceable class="parameter">locale</replaceable></option></term>
<term><option>--encoding <replaceable class="parameter">locale</replaceable></option></term>
<listitem>
@@ -141,7 +170,7 @@
</para>
<para>
- Les options <option>-D</option>, <option>-E</option>,
+ Les options <option>-D</option>, <option>-E</option>, <option>-l</option>,
<option>-O</option> et <option>-T</option> correspondent aux options de la
commande SQL sous-jacente
<xref linkend="sql-createdatabase" endterm="sql-createdatabase-title"/>,
@@ -187,6 +216,21 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
Modified: traduc/trunk/postgresql/ref/createlang.xml
===================================================================
--- traduc/trunk/postgresql/ref/createlang.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/createlang.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -140,6 +140,21 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
Modified: traduc/trunk/postgresql/ref/createuser.xml
===================================================================
--- traduc/trunk/postgresql/ref/createuser.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/createuser.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -296,6 +296,21 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
Modified: traduc/trunk/postgresql/ref/deallocate.xml
===================================================================
--- traduc/trunk/postgresql/ref/deallocate.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/deallocate.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-deallocate">
<refmeta>
<refentrytitle id="sql-deallocate-title">DEALLOCATE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/declare.xml
===================================================================
--- traduc/trunk/postgresql/ref/declare.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/declare.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-declare">
<refmeta>
<refentrytitle id="sql-declare-title">DECLARE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -174,9 +175,9 @@
jusqu'à la fin de l'instruction. <productname>PostgreSQL</productname>
rapporte donc une erreur si cette commande
est utilisée en dehors d'un bloc de transactions.
- On utilise <xref linkend="sql-begin" endterm="sql-begin-title"/>,
- <xref linkend="sql-commit" endterm="sql-commit-title"/> et
- <xref linkend="sql-rollback" endterm="sql-rollback-title"/> pour définir un bloc de transaction.
+ On utilise <xref linkend="sql-begin" endterm="sql-begin-title"/> et
+ <xref linkend="sql-commit" endterm="sql-commit-title"/> (ou
+ <xref linkend="sql-rollback" endterm="sql-rollback-title"/>) pour définir un bloc de transaction.
</para>
<para>
Si la clause <literal>WITH HOLD</literal> est précisée, et que la
@@ -214,6 +215,12 @@
</para>
<para>
+ Backward fetches are also disallowed when the query
+ includes <literal>FOR UPDATE</> or <literal>FOR SHARE</>; therefore
+ <literal>SCROLL</literal> may not be specified in this case.
+ </para>
+
+ <para>
Si la requête du curseur inclut les clauses <literal>FOR UPDATE</literal>
ou <literal>FOR SHARE</literal>, alors les lignes renvoyées sont verrouillées
au moment où elles sont récupérées, de la même façon qu'une commande
@@ -221,21 +228,41 @@
options.
De plus, les lignes renvoyées seront les versions les plus à jour ; du
coup, ces options fournissent l'équivalent de ce que le standard SQL appelle
- un <quote>curseur sensible</quote>. Il est souvent conseillé d'utiliser
- <literal>FOR UPDATE</literal> si le cuseur doit être utilisé avec
- <command>UPDATE ... WHERE CURRENT OF</command> ou <command>DELETE ... WHERE
- CURRENT OF</command>, car cela empêchera les autres sessions de modifier
- les lignes entre le moment où elles ont été récupérées et le moment où elles
- ont été mises à jour. Sans <literal>FOR UPDATE</literal>, une commande
- <literal>WHERE CURRENT OF</literal> n'aura aucun effet si la ligne a été
- modifiée entre temps.
+ un <quote>curseur sensible</quote>. (Specifying <literal>INSENSITIVE</>
+ together with <literal>FOR UPDATE</> or <literal>FOR SHARE</> is an error.)
</para>
- <para>
- <literal>SCROLL</literal> peut ne pas être indiqué quand la requête inclut
- <literal>FOR UPDATE</literal> ou <literal>FOR SHARE</literal>.
- </para>
+ <caution>
+ <para>
+ It is generally recommended to use <literal>FOR UPDATE</> if the cursor
+ is intended to be used with <command>UPDATE ... WHERE CURRENT OF</> or
+ <command>DELETE ... WHERE CURRENT OF</>. Using <literal>FOR UPDATE</>
+ prevents other sessions from changing the rows between the time they are
+ fetched and the time they are updated. Without <literal>FOR UPDATE</>,
+ a subsequent <literal>WHERE CURRENT OF</> command will have no effect if
+ the row was changed since the cursor was created.
+ </para>
+ <para>
+ Another reason to use <literal>FOR UPDATE</> is that without it, a
+ subsequent <literal>WHERE CURRENT OF</> might fail if the cursor query
+ does not meet the SQL standard's rules for being <quote>simply
+ updatable</> (in particular, the cursor must reference just one table
+ and not use grouping or <literal>ORDER BY</>). Cursors
+ that are not simply updatable might work, or might not, depending on plan
+ choice details; so in the worst case, an application might work in testing
+ and then fail in production.
+ </para>
+
+ <para>
+ The main reason not to use <literal>FOR UPDATE</> with <literal>WHERE
+ CURRENT OF</> is if you need the cursor to be scrollable, or to be
+ insensitive to the subsequent updates (that is, continue to show the old
+ data). If this is a requirement, pay close heed to the caveats shown
+ above.
+ </para>
+ </caution>
+
<para>
Le standard SQL ne mentionne les curseurs que pour le
<acronym>SQL</acronym> embarqué. <productname>PostgreSQL</productname>
Modified: traduc/trunk/postgresql/ref/delete.xml
===================================================================
--- traduc/trunk/postgresql/ref/delete.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/delete.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-delete">
<refmeta>
<refentrytitle id="sql-delete-title">DELETE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -20,7 +21,7 @@
<synopsis>DELETE FROM [ ONLY ] <replaceable class="parameter">table</replaceable> [ [ AS ] <replaceable class="parameter">alias</replaceable> ]
[ USING <replaceable class="parameter">liste_using</replaceable> ]
[ WHERE <replaceable class="parameter">condition</replaceable> | WHERE CURRENT OF <replaceable class="parameter">nom_curseur</replaceable> ]
- [ RETURNING * | <replaceable class="parameter">expression_sortie</replaceable> [ AS <replaceable class="parameter">output_name</replaceable> ] [, ...] ]
+ [ RETURNING * | <replaceable class="parameter">expression_sortie</replaceable> [ [ AS ] <replaceable class="parameter">output_name</replaceable> ] [, ...] ]
</synopsis>
</refsynopsisdiv>
@@ -148,10 +149,13 @@
<para>
Le nom du curseur à utiliser dans une condition <literal>WHERE CURRENT
OF</literal>. La ligne à supprimer est la dernière ligne récupérée avec
- ce curseur. Le curseur doit être une requête simple (pas de jointure, pas
- d'agrégat) sur la table cible du <command>DELETE</command>.
+ ce curseur. Le curseur doit être une requête sans regroupement
+ sur la table cible du <command>DELETE</command>.
Notez que <literal>WHERE CURRENT OF</literal> ne peut pas se voir ajouter
- de condition booléenne.
+ de condition booléenne. See
+ <xref linkend="sql-declare" endterm="sql-declare-title">
+ for more information about using cursors with
+ <literal>WHERE CURRENT OF</>.
</para>
</listitem>
</varlistentry>
Modified: traduc/trunk/postgresql/ref/discard.xml
===================================================================
--- traduc/trunk/postgresql/ref/discard.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/discard.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-discard">
<refmeta>
<refentrytitle id="sql-discard-title">DISCARD</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_aggregate.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_aggregate.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_aggregate.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropaggregate">
<refmeta>
<refentrytitle id="sql-dropaggregate-title">DROP AGGREGATE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_cast.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_cast.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_cast.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropcast">
<refmeta>
<refentrytitle id="sql-dropcast-title">DROP CAST</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_conversion.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_conversion.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_conversion.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropconversion">
<refmeta>
<refentrytitle id="sql-dropconversion-title">DROP CONVERSION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_database.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_database.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_database.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropdatabase">
<refmeta>
<refentrytitle id="sql-dropdatabase-title">DROP DATABASE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_domain.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_domain.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_domain.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropdomain">
<refmeta>
<refentrytitle id="sql-dropdomain-title">DROP DOMAIN</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Added: traduc/trunk/postgresql/ref/drop_foreign_data_wrapper.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_foreign_data_wrapper.xml (rev 0)
+++ traduc/trunk/postgresql/ref/drop_foreign_data_wrapper.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -0,0 +1,112 @@
+<!--
+$PostgreSQL: pgsql/doc/src/sgml/ref/drop_foreign_data_wrapper.sgml,v 1.1 2008-12-19 16:25:16 petere Exp $
+PostgreSQL documentation
+-->
+
+<refentry id="SQL-DROPFOREIGNDATAWRAPPER">
+ <refmeta>
+ <refentrytitle id="sql-dropforeigndatawrapper-title">DROP FOREIGN DATA WRAPPER</refentrytitle>
+ <refmiscinfo>SQL - Language Statements</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>DROP FOREIGN DATA WRAPPER</refname>
+ <refpurpose>remove a foreign-data wrapper</refpurpose>
+ </refnamediv>
+
+ <indexterm zone="sql-dropforeigndatawrapper">
+ <primary>DROP FOREIGN DATA WRAPPER</primary>
+ </indexterm>
+
+ <refsynopsisdiv>
+<synopsis>
+DROP FOREIGN DATA WRAPPER [ IF EXISTS ] <replaceable class="parameter">name</replaceable> [ CASCADE | RESTRICT ]
+</synopsis>
+ </refsynopsisdiv>
+
+ <refsect1>
+ <title>Description</title>
+
+ <para>
+ <command>DROP FOREIGN DATA WRAPPER</command> removes an existing
+ foreign-data wrapper. To execute this command, the current user
+ must be the owner of the foreign-data wrapper.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Parameters</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><literal>IF EXISTS</literal></term>
+ <listitem>
+ <para>
+ Do not throw an error if the foreign-data wrapper does not
+ exist. A notice is issued in this case.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">name</replaceable></term>
+ <listitem>
+ <para>
+ The name of an existing foreign-data wrapper.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>CASCADE</literal></term>
+ <listitem>
+ <para>
+ Automatically drop objects that depend on the foreign-data
+ wrapper (such as servers).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>RESTRICT</literal></term>
+ <listitem>
+ <para>
+ Refuse to drop the foreign-data wrappers if any objects depend
+ on it. This is the default.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>
+ Drop the foreign-data wrapper <literal>dbi</>:
+<programlisting>
+DROP FOREIGN DATA WRAPPER dbi;
+</programlisting>
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Compatibility</title>
+
+ <para>
+ <command>DROP FOREIGN DATA WRAPPER</command> conforms to ISO/IEC
+ 9075-9 (SQL/MED). The <literal>IF EXISTS</> clause is
+ a <productname>PostgreSQL</> extension.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-createforeigndatawrapper" endterm="sql-createforeigndatawrapper-title"></member>
+ <member><xref linkend="sql-alterforeigndatawrapper" endterm="sql-alterforeigndatawrapper-title"></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
Modified: traduc/trunk/postgresql/ref/drop_function.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_function.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_function.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropfunction">
<refmeta>
<refentrytitle id="sql-dropfunction-title">DROP FUNCTION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -65,13 +66,14 @@
<listitem>
<para>
- Le mode d'un argument : <literal>IN</literal>, <literal>OUT</literal> ou
- <literal>INOUT</literal>. Sans précision, la valeur par défaut est
+ Le mode d'un argument : <literal>IN</literal>, <literal>OUT</literal>,
+ <literal>INOUT</literal> ou <literal>VARIADIC</>. Sans précision, la valeur
+ par défaut est
<literal>IN</literal>. <command>DROP FUNCTION</command> ne s'intéresse pas
aux arguments <literal>OUT</literal> car seuls ceux
en entrée déterminent l'identité de la fonction.
- Il est ainsi suffisant de lister les arguments <literal>IN</literal> et
- <literal>INOUT</literal>.
+ Il est ainsi suffisant de lister les arguments <literal>IN</literal>,
+ <literal>INOUT</literal> et <literal>VARIADIC</>.
</para>
</listitem>
</varlistentry>
Modified: traduc/trunk/postgresql/ref/drop_group.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_group.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_group.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropgroup">
<refmeta>
<refentrytitle id="sql-dropgroup-title">DROP GROUP</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_index.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_index.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_index.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropindex">
<refmeta>
<refentrytitle id="sql-dropindex-title">DROP INDEX</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_language.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_language.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_language.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-droplanguage">
<refmeta>
<refentrytitle id="sql-droplanguage-title">DROP LANGUAGE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_opclass.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_opclass.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_opclass.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropopclass">
<refmeta>
<refentrytitle id="sql-dropopclass-title">DROP OPERATOR CLASS</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_operator.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_operator.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_operator.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropoperator">
<refmeta>
<refentrytitle id="sql-dropoperator-title">DROP OPERATOR</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_opfamily.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_opfamily.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_opfamily.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-dropopfamily">
<refmeta>
<refentrytitle id="sql-dropopfamily-title">DROP OPERATOR FAMILY</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_owned.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_owned.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_owned.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-drop-owned">
<refmeta>
<refentrytitle id="sql-drop-owned-title">DROP OWNED</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_role.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_role.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_role.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-droprole">
<refmeta>
<refentrytitle id="sql-droprole-title">DROP ROLE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_rule.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_rule.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_rule.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-droprule">
<refmeta>
<refentrytitle id="sql-droprule-title">DROP RULE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_schema.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_schema.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_schema.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropschema">
<refmeta>
<refentrytitle id="sql-dropschema-title">DROP SCHEMA</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_sequence.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_sequence.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_sequence.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropsequence">
<refmeta>
<refentrytitle id="sql-dropsequence-title">DROP SEQUENCE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Added: traduc/trunk/postgresql/ref/drop_server.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_server.xml (rev 0)
+++ traduc/trunk/postgresql/ref/drop_server.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -0,0 +1,112 @@
+<!--
+$PostgreSQL: pgsql/doc/src/sgml/ref/drop_server.sgml,v 1.1 2008-12-19 16:25:16 petere Exp $
+PostgreSQL documentation
+-->
+
+<refentry id="SQL-DROPSERVER">
+ <refmeta>
+ <refentrytitle id="sql-dropserver-title">DROP SERVER</refentrytitle>
+ <refmiscinfo>SQL - Language Statements</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>DROP SERVER</refname>
+ <refpurpose>remove a foreign server descriptor</refpurpose>
+ </refnamediv>
+
+ <indexterm zone="sql-dropserver">
+ <primary>DROP SERVER</primary>
+ </indexterm>
+
+ <refsynopsisdiv>
+<synopsis>
+DROP SERVER [ IF EXISTS ] <replaceable class="parameter">servername</replaceable> [ CASCADE | RESTRICT ]
+</synopsis>
+ </refsynopsisdiv>
+
+ <refsect1>
+ <title>Description</title>
+
+ <para>
+ <command>DROP SERVER</command> removes an existing foreign server
+ descriptor. To execute this command, the current user must be the
+ owner of the server.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Parameters</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><literal>IF EXISTS</literal></term>
+ <listitem>
+ <para>
+ Do not throw an error if the server does not exist. A notice is
+ issued in this case.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">servername</replaceable></term>
+ <listitem>
+ <para>
+ The name of an existing server.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>CASCADE</literal></term>
+ <listitem>
+ <para>
+ Automatically drop objects that depend on the server (such as
+ user mappings).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>RESTRICT</literal></term>
+ <listitem>
+ <para>
+ Refuse to drop the server if any objects depend on it. This is
+ the default.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>
+ Drop a server <literal>foo</> if it exists:
+<programlisting>
+DROP SERVER IF EXISTS foo;
+</programlisting>
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Compatibility</title>
+
+ <para>
+ <command>DROP SERVER</command> conforms to ISO/IEC 9075-9
+ (SQL/MED). The <literal>IF EXISTS</> clause is
+ a <productname>PostgreSQL</> extension.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-createserver" endterm="sql-createserver-title"></member>
+ <member><xref linkend="sql-alterserver" endterm="sql-alterserver-title"></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
Modified: traduc/trunk/postgresql/ref/drop_table.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_table.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_table.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-droptable">
<refmeta>
<refentrytitle id="sql-droptable-title">DROP TABLE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_tablespace.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_tablespace.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_tablespace.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-droptablespace">
<refmeta>
<refentrytitle id="sql-droptablespace-title">DROP TABLESPACE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_trigger.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_trigger.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_trigger.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-droptrigger">
<refmeta>
<refentrytitle id="sql-droptrigger-title">DROP TRIGGER</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_tsconfig.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_tsconfig.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_tsconfig.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-droptsconfig">
<refmeta>
<refentrytitle id="sql-droptsconfig-title">DROP TEXT SEARCH CONFIGURATION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_tsdictionary.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_tsdictionary.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_tsdictionary.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-droptsdictionary">
<refmeta>
<refentrytitle id="sql-droptsdictionary-title">DROP TEXT SEARCH DICTIONARY</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_tsparser.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_tsparser.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_tsparser.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-droptsparser">
<refmeta>
<refentrytitle id="sql-droptsparser-title">DROP TEXT SEARCH PARSER</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_tstemplate.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_tstemplate.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_tstemplate.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-droptstemplate">
<refmeta>
<refentrytitle id="sql-droptstemplate-title">DROP TEXT SEARCH TEMPLATE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_type.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_type.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_type.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-droptype">
<refmeta>
<refentrytitle id="sql-droptype-title">DROP TYPE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/drop_user.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_user.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_user.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropuser">
<refmeta>
<refentrytitle id="sql-dropuser-title">DROP USER</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Added: traduc/trunk/postgresql/ref/drop_user_mapping.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_user_mapping.xml (rev 0)
+++ traduc/trunk/postgresql/ref/drop_user_mapping.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -0,0 +1,110 @@
+<!--
+$PostgreSQL: pgsql/doc/src/sgml/ref/drop_user_mapping.sgml,v 1.2 2009-01-20 09:10:20 petere Exp $
+PostgreSQL documentation
+-->
+
+<refentry id="SQL-DROPUSERMAPPING">
+ <refmeta>
+ <refentrytitle id="sql-dropusermapping-title">DROP USER MAPPING</refentrytitle>
+ <refmiscinfo>SQL - Language Statements</refmiscinfo>
+ </refmeta>
+
+ <refnamediv>
+ <refname>DROP USER MAPPING</refname>
+ <refpurpose>remove a user mapping for a foreign server</refpurpose>
+ </refnamediv>
+
+ <indexterm zone="sql-dropusermapping">
+ <primary>DROP USER MAPPING</primary>
+ </indexterm>
+
+ <refsynopsisdiv>
+<synopsis>
+DROP USER MAPPING [ IF EXISTS ] FOR { <replaceable class="parameter">username</replaceable> | USER | CURRENT_USER | PUBLIC } SERVER <replaceable class="parameter">servername</replaceable>
+</synopsis>
+ </refsynopsisdiv>
+
+ <refsect1>
+ <title>Description</title>
+
+ <para>
+ <command>DROP USER MAPPING</command> removes an existing user
+ mapping from foreign server.
+ </para>
+
+ <para>
+ The owner of a foreign server can drop user mappings for that server
+ for any user. Also, a user can drop a user mapping for his own
+ user name if <literal>USAGE</> privilege on the server has been
+ granted to the user.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Parameters</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><literal>IF EXISTS</literal></term>
+ <listitem>
+ <para>
+ Do not throw an error if the user mapping does not exist. A
+ notice is issued in this case.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">username</replaceable></term>
+ <listitem>
+ <para>
+ User name of the mapping. <literal>CURRENT_USER</>
+ and <literal>USER</> match the name of the current
+ user. <literal>PUBLIC</> is used to match all present and
+ future user names in the system.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><replaceable class="parameter">servername</replaceable></term>
+ <listitem>
+ <para>
+ Server name of the user mapping.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
+ <title>Examples</title>
+
+ <para>
+ Drop a user mapping <literal>bob</>, server <literal>foo</> if it exists:
+<programlisting>
+DROP USER MAPPING IF EXISTS FOR bob SERVER foo;
+</programlisting>
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>Compatibility</title>
+
+ <para>
+ <command>DROP USER MAPPING</command> conforms to ISO/IEC 9075-9
+ (SQL/MED). The <literal>IF EXISTS</> clause is
+ a <productname>PostgreSQL</> extension.
+ </para>
+ </refsect1>
+
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member><xref linkend="sql-createusermapping" endterm="sql-createusermapping-title"></member>
+ <member><xref linkend="sql-alterusermapping" endterm="sql-alterusermapping-title"></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
Modified: traduc/trunk/postgresql/ref/drop_view.xml
===================================================================
--- traduc/trunk/postgresql/ref/drop_view.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/drop_view.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-dropview">
<refmeta>
<refentrytitle id="sql-dropview-title">DROP VIEW</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/dropdb.xml
===================================================================
--- traduc/trunk/postgresql/ref/dropdb.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/dropdb.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -131,6 +131,21 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
Modified: traduc/trunk/postgresql/ref/droplang.xml
===================================================================
--- traduc/trunk/postgresql/ref/droplang.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/droplang.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -149,6 +149,21 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
Modified: traduc/trunk/postgresql/ref/dropuser.xml
===================================================================
--- traduc/trunk/postgresql/ref/dropuser.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/dropuser.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -133,6 +133,21 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
Modified: traduc/trunk/postgresql/ref/end.xml
===================================================================
--- traduc/trunk/postgresql/ref/end.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/end.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-end">
<refmeta>
<refentrytitle id="sql-end-title">END</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/execute.xml
===================================================================
--- traduc/trunk/postgresql/ref/execute.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/execute.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-execute">
<refmeta>
<refentrytitle id="sql-execute-title">EXECUTE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/explain.xml
===================================================================
--- traduc/trunk/postgresql/ref/explain.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/explain.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-explain">
<refmeta>
<refentrytitle id="sql-explain-title">EXPLAIN</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -82,7 +83,8 @@
de l'instruction sont présents. Si <command>EXPLAIN ANALYZE</command>
doit être utilisé sur une instruction
<command>INSERT</command>, <command>UPDATE</command>,
- <command>DELETE</command> ou <command>EXECUTE</command> sans que la commande
+ <command>DELETE</command> <command>CREATE TABLE AS</command> ou
+ <command>EXECUTE</command> sans que la commande
n'affecte les données, l'approche suivante peut être envisagée :
<programlisting>BEGIN;
EXPLAIN ANALYZE ...;
@@ -109,11 +111,7 @@
<term><literal>VERBOSE</literal></term>
<listitem>
<para>
- Affiche la représentation interne complète du plan plutôt qu'un simple
- résumé. Cette option n'est réellement utile que lors de débogage.
- Le formatage
- de la sortie de <literal>VERBOSE</literal> peut être modifié à l'aide du
- paramètre de configuration <xref linkend="guc-explain-pretty-print"/>.
+ Include the output column list for each node in the plan tree.
</para>
</listitem>
</varlistentry>
@@ -124,7 +122,8 @@
<para>
Toute instruction <command>SELECT</command>, <command>INSERT</command>,
<command>UPDATE</command>, <command>DELETE</command>, <command>VALUES</command>
- <command>EXECUTE</command> ou <command>DECLARE</command> dont le plan
+ <command>EXECUTE</command>, <command>DECLARE</command> ou
+ <command>CREATE TABLE AS</command> dont le plan
d'exécution est souhaité.
</para>
</listitem>
Modified: traduc/trunk/postgresql/ref/fetch.xml
===================================================================
--- traduc/trunk/postgresql/ref/fetch.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/fetch.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-fetch">
<refmeta>
<refentrytitle id="sql-fetch-title">FETCH</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/grant.xml
===================================================================
--- traduc/trunk/postgresql/ref/grant.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/grant.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-grant">
<refmeta>
<refentrytitle id="sql-grant-title">GRANT</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -17,8 +18,13 @@
</refnamediv>
<refsynopsisdiv>
-<synopsis>GRANT { { SELECT | INSERT | UPDATE | DELETE | REFERENCES | TRIGGER }
+<synopsis>GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER }
[,...] | ALL [ PRIVILEGES ] }
+ ON [ TABLE ] <replaceable class="PARAMETER">nomtable</replaceable> [, ...]
+ TO { [ GROUP ] <replaceable class="PARAMETER">nomrole</replaceable> | PUBLIC } [, ...] [ WITH GRANT OPTION ]
+
+GRANT { { SELECT | INSERT | UPDATE | REFERENCES } ( <replaceable class="PARAMETER">colonne</replaceable> [, ...] )
+ [,...] | ALL [ PRIVILEGES ] ( <replaceable class="PARAMETER">colonne</replaceable> [, ...] ) }
ON [ TABLE ] <replaceable class="parameter">nomtable</replaceable> [, ...]
TO { [ GROUP ] <replaceable class="PARAMETER">nomrole</replaceable> | PUBLIC } [, ...] [ WITH GRANT OPTION ]
@@ -31,6 +37,14 @@
ON DATABASE <replaceable>nombase</replaceable> [, ...]
TO { [ GROUP ] <replaceable class="PARAMETER">nomrole</replaceable> | PUBLIC } [, ...] [ WITH GRANT OPTION ]
+GRANT { USAGE | ALL [ PRIVILEGES ] }
+ ON FOREIGN DATA WRAPPER <replaceable>fdwname</> [, ...]
+ TO { [ GROUP ] <replaceable class="PARAMETER">rolename</replaceable> | PUBLIC } [, ...] [ WITH GRANT OPTION ]
+
+GRANT { USAGE | ALL [ PRIVILEGES ] }
+ ON FOREIGN SERVER <replaceable>servername</> [, ...]
+ TO { [ GROUP ] <replaceable class="PARAMETER">rolename</replaceable> | PUBLIC } [, ...] [ WITH GRANT OPTION ]
+
GRANT { EXECUTE | ALL [ PRIVILEGES ] }
ON FUNCTION <replaceable>nomfonction</replaceable> ( [ [ <replaceable class="parameter">modearg</replaceable> ] [ <replaceable class="parameter">nomarg</replaceable> ] <replaceable class="parameter">typearg</replaceable> [, ...] ] ) [, ...]
TO { [ GROUP ] <replaceable class="PARAMETER">nomrole</replaceable> | PUBLIC } [, ...] [ WITH GRANT OPTION ]
@@ -60,7 +74,7 @@
<para>
La commande <command>GRANT</command> a deux variantes basiques : la première
donne des droits sur un objet de la base de données (table, vue,
- séquence, base de données, fonction, langage de procédure, schéma ou espace
+ séquence, base de données, foreign-data wrapper, foreign server, fonction, langage de procédure, schéma ou espace
logique), la seconde gère les appartenances à un rôle. Ces variantes sont
assez similaires mais somme toute assez différentes pour être
décrites séparément.
@@ -115,7 +129,7 @@
<para>
En fonction du type de l'objet, les privilèges initiaux par défaut peuvent inclure
la transmission de certains privilèges à <literal>PUBLIC</literal>. Par
- défaut, aucun accès public n'est accordé sur les tables, schémas et tablespaces ;
+ défaut, aucun accès public n'est accordé sur les tables, colonnes, schémas et tablespaces ;
le droit de création de table <literal>CONNECT</literal> et <literal>TEMP</literal>
est accordé sur les bases de données ;
le droit <literal>EXECUTE</literal> sur les fonctions ; et le droit
@@ -135,7 +149,7 @@
<listitem>
<para>
Autorise <xref linkend="sql-select" endterm="sql-select-title"/> sur
- toutes les colonnes de la table, vue ou séquence indiquée. Autorise
+ toutes les colonnes, or the specific columns listed, de la table, vue ou séquence indiquée. Autorise
aussi l'utilisation de <xref linkend="sql-copy" endterm="sql-copy-title"/>
TO.
Ce droit est aussi nécessaire pour référencer des valeurs de colonnes
@@ -152,8 +166,10 @@
<listitem>
<para>
Autorise <xref linkend="sql-insert" endterm="sql-insert-title"/> d'une
- nouvelle ligne dans la table indiquée. Autorise aussi
- <xref linkend="sql-copy" endterm="sql-copy-title"/> FROM.
+ nouvelle ligne dans la table indiquée. If specific columns are listed,
+ only those columns may be assigned to in the <command>INSERT</>
+ command (other columns will therefore receive default values). Autorise aussi
+ <xref linkend="sql-copy" endterm="sql-copy-title"/> FROM.
</para>
</listitem>
</varlistentry>
@@ -163,13 +179,13 @@
<listitem>
<para>
Autorise <xref linkend="sql-update" endterm="sql-update-title"/> sur toute
- colonne de la table spécifiée. (En fait, toute commande
+ colonne de la table spécifiée, or the specific columns listed. (En fait, toute commande
<command>UPDATE</command> non triviale nécessite aussi le droit
<literal>SELECT</literal> car elle doit référencer les colonnes pour
déterminer les lignes à mettre à jour et/ou calculer les nouvelles
valeurs des colonnes.) <literal>SELECT ... FOR UPDATE</literal>
et <literal>SELECT ... FOR SHARE</literal> requièrent également ce droit
- en plus du droit <literal>SELECT</literal>.
+ on at least one column en plus du droit <literal>SELECT</literal>.
Pour les séquences, ce droit autorise l'utilisation des fonctions
<function>nextval</function> et <function>setval</function>.
</para>
@@ -190,11 +206,23 @@
</varlistentry>
<varlistentry>
+ <term>TRUNCATE</term>
+ <listitem>
+ <para>
+ Allows <xref linkend="sql-truncate" endterm="sql-truncate-title"> on
+ the specified table.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term>REFERENCES</term>
<listitem>
<para>
- Ce privilège est requis sur la table de référence et la table qui référence pour
- créer une contrainte de clé étrangère.
+ Ce privilège est requis sur les colonnes de référence et les colonnes
+ qui référencent pour créer une contrainte de clé étrangère. The
+ privilege may be granted for all columns of a table, or just specific
+ columns.
</para>
</listitem>
</varlistentry>
@@ -287,6 +315,14 @@
Pour les séquences, ce droit autorise l'utilisation des fonctions
<function>currval</function> et <function>nextval</function>.
</para>
+ <para>
+ For foreign-data wrappers, this privilege enables the grantee
+ to create new servers using that foreign-data wrapper.
+ </para>
+ <para>
+ For servers, this privilege enables the grantee to query the
+ options of the server and associated user mappings.
+ </para>
</listitem>
</varlistentry>
@@ -345,6 +381,14 @@
</para>
<para>
+ A user may perform <command>SELECT</>, <command>INSERT</>, etc. on a
+ column if he holds that privilege for either the specific column or
+ its whole table. Granting the privilege at the table level and then
+ revoking it for one column will not do what you might wish: the
+ table-level grant is unaffected by a column-level operation.
+ </para>
+
+ <para>
Quand un utilisateur, non propriétaire d'un objet, essaie d'octroyer des
droits sur cet objet, la commande échoue si l'utilisateur
n'a aucun droit sur l'objet. Tant que des privilèges existent, la commande
@@ -405,23 +449,19 @@
</para>
<para>
- Actuellement, <productname>PostgreSQL</productname> ne permet pas
- d'attribuer ou de révoquer des droits sur les colonnes individuelles d'une
- table. Une manière de mimer ce comportement consiste à créer une vue composée des
- colonnes désirées et d'attribuer les droits sur cette vue.
- </para>
-
- <para>
- La commande <command>\z</command> de <xref linkend="app-psql"/> permet
- d'obtenir des informations sur les droits existants, par exemple :
+ La commande <command>\dp</command> de <xref linkend="app-psql"/> permet
+ d'obtenir des informations sur les droits existants for tables and
+ columns, par exemple :
<programlisting>=> \z matable
- Access privileges for database "lusitania"
- Schema | Name | Type | Access privileges
---------+---------+-------+-----------------------------------------------------------
- public | matable | table | {miriam=arwdxt/miriam,=r/miriam,"group todos=arw/miriam"}
+ Access privileges
+ Schema | Name | Type | Access privileges | Column access privileges
+--------+---------+-------+-----------------------+--------------------------
+ public | mytable | table | miriam=arwdDxt/miriam | col1:
+ : =r/miriam : miriam_rw=rw/miriam
+ : admin=arw/miriam
(1 row)
</programlisting>
- Les entrées affichées par <command>\z</command> sont interprétées
+ Les entrées affichées par <command>\dp</command> sont interprétées
ainsi :
<programlisting> rolename=xxxx -- privileges granted to a role
=xxxx -- privileges granted to PUBLIC
@@ -431,6 +471,7 @@
w -- UPDATE ("écriture")
a -- INSERT ("ajout")
d -- DELETE
+ D -- TRUNCATE
x -- REFERENCES
t -- TRIGGER
X -- EXECUTE
@@ -438,7 +479,7 @@
C -- CREATE
c -- CONNECT
T -- TEMPORARY
- arwdxt -- ALL PRIVILEGES (pour les tables)
+ arwdDxt -- ALL PRIVILEGES (pour les tables, varies for other objects)
* -- option de transmission du privilège qui précède
/yyyy -- role qui a donné le droit
@@ -450,10 +491,16 @@
<programlisting>GRANT SELECT ON matable TO PUBLIC;
GRANT SELECT, UPDATE, INSERT ON matable TO admin;
+GRANT SELECT (col1), UPDATE (col1) ON mytable TO miriam_rw;
</programlisting>
</para>
<para>
+ For non-table objects there are other <command>\d</> commands
+ that can display their privileges.
+ </para>
+
+ <para>
Si la colonne <quote>Access privileges</quote> est vide pour un objet donné, cela
signifie que l'objet possède les droits par défaut (c'est-à-dire que la
colonne des droits est NULL). Les droits par défaut incluent toujours les
@@ -461,8 +508,9 @@
<literal>PUBLIC</literal> en fonction du type d'objet comme cela est expliqué plus haut. Le
premier <command>GRANT</command> ou <command>REVOKE</command> sur un objet instancie les
droits par défaut (produisant, par exemple,
- <literal>{=,miriam=arwdxt/miriam}</literal>) puis les modifie en fonction de la requête
- spécifiée.
+ <literal>{=,miriam=arwdDxt/miriam}</literal>) puis les modifie en fonction de la requête
+ spécifiée. Entries are shown in <quote>Column access
+ privileges</> only for columns with nondefault privileges.
</para>
<para>
@@ -517,7 +565,8 @@
<productname>PostgreSQL</productname> autorise un propriétaire d'objet
à révoquer ses propres droits ordinaires : par exemple, le
propriétaire d'un objet peut le placer en lecture seule pour lui-même en
- révoquant ses propres droits INSERT, UPDATE et DELETE. Le standard SQL
+ révoquant ses propres droits <literal>INSERT</>,
+ <literal>UPDATE</>, <literal>DELETE</>, and <literal>TRUNCATE</>. Le standard SQL
ne l'autorise pas. La raison en est que
<productname>PostgreSQL</productname> traite les droits du propriétaire
comme ayant été donnés par le propriétaire ; il peut, de ce fait, aussi les
@@ -527,12 +576,6 @@
</para>
<para>
- <productname>PostgreSQL</productname> ne dispose pas de la fonctionnalité
- du standard SQL qui autorise l'ajout de droits pour certaines colonnes
- spécifiques d'une table.
- </para>
-
- <para>
Le standard SQL fournit un droit <literal>USAGE</literal> sur d'autres
types d'objet : jeux de caractères, collations, conversions,
domaines.
Modified: traduc/trunk/postgresql/ref/initdb.xml
===================================================================
--- traduc/trunk/postgresql/ref/initdb.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/initdb.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -94,30 +94,37 @@
</para>
<para>
- <command>initdb</command> initialise la locale et l'encodage par défaut
- du cluster. L'ordre de tri
- (<literal>LC_COLLATE</literal>) et les classes de jeux de caractères
- (<literal>LC_CTYPE</literal>, c'est-à-dire majuscule (<foreignphrase>upper</foreignphrase>),
- minuscule (<foreignphrase>lower</foreignphrase>), chiffre (<foreignphrase>digit</foreignphrase>))
- sont fixées pour l'ensemble des bases de données et ne peuvent
- pas être modifiées. Les ordres de tri autres que <literal>C</literal> ou
- <literal>POSIX</literal> sont également moins performants. Pour ces
- raisons, il est important de choisir la bonne locale lors de l'exécution
- d'<command>initdb</command>. Les catégories de locale restantes peuvent
- être modifiées par la suite, serveur démarré. Toutes les valeurs
- de locales du serveur (<literal>lc_*</literal>) peuvent être affichées
- à l'aide de l'instruction <command>SHOW ALL</command>.
- Plus de détails sont disponibles dans <xref linkend="locale"/>.
+ <command>initdb</command> initializes the database cluster's default
+ locale and character set encoding. The character set encoding,
+ collation order (<literal>LC_COLLATE</>) and character set classes
+ (<literal>LC_CTYPE</>, e.g. upper, lower, digit) can be set separately
+ for a database when it is created. <command>initdb</command> determines
+ those settings for the <literal>template1</literal> database, which will
+ serve as the default for all other databases.
</para>
<para>
- L'encodage d'une base de données peut être configuré à sa création.
- <command>initdb</command> détermine l'encodage de la base de données
- <literal>template1</literal>, qui sert de modèle par défaut pour les autres bases de données.
- Cet encodage par défaut peut être modifié avec l'option <option>--encoding</option>.
- De plus amples détails sont présentés dans <xref linkend="multibyte"/>.
+ To alter the default collation order or character set classes, use the
+ <option>--lc-collate</option> and <option>--lc-ctype</option> options.
+ Collation orders other than <literal>C</> or <literal>POSIX</> also have
+ a performance penalty. For these reasons it is important to choose the
+ right locale when running <command>initdb</command>.
</para>
+ <para>
+ The remaining locale categories can be changed later when the server
+ is started. You can also use <option>--locale</option> to set the
+ default for all locale categories, including collation order and
+ character set classes. All server locale values (<literal>lc_*</>) can
+ be displayed via <command>SHOW ALL</>.
+ More details can be found in <xref linkend="locale">.
+ </para>
+
+ <para>
+ To alter the default encoding, use the <option>--encoding</option>.
+ More details can be found in <xref linkend="multibyte">.
+ </para>
+
</refsect1>
<refsect1>
Modified: traduc/trunk/postgresql/ref/insert.xml
===================================================================
--- traduc/trunk/postgresql/ref/insert.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/insert.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-insert">
<refmeta>
<refentrytitle id="sql-insert-title">INSERT</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -20,7 +21,7 @@
<synopsis>INSERT INTO <replaceable class="parameter">table</replaceable> [ ( <replaceable
class="parameter">colonne</replaceable> [, ...] ) ]
{ DEFAULT VALUES | VALUES ( { <replaceable class="parameter">expression</replaceable> | DEFAULT } [, ...] ) [, ...] | <replaceable class="parameter">requête</replaceable> }
- [ RETURNING * | <replaceable class="parameter">expression_sortie</replaceable> [ AS <replaceable class="parameter">nom_sortie</replaceable> ] [, ...] ]
+ [ RETURNING * | <replaceable class="parameter">expression_sortie</replaceable> [ [ AS ] <replaceable class="parameter">nom_sortie</replaceable> ] [, ...] ]
</synopsis>
</refsynopsisdiv>
@@ -71,10 +72,12 @@
<para>
Le droit <literal>INSERT</literal> sur une table est requis pour
- pouvoir y insérer des lignes et le droit <literal>SELECT</literal> est
- requis pour utiliser <literal>RETURNING</literal>. Si la clause <replaceable
+ pouvoir y insérer des lignes. If a column list is specified, you only
+ need <literal>INSERT</literal> privilege on the listed columns.
+ Use of the <literal>RETURNING</> clause requires <literal>SELECT</>
+ privilege on all columns mentioned in <literal>RETURNING</>. Si la clause <replaceable
class="parameter">requête</replaceable> est utilisée pour insérer des
- lignes, le droit <literal>SELECT</literal> sur toute table
+ lignes, le droit <literal>SELECT</literal> sur toute table ou colonne
utilisée dans la requête est également requis.
</para>
</refsect1>
Modified: traduc/trunk/postgresql/ref/listen.xml
===================================================================
--- traduc/trunk/postgresql/ref/listen.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/listen.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-listen">
<refmeta>
<refentrytitle id="sql-listen-title">LISTEN</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/load.xml
===================================================================
--- traduc/trunk/postgresql/ref/load.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/load.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-load">
<refmeta>
<refentrytitle id="sql-load-title">LOAD</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/lock.xml
===================================================================
--- traduc/trunk/postgresql/ref/lock.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/lock.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-lock">
<refmeta>
<refentrytitle id="sql-lock-title">LOCK</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -17,7 +18,7 @@
</refnamediv>
<refsynopsisdiv>
-<synopsis>LOCK [ TABLE ] <replaceable class="parameter">nom</replaceable> [, ...] [ IN <replaceable class="parameter">mode_verrou</replaceable> MODE ] [ NOWAIT ]
+<synopsis>LOCK [ TABLE ] [ ONLY ] <replaceable class="parameter">nom</replaceable> [, ...] [ IN <replaceable class="parameter">mode_verrou</replaceable> MODE ] [ NOWAIT ]
où <replaceable class="parameter">mode_verrou</replaceable> peut être :
@@ -112,7 +113,9 @@
<listitem>
<para>
Le nom d'une table à verrouiller (éventuellement qualifié du nom du
- schéma).
+ schéma). If <literal>ONLY</> is specified, only that table is
+ locked. If <literal>ONLY</> is not specified, the table and all
+ its descendant tables (if any) are locked.
</para>
<para>
@@ -157,16 +160,20 @@
<para>
<literal>LOCK TABLE ... IN ACCESS SHARE MODE</literal> requiert les droits
<literal>SELECT</literal> sur la table cible. Toutes les autres formes de
- <command>LOCK</command> requièrent les droits <literal>UPDATE</literal> et/ou
- <literal>DELETE</literal>.
+ <command>LOCK</command> requièrent au moins un des droits
+ <literal>UPDATE</literal>, <literal>DELETE</literal> et <literal>TRUNCATE</>.
</para>
<para>
- <command>LOCK TABLE</command> n'est utile qu'à l'intérieur d'un bloc
- transactionnel (paire <command>BEGIN</command>/<command>COMMIT</command>),
- puisque le verrou est supprimé dès que la transaction se termine. Une commande
- <command>LOCK</command> à l'extérieur de tout bloc transactionnel constitue
- une transaction auto-contenue. Le verrou est alors supprimé aussitôt obtenu.
+ <command>LOCK TABLE</> is useless outside a transaction block: the lock
+ would remain held only to the completion of the statement. Therefore
+ <productname>PostgreSQL</productname> reports an error if <command>LOCK</>
+ is used outside a transaction block.
+ Use
+ <xref linkend="sql-begin" endterm="sql-begin-title"> and
+ <xref linkend="sql-commit" endterm="sql-commit-title">
+ (or <xref linkend="sql-rollback" endterm="sql-rollback-title">)
+ to define a transaction block.
</para>
<para>
Modified: traduc/trunk/postgresql/ref/move.xml
===================================================================
--- traduc/trunk/postgresql/ref/move.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/move.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-move">
<refmeta>
<refentrytitle id="sql-move-title">MOVE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/notify.xml
===================================================================
--- traduc/trunk/postgresql/ref/notify.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/notify.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-notify">
<refmeta>
<refentrytitle id="sql-notify-title">NOTIFY</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/pg_config-ref.xml
===================================================================
--- traduc/trunk/postgresql/ref/pg_config-ref.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/pg_config-ref.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -63,14 +63,21 @@
<term><option>--docdir</option></term>
<listitem>
<para>
- Afficher l'emplacement des fichiers de documentation (c'est une chaîne
- vide si <literal>--without-docdir</literal> a été spécifié lors de la
- construction de <productname>PostgreSQL</productname>).
+ Afficher l'emplacement des fichiers de documentation.
</para>
</listitem>
</varlistentry>
<varlistentry>
+ <term><option>--htmldir</option></>
+ <listitem>
+ <para>
+ Print the location of HTML documentation files.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>--includedir</option></term>
<listitem>
<para>
@@ -302,6 +309,7 @@
<option>--ldflags</option>, <option>--ldflags_sl</option>
et <option>--libs</option> sont apparues avec <productname>PostgreSQL</productname>
8.1.
+ The option <option>--htmldir</option> is new in <productname>PostgreSQL</> 8.4.
</para>
<para>
Modified: traduc/trunk/postgresql/ref/pg_controldata.xml
===================================================================
--- traduc/trunk/postgresql/ref/pg_controldata.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/pg_controldata.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -33,8 +33,8 @@
<para>
<command>pg_controldata</command> affiche les informations initialisées lors
- d'<command>initdb</command>, telles que la version du catalogue et la locale du
- serveur. Il affiche aussi des informations sur le traitement des WAL et des
+ d'<command>initdb</command>, telles que la version du catalogue.
+ Il affiche aussi des informations sur le traitement des WAL et des
points de vérification. Cette information, qui porte sur le groupe complet,
n'est pas spécifique à une base de données.
</para>
Modified: traduc/trunk/postgresql/ref/pg_ctl-ref.xml
===================================================================
--- traduc/trunk/postgresql/ref/pg_ctl-ref.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/pg_ctl-ref.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -129,9 +129,11 @@
Dans le mode <option>stop</option>, le serveur en cours d'exécution dans le
répertoire spécifié est arrêté. Trois méthodes différentes d'arrêt peuvent
être choisies avec l'option <option>-m</option> : le mode
- <quote>Smart</quote> attend la déconnexion de tous les clients. C'est la
- valeur par défaut. Le mode <quote>Fast</quote> n'attend pas la déconnexion
- des clients. Toutes les transactions actives sont annulées et les clients
+ <quote>Smart</quote> attend du mode de sauvegarde en ligne (PITR) et la
+ déconnexion de tous les clients. C'est la valeur par défaut. Le mode
+ <quote>Fast</quote> n'attend pas la déconnexion des clients et stoppera le
+ mode de sauvegarde en ligne (PITR). Toutes les transactions actives sont
+ annulées et les clients
sont contraints de se déconnecter. Le serveur est ensuite arrêté. Le mode
<quote>Immediate</quote> tue tous les processus serveurs sans leur laisser
la possibilité de faire un arrêt propre.
@@ -405,23 +407,6 @@
</varlistentry>
<varlistentry>
- <term><filename>postmaster.opts.default</filename></term>
-
- <listitem>
- <para>
- Si ce fichier existe dans le répertoire des données,
- <application>pg_ctl</application> (dans le mode <option>start</option>)
- passe le contenu du fichier comme options de la commande
- <command>postgres</command>, sauf en cas de surcharge par l'option
- <option>-o</option>.
- <!-- Je n'ai pas cette phrase dans la VO...
- Le contenu de ce fichier est aussi affiché en mode <option>status</option>
- -->
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
<term><filename>postmaster.opts</filename></term>
<listitem>
Modified: traduc/trunk/postgresql/ref/pg_dump.xml
===================================================================
--- traduc/trunk/postgresql/ref/pg_dump.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/pg_dump.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -174,26 +174,6 @@
</varlistentry>
<varlistentry>
- <term><option>-d</option></term>
- <term><option>--inserts</option></term>
- <listitem>
- <para>
- Les données sont copiées à l'aide de commandes <command>INSERT</command>
- plutôt que <command>COPY</command>. La restauration en est considérablement
- ralentie. Cela s'avère essentiellement utile pour créer des sauvegardes
- rechargées dans des bases de données autres que
- <productname>PostgreSQL</productname>.
- De plus, comme cette option produit une commande séparée pour chaque
- ligne, une erreur lors du chargement d'une ligne ne perd que
- cette ligne plutôt que le contenu entier de la table.
- La restauration échoue également si les colonnes ont été réorganisées.
- L'option <option>-D</option> permet de s'affranchir des modifications
- de l'ordre des colonnes, mais est encore plus lente.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
<term><option>-D</option></term>
<term><option>--column-inserts</option></term>
<term><option>--attribute-inserts</option></term>
@@ -291,21 +271,8 @@
<term><option>--ignore-version</option></term>
<listitem>
<para>
- Les différences de version entre
- <application>pg_dump</application> et le serveur de bases de données sont ignorées.
+ A deprecated option that is now ignored.
</para>
-
- <para>
- <application>pg_dump</application> peut créer des sauvegardes de bases
- de données de versions différentes, mais les très anciennes versions ne
- sont plus supportées (actuellement celles antérieures à la 7.0).
- Sauvegarder à partir d'une version de serveur plus récente que celle de
- <application>pg_dump</application> a toutes les chances de ne pas
- fonctionner du tout.
- Cette option est utilisée lorsque la vérification de version ne doit pas
- être effectuée. Dans ce cas, il se peut que
- <application>pg_dump</application> échoue.
- </para>
</listitem>
</varlistentry>
@@ -550,77 +517,157 @@
</varlistentry>
<varlistentry>
- <term><option>--disable-dollar-quoting</option></term>
+ <term><option>-Z <replaceable class="parameter">0..9</replaceable></option></term>
+ <term><option>--compress=<replaceable class="parameter">0..9</replaceable></option></term>
<listitem>
<para>
- Cette option désactive l'utilisation des guillemets dollar pour le
- corps des fonctions. La syntaxe SQL standard des chaînes est utilisée pour
- la mise entre guillemets du corps des fonctions.
+ Indique le niveau de compression à utiliser. Zéro signifie sans
+ compression. Pour le format d'archive personnalisé, cela signifie la
+ compression des segments individuels des données des tables. Par
+ défaut, la compression se fait à un niveau modéré. Pour le format texte,
+ indiquer une valeur différente de zéro implique une compression du
+ fichier complet, comme s'il était passé à
+ <application>gzip</application> ; mais par défaut, la sortie n'est
+ pas compressée. Le format d'archive tar ne supporte pas du tout la
+ compression.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><option>--disable-triggers</option></term>
+ <term><option>--binary-upgrade</option></term>
<listitem>
<para>
- Cette option n'a d'intérêt que dans le cas de sauvegarde des données seules.
- Dans ce cas, <application>pg_dump</application> inclut à la sortie des
- commandes permettant de désactiver temporairement les déclencheurs sur les tables
- cibles lors du chargement des données.
- Cette commande est utilisée lorsqu'il existe sur les tables des vérifications d'intégrité
- référentielles ou des déclencheurs dont l'exécution n'est pas souhaitable
- lors du chargement des données.
+ This option is for use by in-place upgrade utilities. Its use
+ for other purposes is not recommended or supported. The
+ behavior of the option may change in future releases without
+ notice.
</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--inserts</option></term>
+ <listitem>
<para>
- À l'heure actuelle, les commandes engendrées par <option>--disable-triggers</option>
- doivent être exécutées par le superutilisateur. Il est donc nécessaire que le nom
- du superutilisateur soit également précisé, à l'aide de
- <option>-S</option>, ou que le script résultant soit lancé par le
- superutilisateur (c'est d'ailleurs préférable).
+ Dump data as <command>INSERT</command> commands (rather
+ than <command>COPY</command>). This will make restoration very slow;
+ it is mainly useful for making dumps that can be loaded into
+ non-<productname>PostgreSQL</productname> databases.
+ Also, since this option generates a separate command for each row,
+ an error in reloading a row causes only that row to be lost rather
+ than the entire table contents.
+ Note that
+ the restore might fail altogether if you have rearranged column order.
+ The <option>--column-inserts</option> option is safe against column
+ order changes, though even slower.
</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--column-inserts</option></term>
+ <term><option>--attribute-inserts</option></term>
+ <listitem>
<para>
- Cette option n'a d'intérêt que pour le format texte. Pour les
- formats archive, l'option est précisée à l'appel de <command>pg_restore</command>.
+ Dump data as <command>INSERT</command> commands with explicit
+ column names (<literal>INSERT INTO
+ <replaceable>table</replaceable>
+ (<replaceable>column</replaceable>, ...) VALUES
+ ...</literal>). This will make restoration very slow; it is mainly
+ useful for making dumps that can be loaded into
+ non-<productname>PostgreSQL</productname> databases.
+ Also, since this option generates a separate command for each row,
+ an error in reloading a row causes only that row to be lost rather
+ than the entire table contents.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><option>--use-set-session-authorization</option></term>
+ <term><option>--disable-dollar-quoting</></term>
<listitem>
<para>
- Les commandes <command>SET SESSION AUTHORIZATION</command> du standard
- SQL sont affichées à la place des commandes <command>ALTER OWNER</command> pour
- préciser le propriétaire d'un objet. Cela rend la sauvegarde plus compatible
- avec le standard mais, en fonction de l'historique des objets dans la sauvegarde,
- il se peut que la restauration soit incorrecte. De plus, une sauvegarde qui utilise
- <command>SET SESSION AUTHORIZATION</command> nécessite pour la restauration des droits
- superutilisateur tandis que <command>ALTER OWNER</command> requiert des privilèges
- moins étendus.
+ This option disables the use of dollar quoting for function bodies,
+ and forces them to be quoted using SQL standard string syntax.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><option>-Z <replaceable class="parameter">0..9</replaceable></option></term>
- <term><option>--compress=<replaceable class="parameter">0..9</replaceable></option></term>
+ <term><option>--disable-triggers</></term>
<listitem>
<para>
- Indique le niveau de compression à utiliser. Zéro signifie sans
- compression. Pour le format d'archive personnalisé, cela signifie la
- compression des segments individuels des données des tables. Par
- défaut, la compression se fait à un niveau modéré. Pour le format texte,
- indiquer une valeur différente de zéro implique une compression du
- fichier complet, comme s'il était passé à
- <application>gzip</application> ; mais par défaut, la sortie n'est
- pas compressée. Le format d'archive tar ne supporte pas du tout la
- compression.
+ This option is only relevant when creating a data-only dump.
+ It instructs <application>pg_dump</application> to include commands
+ to temporarily disable triggers on the target tables while
+ the data is reloaded. Use this if you have referential
+ integrity checks or other triggers on the tables that you
+ do not want to invoke during data reload.
</para>
+
+ <para>
+ Presently, the commands emitted for <option>--disable-triggers</>
+ must be done as superuser. So, you should also specify
+ a superuser name with <option>-S</>, or preferably be careful to
+ start the resulting script as a superuser.
+ </para>
+
+ <para>
+ This option is only meaningful for the plain-text format. For
+ the archive formats, you can specify the option when you
+ call <command>pg_restore</command>.
+ </para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><option>--lock-wait-timeout=<replaceable class="parameter">timeout</replaceable></option></term>
+ <listitem>
+ <para>
+ Do not wait forever to acquire shared table locks at the beginning of
+ the dump. Instead fail if unable to lock a table within the specified
+ <replaceable class="parameter">timeout</>. The timeout may be
+ specified in any of the formats accepted by <command>SET
+ statement_timeout</>. (Allowed values vary depending on the server
+ version you are dumping from, but an integer number of milliseconds
+ is accepted by all versions since 7.3. This option is ignored when
+ dumping from a pre-7.3 server.)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--no-tablespaces</option></term>
+ <listitem>
+ <para>
+ Do not output commands to select tablespaces.
+ With this option, all objects will be created in whichever
+ tablespace is the default during restore.
+ </para>
+
+ <para>
+ This option is only meaningful for the plain-text format. For
+ the archive formats, you can specify the option when you
+ call <command>pg_restore</command>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--use-set-session-authorization</></term>
+ <listitem>
+ <para>
+ Output SQL-standard <command>SET SESSION AUTHORIZATION</> commands
+ instead of <command>ALTER OWNER</> commands to determine object
+ ownership. This makes the dump more standards compatible, but
+ depending on the history of the objects in the dump, might not restore
+ properly. Also, a dump using <command>SET SESSION AUTHORIZATION</>
+ will certainly require superuser privileges to restore correctly,
+ whereas <command>ALTER OWNER</> requires lesser privileges.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
@@ -668,6 +715,21 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
@@ -687,6 +749,23 @@
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><option>--role=<replaceable class="parameter">rolename</replaceable></option></term>
+ <listitem>
+ <para>
+ Specifies a role name to be used to create the dump.
+ This option causes <application>pg_dump</> to issue a
+ <command>SET ROLE</> <replaceable class="parameter">rolename</>
+ command after connecting to the database. It is useful when the
+ authenticated user (specified by <option>-U</>) lacks privileges
+ needed by <application>pg_dump</>, but can switch to a role with
+ the required rights. Some installations have a policy against
+ logging in directly as a superuser, and use of this option allows
+ dumps to be made without violating the policy.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
</refsect1>
@@ -698,6 +777,7 @@
<varlistentry>
<term><envar>PGDATABASE</envar></term>
<term><envar>PGHOST</envar></term>
+ <term><envar>PGOPTIONS</envar></term>
<term><envar>PGPORT</envar></term>
<term><envar>PGUSER</envar></term>
@@ -729,6 +809,14 @@
tout paramètre de connexion par défaut et toute variable d'environnement
utilisé par la bibliothèque <application>libpq</application> s'appliquent.
</para>
+
+ <para>
+ The database activity of <application>pg_dump</application> is
+ normally collected by the statistics collector. If this is
+ undesirable, you can set parameter <literal>track_counts</literal>
+ to false via <envar>PGOPTIONS</envar> or the <literal>ALTER
+ USER</literal> command.
+ </para>
</refsect1>
@@ -749,12 +837,11 @@
</para>
<para>
- <application>pg_dump</application> a une limitation ; quand une
- sauvegarde des seules données est sélectionnée et que l'option
+ Quand une sauvegarde des seules données est sélectionnée et que l'option
<option>--disable-triggers</option> est utilisée,
<application>pg_dump</application> engendre des commandes de désactivation
- des déclencheurs sur les tables utilisateur avant l'insertion des données et
- des commandes de réactivation après l'insertion. Si la restauration est
+ des déclencheurs sur les tables utilisateur avant l'insertion des données, puis
+ après coup, des commandes de réactivation après l'insertion. Si la restauration est
interrompue, il se peut que les catalogues systèmes conservent cette
position.
</para>
@@ -780,15 +867,21 @@
</para>
<para>
- <application>pg_dump</application> est utilisé pour transférer des
- données vers les nouvelles versions de <productname>PostgreSQL</productname>.
- De ce fait, le résultat de <application>pg_dump</application> peut être chargé dans des
- bases de données <productname>PostgreSQL</productname> de versions supérieures.
- Cet outil sait également lire les données sur des serveurs <productname>PostgreSQL</productname>
- plus anciens. Néanmoins, <application>pg_dump</application> ne peut généralement
- pas lire des bases de données plus récentes ou produire une
- sauvegarde qui puisse être chargée par des versions antérieures. Pour cela, une
- édition manuelle de la sauvegarde peut s'avérer nécessaire.
+ Because <application>pg_dump</application> is used to transfer data
+ to newer versions of <productname>PostgreSQL</>, the output of
+ <application>pg_dump</application> can be expected to load into
+ <productname>PostgreSQL</> server versions newer than
+ <application>pg_dump</>'s version. <application>pg_dump</> can also
+ dump from <productname>PostgreSQL</> servers older than its own version.
+ (Currently, servers back to version 7.0 are supported.)
+ However, <application>pg_dump</> cannot dump from
+ <productname>PostgreSQL</> servers newer than its own major version;
+ it will refuse to even try, rather than risk making an invalid dump.
+ Also, it is not guaranteed that <application>pg_dump</>'s output can
+ be loaded into a server of an older major version — not even if the
+ dump was taken from a server of that version. Loading a dump file
+ into an older server may require manual editing of the dump file
+ to remove syntax not understood by the older server.
</para>
</refsect1>
Modified: traduc/trunk/postgresql/ref/pg_dumpall.xml
===================================================================
--- traduc/trunk/postgresql/ref/pg_dumpall.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/pg_dumpall.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -43,7 +43,7 @@
globaux, communs à toutes les bases de données.
(<application>pg_dump</application> ne sauvegarde pas ces objets.) Cela
inclut aussi les informations concernant les utilisateurs et groupes des
- bases de données ainsi que les droits d'accès s'y appliquant.
+ bases de données, ainsi que les tablespaces, and properties such as les droits d'accès s'y appliquant.
</para>
<para>
@@ -103,22 +103,6 @@
</varlistentry>
<varlistentry>
- <term><option>-d</option></term>
- <term><option>--inserts</option></term>
- <listitem>
- <para>
- Les données sont sauvegardées sous la forme de commandes
- <command>INSERT</command> (plutôt que des <command>COPY</command>).
- Cela ralentit la restauration ; c'est principalement utile pour créer des
- sauvegardes qui peuvent être chargées dans des bases de données autres
- que <productname>PostgreSQL</productname>. La restauration
- peut toutefois échouer si l'ordre des colonnes a été modifié.
- L'option <option>-D</option> est plus sûre, bien que plus lente.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
<term><option>-D</option></term>
<term><option>--column-inserts</option></term>
<term><option>--attribute-inserts</option></term>
@@ -162,9 +146,7 @@
<term><option>--ignore-version</option></term>
<listitem>
<para>
- Toute différence de version entre
- <application>pg_dumpall</application> et le serveur de bases de données
- est ignorée.
+ A deprecated option that is now ignored.
</para>
<para>
@@ -212,6 +194,34 @@
</varlistentry>
<varlistentry>
+ <term><option>--lock-wait-timeout=<replaceable class="parameter">timeout</replaceable></option></term>
+ <listitem>
+ <para>
+ Do not wait forever to acquire shared table locks at the beginning of
+ the dump. Instead fail if unable to lock a table within the specified
+ <replaceable class="parameter">timeout</>. The timeout may be
+ specified in any of the formats accepted by <command>SET
+ statement_timeout</>. (Allowed values vary depending on the server
+ version you are dumping from, but an integer number of milliseconds
+ is accepted by all versions since 7.3. This option is ignored when
+ dumping from a pre-7.3 server.)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--no-tablespaces</option></term>
+ <listitem>
+ <para>
+ Do not output commands to create tablespaces nor select tablespaces
+ for objects.
+ With this option, all objects will be created in whichever
+ tablespace is the default during restore.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-r</option></term>
<term><option>--roles-only</option></term>
<listitem>
@@ -281,6 +291,49 @@
</varlistentry>
<varlistentry>
+ <term><option>--binary-upgrade</option></term>
+ <listitem>
+ <para>
+ This option is for use by in-place upgrade utilities. Its use
+ for other purposes is not recommended or supported. The
+ behavior of the option may change in future releases without
+ notice.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--inserts</option></term>
+ <listitem>
+ <para>
+ Dump data as <command>INSERT</command> commands (rather
+ than <command>COPY</command>). This will make restoration very slow;
+ it is mainly useful for making dumps that can be loaded into
+ non-<productname>PostgreSQL</productname> databases. Note that
+ the restore might fail altogether if you have rearranged column order.
+ The <option>--column-inserts</option> option is safer, though even
+ slower.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--column-inserts</option></term>
+ <term><option>--attribute-inserts</option></term>
+ <listitem>
+ <para>
+ Dump data as <command>INSERT</command> commands with explicit
+ column names (<literal>INSERT INTO
+ <replaceable>table</replaceable>
+ (<replaceable>column</replaceable>, ...) VALUES
+ ...</literal>). This will make restoration very slow; it is mainly
+ useful for making dumps that can be loaded into
+ non-<productname>PostgreSQL</productname> databases.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>--disable-dollar-quoting</option></term>
<listitem>
<para>
@@ -336,8 +389,8 @@
<variablelist>
<varlistentry>
- <term>-h <replaceable>hôte</replaceable></term>
- <term>--host=<replaceable>hôte</replaceable></term>
+ <term><option>-h <replaceable>hôte</replaceable></option></term>
+ <term><option>--host=<replaceable>hôte</replaceable></option></term>
<listitem>
<para>
Précise le nom d'hôte de la machine sur laquelle le serveur de bases de
@@ -351,8 +404,8 @@
</varlistentry>
<varlistentry>
- <term>-l <replaceable>dbname</replaceable></term>
- <term>--database=<replaceable>dbname</replaceable></term>
+ <term><option>-l <replaceable>dbname</replaceable></option></term>
+ <term><option>--database=<replaceable>dbname</replaceable></option></term>
<listitem>
<para>
Spécifie le nom de la base où se connecter pour la sauvegarde des
@@ -365,8 +418,8 @@
</varlistentry>
<varlistentry>
- <term>-p <replaceable>port</replaceable></term>
- <term>--port=<replaceable>port</replaceable></term>
+ <term><option>-p <replaceable>port</replaceable></option></term>
+ <term><option>--port=<replaceable>port</replaceable></option></term>
<listitem>
<para>
Précise le port TCP ou l'extension du fichier socket de domaine Unix
@@ -378,8 +431,8 @@
</varlistentry>
<varlistentry>
- <term>-U <replaceable>nomutilisateur</replaceable></term>
- <term>--username=<replaceable>nomutilisateur</replaceable></term>
+ <term><option>-U <replaceable>nomutilisateur</replaceable></option></term>
+ <term><option>--username=<replaceable>nomutilisateur</replaceable></option></term>
<listitem>
<para>
Utilisateur utilisé pour initier la connexion.
@@ -388,10 +441,25 @@
</varlistentry>
<varlistentry>
- <term>-W</term>
- <term>--password</term>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
<listitem>
<para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-W</option></term>
+ <term><option>--password</option></term>
+ <listitem>
+ <para>
Force <application>pg_dumpall</application> à demander un mot de passe
avant la connexion à une base de données.
</para>
@@ -414,6 +482,23 @@
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><option>--role=<replaceable class="parameter">rolename</replaceable></option></term>
+ <listitem>
+ <para>
+ Specifies a role name to be used to create the dump.
+ This option causes <application>pg_dumpall</> to issue a
+ <command>SET ROLE</> <replaceable class="parameter">rolename</>
+ command after connecting to the database. It is useful when the
+ authenticated user (specified by <option>-U</>) lacks privileges
+ needed by <application>pg_dumpall</>, but can switch to a role with
+ the required rights. Some installations have a policy against
+ logging in directly as a superuser, and use of this option allows
+ dumps to be made without violating the policy.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
</refsect1>
@@ -425,6 +510,7 @@
<variablelist>
<varlistentry>
<term><envar>PGHOST</envar></term>
+ <term><envar>PGOPTIONS</envar></term>
<term><envar>PGPORT</envar></term>
<term><envar>PGUSER</envar></term>
Modified: traduc/trunk/postgresql/ref/pg_resetxlog.xml
===================================================================
--- traduc/trunk/postgresql/ref/pg_resetxlog.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/pg_resetxlog.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -69,13 +69,9 @@
cas, des valeurs probables sont substituées aux données manquantes. La
plupart des champs correspondent mais une aide manuelle pourrait être
nécessaire pour le prochain OID, le prochain TID et sa date, le prochain ID
- multi-transaction et son décalage, l'adresse de début des WAL et les
- champs locale des bases de données. Les six premiers
- peuvent être initialisés en utilisant les options discutées plus bas. Le
- propre environnement de <command>pg_resetxlog</command> est la source de ses
- suppositions quant aux champs locale ; faites attention que
- <envar>LANG</envar> et d'autres correspondent à l'environnement avec lequel
- <command>initdb</command> a été exécuté. Si vous n'êtes pas capable de déterminer
+ multi-transaction et son décalage, l'adresse de début des WAL. These fields can
+ be set using the switches
+ discussed below. Si vous n'êtes pas capable de déterminer
les bonnes valeurs pour tous ces champs, <literal>-f</literal> peut toujours être
utilisé mais la base de données récupérée doit être traitée avec encore plus
de suspicion que d'habitude : une sauvegarde immédiate et un
Modified: traduc/trunk/postgresql/ref/pg_restore.xml
===================================================================
--- traduc/trunk/postgresql/ref/pg_restore.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/pg_restore.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -205,7 +205,7 @@
<term><option>--ignore-version</option></term>
<listitem>
<para>
- Ignore la vérification de version de la base de données.
+ A deprecated option that is now ignored.
</para>
</listitem>
</varlistentry>
@@ -221,6 +221,46 @@
</varlistentry>
<varlistentry>
+ <term><option>-j <replaceable class="parameter">number-of-jobs</replaceable></option></term>
+ <term><option>--jobs=<replaceable class="parameter">number-of-jobs</replaceable></option></term>
+ <listitem>
+ <para>
+ Run the most time-consuming parts
+ of <application>pg_restore</> — those which load data,
+ create indexes, or create constraints — using multiple
+ concurrent jobs. This option can dramatically reduce the time
+ to restore a large database to a server running on a
+ multi-processor machine.
+ </para>
+
+ <para>
+ Each job is one process or one thread, depending on the
+ operating system, and uses a separate connection to the
+ server.
+ </para>
+
+ <para>
+ The optimal value for this option depends on the hardware
+ setup of the server, of the client, and of the network.
+ Factors include the number of CPU cores and the disk setup. A
+ good place to start is the number of CPU cores on the server,
+ but values larger than that can also lead to faster restore
+ times in many cases. Of course, values that are too high will
+ lead to decreasing performance because of thrashing.
+ </para>
+
+ <para>
+ Only the custom archive format is supported with this option.
+ The input file must be a regular file (not, for example, a
+ pipe). This option is ignored when emitting a script rather
+ than connecting directly to a database server. Also, multiple
+ jobs cannot be used together with the
+ option <option>--single-transaction</option>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-l</option></term>
<term><option>--list</option></term>
<listitem>
@@ -281,6 +321,17 @@
</varlistentry>
<varlistentry>
+ <term><option>--no-tablespaces</option></term>
+ <listitem>
+ <para>
+ Do not output commands to select tablespaces.
+ With this option, all objects will be created in whichever
+ tablespace is the default during restore.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-P <replaceable class="parameter">nom_fonction(argtype [,
...])</replaceable></option></term>
<term><option>--function=<replaceable
@@ -433,6 +484,20 @@
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><option>-1</option></term>
+ <term><option>--single-transaction</option></term>
+ <listitem>
+ <para>
+ Execute the restore as a single transaction (that is, wrap the
+ emitted commands in <command>BEGIN</>/<command>COMMIT</>). This
+ ensures that either all the commands complete successfully, or no
+ changes are applied. This option implies
+ <option>--exit-on-error</>.
+ </para>
+ </listitem>
+ </varlistentry>
+
</variablelist>
</para>
@@ -482,6 +547,21 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
@@ -503,16 +583,18 @@
</varlistentry>
<varlistentry>
- <term><option>-1</option></term>
- <term><option>--single-transaction</option></term>
+ <term><option>--role=<replaceable class="parameter">rolename</replaceable></option></term>
<listitem>
<para>
- Exécute la restauration en une seule transaction (c'est-à-dire qu'elle
- entoure les commandes de restauration par les commandes
- <command>BEGIN</command>/<command>COMMIT</command>). Ceci vous assure
- que soit toutes les commandes terminent avec succès soit aucune
- modification n'a lieu. Cette option implique
- <option>--exit-on-error</option>.
+ Specifies a role name to be used to perform the restore.
+ This option causes <application>pg_restore</> to issue a
+ <command>SET ROLE</> <replaceable class="parameter">rolename</>
+ command after connecting to the database. It is useful when the
+ authenticated user (specified by <option>-U</>) lacks privileges
+ needed by <application>pg_restore</>, but can switch to a role with
+ the required rights. Some installations have a policy against
+ logging in directly as a superuser, and use of this option allows
+ restores to be performed without violating the policy.
</para>
</listitem>
</varlistentry>
@@ -527,6 +609,7 @@
<variablelist>
<varlistentry>
<term><envar>PGHOST</envar></term>
+ <term><envar>PGOPTIONS</envar></term>
<term><envar>PGPORT</envar></term>
<term><envar>PGUSER</envar></term>
@@ -597,9 +680,11 @@
<listitem>
<para>
- <application>pg_restore</application> ne restaure pas les objets
- larges pour une seule table. Si une archive contient des objets larges,
- alors ils sont tous restaurés.
+ <application>pg_restore</application> cannot restore large objects
+ selectively, for instance only those for a specific table. If
+ an archive contains large objects, then all large objects will be
+ restored, or none of them if they are excluded via <option>-L</option>,
+ <option>-t</option>, or other options.
</para>
</listitem>
Modified: traduc/trunk/postgresql/ref/prepare.xml
===================================================================
--- traduc/trunk/postgresql/ref/prepare.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/prepare.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-prepare">
<refmeta>
<refentrytitle id="sql-prepare-title">PREPARE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/prepare_transaction.xml
===================================================================
--- traduc/trunk/postgresql/ref/prepare_transaction.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/prepare_transaction.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-prepare-transaction">
<refmeta>
<refentrytitle id="sql-prepare-transaction-title">PREPARE TRANSACTION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/psql-ref.xml
===================================================================
--- traduc/trunk/postgresql/ref/psql-ref.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/psql-ref.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -431,6 +431,26 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires password
+ authentication and a password is not available by other means
+ such as a <filename>.pgpass</filename> file, the connection
+ attempt will fail. This option can be useful in batch jobs and
+ scripts where no user is present to enter a password.
+ </para>
+
+ <para>
+ Note that this option will remain set for the entire session,
+ and so it affects uses of the meta-command
+ <command>\connect</command> as well as the initial connection attempt.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
@@ -605,14 +625,9 @@
le nom de la base de données sur laquelle <application>psql</application>
est connecté suivi par la chaîne <literal>=></literal>. Par exemple
<programlisting>$ <userinput>psql basetest</userinput>
-Welcome to psql &version;, the PostgreSQL interactive terminal.
+psql (&version;)
+Type "help" for help.
-Type: \copyright for distribution terms
- \h for help with SQL commands
- \? for help with psql commands
- \g or terminate with semicolon to execute query
- \q to quit
-
basetest=>
</programlisting>
</para>
@@ -856,8 +871,7 @@
</varlistentry>
<varlistentry>
- <term><literal>\d [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
- <term><literal>\d+ [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\d[S+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
@@ -878,6 +892,12 @@
la table.
</para>
+ <para>
+ By default, only user-created objects are shown; supply a
+ pattern or the <literal>S</literal> modifier to include system
+ objects.
+ </para>
+
<note>
<para>
Si <command>\d</command> est utilisé sans argument
@@ -891,7 +911,7 @@
</varlistentry>
<varlistentry>
- <term><literal>\da [ <replaceable
+ <term><literal>\da[S] [ <replaceable
class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
@@ -900,14 +920,16 @@
et les types de données sur lesquels elles opèrent. Si <replaceable
class="parameter">modèle</replaceable> est spécifié, seuls les agrégats
dont les noms commencent par le modèle sont affichés.
+ By default, only user-created objects are shown; supply a
+ pattern or the <literal>S</literal> modifier to include system
+ objects.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>\db [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
- <term><literal>\db+ [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\db[+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
@@ -921,7 +943,7 @@
</varlistentry>
<varlistentry>
- <term><literal>\dc [ <replaceable
+ <term><literal>\dc[S] [ <replaceable
class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
@@ -929,33 +951,44 @@
jeux de caractères. Si <replaceable
class="parameter">modèle</replaceable> est spécifié, seules les
conversions dont le nom correspond au modèle sont listées.
+ By default, only user-created objects are shown; supply a
+ pattern or the <literal>S</literal> modifier to include system
+ objects.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>\dC</literal></term>
+ <term><literal>\dC [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
Liste toutes les conversions de types disponibles.
+ If <replaceable class="parameter">pattern</replaceable>
+ is specified, only casts whose source or target types match the
+ pattern are listed.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>\dd [ <replaceable
+ <term><literal>\dd[S] [ <replaceable
class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
Affiche les descriptions des objets correspondant au <replaceable
class="parameter">modèle</replaceable> ou de tous les objets si aucun
argument n'est donné. Mais dans tous les cas, seuls les objets qui ont
- une description sont listés. (Le terme <quote>objet</quote> couvre les
+ une description sont listés.
+ By default, only user-created objects are shown; supply a
+ pattern or the <literal>S</literal> modifier to include system
+ objects.
+ Le terme <quote>objet</quote> couvre les
agrégats, les fonctions, les opérateurs, les types, les relations
(tables, vues, index, séquences, objets larges), les règles et les
- déclencheurs.) Par exemple, :
+ déclencheurs.
+ Par exemple, :
<programlisting>=> <userinput>\dd version</userinput>
Object descriptions
Schema | Name | Object | Description
@@ -975,45 +1008,98 @@
<varlistentry>
- <term><literal>\dD [ <replaceable
+ <term><literal>\dD[S] [ <replaceable
class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
Liste tous les domaines disponibles. Si <replaceable
class="parameter">modèle</replaceable> est spécifié, seuls les
domaines correspondant sont affichés.
+ By default, only user-created objects are shown; supply a
+ pattern or the <literal>S</literal> modifier to include system
+ objects.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>\df [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
- <term><literal>\df+ [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\des[+] [ <replaceable class="parameter">pattern</replaceable> ]</literal></term>
+ <listitem>
+ <para>
+ Lists all foreign servers (mnemonic: <quote>external
+ servers</quote>).
+ If <replaceable class="parameter">pattern</replaceable> is
+ specified, only those servers whose name matches the pattern
+ are listed. If the form <literal>\des+</literal> is used, a
+ full desription of each server is shown, including the
+ server's ACL, type, version, and options.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>\deu[+] [ <replaceable class="parameter">pattern</replaceable> ]</literal></term>
<listitem>
<para>
+ Lists all user mappings (mnemonic: <quote>external
+ users</quote>).
+ If <replaceable class="parameter">pattern</replaceable> is
+ specified, only those mappings whose user names match the
+ pattern are listed. If the form <literal>\deu+</literal> is
+ used, additional information about each mapping is shown.
+ </para>
+
+ <caution>
+ <para>
+ <literal>\deu+</literal> might also display the user name and
+ password of the remote user, so care should be taken not to
+ disclose them.
+ </para>
+ </caution>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><literal>\dew[+] [ <replaceable class="parameter">pattern</replaceable> ]</literal></term>
+ <listitem>
+ <para>
+ Lists all foreign-data wrappers (mnemonic: <quote>external
+ wrappers</quote>).
+ If <replaceable class="parameter">pattern</replaceable> is
+ specified, only those foreign-data wrappers whose name matches
+ the pattern are listed. If the form <literal>\dew+</literal>
+ is used, the ACL and options of the foreign-data wrapper are
+ also shown.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
+ <term><literal>\df[S+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <listitem>
+ <para>
Liste toutes les fonctions disponibles avec leurs arguments et les types
en retour. Si <replaceable class="parameter">modèle</replaceable> est
spécifié, seules les fonctions dont le nom correspond au modèle sont
affichées. Si la forme <literal>\df+</literal> est utilisée, des
informations supplémentaires sur chaque fonction, dont la volatibilité,
le langage, le code source et la description, sont proposées.
+ By default, only user-created objects are shown; supply a
+ pattern or the <literal>S</literal> modifier to include system
+ objects.
</para>
<note>
<para>
- Pour rechercher des fonctions prenant un argument ou des valeurs de
+ Pour rechercher des fonctions prenant des arguments ou des valeurs de
retour d'un type spécifique, utilisez les capacités de recherche du
paginateur pour parcourir <literal>\df</literal>
output.
</para>
-
- <para>
- Pour réduire les redondances, <literal>\df</literal> n'affiche pas les
- fonctions d'entrées/sorties des types de données. Ceci est implémenté en
- ignorant les fonctions qui acceptent ou renvoient <type>cstring</type>.
- </para>
</note>
</listitem>
@@ -1021,8 +1107,7 @@
<varlistentry>
- <term><literal>\dF [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
- <term><literal>\dF+ [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\dF[+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
Liste les configurations de la recherche plein texte.
@@ -1037,8 +1122,7 @@
</varlistentry>
<varlistentry>
- <term><literal>\dFd [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
- <term><literal>\dFd+ [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\dFd[+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
Liste les dictionnaires de la recherche plein texte.
@@ -1053,8 +1137,7 @@
</varlistentry>
<varlistentry>
- <term><literal>\dFp [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
- <term><literal>\dFp+ [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\dFp[+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
Liste les analyseurs de la recherche plein texte.
@@ -1069,8 +1152,7 @@
</varlistentry>
<varlistentry>
- <term><literal>\dFt [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
- <term><literal>\dFt+ [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\dFt[+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
Liste les modèles de la recherche plein texte.
@@ -1098,21 +1180,26 @@
<varlistentry>
- <term><literal>\distvS [ <replaceable
- class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\di[S+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\ds[S+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\dt[S+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\dv[S+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
- Ceci n'est pas le nom réel de la commande : les lettres
- <literal>i</literal>, <literal>s</literal>, <literal>t</literal>,
- <literal>v</literal>, <literal>S</literal> correspondent respectivement
- à index, séquence, table, vue et
- table système. Vous pouvez spécifier une ou toutes ces lettres, dans
- n'importe quel ordre, pour obtenir une liste de tous les objets
- correspondants. La lettre <literal>S</literal> restreint la liste aux objets système ;
- sans <literal>S</literal>, seuls les objets non système sont affichés. Si
- <literal>+</literal> est ajouté au nom de la commande, chaque objet est
- listé avec sa description associée, si celle-ci est disponible.
+ In this group of commands, the letters
+ <literal>i</literal>, <literal>s</literal>,
+ <literal>t</literal>, and <literal>v</literal>
+ stand for index, sequence, table, and view, respectively.
+ You can specify any or all of
+ these letters, in any order, to obtain a listing of all the
+ matching objects. For example, <literal>\dit</> lists indexes
+ and tables. If <literal>+</literal> is
+ appended to the command name, each object is listed with its
+ physical size on disk and its associated description, if any.
+ By default, only user-created objects are shown; supply a
+ pattern or the <literal>S</literal> modifier to include system
+ objects.
</para>
<para>
@@ -1135,12 +1222,11 @@
<varlistentry>
- <term><literal>\dn</literal> [ <replaceable class="parameter">modèle</replaceable> ]</term>
- <term><literal>\dn+ [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\dn[+] [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
- Liste tous les schémas disponibles (tablespaces). Si <replaceable
+ Liste tous les schémas disponibles. Si <replaceable
class="parameter">modèle</replaceable> (une expression régulière) est
spécifiée, seuls les schémas dont le nom correspond au modèle sont
listés. Tout schéma temporaire non local est supprimé. Si
@@ -1152,7 +1238,7 @@
<varlistentry>
- <term><literal>\do [ <replaceable class="parameter">modèle</replaceable>
+ <term><literal>\do[S] [ <replaceable class="parameter">modèle</replaceable>
]</literal></term>
<listitem>
<para>
@@ -1160,6 +1246,9 @@
retour. Si <replaceable class="parameter">modèle</replaceable> est
spécifié, seuls les opérateurs dont le nom correspond au modèle sont
listés.
+ By default, only user-created objects are shown; supply a
+ pattern or the <literal>S</literal> modifier to include system
+ objects.
</para>
</listitem>
</varlistentry>
@@ -1170,7 +1259,7 @@
class="parameter">modèle</replaceable> ]</literal></term>
<listitem>
<para>
- Produit une liste de toutes les tables, vues et séquences disponibles
+ Liste toutes les tables, vues et séquences disponibles
avec leur droits d'accès associés. Si <replaceable
class="parameter">modèle</replaceable> est spécifié, seules les tables,
vues et séquences dont le nom correspond au modèle sont listées.
@@ -1186,14 +1275,18 @@
<varlistentry>
- <term><literal>\dT [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
- <term><literal>\dT+ [ <replaceable class="parameter">modèle</replaceable> ]</literal></term>
+ <term><literal>\dT[S+] [ <replaceable class="parameter">pattern</replaceable> ]</literal></term>
<listitem>
<para>
- Liste tous les types de données ou seulement ceux dont le nom correspond
- à <replaceable class="parameter">modèle</replaceable>. La
- commande <literal>\dT+</literal> affiche des informations
- supplémentaires.
+ Lists available data types.
+ If <replaceable class="parameter">pattern</replaceable> is
+ specified, only types whose names match the pattern are listed.
+ If <literal>+</literal> is appended to the command name, each type is
+ listed with its internal name and size, as well as its allowed values
+ if it is an <type>enum</> type.
+ By default, only user-created objects are shown; supply a
+ pattern or the <literal>S</literal> modifier to include system
+ objects.
</para>
</listitem>
</varlistentry>
@@ -1204,17 +1297,16 @@
]</literal></term>
<listitem>
<para>
- Liste tous les rôles de la base de données ou seulement ceux dont
- le nom correspond au <replaceable
- class="parameter">modèle</replaceable>.
+ Liste tous les rôles de la base de données. If <replaceable
+ class="parameter">pattern</replaceable> is specified, only
+ those roles whose names match the pattern are listed.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>\edit</literal> (ou <literal>\e</literal>) <literal>[ <replaceable
- class="parameter">nomfichier</replaceable> ]</literal></term>
+ <term><literal>\edit</literal> (or <literal>\e</literal>) <literal><optional> <replaceable class="parameter">filename</replaceable> </optional></literal></term>
<listitem>
<para>
@@ -1250,6 +1342,34 @@
<varlistentry>
+ <term><literal>\ef <optional> <replaceable class="parameter">function_description</replaceable> </optional></literal></term>
+
+ <listitem>
+ <para>
+ This command fetches and edits the definition of the named function,
+ in the form of a <command>CREATE OR REPLACE FUNCTION</> command.
+ Editing is done in the same way as for <literal>\e</>.
+ After the editor exits, the updated command waits in the query buffer;
+ type semicolon or <literal>\g</> to send it, or <literal>\r</>
+ to cancel.
+ </para>
+
+ <para>
+ The target function can be specified by name alone, or by name
+ and arguments, for example <literal>foo(integer, text)</>.
+ The argument types must be given if there is more
+ than one function of the same name.
+ </para>
+
+ <para>
+ If no function is specified, a blank <command>CREATE FUNCTION</>
+ template is presented for editing.
+ </para>
+ </listitem>
+ </varlistentry>
+
+
+ <varlistentry>
<term><literal>\echo <replaceable
class="parameter">texte</replaceable> [ ... ]</literal></term>
<listitem>
@@ -1387,10 +1507,12 @@
<term><literal>\l+</literal> (ou <literal>\list+</literal>)</term>
<listitem>
<para>
- Liste les noms, propriétaires et codages des ensembles de caractères
- de toutes les bases de données du serveur.
- Si <literal>+</literal> est ajouté au nom de la commande,
- les descriptions des bases de données sont aussi affichées.
+ List the names, owners, character set encodings, and access privileges
+ of all the databases in the server.
+ If <literal>+</literal> is appended to the command name, database
+ sizes, default tablespaces, and descriptions are also displayed.
+ (Size information is only available for databases that the current
+ user can connect to.)
</para>
</listitem>
</varlistentry>
@@ -1581,7 +1703,7 @@
<listitem>
<para>
Initialise le format d'affichage parmi <literal>unaligned</literal>,
- <literal>aligned</literal>, <literal>html</literal>,
+ <literal>aligned</literal>, <literal>wrapped</literal>, <literal>html</literal>,
<literal>latex</literal> ou <literal>troff-ms</literal>. Les
abréviations uniques sont autorisées. (ce qui signifie qu'une lettre
est suffisante.)
@@ -1594,7 +1716,21 @@
lisible par d'autres programmes (séparé par des tabulations, séparé
par des virgules). Le mode <quote>Aligned</quote> est l'affichage
texte standard, lisible par un humain, proprement formaté. C'est aussi
- la valeur par défaut. Les modes <quote><acronym>HTML</acronym></quote>
+ la valeur par défaut.
+ </para>
+
+ <para>
+ <quote>Wrapped</quote> is like <literal>aligned</> but wraps
+ output to the specified width. If <literal>\pset columns</> is
+ zero (the default), <literal>wrapped</> mode only affects screen
+ output and wrapped width is controlled by the environment
+ variable <envar>COLUMNS</> or the detected screen width. If
+ <literal>\pset columns</> is set to a non-zero value, all output
+ is wrapped, including file and pipe output.
+ </para>
+
+ <para>
+ Les modes <quote><acronym>HTML</acronym></quote>
et <quote>LaTeX</quote> produisent des tables destinées à être
inclues dans des documents utilisant le langage de marques respectif.
Ce ne sont pas des documents complets ! (Ce n'est pas
@@ -1618,6 +1754,18 @@
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><literal>columns</literal></term>
+ <listitem>
+ <para>
+ Controls the target width for the <literal>wrapped</> format,
+ and width for determining if wide output requires the pager.
+ Zero (the default) causes the <literal>wrapped</> format to
+ affect only screen output.
+ </para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term><literal>expanded</literal> (ou <literal>x</literal>)</term>
<listitem>
@@ -1762,17 +1910,13 @@
</para>
<para>
- Lorsque le paginateur est désactivé, il n'est pas utilisé. Quand le
- paginateur est activé, il est utilisé seulement si nécessaire,
+ Lorsque le paginateur est désactivé (<literal>off</>), il n'est pas utilisé. Quand le
+ paginateur est activé (<literal>on</>), il est utilisé seulement si nécessaire,
c'est-à-dire si l'affichage se fait sur un terminal et qu'il ne tient
- pas sur l'écran. (<application>psql</application> ne fait pas un boulot parfait
- pour savoir quand utiliser le paginateur.) <literal>\pset pager</literal>
+ pas sur l'écran. <literal>\pset pager</literal>
active et désactive le paginateur. Ce dernier peut aussi être
configuré à <literal>always</literal>, ce qui fait qu'il est utilisé en
- permanence. Vous pouvez aussi positionner le paginateur à
- <literal>on</literal> ce qui activera l'utilisation du paginateur si
- besoin, ou vous pouvez le positionner à <literal>off</literal> ce qui
- le désactivera.
+ permanence.
</para>
</listitem>
</varlistentry>
@@ -1925,11 +2069,11 @@
<varlistentry>
- <term><literal>\timing</literal></term>
+ <term><literal>\timing [ <replaceable class="parameter">on</replaceable> | <replaceable class="parameter">off</replaceable> ]</literal></term>
<listitem>
<para>
- Affiche le temps pris par chaque instruction SQL, en
- millisecondes, ou arrête cet affichage.
+ Without parameter, affiche le temps pris par chaque instruction SQL, en
+ millisecondes, ou arrête cet affichage. With parameter, sets same.
</para>
</listitem>
</varlistentry>
@@ -2537,10 +2681,8 @@
</para>
<para>
- Une application populaire de cette fonctionnalité est de renvoyer le
- dernier <acronym>OID</acronym> inséré dans les instructions suivantes
- pour construire un scénario de clé étrangère. Une autre utilisation
- possible de ce mécanisme est de copier le contenu d'un fichier dans une
+ Une utilisation possible de ce mécanisme est de copier le contenu d'un
+ fichier dans une
colonne d'une table. Tout d'abord, chargez le fichier dans une variable puis
procédez ainsi :
<programlisting>basetest=> <userinput>\set contenu '''' `cat mon_fichier.txt` ''''</userinput>
@@ -2812,37 +2954,40 @@
<variablelist>
<varlistentry>
- <term><envar>PAGER</envar></term>
+ <term><envar>COLUMNS</envar></term>
<listitem>
<para>
- Si les résultats d'une requête ne tiennent pas sur l'écran, ils sont
- envoyés via un tube sur cette commande. Les valeurs typiques sont
- <literal>more</literal> ou <literal>less</literal>. La valeur par défaut
- dépend de la plateforme. L'utilisation du paginateur peut être désactivée
- en utilisant la commande <command>\pset</command>.
+ If <literal>\pset columns</> is zero, controls the
+ width for the <literal>wrapped</> format and width for determining
+ if wide output requires the pager.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><envar>PGDATABASE</envar></term>
+ <term><envar>PAGER</envar></term>
<listitem>
<para>
- Base de données où se connecter par défaut
+ Si les résultats d'une requête ne tiennent pas sur l'écran, ils sont
+ envoyés via un tube sur cette commande. Les valeurs typiques sont
+ <literal>more</literal> ou <literal>less</literal>. La valeur par défaut
+ dépend de la plateforme. L'utilisation du paginateur peut être désactivée
+ en utilisant la commande <command>\pset</command>.
</para>
</listitem>
</varlistentry>
<varlistentry>
+ <term><envar>PGDATABASE</envar></term>
<term><envar>PGHOST</envar></term>
<term><envar>PGPORT</envar></term>
<term><envar>PGUSER</envar></term>
<listitem>
<para>
- Paramètres de connexion par défaut
+ Paramètres de connexion par défaut (see <xref linkend="libpq-envars">).
</para>
</listitem>
</varlistentry>
@@ -2939,26 +3084,22 @@
<listitem>
<para>
Dans une vie précédente, <application>psql</application> permettait au
- premier argument d'une commande antislash à une seule lettre de commencer
- directement après la commande, sans espace séparateur. Pour
- la compatibilité, ceci est toujours partiellement supporté mais
- nous n'allons pas expliquer les détails ici car son utilisation n'est pas
- encouragée. Si vous obtenez des messages étranges, gardez ceci en tête. Par
- exemple :
-<programlisting>basetest=> <userinput>\foo</userinput>
-Field separator is "oo".
-</programlisting>
- ce qui n'est probablement pas ce que vous souhaitez.
+ premier argument d'une commande antislash à une seule lettre de commencer
+ directement après la commande, sans espace séparateur. As of
+ <productname>PostgreSQL</productname> 8.4 this is no longer allowed.
</para>
</listitem>
<listitem>
<para>
- <application>psql</application> ne travaille correctement qu'avec
- des serveurs de la même version. Cela ne signifie pas que les autres
- combinaisons ne fonctionnenet pas du tout, mais des problèmes subtiles et moins
- subtiles peuvent survenir. Les commandes antislash sont particulièrement
- susceptibles d'échouer si le serveur est d'une version différente.
+ <application>psql</application> is only guaranteed to work smoothly
+ with servers of the same version. That does not mean other combinations
+ will fail outright, but subtle and not-so-subtle problems might come
+ up. Backslash commands are particularly likely to fail if the
+ server is of a newer version than <application>psql</> itself. However,
+ backslash commands of the <literal>\d</> family should work with
+ servers of versions back to 7.4, though not necessarily with servers
+ newer than <application>psql</> itself.
</para>
</listitem>
Modified: traduc/trunk/postgresql/ref/reassign_owned.xml
===================================================================
--- traduc/trunk/postgresql/ref/reassign_owned.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/reassign_owned.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-reassign-owned">
<refmeta>
<refentrytitle id="sql-reassign-owned-title">REASSIGN OWNED</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/reindex.xml
===================================================================
--- traduc/trunk/postgresql/ref/reindex.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/reindex.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-reindex">
<refmeta>
<refentrytitle id="sql-reindex-title">REINDEX</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/reindexdb.xml
===================================================================
--- traduc/trunk/postgresql/ref/reindexdb.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/reindexdb.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -201,6 +201,21 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
Modified: traduc/trunk/postgresql/ref/release_savepoint.xml
===================================================================
--- traduc/trunk/postgresql/ref/release_savepoint.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/release_savepoint.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-release-savepoint">
<refmeta>
<refentrytitle id="sql-release-savepoint-title">RELEASE SAVEPOINT</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/reset.xml
===================================================================
--- traduc/trunk/postgresql/ref/reset.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/reset.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-reset">
<refmeta>
<refentrytitle id="sql-reset-title">RESET</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/revoke.xml
===================================================================
--- traduc/trunk/postgresql/ref/revoke.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/revoke.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-revoke">
<refmeta>
<refentrytitle id="sql-revoke-title">REVOKE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage </refmiscinfo>
</refmeta>
@@ -17,13 +18,20 @@
<refsynopsisdiv>
<synopsis>REVOKE [ GRANT OPTION FOR ]
- { { SELECT | INSERT | UPDATE | DELETE | REFERENCES | TRIGGER }
+ { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER }
[,...] | ALL [ PRIVILEGES ] }
ON [ TABLE ] <replaceable class="parameter">nom_table</replaceable> [, ...]
FROM { [ GROUP ] <replaceable class="PARAMETER">nom_role</replaceable> | PUBLIC } [, ...]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
+ { { SELECT | INSERT | UPDATE | REFERENCES } ( <replaceable class="PARAMETER">colonne</replaceable> [, ...] )
+ [,...] | ALL [ PRIVILEGES ] ( <replaceable class="PARAMETER">colonne</replaceable> [, ...] ) }
+ ON [ TABLE ] <replaceable class="parameter">nom_table</replaceable> [, ...]
+ FROM { [ GROUP ] <replaceable class="PARAMETER">nom_role</replaceable> | PUBLIC } [, ...]
+ [ CASCADE | RESTRICT ]
+
+REVOKE [ GRANT OPTION FOR ]
{ { USAGE | SELECT | UPDATE }
[,...] | ALL [ PRIVILEGES ] }
ON SEQUENCE <replaceable class="parameter">nom_séquence</replaceable> [, ...]
@@ -37,6 +45,18 @@
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
+ { USAGE | ALL [ PRIVILEGES ] }
+ ON FOREIGN DATA WRAPPER <replaceable>nom_fdw</replaceable> [, ...]
+ FROM { [ GROUP ] <replaceable class="PARAMETER">nom_role</replaceable> | PUBLIC } [, ...]
+ [ CASCADE | RESTRICT ]
+
+REVOKE [ GRANT OPTION FOR ]
+ { USAGE | ALL [ PRIVILEGES ] }
+ ON FOREIGN SERVER <replaceable>nom_serveur</replaceable> [, ...]
+ FROM { [ GROUP ] <replaceable class="PARAMETER">nom_role</replaceable> | PUBLIC } [, ...]
+ [ CASCADE | RESTRICT ]
+
+REVOKE [ GRANT OPTION FOR ]
{ EXECUTE | ALL [ PRIVILEGES ] }
ON FUNCTION <replaceable>nomfonction</replaceable> ( [ [ <replaceable class="parameter">modearg</replaceable> ] [ <replaceable class="parameter">nomarg</replaceable> ] <replaceable class="parameter">typearg</replaceable> [, ...] ] ) [, ...]
FROM { [ GROUP ] <replaceable class="PARAMETER">nom_role</replaceable> | PUBLIC } [, ...]
@@ -94,6 +114,10 @@
<literal>PUBLIC</literal> ne veut pas nécessairement dire que plus aucun rôle
n'a le droit de faire de <literal>SELECT</literal> sur l'objet : ceux qui en
avaient obtenu le droit directement ou via un autre rôle l'ont toujours.
+ Similarly, revoking
+ <literal>SELECT</> from a user might not prevent that user from using
+ <literal>SELECT</> if <literal>PUBLIC</literal> or another membership
+ role still has <literal>SELECT</> rights.
</para>
<para>
@@ -119,6 +143,11 @@
</para>
<para>
+ When revoking privileges on a table, the corresponding column privileges
+ (if any) are automatically revoked on each column of the table, as well.
+ </para>
+
+ <para>
Lors de la révocation de l'appartenance d'un rôle, <literal>GRANT OPTION</literal>
est appelé <literal>ADMIN OPTION</literal> mais le comportement est similaire.
Notez aussi que cette forme de la commande ne permet pas le mot <literal>GROUP</literal>.
@@ -129,10 +158,11 @@
<title>Notes</title>
<para>
- Utilisez la commande <command>\z</command> de <xref linkend="app-psql"/>
- pour afficher les droits donnés sur des objets existants.
- Voir <xref linkend="sql-grant" endterm="sql-grant-title"/>
- pour des informations sur le format.
+ Utilisez la commande <command>\dp</command> de <xref linkend="app-psql"/>
+ pour afficher les droits donnés sur des tables and columns. See <xref
+ linkend="sql-grant" endterm="sql-grant-title"> for information about the
+ format. For non-table objects there are other <command>\d</> commands
+ that can display their privileges.
</para>
<para>
Modified: traduc/trunk/postgresql/ref/rollback.xml
===================================================================
--- traduc/trunk/postgresql/ref/rollback.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/rollback.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-rollback">
<refmeta>
<refentrytitle id="sql-rollback-title">ROLLBACK</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/rollback_prepared.xml
===================================================================
--- traduc/trunk/postgresql/ref/rollback_prepared.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/rollback_prepared.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-rollback-prepared">
<refmeta>
<refentrytitle id="sql-rollback-prepared-title">ROLLBACK PREPARED</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/rollback_to.xml
===================================================================
--- traduc/trunk/postgresql/ref/rollback_to.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/rollback_to.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-rollback-to">
<refmeta>
<refentrytitle id="sql-rollback-to-title">ROLLBACK TO SAVEPOINT</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/savepoint.xml
===================================================================
--- traduc/trunk/postgresql/ref/savepoint.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/savepoint.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-savepoint">
<refmeta>
<refentrytitle id="sql-savepoint-title">SAVEPOINT</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/select.xml
===================================================================
--- traduc/trunk/postgresql/ref/select.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/select.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,34 +8,60 @@
<refentry id="sql-select">
<refmeta>
<refentrytitle id="sql-select-title">SELECT</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
<refnamediv>
<refname>SELECT</refname>
+ <refname>TABLE</refname>
+ <refname>WITH</refname>
<refpurpose>récupère des lignes d'une table ou d'une vue</refpurpose>
</refnamediv>
+ <indexterm zone="sql-select">
+ <primary>SELECT</primary>
+ </indexterm>
+
+ <indexterm zone="sql-select">
+ <primary>TABLE command</primary>
+ </indexterm>
+
+ <indexterm zone="sql-select">
+ <primary>WITH</primary>
+ <secondary>in SELECT</secondary>
+ </indexterm>
+
<refsynopsisdiv>
-<synopsis>SELECT [ ALL | DISTINCT [ ON ( <replaceable class="parameter">expression</replaceable> [, ...] ) ] ]
- * | <replaceable class="parameter">expression</replaceable> [ AS <replaceable class="parameter">nom_d_affichage</replaceable> ] [, ...]
+<synopsis>[ WITH [ RECURSIVE ] <replaceable class="parameter">with_query</replaceable> [, ...] ]
+SELECT [ ALL | DISTINCT [ ON ( <replaceable class="parameter">expression</replaceable> [, ...] ) ] ]
+ * | <replaceable class="parameter">expression</replaceable> [ [ AS ] <replaceable class="parameter">nom_d_affichage</replaceable> ] [, ...]
[ FROM <replaceable class="parameter">éléments_from</replaceable> [, ...] ]
[ WHERE <replaceable class="parameter">condition</replaceable> ]
[ GROUP BY <replaceable class="parameter">expression</replaceable> [, ...] ]
[ HAVING <replaceable class="parameter">condition</replaceable> [, ...] ]
+ [ WINDOW <replaceable class="parameter">window_name</replaceable> AS ( <replaceable class="parameter">window_definition</replaceable> ) [, ...] ]
[ { UNION | INTERSECT | EXCEPT } [ ALL ] <replaceable class="parameter">select</replaceable> ]
[ ORDER BY <replaceable class="parameter">expression</replaceable> [ ASC | DESC | USING <replaceable class="parameter">opérateur</replaceable> ] [ NULLS { FIRST | LAST } ] [, ...] ]
[ LIMIT { <replaceable class="parameter">nombre</replaceable> | ALL } ]
- [ OFFSET <replaceable class="parameter">début</replaceable> ]
+ [ OFFSET <replaceable class="parameter">début</replaceable> ] [ ROW | ROWS ] ]
+ [ FETCH { FIRST | NEXT } [ <replaceable class="parameter">count</replaceable> ] { ROW | ROWS } ONLY ]
[ FOR { UPDATE | SHARE } [ OF <replaceable class="parameter">nom_table</replaceable> [, ...] ] [ NOWAIT ] [...] ]
avec <replaceable class="parameter">éléments_from</replaceable> qui peut être :
[ ONLY ] <replaceable class="parameter">nom_table</replaceable> [ * ] [ [ AS ] <replaceable class="parameter">alias</replaceable> [ ( <replaceable class="parameter">alias_colonne</replaceable> [, ...] ) ] ]
( <replaceable class="parameter">select</replaceable> ) [ AS ] <replaceable class="parameter">alias</replaceable> [ ( <replaceable class="parameter">alias_colonne</replaceable> [, ...] ) ]
+ <replaceable class="parameter">with_query_name</replaceable> [ [ AS ] <replaceable class="parameter">alias</replaceable> [ ( <replaceable class="parameter">column_alias</replaceable> [, ...] ) ] ]
<replaceable class="parameter">nom_fonction</replaceable> ( [ <replaceable class="parameter">argument</replaceable> [, ...] ] ) [ AS ] <replaceable class="parameter">alias</replaceable> [ ( <replaceable class="parameter">alias_colonne</replaceable> [, ...] | <replaceable class="parameter">définition_colonne</replaceable> [, ...] ) ]
<replaceable class="parameter">nom_fonction</replaceable> ( [ <replaceable class="parameter">argument</replaceable> [, ...] ] ) AS ( <replaceable class="parameter">définition_colonne</replaceable> [, ...] )
<replaceable class="parameter">éléments_from</replaceable> [ NATURAL ] <replaceable class="parameter">type_jointure</replaceable> <replaceable class="parameter">éléments_from</replaceable> [ ON <replaceable class="parameter">condition_jointure</replaceable> | USING ( <replaceable class="parameter">colonne_jointure</replaceable> [, ...] ) ]
+
+and <replaceable class="parameter">with_query</replaceable> is:
+
+ <replaceable class="parameter">with_query_name</replaceable> [ ( <replaceable class="parameter">column_name</replaceable> [, ...] ) ] AS ( <replaceable class="parameter">select</replaceable> )
+
+TABLE { [ ONLY ] <replaceable class="parameter">table_name</replaceable> [ * ] | <replaceable class="parameter">with_query_name</replaceable> }
</synopsis>
</refsynopsisdiv>
@@ -54,6 +80,17 @@
<orderedlist>
<listitem>
<para>
+ All queries in the <literal>WITH</literal> list are computed.
+ These effectively serve as temporary tables that can be referenced
+ in the <literal>FROM</literal> list. A <literal>WITH</literal> query
+ that is referenced more than once in <literal>FROM</literal> is
+ computed only once.
+ (See <xref linkend="sql-with" endterm="sql-with-title"> below.)
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
Tous les éléments de la liste <literal>FROM</literal> sont calculés.
(Chaque élément dans la liste <literal>FROM</literal> est une table
réelle ou virtuelle.) Si plus d'un élément sont spécifiés dans la liste
@@ -131,7 +168,8 @@
<listitem>
<para>
- Si les clauses <literal>LIMIT</literal> ou <literal>OFFSET</literal> sont
+ Si les clauses <literal>LIMIT</literal> (or <literal>FETCH FIRST</literal>)
+ ou <literal>OFFSET</literal> sont
spécifiées, l'instruction <command>SELECT</command> ne renvoie qu'un
sous-ensemble de lignes de résultats. (Voir <xref linkend="sql-limit"
endterm="sql-limit-title"/> ci-dessous.)
@@ -151,16 +189,68 @@
</para>
<para>
- Le droit <literal>SELECT</literal> sur une table est nécessaire pour lire
+ Le droit <literal>SELECT</literal> sur each column used
+ in a <command>SELECT</> command est nécessaire pour lire
ses valeurs. L'utilisation de <literal>FOR UPDATE</literal> ou de
<literal>FOR SHARE</literal> requiert en plus le droit
- <literal>UPDATE</literal>.
+ <literal>UPDATE</literal> (for at least one column
+ of each table so selected).
</para>
</refsect1>
<refsect1>
<title>Paramètres</title>
+ <refsect2 id="SQL-WITH">
+ <title id="sql-with-title"><literal>WITH</literal> Clause</title>
+
+ <para>
+ The <literal>WITH</literal> clause allows you to specify one or more
+ subqueries that can be referenced by name in the primary query.
+ The subqueries effectively act as temporary tables or views
+ for the duration of the primary query.
+ </para>
+
+ <para>
+ A name (without schema qualification) must be specified for each
+ <literal>WITH</literal> query. Optionally, a list of column names
+ can be specified; if this is omitted,
+ the column names are inferred from the subquery.
+ </para>
+
+ <para>
+ If <literal>RECURSIVE</literal> is specified, it allows a
+ subquery to reference itself by name. Such a subquery must have
+ the form
+<synopsis>
+<replaceable class="parameter">non_recursive_term</replaceable> UNION [ ALL ] <replaceable class="parameter">recursive_term</replaceable>
+</synopsis>
+ where the recursive self-reference must appear on the right-hand
+ side of the <literal>UNION</>. Only one recursive self-reference
+ is permitted per query.
+ </para>
+
+ <para>
+ Another effect of <literal>RECURSIVE</literal> is that
+ <literal>WITH</literal> queries need not be ordered: a query
+ can reference another one that is later in the list. (However,
+ circular references, or mutual recursion, are not implemented.)
+ Without <literal>RECURSIVE</literal>, <literal>WITH</literal> queries
+ can only reference sibling <literal>WITH</literal> queries
+ that are earlier in the <literal>WITH</literal> list.
+ </para>
+
+ <para>
+ A useful property of <literal>WITH</literal> queries is that they
+ are evaluated only once per execution of the primary query,
+ even if the primary query refers to them more than once.
+ </para>
+
+ <para>
+ See <xref linkend="queries-with"> for additional information.
+ </para>
+ </refsect2>
+
<refsect2 id="sql-from">
<title id="sql-from-title">Clause <literal>FROM</literal></title>
@@ -231,6 +321,21 @@
</varlistentry>
<varlistentry>
+ <term><replaceable class="parameter">with_query_name</replaceable></term>
+ <listitem>
+ <para>
+ A <literal>WITH</> query is referenced by writing its name,
+ just as though the query's name were a table name. (In fact,
+ the <literal>WITH</> query hides any real table of the same name
+ for the purposes of the primary query. If necessary, you can
+ refer to a real table of the same name by schema-qualifying
+ the table's name.)
+ An alias can be provided in the same way as for a table.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><replaceable class="parameter">nom_fonction</replaceable></term>
<listitem>
<para>
@@ -468,6 +573,100 @@
</para>
</refsect2>
+ <refsect2 id="SQL-WINDOW">
+ <title id="sql-window-title"><literal>WINDOW</literal> Clause</title>
+
+ <para>
+ The optional <literal>WINDOW</literal> clause has the general form
+<synopsis>
+WINDOW <replaceable class="parameter">window_name</replaceable> AS ( <replaceable class="parameter">window_definition</replaceable> ) [, ...]
+</synopsis>
+ where <replaceable class="parameter">window_name</replaceable> is
+ a name that can be referenced from subsequent window definitions or
+ <literal>OVER</> clauses, and
+ <replaceable class="parameter">window_definition</replaceable> is
+<synopsis>
+[ <replaceable class="parameter">existing_window_name</replaceable> ]
+[ PARTITION BY <replaceable class="parameter">expression</replaceable> [, ...] ]
+[ ORDER BY <replaceable class="parameter">expression</replaceable> [ ASC | DESC | USING <replaceable class="parameter">operator</replaceable> ] [ NULLS { FIRST | LAST } ] [, ...] ]
+[ <replaceable class="parameter">frame_clause</replaceable> ]
+</synopsis>
+ </para>
+
+ <para>
+ If an <replaceable class="parameter">existing_window_name</replaceable>
+ is specified it must refer to an earlier entry in the <literal>WINDOW</>
+ list; the new window copies its partitioning clause from that entry,
+ as well as its ordering clause if any. In this case the new window cannot
+ specify its own <literal>PARTITION BY</> clause, and it can specify
+ <literal>ORDER BY</> only if the copied window does not have one.
+ The new window always uses its own frame clause; the copied window
+ must not specify a frame clause.
+ </para>
+
+ <para>
+ The elements of the <literal>PARTITION BY</> list are interpreted in
+ the same fashion as elements of a
+ <xref linkend="sql-groupby" endterm="sql-groupby-title">, and
+ the elements of the <literal>ORDER BY</> list are interpreted in the
+ same fashion as elements of an
+ <xref linkend="sql-orderby" endterm="sql-orderby-title">.
+ The only difference is that these expressions can contain aggregate
+ function calls, which are not allowed in a regular <literal>GROUP BY</>
+ clause. They are allowed here because windowing occurs after grouping
+ and aggregation.
+ </para>
+
+ <para>
+ The optional <replaceable class="parameter">frame_clause</> defines
+ the <firstterm>window frame</> for window functions that depend on the
+ frame (not all do). It can be one of
+<synopsis>
+RANGE UNBOUNDED PRECEDING
+RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW
+RANGE BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
+ROWS UNBOUNDED PRECEDING
+ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW
+ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING
+</synopsis>
+ The first two are equivalent and are also the default: they set the
+ frame to be all rows from the partition start up through the current row's
+ last peer in the <literal>ORDER BY</> ordering (which means all rows if
+ there is no <literal>ORDER BY</>). The options
+ <literal>RANGE BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING</> and
+ <literal>ROWS BETWEEN UNBOUNDED PRECEDING AND UNBOUNDED FOLLOWING</>
+ are also equivalent: they always select all rows in the partition.
+ Lastly, <literal>ROWS UNBOUNDED PRECEDING</> or its verbose equivalent
+ <literal>ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW</> select
+ all rows up through the current row (regardless of duplicates).
+ Beware that this option can produce implementation-dependent results
+ if the <literal>ORDER BY</> ordering does not order the rows uniquely.
+ </para>
+
+ <para>
+ The purpose of a <literal>WINDOW</literal> clause is to specify the
+ behavior of <firstterm>window functions</> appearing in the query's
+ <xref linkend="sql-select-list" endterm="sql-select-list-title"> or
+ <xref linkend="sql-orderby" endterm="sql-orderby-title">. These functions
+ can reference the <literal>WINDOW</literal> clause entries by name
+ in their <literal>OVER</> clauses. A <literal>WINDOW</literal> clause
+ entry does not have to be referenced anywhere, however; if it is not
+ used in the query it is simply ignored. It is possible to use window
+ functions without any <literal>WINDOW</literal> clause at all, since
+ a window function call can specify its window definition directly in
+ its <literal>OVER</> clause. However, the <literal>WINDOW</literal>
+ clause saves typing when the same window definition is needed for more
+ than one window function.
+ </para>
+
+ <para>
+ Window functions are described in detail in
+ <xref linkend="tutorial-window">,
+ <xref linkend="syntax-window-functions">, and
+ <xref linkend="queries-window">.
+ </para>
+ </refsect2>
+
<refsect2 id="sql-select-list">
<title id="sql-select-list-title">Liste <command>SELECT</command></title>
@@ -476,22 +675,45 @@
<literal>SELECT</literal> et <literal>FROM</literal>) spécifie les expressions qui
forment les lignes en sortie de l'instruction <command>SELECT</command>.
Il se peut que les expressions fassent (en général elles le font) référence aux colonnes
- traitées dans la clause <literal>FROM</literal>. L'utilisation de la clause
- <literal>AS <replaceable class="parameter">nom_sortie</replaceable></literal>
- permet de modifier le nom d'une colonne en sortie. Ce nom est
- principalement utilisé pour l'affichage. Il
- peut aussi l'être pour référencer la valeur de la colonne dans les
- clauses <literal>ORDER BY</literal> et <literal>GROUP BY</literal>. Il ne peut
- en revanche pas être utilisé dans les clauses <literal>WHERE</literal> ou
- <literal>HAVING</literal> ; il faudra dans ce cas écrire les expressions.
+ traitées dans la clause <literal>FROM</literal>.
</para>
<para>
+ Just as in a table, every output column of a <command>SELECT</command>
+ has a name. In a simple <command>SELECT</command> this name is just
+ used to label the column for display, but when the <command>SELECT</>
+ is a sub-query of a larger query, the name is seen by the larger query
+ as the column name of the virtual table produced by the sub-query.
+ To specify the name to use for an output column, write
+ <literal>AS</> <replaceable class="parameter">output_name</replaceable>
+ after the column's expression. (You can omit <literal>AS</literal>,
+ but only if the desired output name does not match any
+ <productname>PostgreSQL</productname> keyword (see <xref
+ linkend="sql-keywords-appendix">). For protection against possible
+ future keyword additions, it is recommended that you always either
+ write <literal>AS</literal> or double-quote the output name.)
+ If you do not specify a column name, a name is chosen automatically
+ by <productname>PostgreSQL</productname>. If the column's expression
+ is a simple column reference then the chosen name is the same as that
+ column's name; in more complex cases a generated name looking like
+ <literal>?column<replaceable>N</>?</literal> is usually chosen.
+ </para>
+
+ <para>
+ An output column's name can be used to refer to the column's value in
+ <literal>ORDER BY</> and <literal>GROUP BY</> clauses, but not in the
+ <literal>WHERE</> or <literal>HAVING</> clauses; there you must write
+ out the expression instead.
+ </para>
+
+ <para>
<literal>*</literal> peut être utilisé, à la place d'une expression, dans la
liste de sortie comme raccourci pour toutes les colonnes des lignes
sélectionnées. De plus,
<literal><replaceable class="parameter">nom_table</replaceable>.*</literal>
- peut être écrit comme raccourci pour toutes les colonnes de cette table.
+ peut être écrit comme raccourci pour toutes les colonnes de cette table. In these
+ cases it is not possible to specify new names with <literal>AS</>;
+ the output column names will be the same as the table columns' names.
</para>
</refsect2>
@@ -719,9 +941,8 @@
</para>
<para>
- Les données de chaînes de caractères sont triées suivant
- l'ordre spécifique à la locale, ordre établi au moment de la création du
- groupe de bases de données.
+ Les données de chaînes de caractères sont triées suivant l'ordre spécifique
+ à la locale, ordre établi au moment de la création de la base de données.
</para>
</refsect2>
@@ -782,6 +1003,32 @@
</para>
<para>
+ If the <replaceable class="parameter">count</replaceable> expression
+ evaluates to NULL, it is treated as <literal>LIMIT ALL</>, i.e., no
+ limit. If <replaceable class="parameter">start</replaceable> evaluates
+ to NULL, it is treated the same as <literal>OFFSET 0</>.
+ </para>
+
+ <para>
+ SQL:2008 introduced a different syntax to achieve the same thing,
+ which PostgreSQL also supports. It is:
+<synopsis>
+OFFSET <replaceable class="parameter">start</replaceable> { ROW | ROWS }
+FETCH { FIRST | NEXT } [ <replaceable class="parameter">count</replaceable> ] { ROW | ROWS } ONLY
+</synopsis>
+ Both clauses are optional, but if present
+ the <literal>OFFSET</literal> clause must come before
+ the <literal>FETCH</literal> clause. <literal>ROW</literal>
+ and <literal>ROWS</literal> as well as <literal>FIRST</literal>
+ and <literal>NEXT</literal> are noise words that don't influence
+ the effects of these clauses. In this syntax, when using expressions
+ other than simple constants for <replaceable class="parameter">start</>
+ or <replaceable class="parameter">count</replaceable>, parentheses will be
+ necessary in most cases. If <replaceable class="parameter">count</> is
+ omitted in <literal>FETCH</>, it defaults to 1.
+ </para>
+
+ <para>
Avec <literal>LIMIT</literal>, utiliser la clause
<literal>ORDER BY</literal> permet de contraindre l'ordre des lignes de
résultat. Dans le cas contraire, le sous-ensemble obtenu n'est pas prévisible —
@@ -954,6 +1201,23 @@
</caution>
</refsect2>
+
+ <refsect2 id="SQL-TABLE">
+ <title><literal>TABLE</literal> Command</title>
+
+ <para>
+ The command
+<programlisting>
+TABLE <replaceable class="parameter">name</replaceable>
+</programlisting>
+ is completely equivalent to
+<programlisting>
+SELECT * FROM <replaceable class="parameter">name</replaceable>
+</programlisting>
+ It can be used as a top-level command or as a space-saving syntax
+ variant in parts of complex queries.
+ </para>
+ </refsect2>
</refsect1>
<refsect1>
@@ -1090,6 +1354,58 @@
111 | Walt Disney
</programlisting>
</para>
+
+ <para>
+ This example shows how to use a simple <literal>WITH</> clause:
+
+<programlisting>
+WITH t AS (
+ SELECT random() as x FROM generate_series(1, 3)
+ )
+SELECT * FROM t
+UNION ALL
+SELECT * FROM t
+
+ x
+--------------------
+ 0.534150459803641
+ 0.520092216785997
+ 0.0735620250925422
+ 0.534150459803641
+ 0.520092216785997
+ 0.0735620250925422
+</programlisting>
+
+ Notice that the <literal>WITH</> query was evaluated only once,
+ so that we got two sets of the same three random values.
+ </para>
+
+ <para>
+ This example uses <literal>WITH RECURSIVE</literal> to find all
+ subordinates (direct or indirect) of the employee Mary, and their
+ level of indirectness, from a table that shows only direct
+ subordinates:
+
+<programlisting>
+WITH RECURSIVE employee_recursive(distance, employee_name, manager_name) AS (
+ SELECT 1, employee_name, manager_name
+ FROM employee
+ WHERE manager_name = 'Mary'
+ UNION ALL
+ SELECT er.distance + 1, e.employee_name, e.manager_name
+ FROM employee_recursive er, employee e
+ WHERE er.employee_name = e.manager_name
+ )
+SELECT distance, employee_name FROM employee_recursive;
+</programlisting>
+
+ Notice the typical form of recursive queries:
+ an initial condition, followed by <literal>UNION</literal>,
+ followed by the recursive part of the query. Be sure that the
+ recursive part of the query will eventually return no tuples, or
+ else the query will loop indefinitely. (See <xref linkend="queries-with">
+ for more examples.)
+ </para>
</refsect1>
<refsect1>
@@ -1138,19 +1454,42 @@
</refsect2>
<refsect2>
- <title>Mot clé <literal>AS</literal></title>
+ <title>Omitting the <literal>AS</literal> Key Word</title>
<para>
- Dans le SQL standard, le mot clé <literal>AS</literal> est optionnel et
- peut être omis sans affecter la signification. L'analyseur
- <productname>PostgreSQL</productname> requiert ce mot clé lors du renommage
- des colonnes en sortie parce que les fonctionnalités d'extension de type
- créent des ambiguïtés d'analyse s'il est omis. <literal>AS</literal>
- est néanmoins optionnel pour les éléments <literal>FROM</literal>.
+ In the SQL standard, the optional key word <literal>AS</> can be
+ omitted before an output column name whenever the new column name
+ is a valid column name (that is, not the same as any reserved
+ keyword). <productname>PostgreSQL</productname> is slightly more
+ restrictive: <literal>AS</> is required if the new column name
+ matches any keyword at all, reserved or not. Recommended practice is
+ to use <literal>AS</> or double-quote output column names, to prevent
+ any possible conflict against future keyword additions.
</para>
+
+ <para>
+ In <literal>FROM</literal> items, both the standard and
+ <productname>PostgreSQL</productname> allow <literal>AS</> to
+ be omitted before an alias that is an unreserved keyword. But
+ this is impractical for output column names, because of syntactic
+ ambiguities.
+ </para>
</refsect2>
<refsect2>
+ <title><literal>ONLY</literal> and Parentheses</title>
+
+ <para>
+ The SQL standard requires parentheses around the table name
+ after <literal>ONLY</literal>, as in <literal>SELECT * FROM ONLY
+ (tab1), ONLY (tab2) WHERE ...</literal>. PostgreSQL supports that
+ as well, but the parentheses are optional. (This point applies
+ equally to all SQL commands supporting the <literal>ONLY</literal>
+ option.)
+ </para>
+ </refsect2>
+
+ <refsect2>
<title>Espace logique disponible pour <literal>GROUP BY</literal> et
<literal>ORDER BY</literal></title>
@@ -1177,12 +1516,40 @@
</refsect2>
<refsect2>
+ <title><literal>WINDOW</literal> Clause Restrictions</title>
+
+ <para>
+ The SQL standard provides additional options for the window
+ <replaceable class="parameter">frame_clause</>.
+ <productname>PostgreSQL</productname> currently supports only the
+ options listed above.
+ </para>
+ </refsect2>
+
+ <refsect2>
+ <title><literal>LIMIT</literal> and <literal>OFFSET</literal></title>
+
+ <para>
+ The clauses <literal>LIMIT</literal> and <literal>OFFSET</literal>
+ are <productname>PostgreSQL</productname>-specific syntax, also
+ used by <productname>MySQL</productname>. The SQL:2008 standard
+ has introduced the clauses <literal>OFFSET ... FETCH {FIRST|NEXT}
+ ...</literal> for the same functionality, as shown above
+ in <xref linkend="sql-limit" endterm="sql-limit-title">, and this
+ syntax is also used by <productname>IBM DB2</productname>.
+ (Applications written for <productname>Oracle</productname>
+ frequently use a workaround involving the automatically
+ generated <literal>rownum</literal> column, not available in
+ PostgreSQL, to implement the effects of these clauses.)
+ </para>
+ </refsect2>
+
+ <refsect2>
<title>Clauses non standard</title>
<para>
- Les clauses <literal>DISTINCT ON</literal>,
- <literal>LIMIT</literal> et <literal>OFFSET</literal> ne sont pas définies
- dans le standard SQL.
+ La clause <literal>DISTINCT ON</literal> n'est pas définie dans le standard
+ SQL.
</para>
</refsect2>
</refsect1>
Modified: traduc/trunk/postgresql/ref/select_into.xml
===================================================================
--- traduc/trunk/postgresql/ref/select_into.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/select_into.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-selectinto">
<refmeta>
<refentrytitle id="sql-selectinto-title">SELECT INTO</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -17,18 +18,21 @@
</refnamediv>
<refsynopsisdiv>
-<synopsis>SELECT [ ALL | DISTINCT [ ON ( <replaceable class="parameter">expression</replaceable> [, ...] ) ] ]
- * | <replaceable class="parameter">expression</replaceable> [ AS <replaceable class="parameter">nom_en_sortie</replaceable> ] [, ...]
+<synopsis>[ WITH [ RECURSIVE ] <replaceable class="parameter">with_query</replaceable> [, ...] ]
+SELECT [ ALL | DISTINCT [ ON ( <replaceable class="parameter">expression</replaceable> [, ...] ) ] ]
+ * | <replaceable class="parameter">expression</replaceable> [ [ AS ] <replaceable class="parameter">nom_en_sortie</replaceable> ] [, ...]
INTO [ TEMPORARY | TEMP ] [ TABLE ] <replaceable
class="parameter">nouvelle_table</replaceable>
[ FROM <replaceable class="parameter">élément_from</replaceable> [, ...] ]
[ WHERE <replaceable class="parameter">condition</replaceable> ]
[ GROUP BY <replaceable class="parameter">expression</replaceable> [, ...] ]
[ HAVING <replaceable class="parameter">condition</replaceable> [, ...] ]
+ [ WINDOW <replaceable class="parameter">window_name</replaceable> AS ( <replaceable class="parameter">window_definition</replaceable> ) [, ...] ]
[ { UNION | INTERSECT | EXCEPT } [ ALL ] <replaceable class="parameter">select</replaceable> ]
[ ORDER BY <replaceable class="parameter">expression</replaceable> [ ASC | DESC | USING <replaceable class="parameter">opérateur</replaceable> ] [, ...] ]
[ LIMIT { <replaceable class="parameter">nombre</replaceable> | ALL } ]
- [ OFFSET <replaceable class="parameter">début</replaceable> ]
+ [ OFFSET <replaceable class="parameter">début</replaceable> [ ROW | ROWS ] ]
+ [ FETCH { FIRST | NEXT } [ <replaceable class="parameter">count</replaceable> ] { ROW | ROWS } ONLY ]
[ FOR { UPDATE | SHARE } [ OF <replaceable class="parameter">nomtable</replaceable> [, ...] ] [ NOWAIT ] [...] ]
</synopsis>
</refsynopsisdiv>
Modified: traduc/trunk/postgresql/ref/set.xml
===================================================================
--- traduc/trunk/postgresql/ref/set.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/set.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-set">
<refmeta>
<refentrytitle id="sql-set-title">SET</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -159,6 +160,17 @@
<variablelist>
<varlistentry>
+ <term><literal>SCHEMA</literal></term>
+ <listitem>
+ <para>
+ <literal>SET SCHEMA '<replaceable>value</>'</> is an alias for
+ <literal>SET search_path TO <replaceable>value</></>. Only one
+ schema can be specified using this syntax.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><literal>NAMES</literal></term>
<listitem>
<para>
@@ -175,7 +187,7 @@
Précise la valeur interne du générateur de nombres aléatoires
(la fonction <function>random</function>).
Les valeurs autorisées sont des nombres à virgule flottante entre
- 0 et 1, qui sont ensuite multipliés par 2<superscript>31</superscript>-1.
+ -1 et 1, qui sont ensuite multipliés par 2<superscript>31</superscript>-1.
</para>
<para>
Modified: traduc/trunk/postgresql/ref/set_constraints.xml
===================================================================
--- traduc/trunk/postgresql/ref/set_constraints.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/set_constraints.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-set-constraints">
<refmeta>
<refentrytitle id="sql-set-constraints-title">SET CONSTRAINTS</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/set_role.xml
===================================================================
--- traduc/trunk/postgresql/ref/set_role.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/set_role.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-set-role">
<refmeta>
<refentrytitle id="sql-set-role-title">SET ROLE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -93,6 +94,13 @@
</para>
<para>
+ <command>SET ROLE</> does not process session variables as specified by
+ the role's <xref linkend="sql-alterrole"
+ endterm="sql-alterrole-title"> settings; this only happens during
+ login.
+ </para>
+
+ <para>
<command>SET ROLE</command> ne peut pas être utilisé dans une
fonction <literal>SECURITY DEFINER</literal>.
</para>
Modified: traduc/trunk/postgresql/ref/set_session_auth.xml
===================================================================
--- traduc/trunk/postgresql/ref/set_session_auth.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/set_session_auth.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-set-session-authorization">
<refmeta>
<refentrytitle id="sql-set-session-authorization-title">SET SESSION AUTHORIZATION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/set_transaction.xml
===================================================================
--- traduc/trunk/postgresql/ref/set_transaction.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/set_transaction.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-set-transaction">
<refmeta>
<refentrytitle id="sql-set-transaction-title">SET TRANSACTION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/show.xml
===================================================================
--- traduc/trunk/postgresql/ref/show.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/show.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-show">
<refmeta>
<refentrytitle id="sql-show-title">SHOW</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -84,7 +85,7 @@
Affiche la locale de la base de données pour le tri de
texte. À ce jour, ce paramètre est affichable mais pas
initialisé parce que la configuration est déterminée lors
- de l'exécution d'<command>initdb</command>.
+ de la création de la base de données.
</para>
</listitem>
</varlistentry>
@@ -96,7 +97,7 @@
Affiche la locale de la base de données pour la
classification des caractères. À ce jour, ce paramètre peut être
affiché mais pas initialisé parce que la configuration est déterminée
- lors de l'exécution d'<command>initdb</command>.
+ lors de la création de la base de données.
</para>
</listitem>
</varlistentry>
Modified: traduc/trunk/postgresql/ref/start_transaction.xml
===================================================================
--- traduc/trunk/postgresql/ref/start_transaction.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/start_transaction.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-start-transaction">
<refmeta>
<refentrytitle id="sql-start-transaction-title">START TRANSACTION</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/truncate.xml
===================================================================
--- traduc/trunk/postgresql/ref/truncate.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/truncate.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-truncate">
<refmeta>
<refentrytitle id="sql-truncate-title">TRUNCATE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -17,7 +18,8 @@
</refnamediv>
<refsynopsisdiv>
- <synopsis>TRUNCATE [ TABLE ] <replaceable class="parameter">nom</replaceable> [, ...] [ CASCADE | RESTRICT ]
+TRUNCATE [ TABLE ] [ ONLY ] <replaceable class="PARAMETER">nom</replaceable> [, ... ]
+ [ RESTART IDENTITY | CONTINUE IDENTITY ] [ CASCADE | RESTRICT ]
</synopsis>
</refsynopsisdiv>
@@ -46,12 +48,33 @@
<term><replaceable class="parameter">name</replaceable></term>
<listitem>
<para>
- Le nom d'une table à vider (peut être qualifié par le schéma).
+ Le nom d'une table à vider (peut être qualifié par le schéma). If <literal>ONLY</> is specified, only that table is
+ truncated. If <literal>ONLY</> is not specified, the table and
+ all its descendant tables (if any) are truncated.
</para>
</listitem>
</varlistentry>
<varlistentry>
+ <term><literal>RESTART IDENTITY</literal></term>
+ <listitem>
+ <para>
+ Automatically restart sequences owned by columns of
+ the truncated table(s).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><literal>CONTINUE IDENTITY</literal></term>
+ <listitem>
+ <para>
+ Do not change the values of sequences. This is the default.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><literal>CASCADE</literal></term>
<listitem>
<para>
@@ -67,7 +90,7 @@
<listitem>
<para>
Refuse le vidage si une des tables a des références de clés étrangères
- sur une table qui ne doit pas être vidée. Cette option est active par
+ sur une table qui ne sont pas listed in the command. Cette option est active par
défaut.
</para>
</listitem>
@@ -79,10 +102,18 @@
<title>Notes</title>
<para>
- Seul le propriétaire d'une table peut la vider (<command>TRUNCATE</command>).
+ You must have the <literal>TRUNCATE</literal> privilege on a table
+ to truncate it.
</para>
<para>
+ <command>TRUNCATE</> acquires an access exclusive lock on the
+ tables in operates on, which blocks all other concurrent operations
+ on the table. If concurrent access to a table is required, then
+ the <command>DELETE</> command should be used instead.
+ </para>
+
+ <para>
<command>TRUNCATE</command> ne peut pas être utilisé sur une table
référencée par d'autres tables au travers de clés étrangères, sauf si ces
tables sont aussi comprises dans la commande. Dans le cas contraire, la
@@ -95,8 +126,16 @@
</para>
<para>
- <command>TRUNCATE</command> n'exécutera aucun trigger <literal>ON
- DELETE</literal> qui pourrait exister sur les tables.
+ <command>TRUNCATE</command> ne déclenchera aucun trigger <literal>ON
+ DELETE</literal> qui pourrait exister sur les tables. But it will fire
+ <literal>ON TRUNCATE</literal> triggers.
+ If <literal>ON TRUNCATE</> triggers are defined for any of
+ the tables, then all <literal>BEFORE TRUNCATE</literal> triggers are
+ fired before any truncation happens, and all <literal>AFTER
+ TRUNCATE</literal> triggers are fired after the last truncation is
+ performed. The triggers will fire in the order that the tables are
+ to be processed (first those listed in the command, and then any
+ that were added due to cascading).
</para>
<warning>
@@ -121,6 +160,39 @@
cours n'est pas validée.
</para>
</warning>
+
+ <para>
+ <command>TRUNCATE</> is transaction-safe with respect to the data
+ in the tables: the truncation will be safely rolled back if the surrounding
+ transaction does not commit.
+ </para>
+
+ <warning>
+ <para>
+ Any <command>ALTER SEQUENCE RESTART</> operations performed as a
+ consequence of using the <literal>RESTART IDENTITY</> option are
+ nontransactional and will not be rolled back on failure. To minimize
+ the risk, these operations are performed only after all the rest of
+ <command>TRUNCATE</>'s work is done. However, there is still a risk
+ if <command>TRUNCATE</> is performed inside a transaction block that is
+ aborted afterwards. For example, consider
+
+<programlisting>
+BEGIN;
+TRUNCATE TABLE foo RESTART IDENTITY;
+COPY foo FROM ...;
+COMMIT;
+</programlisting>
+
+ If the <command>COPY</> fails partway through, the table data
+ rolls back correctly, but the sequences will be left with values
+ that are probably smaller than they had before, possibly leading
+ to duplicate-key failures or other problems in later transactions.
+ If this is likely to be a problem, it's best to avoid using
+ <literal>RESTART IDENTITY</>, and accept that the new contents of
+ the table will have higher serial numbers than the old.
+ </para>
+ </warning>
</refsect1>
<refsect1>
@@ -135,6 +207,14 @@
</para>
<para>
+ The same, and also reset any associated sequence generators:
+
+<programlisting>
+TRUNCATE bigtable, fattable RESTART IDENTITY;
+</programlisting>
+ </para>
+
+ <para>
Vide la table <literal>uneautretable</literal>, et cascade cela à toutes
les tables qui référencent <literal>uneautretable</literal> via des
contraintes de clés étrangères :
@@ -149,7 +229,13 @@
<title>Compatibilité</title>
<para>
- Il n'existe pas de commande <command>TRUNCATE</command> dans le standard SQL.
+ The SQL:2008 standard includes a <command>TRUNCATE</command> command with the syntax
+ <literal>TRUNCATE TABLE <replaceable>tablename</replaceable></literal>.
+ The clauses <literal>CONTINUE IDENTITY</literal>/<literal>RESTART IDENTITY</literal>
+ also appear in that standard but have slightly different but related meanings.
+ Some of the concurrency behavior of this command is left implementation-defined
+ by the standard, so the above notes should be considered and compared with
+ other implementations if necessary.
</para>
</refsect1>
</refentry>
Modified: traduc/trunk/postgresql/ref/unlisten.xml
===================================================================
--- traduc/trunk/postgresql/ref/unlisten.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/unlisten.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-unlisten">
<refmeta>
<refentrytitle id="sql-unlisten-title">UNLISTEN</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
Modified: traduc/trunk/postgresql/ref/update.xml
===================================================================
--- traduc/trunk/postgresql/ref/update.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/update.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -10,6 +10,7 @@
<refentry id="sql-update">
<refmeta>
<refentrytitle id="sql-update-title">UPDATE</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -24,7 +25,7 @@
( <replaceable class="parameter">colonne</replaceable> [, ...] ) = ( { <replaceable class="parameter">expression</replaceable> | DEFAULT } [, ...] ) } [, ...]
[ FROM <replaceable class="parameter">liste_from</replaceable> ]
[ WHERE <replaceable class="parameter">condition</replaceable> | WHERE CURRENT OF <replaceable class="parameter">cursor_name</replaceable> ]
- [ RETURNING * | <replaceable class="parameter">expression_sortie</replaceable> [ AS <replaceable class="parameter">nom_sortie</replaceable> ] [, ...] ]
+ [ RETURNING * | <replaceable class="parameter">expression_sortie</replaceable> [ [ AS ] <replaceable class="parameter">nom_sortie</replaceable> ] [, ...] ]
</synopsis>
</refsynopsisdiv>
@@ -68,9 +69,10 @@
</para>
<para>
- L'utilisateur doit posséder le droit <literal>UPDATE</literal> sur la table pour
- la mettre à jour, ainsi que le droit <literal>SELECT</literal> sur toutes les
- tables dont les valeurs sont lues dans les
+ L'utilisateur doit posséder le droit <literal>UPDATE</literal> sur la table,
+ or at least on the column(s) that are listed to be updated.
+ You must also have the droit <literal>SELECT</literal> sur toutes les
+ colonnes dont les valeurs sont lues dans les
<replaceable class="parameter">expression</replaceable>s ou
<replaceable class="parameter">condition</replaceable>.
</para>
@@ -169,10 +171,13 @@
<para>
Le nom du curseur à utiliser dans une condition <literal>WHERE CURRENT
OF</literal>. La ligne à mettre à jour est la dernière récupérée à
- partir de ce curseur. Le curseur doit être une requête simple (sans
- jointure, sans agrégat) sur la table cible de l'<command>UPDATE</command>.
+ partir de ce curseur. Le curseur doit être une requête sans regroupement
+ sur la table cible de l'<command>UPDATE</command>.
Notez que <literal>WHERE CURRENT OF</literal> ne peut pas être
- spécifié avec une condition booléenne.
+ spécifié avec une condition booléenne. See
+ <xref linkend="sql-declare" endterm="sql-declare-title">
+ for more information about using cursors with
+ <literal>WHERE CURRENT OF</>.
</para>
</listitem>
</varlistentry>
Modified: traduc/trunk/postgresql/ref/vacuum.xml
===================================================================
--- traduc/trunk/postgresql/ref/vacuum.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/vacuum.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -8,6 +8,7 @@
<refentry id="sql-vacuum">
<refmeta>
<refentrytitle id="sql-vacuum-title">VACUUM</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -45,7 +46,8 @@
<para>
Sans paramètre, <command>VACUUM</command> traite toutes les tables de la
- base de données courante. Avec un paramètre, <command>VACUUM</command>
+ base de données courante that the current user has permission to vacuum.
+ Avec un paramètre, <command>VACUUM</command>
ne traite que cette table.
</para>
@@ -104,10 +106,6 @@
<listitem>
<para>
Affiche un rapport détaillé de l'activité de vacuum sur chaque table.
- Peut être utilisé pour aider à déterminer le paramètrage approprié
- pour <xref linkend="guc-max-fsm-pages"/>,
- <xref linkend="guc-max-fsm-relations"/> et
- <xref linkend="guc-default-statistics-target"/>.
</para>
</listitem>
</varlistentry>
@@ -161,11 +159,28 @@
<title>Notes</title>
<para>
+ To vacuum a table, one must ordinarily be the table's owner or a
+ superuser. However, database owners are allowed to
+ vacuum all tables in their databases, except shared catalogs.
+ (The restriction for shared catalogs means that a true database-wide
+ <command>VACUUM</> can only be performed by a superuser.)
+ <command>VACUUM</> will skip over any tables that the calling user
+ does not have permission to vacuum.
+ </para>
+
+ <para>
<command>VACUUM</command> ne peut pas être exécuté à l'intérieur
d'un bloc de transactions.
</para>
<para>
+ For tables with <acronym>GIN</> indexes, <command>VACUUM</command> (in
+ any form) also completes any pending index insertions, by moving pending
+ index entries to the appropriate places in the main <acronym>GIN</> index
+ structure. See <xref linkend="gin-fast-update"> for details.
+ </para>
+
+ <para>
Nous recommandons que les bases de données actives de production soient
traitées par vacuum fréquemment (au moins toutes les nuits), pour supprimer
les lignes mortes. Après avoir ajouté ou supprimé un grand nombre de
Modified: traduc/trunk/postgresql/ref/vacuumdb.xml
===================================================================
--- traduc/trunk/postgresql/ref/vacuumdb.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/vacuumdb.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -25,6 +25,7 @@
<group><arg>--full</arg><arg>-f</arg></group>
<group><arg>--verbose</arg><arg>-v</arg></group>
<group><arg>--analyze</arg><arg>-z</arg></group>
+ <group><arg>--freeze</arg><arg>-F</arg></group>
<arg>--table | -t <replaceable>table</replaceable>
<arg>( <replaceable class="parameter">colonne</replaceable> [,...] )</arg>
</arg>
@@ -36,6 +37,7 @@
<group><arg>--full</arg><arg>-f</arg></group>
<group><arg>--verbose</arg><arg>-v</arg></group>
<group><arg>--analyze</arg><arg>-z</arg></group>
+ <group><arg>--freeze</arg><arg>-F</arg></group>
</cmdsynopsis>
</refsynopsisdiv>
@@ -164,6 +166,16 @@
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><option>-F</option></term>
+ <term><option>--freeze</option></term>
+ <listitem>
+ <para>
+ Aggressively <quote>freeze</quote> tuples.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
@@ -207,6 +219,21 @@
</varlistentry>
<varlistentry>
+ <term><option>-w</></term>
+ <term><option>--no-password</></term>
+ <listitem>
+ <para>
+ Never issue a password prompt. If the server requires
+ password authentication and a password is not available by
+ other means such as a <filename>.pgpass</filename> file, the
+ connection attempt will fail. This option can be useful in
+ batch jobs and scripts where no user is present to enter a
+ password.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>-W</option></term>
<term><option>--password</option></term>
<listitem>
Modified: traduc/trunk/postgresql/ref/values.xml
===================================================================
--- traduc/trunk/postgresql/ref/values.xml 2009-04-12 20:28:19 UTC (rev 1292)
+++ traduc/trunk/postgresql/ref/values.xml 2009-04-13 15:20:17 UTC (rev 1293)
@@ -7,6 +7,7 @@
<refentry id="sql-values">
<refmeta>
<refentrytitle id="sql-values-title">VALUES</refentrytitle>
+ <manvolnum>7</manvolnum>
<refmiscinfo>SQL - Instructions du langage</refmiscinfo>
</refmeta>
@@ -25,7 +26,8 @@
VALUES ( <replaceable class="parameter">expression</replaceable> [, ...] ) [, ...]
[ ORDER BY <replaceable class="parameter">expression_de_tri</replaceable> [ ASC | DESC | USING <replaceable class="parameter">operateur</replaceable> ] [, ...] ]
[ LIMIT { <replaceable class="parameter">nombre</replaceable> | ALL } ]
- [ OFFSET <replaceable class="parameter">debut</replaceable> ]
+ [ OFFSET <replaceable class="parameter">debut</replaceable> ] [ ROW | ROWS ] ]
+ [ FETCH { FIRST | NEXT } [ <replaceable class="parameter">count</replaceable> ] { ROW | ROWS } ONLY ]
</synopsis>
</refsynopsisdiv>
@@ -52,7 +54,8 @@
au niveau de la syntaxe partout où la commande <command>SELECT</command>
l'est. Comme la grammaire traite cette commande comme un
<command>SELECT</command>, il est possible d'utiliser les clauses
- <literal>ORDER BY</literal>, <literal>LIMIT</literal> et
+ <literal>ORDER BY</literal>, <literal>LIMIT</literal> (or
+ equivalently <literal>FETCH FIRST</literal>) et
<literal>OFFSET</literal> avec une commande <command>VALUES</command>.
</para>
</refsect1>
@@ -241,9 +244,10 @@
<title>Compatibilité</title>
<para>
- <command>VALUES</command> est conforme au standard SQL, sauf en ce qui
- concerne les clauses <literal>LIMIT</literal> et <literal>OFFSET</literal>
- qui sont des extensions <productname>PostgreSQL</productname>.
+ <command>VALUES</command> est conforme au standard SQL. Les clauses
+ <literal>LIMIT</literal> et <literal>OFFSET</literal> sont des extensions
+ <productname>PostgreSQL</productname> ; voir aussi <xref
+ linkend="sql-select" endterm="sql-select-title">.
</para>
</refsect1>
More information about the Trad
mailing list