Files
php-doc-ru/reference/oci8/constants.xml
2024-07-10 11:42:21 +03:00

622 lines
26 KiB
XML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: aca4a6319c606a9222b423b9f8d917a14b2b9b3f Maintainer: irker Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="oci8.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<table>
<title>Функции и методы модуля OCI8</title>
<tgroup cols="2">
<thead>
<row>
<entry>Константа</entry>
<entry>Описание</entry>
</row>
</thead>
<tbody>
<row xml:id="constant.oci-assoc">
<entry><constant>OCI_ASSOC</constant></entry>
<entry>
Флаг передают в функции <function>oci_fetch_all</function>
и <function>oci_fetch_array</function>, чтобы получить результаты
в виде ассоциативного массива.
</entry>
</row>
<row xml:id="constant.oci-both">
<entry><constant>OCI_BOTH</constant></entry>
<entry>
Флаг передают в функции <function>oci_fetch_all</function>
и <function>oci_fetch_array</function>, чтобы получить результаты
в виде массива с ассоциативными и числовыми индексами.
</entry>
</row>
<row xml:id="constant.oci-commit-on-success">
<entry><constant>OCI_COMMIT_ON_SUCCESS</constant></entry>
<entry>
Режим выполнения запросов для функции <function>oci_execute</function>.
Автоматически фиксирует изменения в случае успешного выполнения
запроса.
</entry>
</row>
<row xml:id="constant.oci-cred-ext">
<entry><constant>OCI_CRED_EXT</constant></entry>
<entry>
Флаг передают в функцию <function>oci_connect</function> для выбора
режима внешней или системной аутентификации.
</entry>
</row>
<row xml:id="constant.oci-default">
<entry><constant>OCI_DEFAULT</constant></entry>
<entry>
Смотрите описание константы <constant>OCI_NO_AUTO_COMMIT</constant>.
</entry>
</row>
<row xml:id="constant.oci-describe-only">
<entry><constant>OCI_DESCRIBE_ONLY</constant></entry>
<entry>
Режим выполнения запросов для функции <function>oci_execute</function>.
Этот режим устанавливают, когда необходимо
получить данные о выполнении запроса, а не выполнить сам запрос.
</entry>
</row>
<row xml:id="constant.oci-exact-fetch">
<entry><constant>OCI_EXACT_FETCH</constant></entry>
<entry>
Константа устарела. Режим получения результатов запроса. Этот режим устанавливают,
если приложение заранее знает, сколько строк вернёт
результат. БД Oracle 8 и более поздние версии не выбирают
результаты с упреждением в этом режиме, а курсоры уничтожаются
автоматически после выборки ожидаемого количества строк, что
может уменьшить требования сервера к ресурсам.
</entry>
</row>
<row xml:id="constant.oci-fetchstatement-by-column">
<entry><constant>OCI_FETCHSTATEMENT_BY_COLUMN</constant></entry>
<entry>
Режим <function>oci_fetch_all</function> по умолчанию.
</entry>
</row>
<row xml:id="constant.oci-fetchstatement-by-row">
<entry><constant>OCI_FETCHSTATEMENT_BY_ROW</constant></entry>
<entry>
Альтернативный режим функции <function>oci_fetch_all</function>.
</entry>
</row>
<row xml:id="constant.ocilob-buffer-free">
<entry><constant>OCI_LOB_BUFFER_FREE</constant></entry>
<entry>
Флаг передают в метод <xref linkend="ocilob.flush"/> для перевода в режим освобождения
буферов.
</entry>
</row>
<row xml:id="constant.oci-no-auto-commit">
<entry><constant>OCI_NO_AUTO_COMMIT</constant></entry>
<entry>
Режим выполнения запросов для функции <function>oci_execute</function>.
В этом режиме транзакция не завершается
автоматически оператором COMMIT. Для повышения читаемости
в новом коде вместо старой эквивалентной константы <constant>OCI_DEFAULT</constant>
указывают эту константу.
</entry>
</row>
<row xml:id="constant.oci-num">
<entry><constant>OCI_NUM</constant></entry>
<entry>
Флаг передают в функции <function>oci_fetch_all</function>
и <function>oci_fetch_array</function>, чтобы получить результаты
в виде перечислимого массива — с числовыми индексами.
</entry>
</row>
<row xml:id="constant.oci-return-lobs">
<entry><constant>OCI_RETURN_LOBS</constant></entry>
<entry>
Флаг передают в функцию <function>oci_fetch_array</function> для получения
значения данных объекта LOB вместо дескриптора.
</entry>
</row>
<row xml:id="constant.oci-return-nulls">
<entry><constant>OCI_RETURN_NULLS</constant></entry>
<entry>
Флаг передают в функцию <function>oci_fetch_array</function>, чтобы получить
пустые элементы массива, если значение элемента строки
равно &null;.
</entry>
</row>
<row xml:id="constant.oci-seek-cur">
<entry><constant>OCI_SEEK_CUR</constant></entry>
<entry>
Флаг передают в метод <xref linkend="ocilob.seek"/>, чтобы установить позицию для перемещения.
</entry>
</row>
<row xml:id="constant.oci-seek-end">
<entry><constant>OCI_SEEK_END</constant></entry>
<entry>
Флаг передают в метод <xref linkend="ocilob.seek"/>, чтобы установить позицию для перемещения.
</entry>
</row>
<row xml:id="constant.oci-seek-set">
<entry><constant>OCI_SEEK_SET</constant></entry>
<entry>
Флаг передают в метод <xref linkend="ocilob.seek"/>, чтобы установить позицию для перемещения.
</entry>
</row>
<row xml:id="constant.oci-sysdate">
<entry><constant>OCI_SYSDATE</constant></entry>
<entry>
Устарела.
</entry>
</row>
<row xml:id="constant.oci-sysdba">
<entry><constant>OCI_SYSDBA</constant></entry>
<entry>
Флаг передают в функцию <function>oci_connect</function> для соединения
с привилегиями SYSOPER. В файле &php.ini; потребуется включить
опцию <link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>.
</entry>
</row>
<row xml:id="constant.oci-sysoper">
<entry><constant>OCI_SYSOPER</constant></entry>
<entry>
Флаг передают в функцию <function>oci_connect</function> для соединения
с привилегиями SYSOPER. В файле &php.ini; потребуется включить
опцию <link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>.
</entry>
</row>
<row xml:id="constant.oci-temp-blob">
<entry><constant>OCI_TEMP_BLOB</constant></entry>
<entry>
Флаг передают в метод <xref linkend="ocilob.writetemporary"/>, чтобы указать,
что требуется создать временный BLOB-объект.
</entry>
</row>
<row xml:id="constant.oci-temp-clob">
<entry><constant>OCI_TEMP_CLOB</constant></entry>
<entry>
Флаг передают в метод <xref linkend="ocilob.writetemporary"/>, чтобы указать,
что требуется создать временный CLOB-объект.
</entry>
</row>
</tbody>
</tgroup>
</table>
<table>
<title>OCI8 привязка переменных и определение типов</title>
<tgroup cols="2">
<thead>
<row>
<entry>Константа</entry>
<entry>Описание</entry>
</row>
</thead>
<tbody>
<row xml:id="constant.oci-b-bfile">
<entry><constant>OCI_B_BFILE</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_by_name</function>
для привязки переменных с типом BFILE.
</entry>
</row>
<row xml:id="constant.oci-b-bin">
<entry><constant>OCI_B_BIN</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_by_name</function>
для привязки необработанных данных.
</entry>
</row>
<row xml:id="constant.oci-b-blob">
<entry><constant>OCI_B_BLOB</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_by_name</function>
для привязки переменных с типом BLOB.
</entry>
</row>
<row xml:id="constant.oci-b-bol">
<entry><constant>OCI_B_BOL</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_by_name</function>
для привязки BOOLEAN-переменной PL/SQL-запроса.
</entry>
</row>
<row xml:id="constant.oci-b-cfilee">
<entry><constant>OCI_B_CFILEE</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_by_name</function>
для привязки переменных с типом CFILE.
</entry>
</row>
<row xml:id="constant.oci-b-clob">
<entry><constant>OCI_B_CLOB</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_by_name</function>
для привязки переменных с типом CLOB.
</entry>
</row>
<row xml:id="constant.oci-b-cursor">
<entry><constant>OCI_B_CURSOR</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_by_name</function>
для привязки курсоров, которые ранее получили
из функции <function>oci_new_descriptor</function>.
</entry>
</row>
<row xml:id="constant.oci-b-int">
<entry><constant>OCI_B_INT</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_array_by_name</function>
для привязки массивов элементов с типом INTEGER.
</entry>
</row>
<row xml:id="constant.oci-b-nty">
<entry><constant>OCI_B_NTY</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_by_name</function>
для привязки именованных типов данных.
</entry>
</row>
<row xml:id="constant.oci-b-num">
<entry><constant>OCI_B_NUM</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_array_by_name</function>
для привязки массивов элементов с типом NUMBER.
</entry>
</row>
<row xml:id="constant.oci-b-rowid">
<entry><constant>OCI_B_ROWID</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_by_name</function>
для привязки переменных с типом ROWID.
</entry>
</row>
<row xml:id="constant.sqlt-afc">
<entry><constant>SQLT_AFC</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_array_by_name</function>
для привязки массивов элементов с типом CHAR.
</entry>
</row>
<row xml:id="constant.sqlt-avc">
<entry><constant>SQLT_AVC</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_array_by_name</function>
для привязки массивов элементов с типом VARCHAR2.
</entry>
</row>
<row xml:id="constant.sqlt-bdouble">
<entry><constant>SQLT_BDOUBLE</constant></entry>
<entry>
Не поддерживается.
</entry>
</row>
<row xml:id="constant.sqlt-bfilee">
<entry><constant>SQLT_BFILEE</constant></entry>
<entry>
То же, что и <constant>OCI_B_BFILE</constant>.
</entry>
</row>
<row xml:id="constant.sqlt-bfloat">
<entry><constant>SQLT_BFLOAT</constant></entry>
<entry>
Не поддерживается.
</entry>
</row>
<row xml:id="constant.sqlt-bin">
<entry><constant>SQLT_BIN</constant></entry>
<entry>
То же, что и <constant>OCI_B_BIN</constant>.
</entry>
</row>
<row xml:id="constant.sqlt-blob">
<entry><constant>SQLT_BLOB</constant></entry>
<entry>
То же, что и <constant>OCI_B_BLOB</constant>.
</entry>
</row>
<row xml:id="constant.sqlt-bol">
<entry><constant>SQLT_BOL</constant></entry>
<entry>
То же, что и <constant>OCI_B_BOL</constant>.
</entry>
</row>
<row xml:id="constant.sqlt-cfilee">
<entry><constant>SQLT_CFILEE</constant></entry>
<entry>
То же, что и <constant>OCI_B_CFILEE</constant>.
</entry>
</row>
<row xml:id="constant.sqlt-chr">
<entry><constant>SQLT_CHR</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_array_by_name</function>
для привязки массивов элементов с типом VARCHAR2.
Константа также работает с функцией <function>oci_bind_by_name</function>.
</entry>
</row>
<row xml:id="constant.sqlt-clob">
<entry><constant>SQLT_CLOB</constant></entry>
<entry>
То же, что и <constant>OCI_B_CLOB</constant>.
</entry>
</row>
<row xml:id="constant.sqlt-flt">
<entry><constant>SQLT_FLT</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_array_by_name</function>
для привязки массивов элементов с типом FLOAT.
</entry>
</row>
<row xml:id="constant.sqlt-int">
<entry><constant>SQLT_INT</constant></entry>
<entry>
То же, что и <constant>OCI_B_INT</constant>.
</entry>
</row>
<row xml:id="constant.sqlt-lbi">
<entry><constant>SQLT_LBI</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_by_name</function>
для привязки переменных с типом LONG RAW.
</entry>
</row>
<row xml:id="constant.sqlt-lng">
<entry><constant>SQLT_LNG</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_by_name</function>
для привязки переменных с типом LONG.
</entry>
</row>
<row xml:id="constant.sqlt-lvc">
<entry><constant>SQLT_LVC</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_array_by_name</function>
для привязки массивов элементов с типом LONG VARCHAR.
</entry>
</row>
<row xml:id="constant.sqlt-nty">
<entry><constant>SQLT_NTY</constant></entry>
<entry>
То же, что и <constant>OCI_B_NTY</constant>.
</entry>
</row>
<row xml:id="constant.sqlt-num">
<entry><constant>SQLT_NUM</constant></entry>
<entry>
То же, что и <constant>OCI_B_NUM</constant>.
</entry>
</row>
<row xml:id="constant.sqlt-odt">
<entry><constant>SQLT_ODT</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_array_by_name</function>
для привязки массивов элементов с типом LONG.
</entry>
</row>
<row xml:id="constant.sqlt-rdd">
<entry><constant>SQLT_RDD</constant></entry>
<entry>
То же, что и <constant>OCI_B_ROWID</constant>.
</entry>
</row>
<row xml:id="constant.sqlt-rset">
<entry><constant>SQLT_RSET</constant></entry>
<entry>
То же, что и <constant>OCI_B_CURSOR</constant>.
</entry>
</row>
<row xml:id="constant.sqlt-str">
<entry><constant>SQLT_STR</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_array_by_name</function>
для привязки массивов элементов с типом STRING.
</entry>
</row>
<row xml:id="constant.sqlt-uin">
<entry><constant>SQLT_UIN</constant></entry>
<entry>
Не поддерживается.
</entry>
</row>
<row xml:id="constant.sqlt-vcs">
<entry><constant>SQLT_VCS</constant></entry>
<entry>
Флаг передают в функцию <function>oci_bind_array_by_name</function>
для привязки массивов элементов с типом VARCHAR.
</entry>
</row>
</tbody>
</tgroup>
</table>
<table>
<title>Типы дескрипторов OCI8</title>
<tgroup cols="2">
<thead>
<row>
<entry>Константа</entry>
<entry>Описание</entry>
</row>
</thead>
<tbody>
<row xml:id="constant.oci-dtype-file">
<entry><constant>OCI_DTYPE_FILE</constant></entry>
<entry>
Флаг указывает функции <function>oci_new_descriptor</function>,
что требуется инициализация дескриптора с типом FILE.
</entry>
</row>
<row xml:id="constant.oci-dtype-lob">
<entry><constant>OCI_DTYPE_LOB</constant></entry>
<entry>
Флаг указывает функции <function>oci_new_descriptor</function>,
что требуется инициализация дескриптора с типом LOB.
</entry>
</row>
<row xml:id="constant.oci-dtype-rowid">
<entry><constant>OCI_DTYPE_ROWID</constant></entry>
<entry>
Флаг указывает функции <function>oci_new_descriptor</function>,
что требуется инициализация дескриптора с типом ROWID.
</entry>
</row>
<row xml:id="constant.oci-d-file">
<entry><constant>OCI_D_FILE</constant></entry>
<entry>
То же, что и <constant>OCI_DTYPE_FILE</constant>.
</entry>
</row>
<row xml:id="constant.oci-d-lob">
<entry><constant>OCI_D_LOB</constant></entry>
<entry>
То же, что и <constant>OCI_DTYPE_LOB</constant>.
</entry>
</row>
<row xml:id="constant.oci-d-rowid">
<entry><constant>OCI_D_ROWID</constant></entry>
<entry>
То же, что и <constant>OCI_DTYPE_ROWID</constant>.
</entry>
</row>
</tbody>
</tgroup>
</table>
<variablelist role="constant_list">
<title>Константы прозрачной для приложений обработки отказов (TAF) модуля OCI8</title>
<varlistentry xml:id="constant.oci-fo-abort">
<term>
<constant>OCI_FO_ABORT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Обработка отказа не удалась и невозможно повторить попытку.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.oci-fo-begin">
<term>
<constant>OCI_FO_BEGIN</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Драйвер механизма отказоустойчивости обнаружил потерянное соединение и начал аварийное переключение.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.oci-fo-end">
<term>
<constant>OCI_FO_END</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Обработка отказа завершилась успешно.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.oci-fo-error">
<term>
<constant>OCI_FO_ERROR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Переключение при отказе не удалось, но это удобный для приложения случай
обработать ошибку и вернуть флаг <constant>OCI_FO_RETRY</constant>, чтобы повторить попытку обработки отказа.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.oci-fo-none">
<term>
<constant>OCI_FO_NONE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Пользователь не запросил тип аварийного переключения.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.oci-fo-reauth">
<term>
<constant>OCI_FO_REAUTH</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Пользователь БД Oracle прошёл повторную аутентификацию.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.oci-fo-retry">
<term>
<constant>OCI_FO_RETRY</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
БД Oracle должна повторить попытку обработать отказ.
Механизм TAF, если требуется, повторяет попытку обработки отказа,
если при переключении на новое соединение возникла ошибка. Обычно коду приложения
требуется выдержать паузу, прежде чем вернуть флаг <constant>OCI_FO_RETRY</constant>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.oci-fo-select">
<term>
<constant>OCI_FO_SELECT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Пользователь также запросил отработку отказа при выполнении инструкции SELECT.
Это разрешает пользователям с открытыми курсорами продолжать извлечение данных из курсоров после сбоя.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.oci-fo-session">
<term>
<constant>OCI_FO_SESSION</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Пользователь запросил только обработку отказа сессии.
Например, если произошла потеря пользовательского соединения,
в резервной копии для пользователя автоматически создаётся новая сессия.
Этот тип аварийного переключения не пытается восстановить SELECT-запросы.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.oci-fo-txnal">
<term>
<constant>OCI_FO_TXNAL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Пользователь запросил обработку отказа транзакции.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</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
-->