Files
php-doc-ru/reference/oci8/functions/oci-set-db-operation.xml
Sergey Panteleev 6d43fd64d7 Исправление форматирования
[skip-spellcheck]
[skip-lint]
2022-12-27 03:42:36 +03:00

138 lines
3.9 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

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

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ed6de1ae20ce16c0c7be0b3fef282b6065bebfac Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.oci-set-db-operation" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>oci_set_db_operation</refname>
<refpurpose>Задаёт операцию базы данных</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>oci_set_db_operation</methodname>
<methodparam><type>resource</type><parameter>connection</parameter></methodparam>
<methodparam><type>string</type><parameter>action</parameter></methodparam>
</methodsynopsis>
<para>
Устанавливает DBOP для трассировки Oracle.
</para>
<para>
Имя операции базы данных регистрируется в базе данных при следующем
"циклическом пути" (round-trip) из PHP в базу данных, как правило, при выполнении выражения SQL.
</para>
<para>
Операция базы данных может впоследствии запрашиваться из
представлений администрирования базы данных, таких как <literal>V$SQL_MONITOR</literal>.
</para>
<para>
Функция <function>oci_set_db_operation</function> доступна, если oci8 использует клиентские библиотеки Oracle версии 12 (или новее)
и базу данных Oracle 12 (или новее).
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
&oci.parameter.connection;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>action</parameter></term>
<listitem>
<para>
Пользовательская строка.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Установка DBOP</title>
<programlisting role="php">
<![CDATA[
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Записать операцию
oci_set_db_operation($c, 'main query');
// Код, вызывающий циклический путь, например запрос:
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);
sleep(30);
?>
]]>
</programlisting>
<screen>
<![CDATA[
// Во время выполнения скрипта администратор может видеть выполняемые операции
// с базой данных.
sqlplus system/welcome
SQL> select dbop_name from v$sql_monitor;
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&oci.roundtrip.caution;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>oci_set_action</function></member>
<member><function>oci_set_module_name</function></member>
<member><function>oci_set_client_info</function></member>
<member><function>oci_set_client_identifier</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->