archived-doc-ru/reference/ibase/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d8da419011b34623bc91aab8d5ef7f5b6bfb128 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="ibase.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 &extension.constants;
 <para>
  Следующие константы можно задавать в функции <function>ibase_trans</function> для
  определения поведения транзакций.
  <table>
   <title>Флаги транзакций Firebird/InterBase</title>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>Константа</entry>
      <entry>Описание</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>IBASE_DEFAULT</entry>
      <entry>
       Настройки по умолчанию для новой транзакции. Это значение определяется клиентской
        библиотекой, которое в большинстве случаев равно
       IBASE_WRITE|IBASE_CONCURRENCY|IBASE_WAIT.</entry>
      </row>
      <row>
       <entry>IBASE_READ</entry>
       <entry>Начинает транзакцию в режиме только на чтение.</entry>
      </row>
      <row>
       <entry>IBASE_WRITE</entry>
       <entry>Начинает транзакцию в режиме чтения и записи.</entry>
      </row>
      <row>
       <entry>IBASE_CONSISTENCY</entry>
       <entry>Начинает транзакцию с уровнем изоляции 'consistency' (согласование).
        Это означает, что транзакция не может читать из таблиц, в которые вносятся
        изменения параллельными (конкурирующими) транзакциями.</entry>
      </row>
      <row>
       <entry>IBASE_CONCURRENCY</entry>
       <entry>Начинает транзакцию с уровнем изоляции 'concurrency' (или 'snapshot',
        'моментальный снимок'). Это означает, что транзакция имеет доступ ко всем
        таблицам, но не может видеть изменения других транзакций после снимка.</entry>
      </row>
      <row>
       <entry>IBASE_COMMITTED</entry>
       <entry>
        Начинает транзакцию с уровнем изоляции 'read committed' (читать фиксированное).
        Этот флаг должен быть объединён с <constant>IBASE_REC_VERSION</constant> или
        <constant>IBASE_REC_NO_VERSION</constant>. Этот уровень изоляции позволяет получить
        доступ к изменениям, совершенными после начала транзакции. Если указан флаг
        <constant>IBASE_REC_NO_VERSION</constant>, только последняя версия изменений может быть прочитана.
        Если указан флаг <constant>IBASE_REC_VERSION</constant>, то можно читать изменения, находящиеся
        в очереди в параллельных транзакциях.</entry>
      </row>
      <row>
       <entry>IBASE_WAIT</entry>
       <entry>Флаг, указывающий, что транзакция должна ждать при возникновении конфликта транзакций.</entry>
      </row>
      <row>
       <entry>IBASE_NOWAIT</entry>
       <entry>Флаг, указывающий, что транзакция должна вернуть ошибку при возникновении конфликта транзакций.</entry>
      </row>
     </tbody>
   </tgroup>
  </table>
 </para>

 <para>
  Следующие константы можно задавать в функциях <function>ibase_fetch_row</function>,
  <function>ibase_fetch_assoc</function> или <function>ibase_fetch_object</function>,
  для управления поведением извлечением данных.
  <table>
   <title>Флаги извлечения Firebird/InterBase</title>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>Константа</entry>
      <entry>Описание</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>IBASE_FETCH_BLOBS</entry>
      <entry>Также можно использовать <constant>IBASE_TEXT</constant> для обеспечения
       обратной совместимости. Вынуждает извлекать объекты BLOB целиком, а не только
       их идентификаторы.</entry>
     </row>
     <row>
      <entry>IBASE_FETCH_ARRAYS</entry>
      <entry>Вынуждает извлекать массивы целиком, а не только их идентификаторы.
       Идентификаторы массивов можно использоваться только для операций вставки, так как
       на данный момент отсутствуют какие-либо другие функции для работы с ними.
      </entry>
     </row>
     <row>
      <entry>IBASE_UNIXTIME</entry>
      <entry>Вынуждает поля типа дата/время извлекаться не как строки, а как временные
       метки Unix (количество секунд, прошедших с 1 января 1970 00:00 UTC). Может
       вызвать проблемы на некоторых системах, если необходимо работать с более ранними
       датами.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>
 <para>
  Следующие константы используются для передачи в запросы и сервисные функции API
  (<function>ibase_server_info</function>, <function>ibase_db_info</function>,
  <function>ibase_backup</function>, <function>ibase_restore</function>
  и <function>ibase_maintain_db</function>). За подробностями обратитесь к
  документации Firebird/InterBase.
  <variablelist>
   <varlistentry xml:id="constant.ibase-bkp-ignore-checksums">
    <term>
     <constant>IBASE_BKP_IGNORE_CHECKSUMS</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-bkp-ignore-limbo">
    <term>
     <constant>IBASE_BKP_IGNORE_LIMBO</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_backup</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-bkp-metadata-only">
    <term>
     <constant>IBASE_BKP_METADATA_ONLY</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_backup</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-bkp-no-garbage-collect">
    <term>
     <constant>IBASE_BKP_NO_GARBAGE_COLLECT</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_backup</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-bkp-old-descriptions">
    <term>
     <constant>IBASE_BKP_OLD_DESCRIPTIONS</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_backup</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-bkp-non-transportable">
    <term>
     <constant>IBASE_BKP_NON_TRANSPORTABLE</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_backup</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-bkp-convert">
    <term>
     <constant>IBASE_BKP_CONVERT</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_backup</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-res-deactivate-idx">
    <term>
     <constant>IBASE_RES_DEACTIVATE_IDX</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_restore</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-res-no-shadow">
    <term>
     <constant>IBASE_RES_NO_SHADOW</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_restore</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-res-no-validity">
    <term>
     <constant>IBASE_RES_NO_VALIDITY</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_restore</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-res-one-at-a-time">
    <term>
     <constant>IBASE_RES_ONE_AT_A_TIME</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_restore</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-res-replace">
    <term>
     <constant>IBASE_RES_REPLACE</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-res-create">
    <term>
     <constant>IBASE_RES_CREATE</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_restore</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-res-use-all-space">
    <term>
     <constant>IBASE_RES_USE_ALL_SPACE</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_restore</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-page-buffers">
    <term>
     <constant>IBASE_PRP_PAGE_BUFFERS</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-sweep-interval">
    <term>
     <constant>IBASE_PRP_SWEEP_INTERVAL</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-shutdown-db">
    <term>
     <constant>IBASE_PRP_SHUTDOWN_DB</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-deny-new-transactions">
    <term>
     <constant>IBASE_PRP_DENY_NEW_TRANSACTIONS</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-deny-new-attachments">
    <term>
     <constant>IBASE_PRP_DENY_NEW_ATTACHMENTS</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-reserve-space">
    <term>
     <constant>IBASE_PRP_RESERVE_SPACE</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-res-use-full">
    <term>
     <constant>IBASE_PRP_RES_USE_FULL</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-res">
    <term>
     <constant>IBASE_PRP_RES</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-write-mode">
    <term>
     <constant>IBASE_PRP_WRITE_MODE</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-wm-async">
    <term>
     <constant>IBASE_PRP_WM_ASYNC</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-wm-sync">
    <term>
     <constant>IBASE_PRP_WM_SYNC</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-access-mode">
    <term>
     <constant>IBASE_PRP_ACCESS_MODE</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-am-readonly">
    <term>
     <constant>IBASE_PRP_AM_READONLY</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-am-readwrite">
    <term>
     <constant>IBASE_PRP_AM_READWRITE</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-set-sql-dialect">
    <term>
     <constant>IBASE_PRP_SET_SQL_DIALECT</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-activate">
    <term>
     <constant>IBASE_PRP_ACTIVATE</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-prp-db-online">
    <term>
     <constant>IBASE_PRP_DB_ONLINE</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-rpr-check-db">
    <term>
     <constant>IBASE_RPR_CHECK_DB</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-rpr-ignore-checksum">
    <term>
     <constant>IBASE_RPR_IGNORE_CHECKSUM</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-rpr-kill-shadows">
    <term>
     <constant>IBASE_RPR_KILL_SHADOWS</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-rpr-mend-db">
    <term>
     <constant>IBASE_RPR_MEND_DB</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-rpr-validate-db">
    <term>
     <constant>IBASE_RPR_VALIDATE_DB</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-rpr-full">
    <term>
     <constant>IBASE_RPR_FULL</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-rpr-sweep-db">
    <term>
     <constant>IBASE_RPR_SWEEP_DB</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_maintain_db</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-sts-data-pages">
    <term>
     <constant>IBASE_STS_DATA_PAGES</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-sts-db-log">
    <term>
     <constant>IBASE_STS_DB_LOG</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-sts-hdr-pages">
    <term>
     <constant>IBASE_STS_HDR_PAGES</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-sts-idx-pages">
    <term>
     <constant>IBASE_STS_IDX_PAGES</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-sts-sys-relations">
    <term>
     <constant>IBASE_STS_SYS_RELATIONS</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_db_info</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-svc-server-version">
    <term>
     <constant>IBASE_SVC_SERVER_VERSION</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_server_info</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-svc-implementation">
    <term>
     <constant>IBASE_SVC_IMPLEMENTATION</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_server_info</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-svc-get-env">
    <term>
     <constant>IBASE_SVC_GET_ENV</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_server_info</function>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-svc-get-env-lock">
    <term>
     <constant>IBASE_SVC_GET_ENV_LOCK</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-svc-get-env-msg">
    <term>
     <constant>IBASE_SVC_GET_ENV_MSG</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-svc-user-dbpath">
    <term>
     <constant>IBASE_SVC_USER_DBPATH</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-svc-svr-db-info">
    <term>
     <constant>IBASE_SVC_SVR_DB_INFO</constant>
    </term>
    <listitem>
     <simpara>
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="constant.ibase-svc-get-users">
    <term>
     <constant>IBASE_SVC_GET_USERS</constant>
    </term>
    <listitem>
     <simpara>
      Опция для <function>ibase_server_info</function>
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>
</appendix>
<!-- 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
-->