cubrid-get-db-parameter.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 648875cf73af01acdb6afaa5ca38b0bf6631bf42 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->

<refentry xml:id="function.cubrid-get-db-parameter" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>cubrid_get_db_parameter</refname>
  <refpurpose>Retourne les paramètres de la base de données CUBRID</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>array</type><methodname>cubrid_get_db_parameter</methodname>
   <methodparam><type>resource</type><parameter>conn_identifier</parameter></methodparam>  
  </methodsynopsis>
  <para>
   Cette fonction retourne les paramètres de la base de données CUBRID,&return.falseforfailure;. Elle retourne un tableau associatif
   avec les valeurs des paramètres suivants:
  </para>
  <para>
   <simplelist>
    <member><constant>PARAM_ISOLATION_LEVEL</constant></member>
    <member><constant>PARAM_LOCK_TIMEOUT</constant></member>
    <member><constant>PARAM_MAX_STRING_LENGTH</constant></member>
    <member><constant>PARAM_AUTO_COMMIT</constant></member>
   </simplelist>
  </para>
  <para>
   <table>
    <title>Paramètres de la base de données</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Paramètre</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>PARAM_ISOLATION_LEVEL</entry>
       <entry>Le niveau d'isolation de la transaction.</entry>
      </row>
      <row>
       <entry>LOCK_TIMEOUT</entry>
       <entry>CUBRID fournit la fonctionnalité de verrou du délai d'expiration,
        qui définit le temps d'attente (en secondes) pour le verrou tant que
        la configuration du verrou de la transaction est autorisée.
        La valeur par défaut du paramètre lock_timeout_in_secs vaut -1, qui
        signifie que l'application cliente attendra indéfiniment tant que le
        verrou de transaction est autorisé.</entry>
      </row>
      <row>
       <entry>PARAM_AUTO_COMMIT</entry>
       <entry>En CUBRID PHP, le mode auto-commit est désactivé par défaut pour
        le gestionnaire de transaction. Il peut être défini par
        la fonction <function>cubrid_set_autocommit</function>.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para>
   La table suivante montre les niveaux d'isolation de 1 à 6 :
   <table>
    <title>Niveaux d'isolation supportés par CUBRID</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Nom</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>SERIALIZABLE (6)</entry>
       <entry>Dans ce niveau d'isolation, les problèmes de concurrence
        (i.e. lecture de données modifiées, lecture répétée de données,
        lecture de données fantôme, etc.) ne peuvent pas survenir.</entry>
      </row>
      <row>
       <entry>REPEATABLE READ CLASS avec REPEATABLE READ INSTANCES (5)</entry>
       <entry>Une autre transaction T2 ne peut pas mettre à jour le schéma
        de la table A tant que la transaction T1 lit la table A. La transaction
        T1 peut rencontrer des données fantômes de l'enregistrement R
        qui a été inséré par la transaction T2 lorsqu'elle récupère à plusieurs
        reprises un enregistrement spécifique.</entry>
      </row>
      <row>
       <entry>REPEATABLE READ CLASS with READ COMMITTED INSTANCES (or CURSOR STABILITY) (4)</entry>
       <entry>Une autre transaction T2 ne peut pas mettre à jour le schéma
        de la table A alors qu'une transaction T1 lit la table A. La transaction
        T1 peut rencontrer des lectures répétées de données qui ont 
        été mises à jour, et valider par une autre transaction T2 lorsqu'elle
        récupère à plusieurs reprises l'enregistrement R.</entry>
      </row>
      <row>
       <entry>REPEATABLE READ CLASS with READ UNCOMMITTED INSTANCES (3)</entry>
       <entry>Niveau d'isolation par défaut. Une transaction T2 ne peut
        pas mettre à jour le schéma de la table A alors qu'une transaction
        T1 lit la table A. La transaction T1 peut rencontrer des données
        non mises à jour pour l'enregistrement qui a été mis à jour
        mais non encore validé par la transaction T2.</entry>
      </row>
      <row>
       <entry>READ COMMITTED CLASS with READ COMMITTED INSTANCES (2)</entry>
       <entry>La transaction T1 peut rencontrer des lectures répétées de données
        pour la table qui a été mise à jour et validée par la transaction T2
        alors qu'elle lit plusieurs fois la table A. La transaction T1 peut
        rencontrer des lectures répétées de données pour l'enregistrement qui
        a été mis à jour et validé par la transaction T2 alors qu'elle récupère
        à plusieurs reprises l'enregistrement R.</entry>
      </row>
      <row>
       <entry>READ COMMITTED CLASS with READ UNCOMMITTED INSTANCES (1)</entry>
       <entry>La transaction T1 peut rencontrer des lectures répétées
        de données pour la table qui a été mise à jour et validée par la
        transaction T2 alors qu'elle lit à plusieurs reprises la table A.
        La transaction T1 peut rencontrer des données non mises à jour pour
        l'enregistrement qui a été mise à jour mais non validé par la transaction
        T2.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </refsect1>
 
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>conn_identifier</parameter></term>
     <listitem><para>La connexion CUBRID. Si l'identifiant de connexion
      n'est pas spécifié, le dernier lien ouvert avec la fonction
      <function>cubrid_connect</function> sera utilisé.</para></listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Un tableau associatif contenant les paramètres de la base
   de données CUBRID en cas de succès,&return.falseforfailure;.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>8.4.0</entry>
       <entry>
        Modification de LOCK_TIMEOUT en PARAM_LOCK_TIMEOUT,
        de MAX_STRING_LENGTH en PARAM_MAX_STRING_LENGTH dans le
        résultat.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <example>
   <title>Exemple avec <function>cubrid_get_db_parameter</function></title>
   <programlisting role="php">
<![CDATA[
<?php
printf("%-30s %s\n", "CUBRID PHP Version:", cubrid_version());

printf("\n");

$conn = cubrid_connect("localhost", 33088, "demodb");

if (!$conn) {
    die('Connect Error ('. cubrid_error_code() .')' . cubrid_error_msg());
}

$db_params = cubrid_get_db_parameter($conn);

while (list($param_name, $param_value) = each($db_params)) {
    printf("%-30s %s\n", $param_name, $param_value);
}

printf("\n");

$server_info = cubrid_get_server_info($conn);
$client_info = cubrid_get_client_info();

printf("%-30s %s\n", "Server Info:", $server_info);
printf("%-30s %s\n", "Client Info:", $client_info);

printf("\n");

$charset = cubrid_get_charset($conn);

printf("%-30s %s\n", "CUBRID Charset:", $charset);

cubrid_disconnect($conn);

?>
]]>
   </programlisting>
   &example.outputs;
   <screen>
<![CDATA[
CUBRID PHP Version:            9.1.0.0001

PARAM_ISOLATION_LEVEL          3
LOCK_TIMEOUT                   -1
MAX_STRING_LENGTH              1073741823
PARAM_AUTO_COMMIT              1

Server Info:                   9.1.0.0212
Client Info:                   9.1.0

CUBRID Charset:                iso8859-1
]]>
   </screen>
  </example>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>cubrid_set_db_parameter</function></member>
    <member><function>cubrid_get_autocommit</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
-->