php/archived-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2026-03-23 23:32:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

ibm_db2 : fix XML by converting para to simpara tags via script

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-18 21:36:36 +00:00
parent db851f4980
commit eb93a15b86
55 changed files with 1051 additions and 1052 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
reference/ibm_db2/book.xml
View File

@@ -1,8 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<book xml:id="book.ibm-db2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.ibm-db2">
<?phpdoc extension-membership="pecl" ?>
<title>IBM DB2, Cloudscape и Apache Derby</title>
<titleabbrev>IBM DB2</titleabbrev>
@@ -10,11 +9,11 @@
<!-- {{{ preface -->
<preface xml:id="intro.ibm-db2">
&reftitle.intro;
<para>
<simpara>
Эти функции позволят вам получить доступ к базам данных
IBM DB2 Universal Database, IBM Cloudscape и Apache Derby,
используя DB2 Call Level Interface (DB2 CLI).
</para>
</simpara>
</preface>
<!-- }}} -->

14
reference/ibm_db2/configure.xml
View File

@@ -1,9 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ibm-db2.installation">
&reftitle.install;
<para>
<simpara>
Чтобы собрать модуль ibm_db2, необходимо установить в систему
файлы заголовков и библиотеки для разработки приложений СУБД DB2.
Система DB2 не устанавливает их по умолчанию, поэтому, возможно, придётся
@@ -11,13 +11,13 @@
Клиент разработки приложений (Application Development Client) DB2 включает файлы заголовков
и доступен для бесплатного скачивания с <link xlink:href="&url.ibm.db2.client;">сайта поддержки</link>
реляционной системы управления базами данных IBM DB2 Universal Database (DB2 UDB).
</para>
<para>
</simpara>
<simpara>
Если файлы заголовков и библиотеки для разработки DB2-приложений добавлены
в операционную систему Linux или Unix, в которой база DB2 уже была установлена,
нужно запустить команду <command>db2iupdt -e</command>, чтобы обновить
символические ссылки на них в этом экземпляре DB2.
</para>
</simpara>
<para>
Модуль ibm_db2 — это модуль &link.pecl;, так что следуйте инструкции
«<xref linkend="install.pecl"/>» для его установки в PHP.
@@ -33,10 +33,10 @@ bash$ ./configure --with-IBM_DB2=/path/to/DB2
</para>
<note>
<title>Замечание для пользователей IIS</title>
<para>
<simpara>
Если драйвер ibm_db2 работает на сервере Microsoft Internet Information
Server (IIS), возможно, потребуется сделать следующее:
</para>
</simpara>
<simplelist>
<member>
Установите DB2 с расширенной безопасностью операционной системы.

34
reference/ibm_db2/functions/db2-autocommit.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-autocommit">
<refnamediv>
@@ -16,10 +16,10 @@
<methodparam choice="opt"><type>int</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает или устанавливает режим автоподтверждения
транзакций для указанного соединения.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,11 +28,11 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Переменная содержащая активный ресурс подключения,
полученный с помощью <function>db2_connect</function>
или <function>db2_pconnect</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -44,17 +44,17 @@
<varlistentry>
<term><constant>DB2_AUTOCOMMIT_OFF</constant></term>
<listitem>
<para>
<simpara>
Отключает автоподтверждение.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>DB2_AUTOCOMMIT_ON</constant></term>
<listitem>
<para>
<simpara>
Включает автоподтверждение.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -65,21 +65,21 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Если в <function>db2_autocommit</function> передать только
параметр <parameter>connection</parameter>, она вернёт
значение текущего режима для этого соединения в виде
целого числа принимающего значение <constant>DB2_AUTOCOMMIT_OFF</constant>, если
автоподтверждение отключено и <constant>DB2_AUTOCOMMIT_ON</constant>, если включено.
</para>
<para>
</simpara>
<simpara>
Если в <function>db2_autocommit</function> переданы оба
параметра, <parameter>connection</parameter> и
<parameter>autocommit</parameter>, она попытается
установить для заданного соединения указанный режим
автоподтверждения.
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -87,11 +87,11 @@
<para>
<example>
<title>Получение текущего режима автоподтверждения транзакций</title>
<para>
<simpara>
В следующем примере мы создадим соединение с
отключённым автоподтверждением и проверим его с
помощью <function>db2_autocommit</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -115,11 +115,11 @@ if ($ac == DB2_AUTOCOMMIT_OFF) {
</example>
<example>
<title>Установка режима автоподтверждения транзакции</title>
<para>
<simpara>
В следующем примере мы создадим соединение с
отключённым автоподтверждением, после чего его включим
и проверим.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

58
reference/ibm_db2/functions/db2-bind-param.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-bind-param">
<refnamediv>
@@ -21,13 +21,13 @@
<methodparam choice="opt"><type>int</type><parameter>scale</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Связывает переменную PHP с параметром SQL-выражения в ресурсе выражения,
возвращаемом <function>db2_prepare</function>. Эта функция даёт больший
контроль над типом параметра, типом данных, точностью и масштабом для
параметра, чем простая передача переменной как части необязательного
входного массива в <function>db2_execute</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,33 +36,33 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Подготовленное выражение, возвращаемое <function>db2_prepare</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>parameter_number</parameter></term>
<listitem>
<para>
<simpara>
Задаёт позицию параметра, которая нумеруется с 1, в подготовленном
выражении.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>variable_name</parameter></term>
<listitem>
<para>
<simpara>
Строка, определяющая имя переменной PHP для привязки к параметру,
заданному <parameter>parameter_number</parameter>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>parameter_type</parameter></term>
<listitem>
<para>
<simpara>
Константа, которая определяет, должна ли переменная PHP быть привязана к
параметру SQL как входной параметр (<constant>DB2_PARAM_IN</constant>),
выходной параметр (<constant>DB2_PARAM_OUT</constant>) или как параметр,
@@ -70,47 +70,47 @@
Чтобы избежать перегрузки памяти, можно также указать
<constant>DB2_PARAM_FILE</constant>, чтобы привязать переменную PHP к имени
файла, который содержит данные большого объекта (BLOB, CLOB или DBCLOB).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data_type</parameter></term>
<listitem>
<para>
<simpara>
Константа, указывающая тип данных SQL, с которым должна быть связана
переменная PHP: <constant>DB2_BINARY</constant>, <constant>DB2_CHAR</constant>,
<literal>DB2_DOUBLE</literal> или <constant>DB2_LONG</constant>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>precision</parameter></term>
<listitem>
<para>
<simpara>
Задаёт точность, с которой переменная должна быть привязана к базе данных.
Этот параметр также можно использовать для получения выходных значений
XML из хранимых процедур. Неотрицательное значение указывает максимальный
размер данных XML, которые будут извлечены из базы данных. Если этот
параметр не используется, для получения выходного значения XML из
хранимой процедуры предполагается значение по умолчанию 1 МБ.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>scale</parameter></term>
<listitem>
<para>
<simpara>
Задаёт масштаб, с которым переменная должна быть привязана к базе данных.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -118,7 +118,7 @@
<para>
<example>
<title>Привязка переменных PHP к подготовленному выражению</title>
<para>
<simpara>
SQL-выражение в данном примере использует два входных параметра в
предложении WHERE. Вызывается <function>db2_bind_param</function>, чтобы
связать две переменные PHP с соответствующими параметрами SQL. Обратите
@@ -131,7 +131,7 @@
связаны, а параметрам, принимающим ввод, должно быть присвоено любое
значение.
<function>db2_execute</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -174,23 +174,23 @@ Peaches, dog, 12.3
параметра:
<orderedlist>
<listitem>
<para>
<simpara>
входной параметр (IN), который принимает имя первого животного в
качестве входных данных
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
параметр ввода-вывода (INOUT), который принимает имя второго животного
в качестве входных данных и возвращает строку <literal>TRUE</literal>,
если животное в базе данных совпадает с этим именем
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
выходной параметр (OUT), который возвращает сумму веса двух
идентифицированных животных
</para>
</simpara>
</listitem>
</orderedlist>
Кроме того, хранимая процедура возвращает набор результатов, состоящий из
@@ -247,14 +247,14 @@ Results:
</example>
<example>
<title>Вставка большого двоичного объекта (BLOB) напрямую из файла</title>
<para>
<simpara>
Данные для больших объектов обычно хранятся в файлах, таких как документы
XML или аудиофайлы. Вместо того, чтобы считывать весь файл в переменную PHP
и затем связывать эту переменную PHP с SQL-выражением, можно избежать
некоторых накладных расходов на память, привязав файл напрямую к
входному параметру SQL-выражения. В данном примере показано, как
привязать файл напрямую к столбцу BLOB.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

26
reference/ibm_db2/functions/db2-client-info.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-client-info">
<refnamediv>
@@ -81,25 +81,25 @@
<varlistentry>
<term>MINIMUM</term>
<listitem>
<para>
<simpara>
Минимальная поддержка грамматики ODBC SQL.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>CORE</term>
<listitem>
<para>
<simpara>
Базовая поддержка грамматики ODBC SQL.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>EXTENDED</term>
<listitem>
<para>
<simpara>
Расширенная поддержка грамматики ODBC SQL.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -129,18 +129,18 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Задаёт активное соединение DB2.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
В случае успешного выполнения возвращает объект&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<!-- Use when ERRORS exist
@@ -180,10 +180,10 @@
&reftitle.examples;
<example>
<title>Пример использования <function>db2_client_info</function></title>
<para>
<simpara>
Для получения информации вы должны передать корректный
ресурс соединения в <function>db2_client_info</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[<?php
$conn = db2_connect( 'SAMPLE', 'db2inst1', 'ibmdb2' );

22
reference/ibm_db2/functions/db2-close.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-close">
@@ -16,17 +16,17 @@
<methodparam><type>resource</type><parameter>connection</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Функция закрывает соединение с базой DB2, созданное
с помощью <function>db2_connect</function> и возвращает
соответствующие ресурсы серверу баз данных.
</para>
<para>
</simpara>
<simpara>
Если вы попытаетесь закрыть постоянное соединение,
созданное с помощью <function>db2_pconnect</function>,
то запрос на закрытие будет проигнорирован и соединение
будет доступно для последующего использования.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -35,29 +35,29 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Активное соединение с DB2.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Закрытие соединения</title>
<para>
<simpara>
Следующий пример демонстрирует успешную попытку
закрыть соединение с IBM DB2, Cloudscape, или базой
данных Apache Derby.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

26
reference/ibm_db2/functions/db2-column-privileges.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-column-privileges">
<refnamediv>
@@ -21,10 +21,10 @@
</methodsynopsis>
<para>
<simpara>
Возвращает результирующий набор, перечисляющий столбцы
и связанные с ним привилегии для таблицы.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -33,47 +33,47 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Ресурс соединения с базой данных IBM DB2, Cloudscape
или Apache Derby.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>qualifier</parameter></term>
<listitem>
<para>
<simpara>
Квалификатор для баз DB2, работающих на серверах
OS/390 или z/OS. В остальных случаях указывайте &null;
или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>schema</parameter></term>
<listitem>
<para>
<simpara>
Схема, содержащая таблицы. Для выбора всех схем
укажите &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>table_name</parameter></term>
<listitem>
<para>
<simpara>
Имя таблицы или представления. Для выбора всех таблиц
укажите &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>column_name</parameter></term>
<listitem>
<para>
<simpara>
Имя столбца. Для выбора всех столбцов
укажите &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

26
reference/ibm_db2/functions/db2-columns.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-columns">
<refnamediv>
@@ -19,10 +19,10 @@
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>column_name</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Returns a result set listing the columns and associated metadata for a
table.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,47 +31,47 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Ресурс соединения с базой данных IBM DB2, Cloudscape
или Apache Derby.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>qualifier</parameter></term>
<listitem>
<para>
<simpara>
Квалификатор для баз DB2, работающих на серверах
OS/390 или z/OS. В остальных случаях указывайте &null;
или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>schema</parameter></term>
<listitem>
<para>
<simpara>
Схема, содержащая таблицы. Для выбора всех схем
укажите <literal>'%'</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>table_name</parameter></term>
<listitem>
<para>
<simpara>
Имя таблицы или представления. Для выбора всех таблиц
укажите &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>column_name</parameter></term>
<listitem>
<para>
<simpara>
Имя столбца. Для выбора всех столбцов
укажите &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

14
reference/ibm_db2/functions/db2-commit.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-commit">
@@ -17,14 +17,14 @@
</methodsynopsis>
<para>
<simpara>
Подтверждает текущую транзакцию на указанном соединении
и начинает новую. По умолчанию, в PHP, используется
автоподтверждение транзакций, так что функция
<function>db2_commit</function> нужна
только в том случае, если вы принудительно отключили
автоподтверждение транзакций для соединения.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -33,20 +33,20 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Переменная содержащая активный ресурс подключения,
полученный с помощью <function>db2_connect</function>
или <function>db2_pconnect</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<!-- Use when examples exist

22
reference/ibm_db2/functions/db2-conn-error.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-conn-error">
<refnamediv>
@@ -17,19 +17,19 @@
</methodsynopsis>
<para>
<simpara>
Возвращает значение SQLSTATE, представляющее причину, по которой последняя
попытка подключения к базе данных завершилась неудачей. Поскольку
<function>db2_connect</function> возвращает &false; в случае неудачной
попытки подключения, не нужно передавать никаких параметров в
<function>db2_conn_error</function> для получения значения SQLSTATE.
</para>
<para>
</simpara>
<simpara>
Однако, если соединение было успешным, но со временем стало
недействительным, можно передать параметр
<parameter>connection</parameter>, чтобы получить значение SQLSTATE для
конкретного соединения.
</para>
</simpara>
<para>
Чтобы узнать, что означает значение SQLSTATE, вы можете ввести следующую
команду в командной строке DB2 Command Line Processor:
@@ -44,32 +44,32 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Ресурс подключения, связанный с подключением, которое изначально было
успешным, но со временем стало недействительным.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает значение SQLSTATE, полученное в результате неудачной попытки
подключения. Возвращает пустую строку, если при последней попытке подключения
ошибок не возникло.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Получение значения SQLSTATE для неудачной попытки подключения</title>
<para>
<simpara>
В данном примере показано, как вернуть значение SQLSTATE после
преднамеренной передачи недопустимых параметров в
<function>db2_connect</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

22
reference/ibm_db2/functions/db2-conn-errormsg.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-conn-errormsg">
<refnamediv>
@@ -15,20 +15,20 @@
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>connection</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает сообщение об ошибке и значение SQLCODE, представляющее причину, по
которой последняя попытка подключения к базе данных завершилась неудачей.
Поскольку <function>db2_connect</function> возвращает &false; в случае неудачной
попытки подключения, не нужно передавать никаких параметров в
<function>db2_conn_errormsg</function> для получения соответствующего
сообщения об ошибке и значения SQLCODE.
</para>
<para>
</simpara>
<simpara>
Однако, если соединение было успешным, но со временем стало
недействительным, можно передать параметр <parameter>connection</parameter>,
чтобы получить соответствующее сообщение об ошибке и значение SQLCODE для
конкретного соединения.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -36,22 +36,22 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Ресурс подключения, связанный с подключением, которое изначально было
успешным, но со временем стало недействительным.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку, содержащую сообщение об ошибке и значение SQLCODE,
полученное в результате неудачной попытки подключения. Если при последней
попытке подключения ошибок не возникло, <function>db2_conn_errormsg</function>
возвращает пустую строку.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -60,11 +60,11 @@
<title>
Получение сообщения об ошибке, возвращённого при неудачной попытке подключения
</title>
<para>
<simpara>
В данном примере показано, как вернуть сообщение об ошибке и значение
SQLCODE после преднамеренной передачи недопустимых параметров в
<function>db2_connect</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

286
reference/ibm_db2/functions/db2-connect.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.db2-connect">
<refnamediv>
@@ -18,10 +18,10 @@
<methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Функция создаёт новое соединение с базой данных IBM DB2 Universal Database,
IBM Cloudscape или базой данных Apache Derby.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,11 +30,11 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
Для каталогизированного соединения с базой данных
параметр <parameter>database</parameter> представляет собой псевдоним базы данных
в клиентском каталоге DB2.
</para>
</simpara>
<para>
Для некаталогизированного подключения к базе данных
параметр <parameter>database</parameter> представляет собой полную строку
@@ -55,41 +55,41 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
Имя базы данных.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
Имя хоста или IP-адрес сервера базы данных.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>port</parameter></term>
<listitem>
<para>
<simpara>
Порт TCP/IP, который используется базой данных для принятия запросов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>username</parameter></term>
<listitem>
<para>
<simpara>
Имя пользователя, под которым выполняется подключение к базе данных.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>password</parameter></term>
<listitem>
<para>
<simpara>
Пароль, с которым выполняется подключение к базе данных.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -99,25 +99,25 @@
<varlistentry>
<term><parameter>username</parameter></term>
<listitem>
<para>
<simpara>
Имя пользователя, под которым выполняется подключение к базе данных.
</para>
<para>
</simpara>
<simpara>
Для некаталогизированных соединений необходимо передать значение &null;
или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>password</parameter></term>
<listitem>
<para>
<simpara>
Пароль, с которым выполняется подключение к базе данных.
</para>
<para>
</simpara>
<simpara>
Для некаталогизированных соединений необходимо передать значение &null;
или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -130,48 +130,48 @@
<varlistentry>
<term><parameter>autocommit</parameter></term>
<listitem>
<para>
<simpara>
Передача значения <constant>DB2_AUTOCOMMIT_ON</constant> включает
автоматическую фиксацию (autocommit) для этого дескриптора соединения.
</para>
<para>
</simpara>
<simpara>
Передача значения <constant>DB2_AUTOCOMMIT_OFF</constant> выключает
автоматическую фиксацию (autocommit) для этого дескриптора соединения.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>DB2_ATTR_CASE</parameter></term>
<listitem>
<para>
<simpara>
Передача значения <constant>DB2_CASE_NATURAL</constant> указывает,
что имена столбцов возвращаются в естественном регистре.
</para>
<para>
</simpara>
<simpara>
Передача значения <constant>DB2_CASE_LOWER</constant> указывает,
что имена столбцов возвращаются в нижнем регистре.
</para>
<para>
</simpara>
<simpara>
Передача значения <constant>DB2_CASE_UPPER</constant> указывает,
что имена столбцов возвращаются в верхнем регистре.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>CURSOR</parameter></term>
<listitem>
<para>
<simpara>
Передача значения <constant>DB2_FORWARD_ONLY</constant> задаёт курсор,
который двигается только вперёд, для ресурса оператора. Данный тип
курсора используется по умолчанию, он поддерживается всеми серверами
баз данных.
</para>
<para>
</simpara>
<simpara>
Передача значения <constant>DB2_SCROLLABLE</constant> задаёт
прокручиваемый курсор для ресурса оператора. Этот режим включает
произвольный доступ к строкам в наборе результатов, но в настоящее
время поддерживается только IBM DB2 Universal Database.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -182,20 +182,20 @@
<varlistentry>
<term><parameter>trustedcontext</parameter></term>
<listitem>
<para>
<simpara>
Передача значения DB2_TRUSTED_CONTEXT_ENABLE
включает доверенный контекст для этого дескриптора соединения.
Этот параметр нельзя установить функцией
<function>db2_set_option</function>.
</para>
<para>
</simpara>
<simpara>
Этот ключ работает только тогда, когда базу данных
каталогизировали (даже если база данных локальная) или
если укажут полное DSN-имя при создании соединения.
</para>
<para>
</simpara>
<simpara>
Чтобы каталогизировать базу данных, выполняют следующие команды:
</para>
</simpara>
<literallayout>db2 catalog tcpip node loopback remote &lt;SERVERNAME&gt; server &lt;SERVICENAME&gt;
db2 catalog database &lt;LOCALDBNAME&gt; as &lt;REMOTEDBNAME&gt; at node loopback
db2 "update dbm cfg using svcename &lt;SERVICENAME&gt;"
@@ -210,31 +210,31 @@
<varlistentry>
<term><parameter>i5_lib</parameter></term>
<listitem>
<para>
<simpara>
Символьное значение, которое указывает библиотеку по умолчанию, которая
будет использоваться для разрешения неквалифицированных ссылок на
файлы. Это недопустимо, если соединение использует режим именования
системы.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_naming</parameter></term>
<listitem>
<para>
<simpara>
Значение <literal>DB2_I5_NAMING_ON</literal> включает режим
именования системы DB2 UDB CLI iSeries. Файлы квалифицируются
через слеш (/) в качестве разделителя. Неквалифицированные
файлы разрешаются с использованием списка библиотек для работы.
</para>
<para>
</simpara>
<simpara>
Значение <literal>DB2_I5_NAMING_OFF</literal> выключает режим
именования по умолчанию DB2 UDB CLI, который представляет собой именование SQL.
Файлы квалифицируются через точку (.) в качестве
разделителя. Неквалифицированные файлы разрешаются с использованием
либо библиотеки по умолчанию, либо текущего идентификатора
пользователя.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -248,207 +248,207 @@
следующего успешного вызова функции <function>db2_connect</function>
для дескриптора соединения.
<note>
<para>
<simpara>
Параметр <parameter>ibm_db2.i5_allow_commit</parameter>==0 файла php.ini
или настройка <literal>DB2_I5_TXN_NO_COMMIT</literal> используется
по умолчанию, но может быть изменён через параметр
<parameter>i5_commit</parameter>.
</para>
</simpara>
</note>
</para>
<para>
<simpara>
<literal>DB2_I5_TXN_NO_COMMIT</literal> — Контроль транзакций не
используется.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_TXN_READ_UNCOMMITTED</literal> — Возможны грязные
чтения, неповторяющиеся чтения и фантомы.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_TXN_READ_COMMITTED</literal> — Грязное чтение невозможно.
Возможны неповторяющиеся чтения и фантомы
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_TXN_REPEATABLE_READ</literal> — Грязные чтения и
неповторяющиеся чтения невозможны. Возможны фантомы.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_TXN_SERIALIZABLE</literal> — Транзакции сериализуемы.
Грязные чтения, неповторяющиеся чтения и фантомы невозможны.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_query_optimize</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_FIRST_IO</literal> — Все запросы оптимизированы с целью
максимально быстрого возврата первой страницы вывода. Эта цель
хорошо работает, когда вывод контролируется пользователем, который,
скорее всего, отменит запрос после просмотра первой страницы
выходных данных. Запросы, закодированные с предложением
OPTIMIZE FOR nnn ROWS, учитывают цель, указанную в предложении.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_ALL_IO</literal> — Все запросы оптимизированы с целью
выполнить весь запрос до завершения в кратчайшие сроки. Это хороший
вариант, когда выходные данные запроса записываются в файл или отчёт,
или когда интерфейс ставит выходные данные в очередь. Запросы,
закодированные с предложением OPTIMIZE FOR nnn ROWS, учитывают цель,
указанную в предложении. Это значение по умолчанию.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_dbcs_alloc</parameter></term>
<listitem>
<para>
<simpara>
Значение <literal>DB2_I5_DBCS_ALLOC_ON</literal> включает схему
распределения DB2 6X для увеличения размера столбца преобразования DBCS.
</para>
<para>
</simpara>
<simpara>
Значение <literal>DB2_I5_DBCS_ALLOC_OFF</literal> отключает схему
распределения DB2 6X для увеличения размера столбца преобразования DBCS.
</para>
<para>
</simpara>
<simpara>
Замечание: параметр <parameter>ibm_db2.i5_dbcs_alloc</parameter>==0 файла php.ini
или параметр <literal>DB2_I5_DBCS_ALLOC_OFF</literal> — значение
по умолчанию, но его можно изменить через параметр
<parameter>i5_dbcs_alloc</parameter>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_date_fmt</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_FMT_ISO</literal> — Используется формат даты
Международной организации по стандартизации ISO (yyyy-mm-dd).
Это значение по умолчанию.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_USA</literal> — Используется формат даты США
(mm/dd/yyyy).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_EUR</literal> — Используется европейский формат
даты (dd.mm.yyyy).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_JIS</literal> — Используется формат даты японского
промышленного стандарта (yyyy-mm-dd).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_MDY</literal> — Используется формат даты
mm/dd/yyyy.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_DMY</literal> — Используется формат даты
dd/mm/yyyy.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_YMD</literal> — Используется формат даты yy/mm/dd.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_JUL</literal> — Используется юлианский формат
даты (yy/ddd).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_JOB</literal> — Используется задание по умолчанию.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_date_sep</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_SEP_SLASH</literal> — В качестве разделителя даты
используется косая черта ( / ). Это значение по умолчанию.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_DASH</literal> — В качестве разделителя даты
используется дефис ( - ).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_PERIOD</literal> — В качестве разделителя даты
используется точка ( . ).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_COMMA</literal> — В качестве разделителя даты
используется запятая ( , ).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_BLANK</literal> — В качестве разделителя даты
используется пробел.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_JOB</literal> — Используется задание по умолчанию.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_time_fmt</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_FMT_ISO</literal> — Используется формат времени
Международной организации по стандартизации ISO (hh.mm.ss). Это
значение по умолчанию.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_USA</literal> — Используется формат времени США
(hh:mmxx, где xx — обозначение AM или PM).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_EUR</literal> — Используется европейский формат
времени (hh.mm.ss).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_JIS</literal> — Используется японский промышленный
стандартный формат времени (hh:mm:ss).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_HMS</literal> — Используется формат hh:mm:ss.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_time_sep</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_SEP_COLON</literal> — В качестве разделителя
времени используется двоеточие ( : ). Это значение по умолчанию.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_PERIOD</literal> — В качестве разделителя
времени используется точка ( . ).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_COMMA</literal> — В качестве разделителя
времени используется запятая ( , ).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_BLANK</literal> — В качестве разделителя времени
используется пробел.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_JOB</literal> — Используется задание по умолчанию.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_decimal_sep</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_SEP_PERIOD</literal> — В качестве десятичного
разделителя используется точка ( . ). Это значение по умолчанию.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_COMMA</literal> — В качестве десятичного
разделителя используется запятая ( , ).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_JOB</literal> — Используется задание по умолчанию.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -459,17 +459,17 @@
<varlistentry>
<term><parameter>i5_libl</parameter></term>
<listitem>
<para>
<simpara>
Символьное значение, которое указывает список библиотек, который будет
использоваться для разрешения неквалифицированных ссылок на файлы.
Укажите элементы списка библиотек через пробелы:
'i5_libl'=&gt;"MYLIB YOURLIB ANYLIB".
</para>
</simpara>
<note>
<para>
<simpara>
Параметр <parameter>i5_libl</parameter> вызывает qsys2/qcmdexc('cmd',cmdlen),
который доступен только в ОС i5/OS V5R4 и новее.
</para>
</simpara>
</note>
</listitem>
</varlistentry>
@@ -481,10 +481,10 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Функция возвращает ресурс дескриптора подключения, если попытка подключения успешна.
Функция <function>db2_connect</function> возвращает &false;, елси возникла ошибка подключения.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -492,11 +492,11 @@
<para>
<example>
<title>Пример создания каталогизированного соединения</title>
<para>
<simpara>
Каталогизированные соединения требуют, предварительной каталогизации базы данных
через Command Line Processor (CLP)
или Configuration Assistant базы данных DB2.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -526,10 +526,10 @@ if ($conn) {
</example>
<example>
<title>Пример создания некаталогизированного соединения</title>
<para>
<simpara>
Некаталогизированное соединение разрешает динамически подключаться
к базе данных.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -565,10 +565,10 @@ if ($conn) {
</example>
<example>
<title>Пример создания соединения с отключённой автофиксацией по умолчанию</title>
<para>
<simpara>
Передача массива параметров в функцию <function>db2_connect</function> разрешает
изменять поведение дескриптора соединения по умолчанию.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -607,11 +607,11 @@ if ($conn) {
</example>
<example>
<title>Лучшая производительность ОС i5/OS</title>
<para>
<simpara>
Чтобы добиться максимальной производительности PHP-приложения, которое работает с модулем ibm_db2 1.5.1
операционной системы i5/OS, указывают хост по умолчанию, идентификатор пользователя
и пароль для функции <function>db2_connect</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -644,10 +644,10 @@ PICTURES
</example>
<example>
<title>Пример работы с доверенным контекстом</title>
<para>
<simpara>
Пример показывает, как включить доверенный контекст, переключить
пользователей и получить текущий идентификатор пользователя.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

14
reference/ibm_db2/functions/db2-cursor-type.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-cursor-type">
@@ -16,10 +16,10 @@
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает тип курсора, который используется в ресурсе
оператора.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,20 +28,20 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Корректный ресурс оператора.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Функция возвращает либо значение константы <constant>DB2_FORWARD_ONLY</constant>,
если ресурс инструкции использует курсор только для прямого перемещения,
либо <constant>DB2_SCROLLABLE</constant>, если ресурс инструкции использует прокручиваемый курсор.
</para>
</simpara>
</refsect1>
<!-- Use when examples exist

18
reference/ibm_db2/functions/db2-escape-string.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-escape-string">
<refnamediv>
@@ -15,9 +15,9 @@
<type>string</type><methodname>db2_escape_string</methodname>
<methodparam><type>string</type><parameter>string_literal</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Функция добавляет обратные слеши перед специальными символами в строковом аргументе.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -26,14 +26,14 @@
<varlistentry>
<term><parameter>string_literal</parameter></term>
<listitem>
<para>
<simpara>
Строка, которая содержит символы, которые требуется экранировать.
Символы, которые необходимо экранировать:
<literal>\x00</literal>, <literal>\n</literal>,
<literal>\r</literal>, <literal>\</literal>,
<literal>'</literal>, <literal>"</literal>
и <literal>\x1a</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -41,19 +41,19 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Функция возвращает параметр <parameter>string_literal</parameter>
с экранированными специальными символами.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования функции <function>db2_escape_string</function></title>
<para>
<simpara>
Результат выполнения функции <function>db2_escape_string</function>
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

54
reference/ibm_db2/functions/db2-exec.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-exec">
<refnamediv>
@@ -14,21 +14,21 @@
<methodparam><type>string</type><parameter>statement</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Выполняет SQL-запрос напрямую.
</para>
<para>
</simpara>
<simpara>
Если вы планируете интерполировать переменные PHP в SQL-запрос, имейте в виду,
что это одна из наиболее распространённых уязвимостей безопасности.
Рассмотрите возможность вызова <function>db2_prepare</function> для подготовки SQL-запроса
с маркерами параметров для входных значений. Затем вы можете вызвать <function>db2_execute</function>,
чтобы передать входные значения и избежать атак SQL-инъекций.
</para>
<para>
</simpara>
<simpara>
Если вы планируете многократно выполнять один и тот же SQL-запрос с разными параметрами,
рассмотрите возможность вызова <function>db2_prepare</function> и <function>db2_execute</function>,
чтобы сервер базы данных мог повторно использовать свой план доступа и повысить эффективность вашей базы данных.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -37,31 +37,31 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Допустимая переменная ресурса соединения с базой данных,
возвращаемого функцией <function>db2_connect</function> или <function>db2_pconnect</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>statement</parameter></term>
<listitem>
<para>
<simpara>
SQL-запрос. Запрос не может содержать маркеры параметров.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Ассоциативный массив, содержащий параметры оператора.
Параметр можно использовать для запроса прокручиваемого курсора на серверах баз данных,
поддерживающих эту функцию.
</para>
<para>
</simpara>
<simpara>
Описание допустимых опций оператора смотрите в разделе <function>db2_set_option</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -69,10 +69,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает ресурс оператора, в случае успешного выполнения SQL-запроса
или &false;, если базе данных не удалось выполнить SQL-запрос.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -80,10 +80,10 @@
<para>
<example>
<title>Создание таблицы с помощью <function>db2_exec</function></title>
<para>
<simpara>
В следующем примере <function>db2_exec</function> используется для
выполнения набора DDL-запросов в процессе создания таблицы.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -129,10 +129,10 @@ foreach ($animals as $animal) {
<example>
<title>Выполнение запроса SELECT с прокручиваемым курсором</title>
<para>
<simpara>
В следующем примере показано, как запросить прокручиваемый курсор для SQL-запроса,
выданного функцией <function>db2_exec</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -162,11 +162,11 @@ Rickety Ride
</example>
<example>
<title>Получение XML-данных как SQL ResultSet</title>
<para>
<simpara>
В следующем примере показано, как работать с документами, хранящимися в столбце XML
с помощью базы данных SAMPLE. Используя довольно простой SQL/XML, этот пример возвращает некоторые узлы в XML-документе
в формате SQL ResultSet, с которым знакомо большинство пользователей.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -203,11 +203,11 @@ db2_close($conn);
</example>
<example>
<title>Выполнение "JOIN" с данными XML</title>
<para>
<simpara>
Следующий пример работает с документами, хранящимися в 2 разных столбцах XML в базе данных SAMPLE.
Он создаёт 2 временные таблицы из XML-документов из 2 разных столбца и возвращает SQL ResultSet
с информацией о статусе доставки для клиента.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -258,10 +258,10 @@ db2_close($conn);
</example>
<example>
<title>Возврат SQL-данных как части большого XML-документа</title>
<para>
<simpara>
Следующий пример работает с частью документов PRODUCT.DESCRIPTION в базе данных SAMPLE.
Он создаёт XML-документ, содержащий описание продукта (данные XML) и информацию о ценах (данные SQL).
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

46
reference/ibm_db2/functions/db2-execute.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-execute">
<refnamediv>
@@ -13,11 +13,11 @@
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>parameters</parameter><initializer>[]</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>db2_execute</function> выполняет SQL-запрос,
подготовленный с помощью <function>db2_prepare</function>.
</para>
<para>
</simpara>
<simpara>
Если SQL-запрос возвращает набор результатов, например, инструкция SELECT или CALL для хранимой процедуры,
которая возвращает один или несколько наборов результатов, вы можете получить строку как массив
из ресурса <literal>stmt</literal>, используя <function>db2_fetch_assoc</function>,
@@ -25,12 +25,12 @@
В качестве альтернативы вы можете использовать <function>db2_fetch_row</function>
для перемещения указателя набора результатов на следующую строку и выборки столбца из этой строки
с помощью <function>db2_result</function>.
</para>
<para>
</simpara>
<simpara>
Обратитесь к <function>db2_prepare</function> для краткого обсуждения преимуществ
использования <function>db2_prepare</function> и
<function>db2_execute</function> вместо <function>db2_exec</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,18 +39,18 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Подготовленный запрос, возвращаемый функцией <function>db2_prepare</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>parameters</parameter></term>
<listitem>
<para>
<simpara>
Массив входных параметров, соответствующих любым маркерам параметров,
содержащимся в подготовленном запросе.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -58,9 +58,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -68,11 +68,11 @@
<para>
<example>
<title>Подготовка и выполнение SQL-запроса с маркерами параметров</title>
<para>
<simpara>
В следующем примере подготавливается запрос INSERT, который принимает четыре маркера параметров,
а затем выполняет итерацию по массиву массивов, содержащих входные значения,
которые необходимо передать в <function>db2_execute</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -100,14 +100,14 @@ if ($stmt) {
</example>
<example>
<title>Вызов хранимой процедуры с параметром OUT</title>
<para>
<simpara>
В следующем примере подготавливается запрос CALL, который принимает один маркер параметра,
представляющий параметр OUT, связывает переменную PHP <literal>$my_pets</literal>
с параметром с помощью <function>db2_bind_param</function>, а затем вызывает
<function>db2_execute</function> для выполнения запроса CALL.
После выполнения запроса CALL хранимой процедуры значение <literal>$num_pets</literal> изменяется,
чтобы отразить значение, возвращаемое хранимой процедурой для этого параметра OUT.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -128,12 +128,12 @@ print "У меня $num_pets домашних животных!";
</example>
<example>
<title>Возврат XML-данных как SQL ResultSet</title>
<para>
<simpara>
В следующем примере показано, как работать с документами, хранящимися в столбце XML
с помощью базы данных SAMPLE. Используя довольно простой SQL/XML,
этот пример возвращает некоторые узлы в XML-документе в формате SQL ResultSet,
с которым знакомо большинство пользователей.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -178,11 +178,11 @@ db2_close($conn);
</example>
<example>
<title>Выполнение "JOIN" с данными XML</title>
<para>
<simpara>
Следующий пример работает с документами, хранящимися в 2 разных столбцах XML в базе данных SAMPLE.
Он создаёт 2 временные таблицы из XML-документов из 2 разных столбца и возвращает SQL ResultSet
с информацией о статусе доставки для клиента.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -240,10 +240,10 @@ db2_close($conn);
</example>
<example>
<title>Возврат SQL-данных как части большого XML-документа</title>
<para>
<simpara>
Следующий пример работает с частью документов PRODUCT.DESCRIPTION в базе данных SAMPLE.
Он создаёт XML-документ, содержащий описание продукта (данные XML) и информацию о ценах (данные SQL).
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

26
reference/ibm_db2/functions/db2-fetch-array.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-fetch-array">
<refnamediv>
@@ -13,10 +13,10 @@
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>row_number</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает массив, индексированный по положению столбца, представляющий строку в наборе результатов.
Индекс столбцов начинается с 0.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,30 +25,30 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс <literal>stmt</literal>, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>row_number</parameter></term>
<listitem>
<para>
<simpara>
Запрашивает конкретную строку по индексу (начинается с 1) из набора результатов.
Передача параметра приводит к предупреждению PHP, если в наборе результатов используется курсор "forward-only".
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает индексированный массив (начинается с 0) со значениями столбцов, индексированными по позиции столбца,
представляющий следующую или запрошенную строку в наборе результатов.
Возвращает &false;, если в наборе результатов не осталось строк или если строка,
запрошенная <parameter>row_number</parameter>, не существует в наборе результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -56,10 +56,10 @@
<para>
<example>
<title>Перебор курсором "forward-only"</title>
<para>
<simpara>
Если вы вызываете <function>db2_fetch_array</function> без определённого номера строки,
он автоматически получает следующую строку в наборе результатов.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -88,11 +88,11 @@ while ($row = db2_fetch_array($stmt)) {
<example>
<title>Получение определённых строк с помощью <function>db2_fetch_array</function>
из прокручиваемого курсора</title>
<para>
<simpara>
Если в вашем наборе результатов используется прокручиваемый курсор,
вы можете вызвать <function>db2_fetch_array</function> с определённым номером строки.
В следующем примере извлекается каждая вторая строка в наборе результатов, начиная со второй строки.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

26
reference/ibm_db2/functions/db2-fetch-assoc.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-fetch-assoc">
<refnamediv>
@@ -13,9 +13,9 @@
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>row_number</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает массив, индексированный по имени столбца, представляющий строку в наборе результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -24,30 +24,30 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс <literal>stmt</literal>, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>row_number</parameter></term>
<listitem>
<para>
<simpara>
Запрашивает конкретную строку по индексу (начинается с 1) из набора результатов.
Передача параметра приводит к предупреждению PHP, если в наборе результатов используется курсор "forward-only".
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает ассоциативный массив со значениями столбцов, проиндексированными по имени столбца,
представляющий следующую или запрошенную строку в наборе результатов.
Возвращает &false;, если в наборе результатов не осталось строк или если строка,
запрошенная <parameter>row_number</parameter>, не существует в наборе результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -55,10 +55,10 @@
<para>
<example>
<title>Перебор курсором "forward-only"</title>
<para>
<simpara>
Если вы вызываете <function>db2_fetch_assoc</function> без определённого номера строки,
он автоматически получает следующую строку в наборе результатов.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -87,11 +87,11 @@ while ($row = db2_fetch_assoc($stmt)) {
<example>
<title>Получение определённых строк с помощью <function>db2_fetch_assoc</function>
из прокручиваемого курсора</title>
<para>
<simpara>
Если в вашем наборе результатов используется прокручиваемый курсор,
вы можете вызвать <function>db2_fetch_assoc</function> с определённым номером строки.
В следующем примере извлекается каждая вторая строка в наборе результатов, начиная со второй строки.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

26
reference/ibm_db2/functions/db2-fetch-both.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-fetch-both">
<refnamediv>
@@ -13,12 +13,12 @@
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>row_number</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает массив, индексированный как по имени столбца, так и по позиции, представляющий строку в наборе результатов.
Обратите внимание, что строка, возвращаемая <function>db2_fetch_both</function>, требует больше памяти,
чем массивы с одним индексом, возвращаемые <function>db2_fetch_assoc</function> или
<function>db2_fetch_array</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,30 +27,30 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс <literal>stmt</literal>, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>row_number</parameter></term>
<listitem>
<para>
<simpara>
Запрашивает конкретную строку по индексу (начинается с 1) из набора результатов.
Передача параметра приводит к предупреждению PHP, если в наборе результатов используется курсор "forward-only".
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает ассоциативный массив со значениями столбцов, проиндексированными как по имени столбца,
так и по индексу столбца (начиная с 0). Массив представляет следующую или запрошенную строку в наборе результатов.
Возвращает &false;, если в наборе результатов не осталось строк или если строка,
запрошенная <parameter>row_number</parameter>, не существует в наборе результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -58,12 +58,12 @@
<para>
<example>
<title>Перебор курсором "forward-only"</title>
<para>
<simpara>
Если вы вызываете <function>db2_fetch_both</function> без определённого номера строки,
он автоматически получает следующую строку в наборе результатов.
В следующем примере доступ к столбцам в возвращаемом массиве осуществляется как по имени столбца,
так и по числовому индексу.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -92,11 +92,11 @@ while ($row = db2_fetch_both($stmt)) {
<example>
<title>Получение определённых строк с помощью <function>db2_fetch_both</function>
из прокручиваемого курсора</title>
<para>
<simpara>
Если в вашем наборе результатов используется прокручиваемый курсор,
вы можете вызвать <function>db2_fetch_both</function> с определённым номером строки.
В следующем примере извлекается каждая вторая строка в наборе результатов, начиная со второй строки.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

34
reference/ibm_db2/functions/db2-fetch-object.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-fetch-object">
<refnamediv>
@@ -13,10 +13,10 @@
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>row_number</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает объект, в котором каждое свойство представляет столбец,
возвращённый в строке, полученной из набора результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,54 +25,54 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс <literal>stmt</literal>, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>row_number</parameter></term>
<listitem>
<para>
<simpara>
Запрашивает конкретную строку по индексу (начинается с 1) из набора результатов.
Передача параметра приводит к предупреждению PHP, если в наборе результатов используется курсор "forward-only".
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает объект, представляющий одну строку в наборе результатов.
Свойства объекта сопоставляются с именами столбцов в наборе результатов.
</para>
<para>
</simpara>
<simpara>
Серверы баз данных IBM DB2, Cloudscape и Apache Derby обычно переводят имена столбцов
в верхний регистр, поэтому свойства объекта будут отражать этот регистр.
</para>
<para>
</simpara>
<simpara>
Если запрос SELECT вызывает скалярную функцию для изменения значения столбца,
серверы баз данных возвращают номер столбца как имя столбца в наборе результатов.
Если требуется более осмысленное имя столбца и свойство объекта,
вы можете использовать конструкцию AS, чтобы присвоить имя столбцу в наборе результатов.
</para>
<para>
</simpara>
<simpara>
Возвращает &false;, если ни одна строка не была получена.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования <function>db2_fetch_object</function></title>
<para>
<simpara>
В следующем примере выполняется запрос SELECT со скалярной функцией RTRIM,
которая удаляет пробелы в конце столбца. Вместо того, чтобы создавать объект со свойствами "BREED" и "2",
мы используем конструкцию AS в запросе SELECT для присвоения имени "name" изменённому столбцу.
Сервер базы данных переводит имена столбцов в верхний регистр,
в результате чего получается объект со свойствами "BREED" и "NAME".
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

34
reference/ibm_db2/functions/db2-fetch-row.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-fetch-row">
<refnamediv>
@@ -13,21 +13,21 @@
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>row_number</parameter><initializer>-1</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Используйте <function>db2_fetch_row</function> для итерации по набору результатов или для указания
на определённую строку в наборе результатов, если вы запросили прокручиваемый курсор.
</para>
<para>
</simpara>
<simpara>
Чтобы получить отдельные поля из набора результатов,
вызовите функцию <function>db2_result</function>.
</para>
<para>
</simpara>
<simpara>
Вместо того, чтобы вызывать <function>db2_fetch_row</function> и
<function>db2_result</function>, большинство приложений будет вызывать одну
из функций <function>db2_fetch_assoc</function>, <function>db2_fetch_both</function>
или <function>db2_fetch_array</function>, чтобы продвинуть указатель набора результатов
и вернуть полную строку в виде массива.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,28 +36,28 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс <literal>stmt</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>row_number</parameter></term>
<listitem>
<para>
<simpara>
С помощью прокручиваемых курсоров вы можете запросить конкретный
номер строки в наборе результатов. Нумерация строк начинается с 1.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает &true;, если запрошенная строка существует в наборе результатов.
Возвращает &false;, если запрошенная строка не существует в наборе результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -65,11 +65,11 @@
<para>
<example>
<title>Итерации по набору результатов</title>
<para>
<simpara>
В следующем примере показано, как выполнить итерацию по набору результатов с помощью
<function>db2_fetch_row</function> и получить столбцы из набора результатов
с помощью <function>db2_result</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -96,7 +96,7 @@ goat Rickety Ride
</example>
<example>
<title>Рекомендуемые альтернативы db2_fetch_row/db2_result для i5/OS</title>
<para>
<simpara>
В i5/OS рекомендуется использовать <function>db2_fetch_both</function>,
<function>db2_fetch_array</function> или <function>db2_fetch_object</function>
вместо <function>db2_fetch_row</function>/<function>db2_result</function>.
@@ -106,7 +106,7 @@ goat Rickety Ride
Вы также можете обнаружить, что производительность <function>db2_fetch_both</function>,
<function>db2_fetch_array</function> и <function>db2_fetch_object</function>
превосходит <function>db2_fetch_row</function>/<function>db2_result</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

18
reference/ibm_db2/functions/db2-field-display-size.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-field-display-size">
<refnamediv>
@@ -14,9 +14,9 @@
<methodparam><type class="union"><type>int</type><type>string</type></type><parameter>column</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает максимальное количество байтов, необходимое для отображения столбца в наборе результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,28 +25,28 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Задаёт ресурс оператора, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>column</parameter></term>
<listitem>
<para>
<simpara>
Задаёт столбец в наборе результатов. Это может быть целое число, представляющее индекс столбца (начиная с 0)
или строка, содержащая имя столбца.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает целочисленное значение с максимальным количеством байтов, необходимых для отображения указанного столбца.
Если указанный столбец не существует в наборе результатов, <function>db2_field_display_size</function> возвращает &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

18
reference/ibm_db2/functions/db2-field-name.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-field-name">
<refnamediv>
@@ -14,9 +14,9 @@
<methodparam><type class="union"><type>int</type><type>string</type></type><parameter>column</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает имя указанного столбца в наборе результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,28 +25,28 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Задаёт ресурс оператора, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>column</parameter></term>
<listitem>
<para>
<simpara>
Задаёт столбец в наборе результатов. Это может быть целое число, представляющее индекс столбца (начиная с 0)
или строка, содержащая имя столбца.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку, содержащую имя указанного столбца.
Если указанный столбец не существует в наборе результатов, <function>db2_field_name</function> возвращает &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

18
reference/ibm_db2/functions/db2-field-num.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-field-num">
<refnamediv>
@@ -14,9 +14,9 @@
<methodparam><type class="union"><type>int</type><type>string</type></type><parameter>column</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает позицию указанного столбца в наборе результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,28 +25,28 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Задаёт ресурс оператора, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>column</parameter></term>
<listitem>
<para>
<simpara>
Задаёт столбец в наборе результатов. Это может быть целое число, представляющее индекс столбца (начиная с 0)
или строка, содержащая имя столбца.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает целое число, содержащее индекс (начиная с 0) указанного столбца в наборе результатов.
Если указанный столбец не существует в наборе результатов, <function>db2_field_num</function> возвращает &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

18
reference/ibm_db2/functions/db2-field-precision.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-field-precision">
<refnamediv>
@@ -14,9 +14,9 @@
<methodparam><type class="union"><type>int</type><type>string</type></type><parameter>column</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает точность указанного столбца в наборе результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,29 +25,29 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Задаёт ресурс оператора, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>column</parameter></term>
<listitem>
<para>
<simpara>
Задаёт столбец в наборе результатов. Это может быть целое число, представляющее индекс столбца (начиная с 0)
или строка, содержащая имя столбца.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает целое число, содержащее точность указанного столбца.
Если указанный столбец не существует в наборе результатов,
<function>db2_field_precision</function> возвращает &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

18
reference/ibm_db2/functions/db2-field-scale.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-field-scale">
<refnamediv>
@@ -14,9 +14,9 @@
<methodparam><type class="union"><type>int</type><type>string</type></type><parameter>column</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает масштаб указанного столбца в наборе результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,28 +25,28 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Задаёт ресурс оператора, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>column</parameter></term>
<listitem>
<para>
<simpara>
Задаёт столбец в наборе результатов. Это может быть целое число, представляющее индекс столбца (начиная с 0)
или строка, содержащая имя столбца.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает целое число, содержащее масштаб указанного столбца.
Если указанный столбец не существует в наборе результатов, <function>db2_field_scale</function> возвращает &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

18
reference/ibm_db2/functions/db2-field-type.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-field-type">
<refnamediv>
@@ -16,9 +16,9 @@
<methodparam><type class="union"><type>int</type><type>string</type></type><parameter>column</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает тип данных указанного столбца в наборе результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,29 +27,29 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Задаёт ресурс оператора, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>column</parameter></term>
<listitem>
<para>
<simpara>
Задаёт столбец в наборе результатов. Это может быть либо целое число,
представляющее позицию столбца с индексом 0, либо строка, содержащая имя столбца.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку, содержащую определённый тип данных указанного столбца.
Если указанный столбец не существует в наборе результатов,
<function>db2_field_type</function> возвращает &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

18
reference/ibm_db2/functions/db2-field-width.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-field-width">
<refnamediv>
@@ -16,11 +16,11 @@
<methodparam><type class="union"><type>int</type><type>string</type></type><parameter>column</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает ширину текущего значения указанного столбца в наборе результатов.
Это максимальная ширина столбца для типа данных фиксированной длины или
фактическая ширина столбца для типа данных переменной длины.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -29,29 +29,29 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Задаёт ресурс оператора, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>column</parameter></term>
<listitem>
<para>
<simpara>
Задаёт столбец в наборе результатов. Это может быть либо целое число,
представляющее позицию столбца с индексом 0, либо строка, содержащая имя столбца.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает целое число, содержащее ширину указанного столбца символьного или
двоичного типа данных в наборе результатов. Если указанный столбец не существует в наборе результатов,
<function>db2_field_width</function> возвращает &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

22
reference/ibm_db2/functions/db2-foreign-keys.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-foreign-keys">
<refnamediv>
@@ -16,9 +16,9 @@
<methodparam><type>string</type><parameter>table_name</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает набор результатов, в котором перечислены внешние ключи таблицы.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,35 +27,35 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Допустимое соединение с базой данных IBM DB2, Cloudscape или Apache Derby.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>qualifier</parameter></term>
<listitem>
<para>
<simpara>
Квалификатор для баз данных DB2, работающих на серверах OS/390 или z/OS.
Для других баз данных передайте &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>schema</parameter></term>
<listitem>
<para>
<simpara>
Схема, содержащая таблицы. Если <parameter>schema</parameter> равно &null;,
<function>db2_foreign_keys</function> соответствует схеме для текущего соединения.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>table_name</parameter></term>
<listitem>
<para>
<simpara>
Название таблицы.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

14
reference/ibm_db2/functions/db2-free-result.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-free-result">
@@ -16,12 +16,12 @@
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Освобождает ресурсы системы и базы данных, связанные с набором результатов.
Эти ресурсы неявно освобождаются при завершении скрипта, но вы можете вызвать
<function>db2_free_result</function>, чтобы явно освободить
ресурсы набора результатов до завершения скрипта.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,18 +30,18 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс выражения.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

14
reference/ibm_db2/functions/db2-free-stmt.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-free-stmt">
@@ -16,12 +16,12 @@
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Освобождает ресурсы системы и базы данных, связанные с ресурсом выражения.
Эти ресурсы неявно освобождаются при завершении скрипта, но вы можете вызвать
<function>db2_free_stmt</function>, чтобы явно освободить ресурсы
выражения до окончания работы скрипта.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,18 +30,18 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс выражения.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

42
reference/ibm_db2/functions/db2-get-option.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-get-option">
<refnamediv>
@@ -14,9 +14,9 @@
<methodparam><type>resource</type><parameter>resource</parameter></methodparam>
<methodparam><type>string</type><parameter>option</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Извлекает значение указанного параметра для ресурса оператора или ресурса соединения.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,11 +25,11 @@
<varlistentry>
<term><parameter>resource</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс оператора, возвращаемый <function>db2_prepare</function>
или допустимый ресурс соединения, возвращаемый <function>db2_connect</function> или
<function>db2_pconnect</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -40,17 +40,17 @@
Они предоставляют полезную информацию для отслеживания, которую можно установить во время выполнения
с помощью <function>db2_get_option</function>.
<note>
<para>
<simpara>
Предыдущие версии ibm_db2 не поддерживают эти новые параметры.
</para>
<para>
</simpara>
<simpara>
Когда устанавливается значение в каждой опции, некоторые серверы могут не обрабатывать
всю предоставленную длину и могут усекать значение.
</para>
<para>
</simpara>
<simpara>
Чтобы обеспечить правильное преобразование данных, указанных в каждой опции,
при передаче в хост-систему, используйте только символы от A до Z, от 0 до 9, знак подчёркивания (_) или точку (.).
</para>
</simpara>
</note>
<variablelist>
<varlistentry>
@@ -61,11 +61,11 @@
используемую для идентификации ID пользователя клиента,
отправляемого на сервер базы данных хоста при использовании DB2 Connect.
<note>
<para>
<simpara>
Серверы DB2 для z/OS и OS/390 поддерживают длину до 16 символов.
Идентификатор пользователя не следует путать с идентификатором пользователя для аутентификации,
он используется только для целей идентификации и не используется для какой-либо авторизации.
</para>
</simpara>
</note>
</para>
</listitem>
@@ -78,9 +78,9 @@
с завершающим нулём, используемую для идентификации учётной строки клиента,
отправляемой на сервер базы данных хоста при использовании DB2 Connect.
<note>
<para>
<simpara>
Серверы DB2 для z/OS и OS/390 поддерживают длину до 200 символов.
</para>
</simpara>
</note>
</para>
</listitem>
@@ -93,9 +93,9 @@
с завершающим нулём, используемую для идентификации имени клиентского приложения,
отправляемого на сервер базы данных хоста при использовании DB2 Connect.
<note>
<para>
<simpara>
Серверы DB2 для z/OS и OS/390 поддерживают длину до 32 символов.
</para>
</simpara>
</note>
</para>
</listitem>
@@ -108,9 +108,9 @@
с завершающим нулём, используемую для идентификации имени клиентского приложения,
отправляемого на сервер базы данных хоста при использовании DB2 Connect.
<note>
<para>
<simpara>
Серверы DB2 для z/OS и OS/390 поддерживают длину до 18 символов.
</para>
</simpara>
</note>
</para>
</listitem>
@@ -179,9 +179,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает текущую настройку атрибута подключения, предоставленную в случае успешного выполнения&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

34
reference/ibm_db2/functions/db2-last-insert-id.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-last-insert-id">
<refnamediv>
@@ -13,31 +13,31 @@
<type class="union"><type>string</type><type>null</type></type><methodname>db2_last_insert_id</methodname>
<methodparam><type>resource</type><parameter>resource</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает автоматически сгенерированный идентификатор последнего запроса на добавление, успешно выполненного в этом соединении.
</para>
</simpara>
<para>
На результат этой функции не влияет ни одно из следующего:
<itemizedlist>
<listitem>
<para>
<simpara>
Оператор INSERT для одной строки с VALUES для таблицы без столбца идентификаторов.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
Оператор INSERT для нескольких строк с VALUES.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
Оператор INSERT с полной выборкой.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
Оператор ROLLBACK TO SAVEPOINT.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -49,11 +49,11 @@
<varlistentry>
<term><parameter>resource</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс подключения, возвращаемый <function>db2_connect</function>
или <function>db2_pconnect</function>.
Значение этого параметра не может быть ресурсом оператора или ресурсом набора результатов.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -61,20 +61,20 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает автоматически сгенерированный идентификатор последнего запроса на добавление,
успешно выполненного в этом соединении.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example xml:id="db2-last-insert-id.example.basic">
<title>Пример использования <function>db2_last_insert_id</function></title>
<para>
<simpara>
В следующем примере показано, как вернуть автоматически сгенерированный идентификатор последнего запроса на добавление,
успешно выполненного в этом соединении.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

26
reference/ibm_db2/functions/db2-lob-read.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-lob-read">
<refnamediv>
@@ -15,10 +15,10 @@
<methodparam><type>int</type><parameter>colnum</parameter></methodparam>
<methodparam><type>int</type><parameter>length</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Используйте <function>db2_lob_read</function> для итерации по указанному столбцу набора результатов
и получения заданного пользователем размера LOB-данных.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,25 +27,25 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс <literal>stmt</literal>, содержащий LOB-данные.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>colnum</parameter></term>
<listitem>
<para>
<simpara>
Допустимый номер столбца в наборе результатов ресурса <literal>stmt</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>length</parameter></term>
<listitem>
<para>
<simpara>
Размер LOB-данных, извлекаемых из ресурса <literal>stmt</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -53,18 +53,18 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает количество данных, указанных пользователем.
Возвращает &false;, если данные не могут быть получены.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Итерации по разным типам данных</title>
<para>
</para>
<simpara>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

18
reference/ibm_db2/functions/db2-next-result.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-next-result">
<refnamediv>
@@ -13,12 +13,12 @@
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Хранимая процедура может возвращать ноль или более наборов результатов.
Хотя вы обрабатываете первый набор результатов точно так же, как и результаты, возвращаемые простым оператором SELECT,
для получения второго и последующих наборов результатов из хранимой процедуры вы должны вызвать функцию
<function>db2_next_result</function> и вернуть результат в переменную PHP с уникальным именем.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,33 +27,33 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Подготовленный оператор, возвращаемый функцией <function>db2_exec</function> или
<function>db2_execute</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает новый ресурс оператора, содержащий следующий набор результатов,
если хранимая процедура вернула другой набор результатов.
Возвращает &false;, если хранимая процедура не вернула другой набор результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Вызов хранимой процедуры, возвращающей несколько наборов результатов</title>
<para>
<simpara>
В следующем примере вызывается хранимая процедура, которая возвращает три набора результатов.
Первый набор результатов извлекается непосредственно из того же ресурса операторов, для которого вызывается оператор CALL,
а второй и третий наборы результатов извлекаются из ресурсов операторов,
возвращаемых вызовами функции <function>db2_next_result</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

18
reference/ibm_db2/functions/db2-num-fields.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-num-fields">
<refnamediv>
@@ -16,12 +16,12 @@
</methodsynopsis>
<para>
<simpara>
Возвращает количество полей в результирующем наборе. Это
полезно при обработке результирующих наборов динамически
сформированных запросов, или в случае использования
хранимых процедур.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,28 +30,28 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Корректный ресурс оператора, содержащий результирующий набор.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает число полей в результирующем наборе или
&false;, если передан некорректный ресурс оператора.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Получение количества полей в результирующем наборе</title>
<para>
<simpara>
Следующий пример демонстрирует получение количества полей в результирующем наборе.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

26
reference/ibm_db2/functions/db2-num-rows.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-num-rows">
<refnamediv>
@@ -13,23 +13,23 @@
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает количество строк, удалённых, добавленных или обновлённых SQL-запросом.
</para>
<para>
</simpara>
<simpara>
Чтобы определить количество строк, которые будут возвращены оператором SELECT, введите SELECT COUNT(*) с теми же параметрами,
что и предполагаемый оператор SELECT и получите значение.
</para>
<para>
</simpara>
<simpara>
Если логика вашего приложения проверяет количество строк, возвращаемых оператором SELECT и ветвей,
если количество строк равно 0, рассмотрите возможность изменения вашего приложения,
чтобы попытаться вернуть первую строку одной из функций <function>db2_fetch_assoc</function>,
<function>db2_fetch_both</function>, <function>db2_fetch_array</function> или <function>db2_fetch_row</function>
и переходите, если функция выборки возвращает &false;.
</para>
</simpara>
<note>
<para>
<simpara>
Если вы выполняете оператор SELECT с помощью прокручиваемого курсора,
<function>db2_num_rows</function> возвращает количество строк, возвращаемых оператором SELECT.
Однако накладные расходы, связанные с прокручиваемыми курсорами, значительно ухудшают производительность вашего приложения,
@@ -37,7 +37,7 @@
вам следует использовать курсор "forward-only" и либо вызвать SELECT COUNT(*),
либо полагаться на логическое значение (<type>bool</type>), которое возвращает значение функций выборки
для достижения эквивалентной функциональности с гораздо большей производительностью.
</para>
</simpara>
</note>
</refsect1>
@@ -48,9 +48,9 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс <literal>stmt</literal>, содержащий набор результатов.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -58,10 +58,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает количество строк, затронутых последним SQL-оператором,
выданным указанным дескриптором оператора&return.falseforfailure;.
</para>
</simpara>
</refsect1>
</refentry>

22
reference/ibm_db2/functions/db2-pclose.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-pclose">
<refnamediv>
@@ -17,17 +17,17 @@
Функция закрывает клиентское соединение DB2, созданное с помощью <function>db2_pconnect</function>
и возвращает соответствующие ресурсы серверу базы данных.
<note>
<para>
<simpara>
Эта функция доступна только в i5/OS в ответ на запросы системного администратора i5/OS.
</para>
</simpara>
</note>
</para>
<para>
<simpara>
Если у вас есть постоянное клиентское соединение DB2, созданное с помощью <function>db2_pconnect</function>,
вы можете использовать эту функцию, чтобы закрыть соединение.
Чтобы избежать значительных потерь производительности соединения, эту функцию следует использовать только в редких случаях,
когда постоянное соединение перестало отвечать или постоянное соединение не будет требоваться в течение длительного периода времени.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,9 +36,9 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Задаёт активное соединение клиента DB2.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -46,19 +46,19 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example xml:id="db2-pclose.example.basic"><!-- {{{ -->
<title>Закрытие постоянного соединения</title>
<para>
<simpara>
В следующем примере демонстрируется успешная попытка закрыть соединение
с базой данных IBM DB2 i5/OS.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

274
reference/ibm_db2/functions/db2-pconnect.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.db2-pconnect">
<refnamediv>
@@ -15,27 +15,27 @@
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Функция возвращает постоянное соединение с базой данных IBM DB2 Universal Database,
IBM Cloudscape или Apache Derby.
</para>
</simpara>
<para>
<simpara>
Дополнительную информацию о постоянных соединениях даёт раздел «<xref linkend="features.persistent-connections"/>».
</para>
</simpara>
<para>
<simpara>
Вызов функции <function>db2_close</function> при постоянном соединении каждый раз возвращает &true;,
но базовое клиентское DB2-соединение остаётся открытым и ожидает обслуживания следующего
соответствующего запроса функции <function>db2_pconnect</function>.
</para>
</simpara>
<para>
<simpara>
Пользователи, которые используют модуль ibm_db2 версии 1.9.0 или новее, должны знать,
что модуль выполнит откат транзакции для постоянных соединений в конце запроса,
чем завершит транзакцию. Это предотвращает перенос блока транзакции на следующий запрос,
который использует это соединение, если выполнение скрипта завершается раньше, чем блок транзакции.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -44,10 +44,10 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
Для каталогизированного подключения к базе данных параметр <parameter>database</parameter>
представляет псевдоним базы данных в клиентском каталоге БД DB2.
</para>
</simpara>
<para>
Для некаталогизированного подключения к базе данных
параметр <parameter>database</parameter> представляет полную строку
@@ -68,41 +68,41 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
Имя базы данных.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
<simpara>
Имя хоста или IP-адрес сервера базы данных.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>port</parameter></term>
<listitem>
<para>
<simpara>
Порт TCP/IP, который используется базой данных для принятия запросов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>username</parameter></term>
<listitem>
<para>
<simpara>
Имя пользователя, под которым выполняется подключение к базе данных.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>password</parameter></term>
<listitem>
<para>
<simpara>
Пароль, с которым выполняется подключение к базе данных.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -112,17 +112,17 @@
<varlistentry>
<term><parameter>username</parameter></term>
<listitem>
<para>
<simpara>
Имя пользователя, под которым выполняется подключение к базе данных.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>password</parameter></term>
<listitem>
<para>
<simpara>
Пароль, который используется при подключении к базе данных.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -135,46 +135,46 @@
<varlistentry>
<term><parameter>autocommit</parameter></term>
<listitem>
<para>
<simpara>
Передача значения <constant>DB2_AUTOCOMMIT_ON</constant>
включает автоматическую фиксацию для этого дескриптора соединения.
</para>
<para>
</simpara>
<simpara>
Передача значения <constant>DB2_AUTOCOMMIT_OFF</constant>
выключает автоматическую фиксацию для этого дескриптора соединения.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>DB2_ATTR_CASE</parameter></term>
<listitem>
<para>
<simpara>
Передача значения <constant>DB2_CASE_NATURAL</constant> указывает,
что имена столбцов возвращаются в естественном регистре.
</para>
<para>
</simpara>
<simpara>
Передача значения <constant>DB2_CASE_LOWER</constant> указывает,
что имена столбцов возвращаются в нижнем регистре.
</para>
<para>
</simpara>
<simpara>
Передача значения <constant>DB2_CASE_UPPER</constant> указывает,
что имена столбцов возвращаются в верхнем регистре.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>CURSOR</parameter></term>
<listitem>
<para>
<simpara>
Передача значения <constant>DB2_FORWARD_ONLY</constant> задаёт курсор
только вперёд для ресурса оператора.
Это тип курсора по умолчанию, который поддерживается на всех серверах баз данных.
</para>
<para>
</simpara>
<simpara>
Передача значения <constant>DB2_SCROLLABLE</constant> задаёт прокручиваемый курсор
для ресурса оператора. Этот режим включает произвольный доступ к строкам в наборе результатов,
но пока поддерживается только СУБД DB2 Universal Database операционной системы IBM.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -185,18 +185,18 @@
<varlistentry>
<term><parameter>trustedcontext</parameter></term>
<listitem>
<para>
<simpara>
Передача значения DB2_TRUSTED_CONTEXT_ENABLE включает доверенный контекст
для этого дескриптора соединения. Параметр нельзя установить
функцией <function>db2_set_option</function>.
</para>
<para>
</simpara>
<simpara>
Ключ работает только тогда, когда базу данных каталогизировали
(даже если база данных локальная) или если указали полное DSN-имя при создании соединения.
</para>
<para>
</simpara>
<simpara>
Чтобы каталогизировать базу данных, вызывают следующие команды:
</para>
</simpara>
<literallayout>db2 catalog tcpip node loopback remote &lt;SERVERNAME&gt; server &lt;SERVICENAME&gt;
db2 catalog database &lt;LOCALDBNAME&gt; as &lt;REMOTEDBNAME&gt; at node loopback
db2 "update dbm cfg using svcename &lt;SERVICENAME&gt;"
@@ -209,39 +209,39 @@ db2set DB2COMM=TCPIP</literallayout>
<para>
Следующие новые параметры ОС i5/OS доступны в модуле ibm_db2 версии 1.5.1 и новее.
<tip>
<para>
<simpara>
Конфликтующие атрибуты соединения, которые используются вместе с постоянными соединениями,
могут привести к неопределённым результатам в ОС i5/OS. Требуется установить политики сайта для каждого приложения,
которое использует каждый профиль пользователя с постоянным подключением.
При работе с постоянными соединениями предлагается значение по умолчанию: DB2_AUTOCOMMIT_ON.
</para>
</simpara>
</tip>
<variablelist>
<varlistentry>
<term><parameter>i5_lib</parameter></term>
<listitem>
<para>
<simpara>
Символьное значение, которое указывает библиотеку по умолчанию,
которая будет использоваться для разрешения неквалифицированных ссылок на файлы.
Недопустимо, если соединение использует режим именования системы.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_naming</parameter></term>
<listitem>
<para>
<simpara>
Значение <literal>DB2_I5_NAMING_ON</literal> включает режим именования системы DB2 UDB CLI iSeries.
Файлы квалифицируются через разделитель в виде слеша (/).
Неквалифицированные файлы разрешаются через список библиотек для задания.
</para>
<para>
</simpara>
<simpara>
Значение <literal>DB2_I5_NAMING_OFF</literal> отключает режим именования по умолчанию
CLI DB2 UDB, который представляет собой именование SQL.
Файлы квалифицируются через разделитель в виде точки (.).
Неквалифицированные файлы разрешаются либо через библиотеки по умолчанию,
либо через текущий идентификатор пользователя.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -254,67 +254,67 @@ db2set DB2COMM=TCPIP</literallayout>
для дескриптора соединения, если значение изменяется после установки соединения,
и соединение установилось с удалённым источником данных.
<note>
<para>
<simpara>
Параметр <parameter>ibm_db2.i5_allow_commit</parameter>==0 файла php.ini
или параметр <literal>DB2_I5_TXN_NO_COMMIT</literal> — значение по умолчанию,
но он доступен для изменения через параметр <parameter>i5_commit</parameter>.
</para>
</simpara>
</note>
</para>
<para>
<simpara>
<literal>DB2_I5_TXN_NO_COMMIT</literal> — Контроль фиксации не используется.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_TXN_READ_UNCOMMITTED</literal> — Грязное чтение, неповторимые
reads, and phantoms are possible.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_TXN_READ_COMMITTED</literal> — Грязное чтение невозможно.
Возможны неповторяющееся чтение и фантомы.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_TXN_REPEATABLE_READ</literal> — Грязное чтение и неповторяющиеся читки невозможны.
Возможны фантомы.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_TXN_SERIALIZABLE</literal> — Транзакции сериализуемы.
Грязное чтение, неповторяющееся чтение и фантомы невозможны.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_query_optimize</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_FIRST_IO</literal> Все запросы оптимизированы с целью максимально
быстрого возврата первой страницы вывода. Эта цель хорошо работает, когда вывод контролируется пользователем,
который, скорее всего, отменит запрос после просмотра первой страницы выходных данных.
Запросы, закодированные с предложением OPTIMIZE FOR nnn ROWS, соответствуют цели, указанной в предложении.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_ALL_IO</literal> Все запросы оптимизированы с целью выполнить весь запрос
о завершения в кратчайшие сроки. Это хороший вариант, когда выходные данные запроса записываются в файл или отчёт
или когда интерфейс ставит выходные данные в очередь. Запросы, закодированные с предложением
OPTIMIZE FOR nnn ROWS, соответствуют цели, указанной в предложении. Это значение по умолчанию.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_dbcs_alloc</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_DBCS_ALLOC_ON</literal> Значение включает схему распределения DB2 6X для увеличения
размера столбца преобразования DBCS.
</para>
</simpara>
<para>
<literal>DB2_I5_DBCS_ALLOC_OFF</literal> Значение выключает схему распределения DB2 6X для увеличения
размера столбца преобразования DBCS.
<note>
<para>
<simpara>
Параметр <parameter>ibm_db2.i5_dbcs_alloc</parameter>==0 файла php.ini
или параметр <literal>DB2_I5_DBCS_ALLOC_OFF</literal> — значение по умолчанию,
но его можно изменить через параметр <parameter>i5_dbcs_alloc</parameter>.
</para>
</simpara>
</note>
</para>
</listitem>
@@ -322,117 +322,117 @@ db2set DB2COMM=TCPIP</literallayout>
<varlistentry>
<term><parameter>i5_date_fmt</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_FMT_ISO</literal> — Формат даты Международной организации
по стандартизации ISO yyyy-mm-dd. Это значение по умолчанию.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_USA</literal> — Формат даты США mm/dd/yyyy.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_EUR</literal> — Европейский формат даты dd.mm.yyyy.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_JIS</literal> — Японский формат даты yyyy-mm-dd.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_MDY</literal> — Формат даты mm/dd/yyyy.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_DMY</literal> — Формат даты dd/mm/yyyy.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_YMD</literal> — Формат даты yy/mm/dd.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_JUL</literal> — Используется юлианский формат даты yy/ddd.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_JOB</literal> — Используется задание по умолчанию.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_date_sep</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_SEP_SLASH</literal> — Разделитель даты — слеш (/).
Это значение по умолчанию.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_DASH</literal> — Разделитель даты — дефис (-).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_PERIOD</literal> — Разделитель даты — точка (.).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_COMMA</literal> — Разделитель даты — запятая (,).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_BLANK</literal> — Разделитель даты — пробел.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_JOB</literal> — Задание по умолчанию.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_time_fmt</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_FMT_ISO</literal> — Формат времени Международной организации
по стандартизации ISO hh.mm.ss. Это значение по умолчанию.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_USA</literal> — Формат времени США hh:mmxx,
где xx — это AM или PM.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_EUR</literal> — Европейский формат времени hh.mm.ss.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_JIS</literal> — Японский промышленный стандартный
формат времени hh:mm:ss.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FMT_HMS</literal> — Формат hh:mm:ss.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_time_sep</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_SEP_COLON</literal> — Разделитель времени — двоеточие (:).
Это значение по умолчанию.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_PERIOD</literal> — Разделитель времени — точка (.).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_COMMA</literal> — Разделитель времени — запятая (,).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_BLANK</literal> — Разделитель времени — пробел.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_JOB</literal> — Задание по умолчанию.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i5_decimal_sep</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_SEP_PERIOD</literal> — Десятичный разделитель — точка (.).
Это значение по умолчанию.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_COMMA</literal> — Десятичный разделитель — запятая (,).
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_SEP_JOB</literal> — Задание по умолчанию.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -449,10 +449,10 @@ db2set DB2COMM=TCPIP</literallayout>
Элементы списка библиотек указывают через пробелы:
'i5_libl'=&gt;"MYLIB YOURLIB ANYLIB".
<note>
<para>
<simpara>
Библиотека i5_libl вызывает qsys2/qcmdexc ('cmd',cmdlen),
который доступен только в ОС i5/OS V5R4 и новее.
</para>
</simpara>
</note>
</para>
</listitem>
@@ -466,13 +466,13 @@ db2set DB2COMM=TCPIP</literallayout>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Функция возвращает ресурс дескриптора подключения в случае успешной попытки подключения.
Функция <function>db2_pconnect</function> пытается переиспользовать существующий ресурс подключения,
который точно соответствует параметрам <parameter>database</parameter>, <parameter>username</parameter>
и <parameter>password</parameter>.
Функция <function>db2_pconnect</function> возвращает &false;, если возникла ошибка подключения.
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
@@ -530,12 +530,12 @@ db2set DB2COMM=TCPIP</literallayout>
Пример возврата постоянного соединения с базой данных
функцией <function>db2_pconnect</function>
</title>
<para>
<simpara>
В следующем примере первый вызов функции <function>db2_pconnect</function>
возвращает новый ресурс постоянного соединения. Второй вызов функции
<function>db2_pconnect</function> возвращает ресурс постоянного соединения,
который просто переиспользует первый ресурс постоянного соединения.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -573,10 +573,10 @@ if ($pconn) {
</example>
<example>
<title>Пример работы с доверенным контекстом</title>
<para>
<simpara>
Следующий пример показывает, как включить доверенный контекст,
переключить пользователей и получить текущий идентификатор пользователя.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

42
reference/ibm_db2/functions/db2-prepare.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-prepare">
<refnamediv>
@@ -14,39 +14,39 @@
<methodparam><type>string</type><parameter>statement</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>db2_prepare</function> создаёт подготовленный SQL-запрос, который может включать 0
или более маркеров параметров (символов <literal>?</literal>), представляющих входные параметры, параметры вывода
или входные параметры и параметры вывода.
Вы можете передать параметры подготовленному запросу, используя <function>db2_bind_param</function>
или только для входных значений в виде массива, переданного в <function>db2_execute</function>.
</para>
</simpara>
<para>
Использование подготовленных запросов в вашем приложении даёт три основных преимущества:
<itemizedlist>
<listitem>
<para>
<simpara>
<emphasis>Производительность</emphasis>: при использовании подготовленного запроса,
сервер базы данных создаёт оптимизированный план доступа для извлечения данных с помощью этого запроса.
Последующее выполнение подготовленного запроса с помощью <function>db2_execute</function> позволяет операторам
повторно использовать этот план доступа и позволяет избежать накладных расходов на динамическое создание нового плана доступа
для каждого выполняемого вами запроса.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
<emphasis>Безопасность</emphasis>: при использовании подготовленного запроса, вы можете включить маркеры
параметров для входных значений. Когда вы выполняете подготовленный запрос с входными значениями для заполнителей,
сервер базы данных проверяет каждое входное значение, чтобы убедиться,
что тип соответствует определению столбца или определению параметра.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
<emphasis>Расширенный функционал</emphasis>: Маркеры параметров не только позволяют передавать
входные значения в подготовленные SQL-запросы, они также позволяют извлекать параметры OUT и INOUT
из хранимых процедур с помощью <function>db2_bind_param</function>.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -58,54 +58,54 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Допустимая переменная ресурса подключения к базе данных, возвращаемая функцией
<function>db2_connect</function> или <function>db2_pconnect</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>statement</parameter></term>
<listitem>
<para>
<simpara>
SQL-запрос, необязательно содержащий один или несколько маркеров параметров.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Ассоциативный массив, содержащий параметры запроса. Параметры можно использовать для запроса
прокручиваемого курсора на серверах баз данных, поддерживающих эту функцию.
</para>
<para>
</simpara>
<simpara>
Описание допустимых опций запроса смотрите в разделе
<function>db2_set_option</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает ресурс оператора, если SQL-запрос был успешно проанализирован и подготовлен сервером базы данных.
Возвращает &false;, если сервер базы данных вернул ошибку.
Вы можете определить, какая ошибка была возвращена, вызвав
<function>db2_stmt_error</function> или <function>db2_stmt_errormsg</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Подготовка и выполнение SQL-запроса с маркерами параметров</title>
<para>
<simpara>
В следующем примере подготавливается запрос INSERT, который принимает четыре маркера параметров,
а затем выполняет итерацию по массиву массивов, содержащих входные значения,
которые необходимо передать в <function>db2_execute</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

22
reference/ibm_db2/functions/db2-primary-keys.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-primary-keys">
<refnamediv>
@@ -16,9 +16,9 @@
<methodparam><type>string</type><parameter>table_name</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает набор результатов, содержащий первичные ключи таблицы.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,35 +27,35 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Допустимое соединение с базой данных IBM DB2, Cloudscape или Apache Derby.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>qualifier</parameter></term>
<listitem>
<para>
<simpara>
Квалификатор для баз данных DB2, работающих на серверах OS/390 или z/OS.
Для других баз данных передайте &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>schema</parameter></term>
<listitem>
<para>
<simpara>
Схема, содержащая таблицы. Если <parameter>schema</parameter> равен &null;,
<function>db2_primary_keys</function> соответствует схеме для текущего соединения.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>table_name</parameter></term>
<listitem>
<para>
<simpara>
Название таблицы.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

26
reference/ibm_db2/functions/db2-procedure-columns.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-procedure-columns">
<refnamediv>
@@ -17,9 +17,9 @@
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>parameter</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает набор результатов, в котором перечислены параметры для одной или нескольких хранимых процедур.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,46 +28,46 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Допустимое соединение с базой данных IBM DB2, Cloudscape или Apache Derby.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>qualifier</parameter></term>
<listitem>
<para>
<simpara>
Квалификатор для баз данных DB2, работающих на серверах OS/390 или z/OS.
Для других баз данных передайте &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>schema</parameter></term>
<listitem>
<para>
<simpara>
Схема, содержащая процедуры. Параметр принимает шаблон поиска,
содержащий <literal>_</literal> и <literal>%</literal> в качестве подстановочных знаков.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>procedure</parameter></term>
<listitem>
<para>
<simpara>
Название процедуры. Параметр принимает шаблон поиска,
содержащий <literal>_</literal> и <literal>%</literal> в качестве подстановочных знаков.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>parameter</parameter></term>
<listitem>
<para>
<simpara>
Имя параметра. Параметр принимает шаблон поиска,
содержащий <literal>_</literal> и <literal>%</literal> в качестве подстановочных знаков.
Если параметр равен &null;, возвращаются все параметры для указанных хранимых процедур.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

22
reference/ibm_db2/functions/db2-procedures.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-procedures">
<refnamediv>
@@ -16,9 +16,9 @@
<methodparam><type>string</type><parameter>procedure</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает набор результатов, в котором перечислены хранимые процедуры, зарегистрированные в базе данных.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,36 +27,36 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Допустимое соединение с базой данных IBM DB2, Cloudscape или Apache Derby.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>qualifier</parameter></term>
<listitem>
<para>
<simpara>
Квалификатор для баз данных DB2, работающих на серверах OS/390 или z/OS.
Для других баз данных передайте &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>schema</parameter></term>
<listitem>
<para>
<simpara>
Схема, содержащая процедуры. Параметр принимает шаблон поиска,
содержащий <literal>_</literal> и <literal>%</literal> в качестве подстановочных знаков.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>procedure</parameter></term>
<listitem>
<para>
<simpara>
Название процедуры. Параметр принимает шаблон поиска,
содержащий <literal>_</literal> и <literal>%</literal> в качестве подстановочных знаков.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

22
reference/ibm_db2/functions/db2-result.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-result">
<refnamediv>
@@ -14,11 +14,11 @@
<methodparam><type class="union"><type>int</type><type>string</type></type><parameter>column</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Используйте <function>db2_result</function>, чтобы вернуть значение указанного столбца в текущей строке набора результатов.
Вы должны вызвать <function>db2_fetch_row</function> перед вызовом <function>db2_result</function>,
чтобы установить положение указателя набора результатов.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,38 +27,38 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс <literal>stmt</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>column</parameter></term>
<listitem>
<para>
<simpara>
Либо целочисленный индекс столбца (начиная с 0) в наборе результатов, либо строка, соответствующая имени столбца.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает значение запрошенного поля, если поле существует в наборе результатов.
Возвращает &null;, если поле не существует и выдаёт предупреждение.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования <function>db2_result</function></title>
<para>
<simpara>
В следующем примере показано, как выполнить итерацию по набору результатов с помощью
<function>db2_fetch_row</function> и получить столбцы из набора результатов
с помощью <function>db2_result</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

18
reference/ibm_db2/functions/db2-rollback.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-rollback">
@@ -16,14 +16,14 @@
<methodparam><type>resource</type><parameter>connection</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Откатывает текущую транзакцию на указанном соединении
и начинает новую. По умолчанию, в PHP, используется
автоподтверждение транзакций, так что функция
<function>db2_rollback</function> нужна
только в том случае, если вы принудительно отключили
автоподтверждение транзакций для соединения.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -32,27 +32,27 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Переменная содержащая активный ресурс подключения,
полученный с помощью <function>db2_connect</function>
или <function>db2_pconnect</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Откат операции DELETE</title>
<para>
<simpara>
В следующем примере мы посчитаем количество строк в
таблице, отключим автоподтверждение транзакций, удалим
все строки в таблице и убедимся, что их стало
@@ -60,7 +60,7 @@
<function>db2_rollback</function> и проверим, что число
строк в таблице стало таким же, как и до удаления - это
подтвердит, что транзакция успешно откатилась.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

50
reference/ibm_db2/functions/db2-server-info.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-server-info">
<refnamediv>
@@ -65,45 +65,45 @@
<varlistentry>
<term>UR</term>
<listitem>
<para>
<simpara>
Незавершённое чтение: изменения сразу видны всем параллельным транзакциям.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>CS</term>
<listitem>
<para>
<simpara>
Стабильность курсора: строка, прочитанная одной транзакцией,
может быть изменена и зафиксирована второй параллельной транзакцией.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>RS</term>
<listitem>
<para>
<simpara>
Стабильность чтения: транзакция может добавлять или удалять строки,
соответствующие условию поиска или ожидающей транзакции.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>RR</term>
<listitem>
<para>
<simpara>
Повторяющееся чтение: данные, на которые влияет ожидающая транзакция,
недоступны для других транзакций.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>NC</term>
<listitem>
<para>
<simpara>
Без фиксации: любые изменения видны в конце успешной операции.
Явные коммиты и откаты недопустимы.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -233,33 +233,33 @@
<varlistentry>
<term>ENTRY</term>
<listitem>
<para>
<simpara>
Соответствие начальному уровню SQL-92.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>FIPS127</term>
<listitem>
<para>
<simpara>
Переходное соответствие FIPS-127-2.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>FULL</term>
<listitem>
<para>
<simpara>
Полное соответствие стандарту SQL-92.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>INTERMEDIATE</term>
<listitem>
<para>
<simpara>
Соответствие среднему уровню SQL-92.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -278,28 +278,28 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Задаёт активное соединение клиента DB2.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает объект в случае успешного вызова функции&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования <function>db2_server_info</function></title>
<para>
<simpara>
Чтобы получить информацию о сервере, вы должны передать действительный
ресурс подключения к базе данных в <function>db2_server_info</function>.
</para>
</simpara>
<programlisting role="php"><![CDATA[<?php
$conn = db2_connect('sample', 'db2inst1', 'ibmdb2');

126
reference/ibm_db2/functions/db2-set-option.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-set-option">
<refnamediv>
@@ -14,10 +14,10 @@
<methodparam><type>array</type><parameter>options</parameter></methodparam>
<methodparam><type>int</type><parameter>type</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Функция устанавливает опции для ресурса запроса или ресурса соединения.
Нельзя установить опции для ресурсов результирующих наборов.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -25,13 +25,13 @@
<varlistentry>
<term><parameter>resource</parameter></term>
<listitem>
<para>
<simpara>
Корректный ресурс запроса, который вернула функция
<function>db2_prepare</function> или корректный ресурс
соединения, который вернула функция
<function>db2_connect</function>
или <function>db2_pconnect</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -47,84 +47,84 @@
<varlistentry>
<term><parameter>autocommit</parameter></term>
<listitem>
<para>
<simpara>
<constant>DB2_AUTOCOMMIT_ON</constant> — включает
режим автофиксации для ресурса соединения.
</para>
<para>
</simpara>
<simpara>
<constant>DB2_AUTOCOMMIT_OFF</constant> — отключает
режим автофиксации для ресурса соединения.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>cursor</parameter></term>
<listitem>
<para>
<simpara>
<constant>DB2_FORWARD_ONLY</constant> — задаёт
тип курсора последовательного доступа для ресурса запроса. Это тип курсора по умолчанию,
который поддерживается всеми серверами баз данных.
</para>
<para>
</simpara>
<simpara>
<constant>DB2_SCROLLABLE</constant> — задаёт тип
прокручиваемого курсора для ресурса запроса. Прокручиваемые курсоры
разрешают получать доступ к произвольным строкам
результирующего набора, но поддерживаются только базами данных
IBM DB2 Universal Database.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>binmode</parameter></term>
<listitem>
<para>
<simpara>
<constant>DB2_BINARY</constant> — указывает, что
функция вернёт двоичные данные как есть. Это эквивалент установки
опции конфигурации <literal>ibm_db2.binmode=1</literal> в файле &php.ini;.
</para>
<para>
</simpara>
<simpara>
<constant>DB2_CONVERT</constant> — указывает, что
функция преобразует двоичные данные
в шестнадцатеричное представление и вернёт данные в таком виде. Это эквивалент установки
опции конфигурации <literal>ibm_db2.binmode=2</literal> в файле &php.ini;.
</para>
<para>
</simpara>
<simpara>
<constant>DB2_PASSTHRU</constant> — указывает, что
функция преобразует двоичные в &null;. Это эквивалент установки
опции конфигурации <literal>ibm_db2.binmode=3</literal> в файле &php.ini;.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>db2_attr_case</parameter></term>
<listitem>
<para>
<simpara>
<constant>DB2_CASE_LOWER</constant> — определяет,
что имена столбцов будут возвращаться в нижнем
регистре.
</para>
<para>
</simpara>
<simpara>
<constant>DB2_CASE_UPPER</constant> — определяет,
что имена столбцов будут возвращаться в верхнем
регистре.
</para>
<para>
</simpara>
<simpara>
<constant>DB2_CASE_NATURAL</constant> — определяет,
что имена столбцов будут возвращаться как есть.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>deferred_prepare</parameter></term>
<listitem>
<para>
<simpara>
<constant>DB2_DEFERRED_PREPARE_ON</constant> -
включает отложенную подготовку ресурса запроса.
</para>
<para>
</simpara>
<simpara>
<constant>DB2_DEFERRED_PREPARE_OFF</constant> -
выключает отложенную подготовку ресурса запроса.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -137,7 +137,7 @@
<varlistentry>
<term><parameter>i5_fetch_only</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_I5_FETCH_ON</literal> — курсоры
доступны только для чтения и не могут
использоваться для позиционирования при операциях
@@ -145,12 +145,12 @@
по умолчанию, только если для переменной окружения
<literal>SQL_ATTR_FOR_FETCH_ONLY</literal>
не установили значение <literal>SQL_FALSE</literal>.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_I5_FETCH_OFF</literal> — курсоры
можно использовать для позиционирования при операциях
DELETE или UPDATE.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -161,7 +161,7 @@
<varlistentry>
<term><parameter>rowcount</parameter></term>
<listitem>
<para>
<simpara>
<literal>DB2_ROWCOUNT_PREFETCH_ON</literal> —
клиент может запросить полное количество строк перед
извлечением, что означает, что функция
@@ -169,12 +169,12 @@
количество выбранных строк, даже если
используется курсор
<literal>ROLLFORWARD_ONLY</literal>.
</para>
<para>
</simpara>
<simpara>
<literal>DB2_ROWCOUNT_PREFETCH_OFF</literal> —
клиент не может запросить полное количество строк перед
извлечением.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -185,7 +185,7 @@
<varlistentry>
<term><parameter>trusted_user</parameter></term>
<listitem>
<para>
<simpara>
Чтобы переключить пользователя в статус доверенного
пользователя, указывают идентификатор (строку)
доверенного пользователя как значение этого
@@ -193,16 +193,16 @@
для ресурса соединения. Чтобы использовать эту опцию,
требуется включить доверенный контекст на ресурсе
подключения.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>trusted_password</parameter></term>
<listitem>
<para>
<simpara>
Пароль (строка), который соответствует идентификатору
пользователя, который задали в опции trusted_user.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -213,16 +213,16 @@
доступ к которой можно получить функцией <function>db2_get_option</function>
во время выполнения.
<note>
<para>
<simpara>
При установке значений для каждой опции отдельные
серверы смогут обработать не всё значение
и обрежут его.
</para>
<para>
</simpara>
<simpara>
Чтобы гарантировать правильное преобразование данных каждой опции
при передаче на хост-систему, указывают только символы A-Z, 0-9,
подчёркивание(_) и точку (.).
</para>
</simpara>
</note>
<variablelist>
<varlistentry>
@@ -234,12 +234,12 @@
и используется для распознавания клиентского идентификатора пользователя,
который передаётся на хост сервера баз данных при соединении через клиент Db2 Connect.
<note>
<para>
<simpara>
БД DB2 для серверов z/OS и OS/390 поддерживает
длину значения до 16 символов. Этот идентификатор пользователя не следует путать
с идентификатором пользователя для аутентификации, он предназначен только
для идентификации и не используется для авторизации.
</para>
</simpara>
</note>
</para>
</listitem>
@@ -253,10 +253,10 @@
и используется для идентификации учётной строки,
которая передаётся на хост сервера баз данных при соединении через клиент Db2 Connect.
<note>
<para>
<simpara>
БД DB2 для серверов z/OS и OS/390 поддерживает
длину значения до 200 символов.
</para>
</simpara>
</note>
</para>
</listitem>
@@ -270,10 +270,10 @@
и используется для идентификации имени клиентского приложения,
которое передаётся на хост сервера баз данных при соединении через клиент Db2 Connect.
<note>
<para>
<simpara>
БД DB2 для серверов z/OS и OS/390 поддерживает
длину значения до 32 символов.
</para>
</simpara>
</note>
</para>
</listitem>
@@ -287,10 +287,10 @@
и используется для идентификации имени рабочей станции,
которое передаётся на хост сервера баз данных при соединении через клиент Db2 Connect.
<note>
<para>
<simpara>
БД DB2 для серверов z/OS и OS/390 поддерживает
длину значения до 18 символов.
</para>
</simpara>
</note>
</para>
</listitem>
@@ -302,22 +302,22 @@
<varlistentry>
<term><parameter>type</parameter></term>
<listitem>
<para>
<simpara>
Целочисленное значение, которое указывает тип ресурса,
который передали в функцию. Тип ресурса и это значение должны совпадать.
</para>
<para>
</simpara>
<simpara>
<literal>1</literal> — ресурс соединения передали в функцию.
</para>
<para>
</simpara>
<simpara>
Передача в качестве значения целого числа, которое не равно <literal>1</literal>,
указывает, что в функцию передали ресурс запроса.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
<para>
</para>
<simpara>
</simpara>
<para>
В следующей таблице указывается совместимость параметров с доступными типами ресурсов:
<table>
@@ -505,9 +505,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<!-- Place Changelog next if any -->

22
reference/ibm_db2/functions/db2-special-columns.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-special-columns">
<refnamediv>
@@ -17,9 +17,9 @@
<methodparam><type>int</type><parameter>scope</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает набор результатов, в котором перечислены столбцы с уникальным идентификатором строки таблицы.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,34 +28,34 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Допустимое соединение с базой данных IBM DB2, Cloudscape или Apache Derby.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>qualifier</parameter></term>
<listitem>
<para>
<simpara>
Квалификатор для баз данных DB2, работающих на серверах OS/390 или z/OS.
Для других баз данных передайте &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>schema</parameter></term>
<listitem>
<para>
<simpara>
Схема, содержащая таблицы.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>table_name</parameter></term>
<listitem>
<para>
<simpara>
Название таблицы.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>

42
reference/ibm_db2/functions/db2-statistics.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-statistics">
<refnamediv>
@@ -17,9 +17,9 @@
<methodparam><type>bool</type><parameter>unique</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает набор результатов, содержащий индекс и статистику таблицы.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,45 +28,45 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Допустимое соединение с базой данных IBM DB2, Cloudscape или Apache Derby.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>qualifier</parameter></term>
<listitem>
<para>
<simpara>
Квалификатор для баз данных DB2, работающей на серверах OS/390 или z/OS.
Для других баз данных передайте &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>schema</parameter></term>
<listitem>
<para>
<simpara>
Схема, содержащая целевую таблицу. Если параметр равен &null;,
статистика и индексы возвращаются для схемы текущего пользователя.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>table_name</parameter></term>
<listitem>
<para>
<simpara>
Название таблицы.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>unique</parameter></term>
<listitem>
<para>
<simpara>
Если у параметра <parameter>unique</parameter> значение &true;,
возвращается информация для всех индексов в таблице.
В противном случае возвращается информация только об уникальных индексах в таблице.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -205,27 +205,27 @@
<row>
<entry>CARDINALITY</entry>
<entry>
<para>
<simpara>
Если строка содержит информацию об индексе, этот столбец содержит целочисленное значение,
представляющее количество уникальных значений в индексе.
</para>
<para>
</simpara>
<simpara>
Если строка содержит информацию о самой таблице, этот столбец содержит целочисленное значение,
представляющее количество строк в таблице.
</para>
</simpara>
</entry>
</row>
<row>
<entry>PAGES</entry>
<entry>
<para>
<simpara>
Если строка содержит информацию об индексе, этот столбец содержит целочисленное значение,
представляющее количество страниц, используемых для хранения индекса.
</para>
<para>
</simpara>
<simpara>
Если строка содержит информацию о самой таблице, этот столбец содержит целочисленное значение,
представляющее количество страниц, используемых для хранения таблицы.
</para>
</simpara>
</entry>
</row>
<row>

18
reference/ibm_db2/functions/db2-stmt-error.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: evvc Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: evvc Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-stmt-error">
<refnamediv>
@@ -13,14 +13,14 @@
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>stmt</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает строку, содержащую SQLSTATE, возвращённую SQL-оператором.
</para>
<para>
</simpara>
<simpara>
Если вы не передадите ресурс оператора в качестве аргумента в <function>db2_stmt_error</function>,
драйвер вернёт значение SQLSTATE, связанное с последней попыткой вернуть ресурс оператора,
например, из <function>db2_prepare</function> или <function>db2_exec</function>.
</para>
</simpara>
<para>
Чтобы узнать, что означает значение SQLSTATE, вы можете ввести следующую команду в командной строке процессора DB2:
<userinput>db2 '? <parameter>sqlstate-value</parameter>'</userinput>.
@@ -35,18 +35,18 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс оператора.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку, содержащую значение SQLSTATE.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

18
reference/ibm_db2/functions/db2-stmt-errormsg.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-stmt-errormsg">
<refnamediv>
@@ -15,16 +15,16 @@
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>stmt</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает строку, содержащую последнее сообщение об ошибке SQL-выражения.
</para>
<para>
</simpara>
<simpara>
Если вы не передаёте ресурс выражения в качестве аргумента в
<function>db2_stmt_errormsg</function>, драйвер возвращает сообщение об ошибке,
связанное с последней попыткой вернуть ресурс оператора,
например, из <function>db2_prepare</function> или
<function>db2_exec</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -33,19 +33,19 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Допустимый ресурс выражения.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает строку, содержащую сообщение об ошибке и значение SQLCODE последней ошибки,
возникшей при выдаче SQL-выражения.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

22
reference/ibm_db2/functions/db2-table-privileges.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-table-privileges">
<refnamediv>
@@ -18,10 +18,10 @@
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>table_name</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает набор результатов, в котором перечислены таблицы и связанные
с ними права доступа к базе данных.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,38 +30,38 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Допустимое соединение с базой данных IBM DB2, Cloudscape или Apache Derby.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>qualifier</parameter></term>
<listitem>
<para>
<simpara>
Квалификатор для баз данных DB2, работающих на серверах OS/390 или z/OS.
Для других баз данных передайте &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>schema</parameter></term>
<listitem>
<para>
<simpara>
Схема, содержащая таблицы. Параметр принимает шаблон поиска,
содержащий <literal>_</literal> и <literal>%</literal>
в качестве подстановочных знаков.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>table_name</parameter></term>
<listitem>
<para>
<simpara>
Название таблицы. Параметр принимает шаблон поиска,
содержащий <literal>_</literal> и <literal>%</literal>
в качестве подстановочных знаков.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

26
reference/ibm_db2/functions/db2-tables.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-tables">
<refnamediv>
@@ -19,9 +19,9 @@
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>table_type</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Возвращает набор результатов, в котором перечислены таблицы и связанные метаданные в базе данных.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,51 +30,51 @@
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
<para>
<simpara>
Допустимое соединение с базой данных IBM DB2, Cloudscape или Apache Derby.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>qualifier</parameter></term>
<listitem>
<para>
<simpara>
Квалификатор для баз данных DB2, работающих на серверах OS/390 или z/OS.
Для других баз данных передайте &null; или пустую строку.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>schema</parameter></term>
<listitem>
<para>
<simpara>
Схема, содержащая таблицы. Параметр принимает шаблон поиска,
содержащий <literal>_</literal> и <literal>%</literal>
в качестве подстановочных знаков.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>table_name</parameter></term>
<listitem>
<para>
<simpara>
Название таблицы. Параметр принимает шаблон поиска,
содержащий <literal>_</literal> и <literal>%</literal>
в качестве подстановочных знаков.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>table_type</parameter></term>
<listitem>
<para>
<simpara>
Список идентификаторов типов таблиц, разделённых запятыми.
Чтобы соответствовать всем типам таблиц, передайте &null; или пустую строку.
К допустимым идентификаторам типа таблицы относятся:
ALIAS, HIERARCHY TABLE, INOPERATIVE VIEW, NICKNAME,
MATERIALIZED QUERY TABLE, SYSTEM TABLE, TABLE, TYPED TABLE, TYPED VIEW,
и VIEW.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

134
reference/ibm_db2/ini.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 59e21cf90a9cdcf8f4e841b3441bd951f24d8078 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ibm-db2.configuration">
&reftitle.runtime;
@@ -124,19 +124,19 @@
приложении PHP.
<itemizedlist>
<listitem>
<para>
<simpara>
1 (DB2_BINARY)
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
2 (DB2_CONVERT)
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
3 (DB2_PASSTHRU)
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -158,14 +158,14 @@
Её не нужно вызывать в новых приложениях.
<itemizedlist>
<listitem>
<para>
<simpara>
0 — могут быть установлены постоянные и непостоянные соединения.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
1 — Все соединения постоянны.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -185,29 +185,29 @@
или <function>db2_pconnect</function> массиве настроек подключения.
<itemizedlist>
<listitem>
<para>
<simpara>
0 — контроль обязательств не используется.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
1 — read uncommitted, возможно грязное чтение.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
2 — read committed, грязное чтение не возможно.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
3 — repeatable read, грязное и неповторяющееся чтение не возможны.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
4 — serializeable, грязное чтение, неповторяющееся чтение и фантомы не возможны.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -228,14 +228,14 @@
в качестве текущего пользователя.
<itemizedlist>
<listitem>
<para>
<simpara>
0 — Не разрешать передачу пустого идентификатора пользователя.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
1 — Разрешать передачу пустого идентификатора пользователя.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -254,14 +254,14 @@
Значение этой опции по умолчанию — <literal>0</literal>.
<itemizedlist>
<listitem>
<para>
<simpara>
0 — Столбцы не обрезаются.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
1 — Пробелы в конце столбцов возвращаемых символов будут удалены.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -284,14 +284,14 @@
обрезанные данные.
<itemizedlist>
<listitem>
<para>
<simpara>
0 — Выделяется минимальный размер буферов.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
1 — Выделяется максимальный размер буферов.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -310,14 +310,14 @@
По умолчанию для этой опции установлено значение <literal>0</literal>.
<itemizedlist>
<listitem>
<para>
<simpara>
0 — Не проверять смену профилей.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
1 — Проверять смену профилей, и если так, — отключать.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -340,14 +340,14 @@
того, не завершится ли функция неудачно.
<itemizedlist>
<listitem>
<para>
<simpara>
0 — Регистрируются только короткие сообщения.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
1 — В дополнение к коротким сообщениям регистрируются диагностические сообщения SQL.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -370,14 +370,14 @@
и <function>db2_pconnect</function>.
<itemizedlist>
<listitem>
<para>
<simpara>
0 — Использует заданные учётные данные и задание сервера SQL/CLI.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
1 — Использует пустые учётные данные и запускает SQL/CLI в задании PHP.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -396,19 +396,19 @@
<literal>SQL_ATTR_CONN_SORT_SEQUENCE</literal> в IBM i.
<itemizedlist>
<listitem>
<para>
<simpara>
0 — Использует настройку сортировки <literal>*HEX</literal>, сортировка по байтам.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
1 — Использует последовательность сортировки заданий, установленную для PHP-задания.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
2 — Использует последовательность сортировки заданий, установленную для задания базы данных.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -420,7 +420,7 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
Эта опция влияет на то, сколько раз постоянное соединение можно переиспользовать
при работе в операционной системе IBM i.
По умолчанию значение этой опции равно <literal>0</literal>, что означает — постоянное
@@ -428,7 +428,7 @@
Этот параметр помогает обойти проблемы долгоработающего задания базы данных.
(т. е. если процедура вызывает утечку памяти), но это явно не долгосрочное
решение.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ibm-db2.i5-override-ccsid">
@@ -437,20 +437,20 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
Идентификатор PASE CCSID для преобразования символов из кода EBCDIC в операционной системе IBM i.
По умолчанию — это <literal>0</literal>, который выберет значение по умолчанию
идентификатор CCSID для задания окружения PASE, который будет взят из настроек языкового стандарта окружения PASE.
Например, установка для этой опции значения <literal>1208</literal> будет использовать кодировку UTF-8.
Эту опцию можно изменять только когда, когда идентификатор CCSID задания окружения PASE не соответствует
идентификатору CCSID, который ожидался, и языковой стандарт нельзя изменить.
</para>
<para>
</simpara>
<simpara>
Узнать больше об идентификаторе CCSIDs операционной системы IBM i можно
в <link xlink:href="&url.ibm.ccsid;">документации IBM</link>.
Узнать, как языковые стандарты в окружении PASE системы IBM i сопоставляются с идентификаторами CCSID можно также
в <link xlink:href="&url.ibm.pase.i;">документации IBM</link>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ibm-db2.i5-sys-naming">
@@ -470,21 +470,21 @@
а для разрешения имён — список библиотек заданий.
<itemizedlist>
<listitem>
<para>
<simpara>
0 — Использовать режим именования SQL («SCHEMA.TABLE»).
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
1 — Использовать режим системного именования («LIBRARY/FILE»).
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
<para>
<simpara>
Узнать больше о режимах именования в системе IBM i можно
в <link xlink:href="&url.db2.object.naming;">документации IBM</link>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ibm-db2.i5-servermode-subsystem">
@@ -493,12 +493,12 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Этот параметр изменяет то, под какой подсистемой выполняются задания сервера базы данных
системы IBM i.
По умолчанию значение этой опции равно &null;, поэтому задания для QSQSRVR-заданий
будут выполняться в подсистеме по умолчанию.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ibm-db2.instance-name">
@@ -514,9 +514,9 @@
Если эта опция установлена, её значение переопределяет
настройку переменной окружения <varname>DB2INSTANCE</varname>.
</para>
<para>
<simpara>
Эта опция игнорируется в операционных системах Windows.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

20
reference/ibm_db2/setup.xml
View File

@@ -1,33 +1,33 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 020edc73be983e8e2aca04782ff7c901da4afad7 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="ibm-db2.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ibm-db2.setup">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="ibm-db2.requirements">
&reftitle.required;
<para>
<simpara>
Для соединения с IBM DB2 Universal Database под Linux, UNIX
и Windows, IBM Cloudscape или Apache Derby, вы должны
установить клиента IBM DB2 Universal Database на той же
машине, где будет работать PHP. Модуль
разрабатывался и тестировался с DB2 версии 8.2.
</para>
<para>
</simpara>
<simpara>
Для соединения с IBM DB2 Universal Database под z/OS или
iSeries, вам нужен IBM DB2 Connect или эквивалентное ПО,
способное быть шлюзом DRDA.
</para>
</simpara>
<section xml:id="ibm-db2.requirements.unix">
<title>Требования под Linux или Unix</title>
<para>
<simpara>
Для доступа к функциям модуля из PHP, вам необходимо
сначала задать экземпляр DB2 с которым вы будете
работать. Его можно задать в &php.ini; с помощью опции
<literal>ibm_db2.instance_name</literal> или вы можете
создать профиль экземпляра DB2.
</para>
</simpara>
<para>
Если вы, к примеру, создадите экземпляр DB2 с именем
<literal>db2inst1</literal> в
@@ -69,11 +69,11 @@ bash$ source /home/db2inst1/sqllib/db2profile
<!-- {{{ Resources -->
<section xml:id="ibm-db2.resources">
&reftitle.resources;
<para>
<simpara>
Модуль ibm_db2 возвращает три типа ресурсов:
ресурс соединения, ресурс оператора и ресурс
результирующего набора.
</para>
</simpara>
</section>
<!-- }}} -->