Traduction de la page ALTER EXTENSION

postgresql/ref/alter_extension.xml

@@ -7,13 +7,13 @@ PostgreSQL documentation
  <refmeta>
   <refentrytitle>ALTER EXTENSION</refentrytitle>
   <manvolnum>7</manvolnum>
-  <refmiscinfo>SQL - Language Statements</refmiscinfo>
+  <refmiscinfo>SQL - Instructions de langage</refmiscinfo>
  </refmeta>
 
  <refnamediv>
   <refname>ALTER EXTENSION</refname>
   <refpurpose>
-   change the definition of an extension
+   modifie la définition d'une extension
   </refpurpose>
  </refnamediv>
 
@@ -23,53 +23,53 @@ PostgreSQL documentation
 
  <refsynopsisdiv>
 <synopsis>
-ALTER EXTENSION <replaceable class="PARAMETER">extension_name</replaceable> UPDATE [ TO <replaceable class="PARAMETER">new_version</replaceable> ]
-ALTER EXTENSION <replaceable class="PARAMETER">extension_name</replaceable> SET SCHEMA <replaceable class="PARAMETER">new_schema</replaceable>
-ALTER EXTENSION <replaceable class="PARAMETER">extension_name</replaceable> ADD <replaceable class="PARAMETER">member_object</replaceable>
-ALTER EXTENSION <replaceable class="PARAMETER">extension_name</replaceable> DROP <replaceable class="PARAMETER">member_object</replaceable>
-
-<phrase>where <replaceable class="PARAMETER">member_object</replaceable> is:</phrase>
-
-  AGGREGATE <replaceable class="PARAMETER">agg_name</replaceable> (<replaceable class="PARAMETER">agg_type</replaceable> [, ...] ) |
-  CAST (<replaceable>source_type</replaceable> AS <replaceable>target_type</replaceable>) |
-  COLLATION <replaceable class="PARAMETER">object_name</replaceable> |
-  CONVERSION <replaceable class="PARAMETER">object_name</replaceable> |
-  DOMAIN <replaceable class="PARAMETER">object_name</replaceable> |
-  FOREIGN DATA WRAPPER <replaceable class="PARAMETER">object_name</replaceable> |
-  FOREIGN TABLE <replaceable class="PARAMETER">object_name</replaceable> |
-  FUNCTION <replaceable class="PARAMETER">function_name</replaceable> ( [ [ <replaceable class="parameter">argmode</replaceable> ] [ <replaceable class="parameter">argname</replaceable> ] <replaceable class="parameter">argtype</replaceable> [, ...] ] ) |
-  OPERATOR <replaceable class="PARAMETER">operator_name</replaceable> (<replaceable class="PARAMETER">left_type</replaceable>, <replaceable class="PARAMETER">right_type</replaceable>) |
-  OPERATOR CLASS <replaceable class="PARAMETER">object_name</replaceable> USING <replaceable class="parameter">index_method</replaceable> |
-  OPERATOR FAMILY <replaceable class="PARAMETER">object_name</replaceable> USING <replaceable class="parameter">index_method</replaceable> |
-  [ PROCEDURAL ] LANGUAGE <replaceable class="PARAMETER">object_name</replaceable> |
-  SCHEMA <replaceable class="PARAMETER">object_name</replaceable> |
-  SEQUENCE <replaceable class="PARAMETER">object_name</replaceable> |
-  SERVER <replaceable class="PARAMETER">object_name</replaceable> |
-  TABLE <replaceable class="PARAMETER">object_name</replaceable> |
-  TEXT SEARCH CONFIGURATION <replaceable class="PARAMETER">object_name</replaceable> |
-  TEXT SEARCH DICTIONARY <replaceable class="PARAMETER">object_name</replaceable> |
-  TEXT SEARCH PARSER <replaceable class="PARAMETER">object_name</replaceable> |
-  TEXT SEARCH TEMPLATE <replaceable class="PARAMETER">object_name</replaceable> |
-  TYPE <replaceable class="PARAMETER">object_name</replaceable> |
-  VIEW <replaceable class="PARAMETER">object_name</replaceable>
+ALTER EXTENSION <replaceable class="PARAMETER">nom_extension</replaceable> UPDATE [ TO <replaceable class="PARAMETER">nouvelle_version</replaceable> ]
+ALTER EXTENSION <replaceable class="PARAMETER">nom_extension</replaceable> SET SCHEMA <replaceable class="PARAMETER">nouveau_schéma</replaceable>
+ALTER EXTENSION <replaceable class="PARAMETER">nom_extension</replaceable> ADD <replaceable class="PARAMETER">objet_membre</replaceable>
+ALTER EXTENSION <replaceable class="PARAMETER">nom_extension</replaceable> DROP <replaceable class="PARAMETER">objet_membre</replaceable>
+
+<phrase>où <replaceable class="PARAMETER">objet_membre</replaceable> peut être&nbsp;:</phrase>
+
+  AGGREGATE <replaceable class="PARAMETER">nom_agg</replaceable> (<replaceable class="PARAMETER">type_agg</replaceable> [, ...] ) |
+  CAST (<replaceable>type_source</replaceable> AS <replaceable>type_cible</replaceable>) |
+  COLLATION <replaceable class="PARAMETER">nom_objet</replaceable> |
+  CONVERSION <replaceable class="PARAMETER">nom_objet</replaceable> |
+  DOMAIN <replaceable class="PARAMETER">nom_objet</replaceable> |
+  FOREIGN DATA WRAPPER <replaceable class="PARAMETER">nom_objet</replaceable> |
+  FOREIGN TABLE <replaceable class="PARAMETER">nom_objet</replaceable> |
+  FUNCTION <replaceable class="PARAMETER">nom_fonction</replaceable> ( [ [ <replaceable class="parameter">mode_arg</replaceable> ] [ <replaceable class="parameter">nom_arg</replaceable> ] <replaceable class="parameter">type_arg</replaceable> [, ...] ] ) |
+  OPERATOR <replaceable class="PARAMETER">nom_opérateur</replaceable> (<replaceable class="PARAMETER">type_gauche</replaceable>, <replaceable class="PARAMETER">type_droit</replaceable>) |
+  OPERATOR CLASS <replaceable class="PARAMETER">nom_objet</replaceable> USING <replaceable class="parameter">méthode_indexage</replaceable> |
+  OPERATOR FAMILY <replaceable class="PARAMETER">nom_objet</replaceable> USING <replaceable class="parameter">méthode_indexage</replaceable> |
+  [ PROCEDURAL ] LANGUAGE <replaceable class="PARAMETER">nom_objet</replaceable> |
+  SCHEMA <replaceable class="PARAMETER">nom_objet</replaceable> |
+  SEQUENCE <replaceable class="PARAMETER">nom_objet</replaceable> |
+  SERVER <replaceable class="PARAMETER">nom_objet</replaceable> |
+  TABLE <replaceable class="PARAMETER">nom_objet</replaceable> |
+  TEXT SEARCH CONFIGURATION <replaceable class="PARAMETER">nom_objet</replaceable> |
+  TEXT SEARCH DICTIONARY <replaceable class="PARAMETER">nom_objet</replaceable> |
+  TEXT SEARCH PARSER <replaceable class="PARAMETER">nom_objet</replaceable> |
+  TEXT SEARCH TEMPLATE <replaceable class="PARAMETER">nom_objet</replaceable> |
+  TYPE <replaceable class="PARAMETER">nom_objet</replaceable> |
+  VIEW <replaceable class="PARAMETER">nom_objet</replaceable>
 </synopsis>
  </refsynopsisdiv>
 
  <refsect1>
   <title>Description</title>
 
   <para>
-   <command>ALTER EXTENSION</command> changes the definition of an installed
-   extension.  There are several subforms:
+   <command>ALTER EXTENSION</command> modifie la définition d'une extension.
+   Il existe plusieurs variantes&nbsp;:
 
    <variablelist>
    <varlistentry>
     <term><literal>UPDATE</literal></term>
     <listitem>
      <para>
-      This form updates the extension to a newer version.  The extension
-      must supply a suitable update script (or series of scripts) that can
-      modify the currently-installed version into the requested version.
+	  Met à jour l'extension avec une nouvelle version. L'extension doit
+	  fournir le script de mise à jour adéquat (voire un ensemble de scripts)
+	  qui peut modifier la version en cours vers la version demandée.
      </para>
     </listitem>
    </varlistentry>
@@ -78,165 +78,167 @@ ALTER EXTENSION <replaceable class="PARAMETER">extension_name</replaceable> DROP
     <term><literal>SET SCHEMA</literal></term>
     <listitem>
      <para>
-      This form moves the extension's objects into another schema. The
-      extension has to be <firstterm>relocatable</firstterm> for this command to
-      succeed.
+	  Déplace les objets de l'extension vers un autre schéma. 
+	  L'extension doit permettre que ses objets soient déplacés pour que cette
+	  commande fonctionne.
      </para>
     </listitem>
    </varlistentry>
 
    <varlistentry>
-    <term><literal>ADD <replaceable class="PARAMETER">member_object</replaceable></literal></term>
+    <term><literal>ADD <replaceable class="PARAMETER">objet_membre</replaceable></literal></term>
     <listitem>
      <para>
-      This form adds an existing object to the extension.  This is mainly
-      useful in extension update scripts.  The object will subsequently
-      be treated as a member of the extension; notably, it can only be
-      dropped by dropping the extension.
+	  Ajoute un objet existant à l'extension. Cette commande est utilisée
+	  principalement dans les scripts de mise à jour d'extensions. L'objet
+	  concerné sera alors considéré comme appartenant à l'extension.
+	  Cela signifie principalement que l'objet ne pourra être supprimé qu'en
+      supprimant l'extension.
      </para>
     </listitem>
    </varlistentry>
 
    <varlistentry>
-    <term><literal>DROP <replaceable class="PARAMETER">member_object</replaceable></literal></term>
+    <term><literal>DROP <replaceable class="PARAMETER">objet_membre</replaceable></literal></term>
     <listitem>
      <para>
-      This form removes a member object from the extension.  This is mainly
-      useful in extension update scripts.  The object is not dropped, only
-      disassociated from the extension.
+	  Supprime un objet de l'extension. Cette commande est utilisée principalement
+	  dans les scripts de mise à jour d'extensions. L'objet n'est pas supprimé&nbsp;: il 
+	  n'appartient simplement plus à l'extension.
      </para>
     </listitem>
    </varlistentry>
    </variablelist>
 
-   See <xref linkend="extend-extensions"/> for more information about these
-   operations.
+   Voir aussi <xref linkend="extend-extensions"/> pour des informations complémentaires
+   sur les extensions.
   </para>
 
   <para>
-   You must own the extension to use <command>ALTER EXTENSION</command>.
-   The <literal>ADD</literal>/<literal>DROP</literal> forms require ownership of the
-   added/dropped object as well.
+   Seul le propriétaire de l'extension peut utiliser la commande <command>ALTER EXTENSION</command>
+   pour supprimer l'extension.
+   Les options <literal>ADD</literal> ou <literal>DROP</literal> nécessitent en complément d'être le propriétaire
+   de l'objet concerné par l'ajout ou la suppression.
   </para>
  </refsect1>
 
  <refsect1>
-  <title>Parameters</title>
+  <title>Paramètres</title>
 
   <para>
    <variablelist>
     <varlistentry>
-     <term><replaceable class="PARAMETER">extension_name</replaceable></term>
+     <term><replaceable class="PARAMETER">nom_extension</replaceable></term>
      <listitem>
       <para>
-       The name of an installed extension.
+	   Le nom de l'extension concernée.
       </para>
      </listitem>
     </varlistentry>
 
     <varlistentry>
-     <term><replaceable class="PARAMETER">new_version</replaceable></term>
+     <term><replaceable class="PARAMETER">nouvelle_version</replaceable></term>
      <listitem>
       <para>
-       The desired new version of the extension.  This can be written as
-       either an identifier or a string literal.  If not specified,
-       <command>ALTER EXTENSION UPDATE</command> attempts to update to whatever is
-       shown as the default version in the extension's control file.
+	   La nouvelle version de l'extension à installer. Il peut autant s'agir d'un identifiant
+	   que d'une chaîne de caractère. Si cette version n'est pas spécifiée, la commande
+	   <command>ALTER EXTENSION UPDATE</command> va utiliser tous les éléments de la 
+	   version par défaut mentionnés dans le fichier de contrôle de l'extension.
       </para>
      </listitem>
     </varlistentry>
 
     <varlistentry>
-     <term><replaceable class="PARAMETER">new_schema</replaceable></term>
+     <term><replaceable class="PARAMETER">nouveau_schéma</replaceable></term>
      <listitem>
       <para>
-       The new schema for the extension.
+       Le nouveau schéma vers lequel déplacer l'extension.
       </para>
      </listitem>
     </varlistentry>
 
     <varlistentry>
-     <term><replaceable class="parameter">object_name</replaceable></term>
-     <term><replaceable class="parameter">agg_name</replaceable></term>
-     <term><replaceable class="parameter">function_name</replaceable></term>
-     <term><replaceable class="parameter">operator_name</replaceable></term>
+     <term><replaceable class="parameter">nom_objet</replaceable></term>
+     <term><replaceable class="parameter">nom_agg</replaceable></term>
+     <term><replaceable class="parameter">nom_fonction</replaceable></term>
+     <term><replaceable class="parameter">nom_opérateur</replaceable></term>
      <listitem>
       <para>
-       The name of an object to be added to or removed from the extension.
-       Names of tables,
-       aggregates, domains, foreign tables, functions, operators,
-       operator classes, operator families, sequences, text search objects,
-       types, and views can be schema-qualified.
+	   Le nom d'un objet qui sera ajouté ou retiré de l'extension.
+	   Les noms de tables, aggrégats, domaines, tables distantes, fonctions,
+	   opérateurs, classes d'opérateurs, familles d'opérateurs, séquences, 
+	   objets de recherche de texte, types et vues peuvent être qualifiés
+	   du nom du schéma.
       </para>
      </listitem>
     </varlistentry>
 
     <varlistentry>
-     <term><replaceable class="parameter">agg_type</replaceable></term>
+     <term><replaceable class="parameter">type_agg</replaceable></term>
      <listitem>
       <para>
-       An input data type on which the aggregate function operates.
-       To reference a zero-argument aggregate function, write <literal>*</literal>
-       in place of the list of input data types.
+	   Un type de donnée paramètres de la fonction d'aggrégat concerné.
+	   La syntaxe <literal>*</literal> peut être utilisée pour
+	   les fonctions d'aggrégat sans paramètres.
       </para>
      </listitem>
     </varlistentry>
 
     <varlistentry>
-     <term><replaceable>source_type</replaceable></term>
+     <term><replaceable>type_source</replaceable></term>
      <listitem>
       <para>
-       The name of the source data type of the cast.
+	   Le nom d'un type de données source d'un transtypage.
       </para>
      </listitem>
     </varlistentry>
 
     <varlistentry>
-     <term><replaceable>target_type</replaceable></term>
+     <term><replaceable>type_cible</replaceable></term>
      <listitem>
       <para>
-       The name of the target data type of the cast.
+	   Le nom du type de donnée cible d'un transtypage.
       </para>
      </listitem>
     </varlistentry>
 
     <varlistentry>
-     <term><replaceable class="parameter">argmode</replaceable></term>
+     <term><replaceable class="parameter">mode_arg</replaceable></term>
 
      <listitem>
       <para>
-       The mode of a function argument: <literal>IN</literal>, <literal>OUT</literal>,
-       <literal>INOUT</literal>, or <literal>VARIADIC</literal>.
-       If omitted, the default is <literal>IN</literal>.
-       Note that <command>ALTER EXTENSION</command> does not actually pay
-       any attention to <literal>OUT</literal> arguments, since only the input
-       arguments are needed to determine the function's identity.
-       So it is sufficient to list the <literal>IN</literal>, <literal>INOUT</literal>,
-       and <literal>VARIADIC</literal> arguments.
+	   Le mode du paramètre d'une méthode&nbsp;: <literal>IN</literal>, <literal>OUT</literal>,
+	   <literal>INOUT</literal> ou <literal>VARIADIC</literal>.
+	   La valeur par défaut est <literal>IN</literal>.
+	   Notez que la commande <command>ALTER EXTENSION</command> ne tient en réalité pas compte
+	   des paramètres dont le mode est <literal>OUT</literal>, car les paramètres
+	   en entrée sont suffisants pour déterminer la signature de la fonction.
+	   Il est ainsi possible de ne spécifier que les paramètres de mode <literal>IN</literal>,
+	   <literal>INOUT</literal> et <literal>VARIADIC</literal>.
       </para>
      </listitem>
     </varlistentry>
 
     <varlistentry>
-     <term><replaceable class="parameter">argname</replaceable></term>
+     <term><replaceable class="parameter">nom_arg</replaceable></term>
 
      <listitem>
       <para>
-       The name of a function argument.
-       Note that <command>ALTER EXTENSION</command> does not actually pay
-       any attention to argument names, since only the argument data
-       types are needed to determine the function's identity.
+	   Le nom du paramètre de la méthode concernée.
+	   Notez que la commande <command>ALTER EXTENSION</command> ne tient pas
+	   compte en réalité des noms de paramètre, car les types de données
+	   sont suffisants pour déterminer la signature de la méthode.
       </para>
      </listitem>
     </varlistentry>
 
     <varlistentry>
-     <term><replaceable class="parameter">argtype</replaceable></term>
+     <term><replaceable class="parameter">type_arg</replaceable></term>
 
      <listitem>
       <para>
-       The data type(s) of the function's arguments (optionally
-       schema-qualified), if any.
+	   Le(s) type(s) de donnée des paramètres de la méthode concernée (éventuellement qualifié du
+	   nom du schéma).
       </para>
      </listitem>
     </varlistentry>
@@ -246,7 +248,8 @@ ALTER EXTENSION <replaceable class="PARAMETER">extension_name</replaceable> DROP
 
      <listitem>
       <para>
-       This is a noise word.
+       Le mot clé <literal>PROCEDURAL</literal> n'est pas nécessaire. Il peut
+       être omis.
       </para>
      </listitem>
     </varlistentry>
@@ -255,33 +258,35 @@ ALTER EXTENSION <replaceable class="PARAMETER">extension_name</replaceable> DROP
  </refsect1>
 
  <refsect1>
-  <title>Examples</title>
+  <title>Exemples</title>
 
   <para>
-   To update the <literal>hstore</literal> extension to version 2.0:
+   Pour mettre à jour l'extension <literal>hstore</literal> à la version
+   2.0&nbsp;:
 <programlisting>
 ALTER EXTENSION hstore UPDATE TO '2.0';
 </programlisting>
   </para>
 
   <para>
-   To change the schema of the <literal>hstore</literal> extension
-   to <literal>utils</literal>:
+   Pour modifier le schéma de l'extension <literal>hstore</literal> vers
+   <literal>utils</literal>&nbsp;:
 <programlisting>
 ALTER EXTENSION hstore SET SCHEMA utils;
 </programlisting>
   </para>
 
   <para>
-   To add an existing function to the <literal>hstore</literal> extension:
+   Pour ajouter une procédure stockée existante à l'extension
+   <literal>hstore</literal>&nbsp;:
 <programlisting>
 ALTER EXTENSION hstore ADD FUNCTION populate_record(anyelement, hstore);
 </programlisting>
   </para>
  </refsect1>
 
  <refsect1 id="SQL-ALTEREXTENSION-see-also">
-  <title>See Also</title>
+  <title>Voir aussi</title>
 
   <simplelist type="inline">
    <member><xref linkend="sql-createextension"/></member>