db2-table-privileges.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 871b71764cdca8238069f27436d96011a6a2cb36 Maintainer: jsgoupil Status: ready -->
<!-- Reviewed: no -->

<refentry xml:id="function.db2-table-privileges" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>db2_table_privileges</refname>
  <refpurpose>
   Retourne un jeu de résultats listant les tables et leurs privilèges
   qui leur sont associées d'une base de données
  </refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>db2_table_privileges</methodname>
   <methodparam><type>resource</type><parameter>connection</parameter></methodparam>
   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>qualifier</parameter><initializer>&null;</initializer></methodparam>
   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>schema</parameter><initializer>&null;</initializer></methodparam>
   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>table_name</parameter><initializer>&null;</initializer></methodparam>
  </methodsynopsis>

  <para>
   Retourne un jeu de résultats listant les tables et leurs privilèges
   qui leur sont associées d'une base de données.
  </para>

 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>connection</parameter></term>
     <listitem>
      <para>
       Une connexion valide à une base de données IBM DB2, Cloudscape ou
       Apache Derby.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>qualifier</parameter></term>
     <listitem>
      <para>
       Un qualificatif pour les bases de données DB2 qui fonctionnent sur
       les serveurs OS/390 ou z/OS. Pour les autres bases de données,
       passez &null; ou une chaîne vide.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>schema</parameter></term>
     <listitem>
      <para>
       Le schéma qui contient les tables. Le paramètre accepte les formes
       contenant <literal>_</literal> et <literal>%</literal> en tant que mot
       clé.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>table-name</parameter></term>
     <listitem>
      <para>
       Le nom de la table. Le paramètre accepte les formes
       contenant <literal>_</literal> et <literal>%</literal> en tant que mot
       clé.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Retourne une ressource avec le jeu de résultats contenant les lignes qui
   décrient les privilèges pour la table qui concordent avec les paramètres spécifiés. Les
   lignes sont composées des colonnes suivantes :
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Nom de la colonne</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>TABLE_CAT</entry>
       <entry>Nom du catalogue que contient la table.
       La valeur est &null; si la table n'a pas de catalogue.</entry>
      </row>
      <row>
       <entry>TABLE_SCHEM</entry>
       <entry>Nom du schéma que contient la table.</entry>
      </row>
      <row>
       <entry>TABLE_NAME</entry>
       <entry>Nom de la table.</entry>
      </row>
      <row>
       <entry>GRANTOR</entry>
       <entry>ID d'autorisation de l'utilisateur qui a donné le privilège.</entry>
      </row>
      <row>
       <entry>GRANTEE</entry>
       <entry>ID d'autorisation de l'utilisateur à qui le privilège a été
       donné.</entry>
      </row>
      <row>
       <entry>PRIVILEGE</entry>
       <entry>Le privilège qui a été donné. Cela peut être un de ces mots
       suivants : ALTER, CONTROL, DELETE, INDEX, INSERT, REFERENCES, SELECT ou
       UPDATE.</entry>
      </row>
      <row>
       <entry>IS_GRANTABLE</entry>
       <entry>Une chaîne contenant "YES" ou "NO" indiquant si l'utilisateur à
       qui le privilège a été donné peut donner le privilège aux autres
       utilisateurs.</entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>db2_column_privileges</function></member>
    <member><function>db2_columns</function></member>
    <member><function>db2_foreign_keys</function></member>
    <member><function>db2_primary_keys</function></member>
    <member><function>db2_procedure_columns</function></member>
    <member><function>db2_procedures</function></member>
    <member><function>db2_special_columns</function></member>
    <member><function>db2_statistics</function></member>
    <member><function>db2_tables</function></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->