-
Notifications
You must be signed in to change notification settings - Fork 56
/
oci-set-edition.xml
153 lines (135 loc) · 4.78 KB
/
oci-set-edition.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
141
142
143
144
145
146
147
148
149
150
151
152
153
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d26548d3357ea3f9488463de6192db814bd05826 Maintainer: satoruyoshida Status: ready -->
<refentry xml:id="function.oci-set-edition" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>oci_set_edition</refname>
<refpurpose>データベース・エディション を設定します</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>oci_set_edition</methodname>
<methodparam><type>string</type><parameter>edition</parameter></methodparam>
</methodsynopsis>
<para>
後続の接続で使用する、オブジェクトのデータベース・エディション を設定します。
</para>
<para>
オラクル・エディション により、同じスキーマ名とオブジェクト名を使って、複数のバージョンのアプリケーションが稼動できます。これは、稼動中のシステムをアップグレードするときに便利です。
</para>
<para>
<function>oci_connect</function>, <function>oci_pconnect</function>
や <function>oci_new_connect</function> を呼び出す前に、<function>oci_set_edition</function> をコールして下さい。
</para>
<para>
データベースで無効なエディションが設定されると、たとえ <function>oci_set_edition</function> が成功しても接続は失敗します。
</para>
<para>
持続的接続を使用している場合、リクエストされたエディション設定値による接続がもしすでにあれば、それが再利用されます。それ以外の場合、持続的接続が別途作成されます。
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>edition</parameter></term>
<listitem>
<para>
<acronym>SQL</acronym>コマンド "<literal>CREATE EDITION</literal>" であらかじめ作成されたオラクル・データベース・エディション名
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>異なるバージョンの myfunc() が利用できる例</title>
<programlisting role="php">
<![CDATA[
<?php
// File 1
echo "Version 1 of application\n";
oci_set_edition('ORA$BASE');
$c = oci_connect('hr', 'welcome', 'localhost/XE');
$s = oci_parse($c, "begin :r := myfunc(); end;");
oci_bind_by_name($s, ":r", $r, 20);
oci_execute($s);
echo "The result is $r\n";
?>
]]>
</programlisting>
<programlisting role="php">
<![CDATA[
<?php
// File 2
echo "Version 2 of application\n";
oci_set_edition('E1');
$c = oci_connect('hr', 'welcome', 'localhost/XE');
$s = oci_parse($c, "begin :r := myfunc(); end;");
oci_bind_by_name($s, ":r", $r, 20);
oci_execute($s);
echo "The result is $r\n";
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<title>Oracle バージョン必要条件</title>
<para>
この関数は Oracle 11<emphasis>g</emphasis>R2 以降で利用可能です
</para>
</note>
<caution>
<title>持続的接続</title>
<para>
持続的接続を使用しているときに "ALTER SESSION SET EDITION" を使ってデータベース・エディションを変更してはいけません。これは設定の不整合や予想外のエラーを避けるためです。
</para>
</caution>
<caution>
<title>DRCP 接続プーリング</title>
<para>
Oracle 11.2.0.1 でエディションや <link linkend="oci8.connection">DRCP</link>
を使用する際の設定の不整合や予想外のエラーを避けるため、<link
linkend="ini.oci8.connection-class">oci8.connection_class</link> と
アプリケーションで使用されるエディション名との間が1対1の対応になるように保ってください。
与えられた接続クラスのプールされたサーバーはそれぞれ、1つのエディションだけで使われるべきです。
この制約は、Oracle 11.2.0.2 以降ではなくなりました。
</para>
</caution>
</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
-->