-
Notifications
You must be signed in to change notification settings - Fork 70
/
oci-set-client-info.xml
140 lines (127 loc) · 3.87 KB
/
oci-set-client-info.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 729d3d6ef52f2e00977f4dc10e5cb28d42405f85 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.oci-set-client-info" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>oci_set_client_info</refname>
<refpurpose>
Задаёт информацию о клиенте
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>oci_set_client_info</methodname>
<methodparam><type>resource</type><parameter>connection</parameter></methodparam>
<methodparam><type>string</type><parameter>client_info</parameter></methodparam>
</methodsynopsis>
<para>
Задет информацию о клиенте для трассировки Oracle.
</para>
<para>
Информация о клиенте регистрируется в базе данных во время очередного
запроса от PHP, например, когда запускается SQL выражение.
</para>
<para>
Клиентская информация может быть извлечена из административных
представлений (view) базы данных, таких как <literal>V$SESSION</literal>.
</para>
<para>
Значение можно устанавливать и через постоянные соединения.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>connection</parameter></term>
<listitem>
&oci.parameter.connection;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>client_info</parameter></term>
<listitem>
<para>
Задаваемая пользователем строка до 64 байт.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Установка клиентской информации</title>
<programlisting role="php">
<![CDATA[
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Запись информации о клиенте
oci_set_client_info($c, 'My Application Version 2');
// Код, осуществляющий запрос к БД, например выборка:
$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 client_info from v$session;
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&oci.availability.note.10g;
&oci.clientinfo.tip;
&oci.roundtrip.caution;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>oci_set_module_name</function></member>
<member><function>oci_set_action</function></member>
<member><function>oci_set_client_identifier</function></member>
<member><function>oci_set_db_operation</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
-->