JBoss Enterprise Data Services 5
Data Services クライアント開発者
ガイド
JBoss 開発者向け
エディッション 5.2.0
Landmann
JBoss Enterprise Data Services 5 Data Services クライアント開発者ガ
イド
JBoss 開発者向け
エディッション 5.2.0
Landmann
[email protected] m
法律上の通知
Copyright © 2011 Red Hat, Inc..
T his document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported
License. If you distribute this document, or a modified version of it, you must provide attribution to Red
Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be
removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section
4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo,
and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux ® is the registered trademark of Linus T orvalds in the United States and other countries.
Java ® is a registered trademark of Oracle and/or its affiliates.
XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States
and/or other countries.
MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other
countries.
Node.js ® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or
endorsed by the official Joyent Node.js open source or commercial project.
T he OpenStack ® Word Mark and OpenStack Logo are either registered trademarks/service marks or
trademarks/service marks of the OpenStack Foundation, in the United States and other countries and
are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or
sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
概要
本書を読んで Data Services の JDBC 拡張を使用してクライアントアプリケーションより仮想データベー
スへアクセスする方法を学びましょう。トランザクションや SSL、Hibernate の統合についても取り上げ
ます。
目次
目次
.はじめに
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. . . . . . . . . .
1. 本書の表記規則
4
1.1. 書体の表記規則
4
1.2. 引用文の表記規則
5
1.3. 注記および警告
6
2. サポート、およびフィードバックのお願い
6
2.1. サポートが必要ですか？
6
2.2. フィードバックをお願いします
7
. . .1章
第
. . . .Data
. . . . . Services
. . . . . . . . . .サーバーへの接続
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8. . . . . . . . . .
1.1. ドライバークラスを使用した接続
8
1.1.1. URL 形式
9
1.1.2. URL 接続プロパティー
10
1.2. データソースクラスを使用した接続
12
1.2.1. Data Services の DataSource 接続プロパティー
13
1.3. JBoss AS データソース
14
1.3.1. DataSource 接続
15
1.3.2. ドライバーベースの接続
15
1.3.3. ローカル JDBC 接続
15
1.4. 複数ホストの使用
16
1.4.1. フェイルオーバー
17
1.4.2. ロードバランシング
17
1.4.3. 詳細設定
18
1.4.4. 再認証
18
. . .2章
第
. . . .準備済みステートメント
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
............
. . .3章
第
. . . JDBC
. . . . . . .API
. . . .への
. . . . .Data
. . . . . Services
. . . . . . . . . .の拡張
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
............
3.1. ステートメントの拡張
20
3.2. 実行プロパティー
20
3.3. SET ステートメント
21
3.4. SHOW ステートメント
22
3.5. トランザクションステートメント
23
3.6. 部分結果モード
23
3.7. XML 拡張
24
3.7.1. ドキュメントのフォーマット
24
3.7.2. スキーマ検証
25
. . .4.章
第
. . .JDBC
. . . . . . でのトランザクション
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
............
4.1. ローカルトランザクション
26
4.1.1. ローカルトランザクションの無効化
26
4.2. 要求レベルトランザクション
27
4.2.1. 複数挿入バッチ
28
4.3. グローバルトランザクションの使用
28
4.4. 制限
29
4.4.1. アプリケーションの制限
29
4.4.2. エンタープライズ情報システムサポート
30
. . .5章
第
. . . .SSL
. . . . クライアント接続
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
...........
5.1. デフォルトのセキュリティー
31
5.2. SSL モデル
31
5.3. クライアントの SSL 設定
32
5.3.1. オプション 1: Java SSL プロパティー
32
1
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
5.3.2. オプション 2: Deta Services 固有のプロパティー
32
. . .6章
第
. . . .Data
. . . . . Services
. . . . . . . . . .を
. . Hibernate
. . . . . . . . . . .と使用する
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
...........
6.1. 制限
35
6.2. 設定
35
. . .7章
第
. . . .ODBC
. . . . . . .サポート
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
...........
7.1. ODBC ドライバークライアントのインストール
37
7.1.1. Red Hat Enterprise Linux やその他の UNIX オペレーティングシステムに ODBC ドライバー
をインストールする
37
7.1.2. Microsoft Windows に ODBC ドライバーをインストールする
38
.サポート対象外の
. . . . . . . . . . . . . . . . . JDBC
. . . . . . .メソッド
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. .2. . . . . . . . . .
A.1. ResultSet の制限
42
A.2. java.sql のサポート対象外のクラスおよびメソッド
42
A.3. javax.sql のサポート対象外のクラスおよびメソッド
47
.Keytool
. . . . . . . .を用いた自己署名証明書の生成
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4. .8. . . . . . . . . .
B.1. 秘密鍵と公開鍵のペアの作成
48
B.2. 公開鍵の抽出
48
B.3. トラストストアの作成
48
. . . . . .Lesser
GNU
. . . . . . . General
. . . . . . . . .Public
. . . . . . .License
. . . . . . . . 2.1
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
............
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
改訂履歴
............
2
目次
3
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
はじめに
1. 本 書 の 表 記 規 則
本ガイドでは、一部の単語や語句を強調して、特定の情報に対する読者の注意を促すために、以下のよう
な表記規則を採用しています。
本ガイドの PDF および紙書籍版では、Liberation フォントセットの書体を使用しています。また、
Liberation フォントセットがご使用のシステムにインストールされている場合には、HT ML 版もこの書体
で表示されます。インストールされていない場合には、別の対応する書体で表示されます。なお、Red
Hat Enterprise Linux 5 以降のバージョンでは、Liberation フォントセットがデフォルトでインストールさ
れる点に注意してください。
1.1. 書体の表記規則
本ガイドでは、特定の単語や語句に対する注意を促すために、4 つの書体表記規則を採用しています。こ
れらの表記規則および適用される状況は、以下のとおりです。
太字の等幅フォント
シェルコマンド、ファイル名、パスなど、システムへの入力を強調するために使用します。また、キー名
やキーの組み合わせを強調するのにも使用します。以下が例となります。
作業ディレクトリ内の m y_next_bestselling_novel というファイルの内容を表示する
には、シェルプロンプトで cat m y_next_bestselling_novel というコマンドを入力し
て Enter キーを押し、そのコマンドを実行します。
上記の例には、ファイル名、シェルコマンド、キー名が含まれており、すべて太字の等幅フォントで表示
されていますが、文脈で区別することができます。
キーの組み合わせは、プラス記号 (+) で各キーがつながれているので、個別のキーと区別することができ
ます。以下が例となります。
Enter を押してコマンドを実行します。
Ctrl+Alt+F2 を押して仮想ターミナルに切り替えます。
第 1 の例では、押すべき特定のキー名が強調されています。第 2 の例では、3 つのキーを同時に押す、
キーの組み合わせが強調されています。
ソースコードを記載する場合、その段落で言及されるクラス名、メソッド、関数、変数名、戻り値は上記
のように 太字の等幅フォント で表示されます。以下が例となります。
ファイル関連のクラスには、filesystem (ファイルシステム)、file (ファイル)、dir
(ディレクトリ) などがあります。各クラスにそれぞれ独自のパーミッションセットが関連付
けられています。
太字の可変幅フォント
この書体は、アプリケーション名、ダイアログボックスのテキスト、ラベル付きボタン、チェックボック
ス/ラジオボタンのラベル、メニュータイトル、サブメニュータイトルなど、システムで表示される単語や
語句であることを示します。以下が例となります。
メインメニューバーから システム → 設定 → マウス の順で選択し、マウスの設定 を起動
します。全般 タブで 左利き のラジオボタンを選択して 閉じる をクリックし、マウスの主
4
はじめに
ボタンを左から右へ切り替えます (左利きのユーザーが使用するのに適切な設定に変更しま
す)。
gedit ファイルに特殊文字を入力するには、メインのメニューバーから アプリケーション
→ アクセサリ → 文字マップ の順に選択します。次に 文字マップ のメニューバーから 検
索 → 検索 … の順に選択して 検索 フィールドに文字名を入力し、次を検索 をクリックしま
す。検索対象の文字が 文字テーブル に強調表示されます。その文字をダブルクリックして
コピーする文字列 のフィールドに表示されたら、コピー ボタンをクリックします。この後
に編集中のドキュメントに戻り、gedit のメニューバーから 編集 → 貼り付け の順で選択し
ます。
上記のテキストには、アプリケーション名、システム全体のメニュー名と項目、アプリケーション固有の
メニュー名、GUI インターフェースで使用されているボタンおよびテキストが含まれており、これらはす
べて、太字の可変幅フォントで表示されていますが、文脈で区別することができます。
太字斜体の等幅フォント または 太字斜体の可変幅フォント
太字の等幅フォントおよび太字の可変幅フォントに斜体を使用した場合には、いずれも置き換え可能な可
変テキストであることを意味します。斜体は、記載されている通りには入力しないテキスト、あるいは状
況によって変化するテキストを示します。以下が例となります。
ssh を使用してリモートマシンに接続するには、シェルプロンプトで ssh
username@ domain.name と入力します。リモートマシンが exam ple.com で、そのマシン
上のユーザー名が john である場合には、ssh john@ exam ple.com と入力してください。
m ount -o rem ount file-system のコマンドは、指定したファイルシステムを再マウン
トします。たとえば、/hom e ファイルシステムを再マウントするコマンドは m ount -o
rem ount /hom e となります。
現在インストール済みのパッケージのバージョンを確認するには、rpm -q package のコマ
ンドを使用します。その結果、次のような出力が返されます: package-version-release
ユーザー名、ドメイン名、ファイルシステム、パッケージ、バージョン、およびリリースが太字のイタ
リック体で表示されている点に注意してください。これらの語句はプレースホルダーで、コマンドを発行
する際に入力するテキストまたはシステムによって表示されるテキストのいずれかです。
斜体は、著作物のタイトルを表すという標準的な用途の他に、重要な用語の初出時にも使用されます。以
下が例となります。
Publican は DocBook の出版システムです。
1.2. 引用文の表記規則
端末の出力とソースコードは、周囲のテキストとは視覚的に区切られて表示されます。
端末に送信される出力は、ローマン体の等幅フォント を使用して以下のように表示されます。
books
books_tests
Desktop
Desktop1
documentation
downloads
drafts
images
mss
notes
photos
scripts
stuff
svgs
svn
ソースコードの表示にも ローマン体の等幅フォント が使用されますが、以下のような構文強調表示が追
加されます。
5
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
package org.jboss.book.jca.ex1;
import javax.naming.InitialContext;
public class ExClient
{
public static void main(String args[])
throws Exception
{
InitialContext iniCtx = new InitialContext();
Object
ref
= iniCtx.lookup("EchoBean");
EchoHome
home
= (EchoHome) ref;
Echo
echo
= home.create();
System.out.println("Created Echo");
System.out.println("Echo.echo('Hello') = " + echo.echo("Hello"));
}
}
1.3. 注記および警告
本ガイドでは、見落としがちな情報に注意を促すために、次にあげる 3 つの視覚的スタイルを使用してい
ます。
注記
注記には、対象のタスクに関するヒント、ショートカット、その他のアプローチなどを記載してい
ます。注記を無視しても、悪影響はありませんが、作業を効率的に行うためのコツを見逃してしま
う可能性があります。
重要
重要の欄には、現行セッションのみに適用される設定の変更や、更新を適用するのに再起動が必要
なサービスなど、見落としがちな情報を記載しています。「重要」と記載された事項を無視して
も、データ損失などには至りませんが、作業が思ったようにスムーズに進まなくなる可能性があり
ます。
警告
警告は、無視しないでください。警告を無視すると、データ損失が発生する可能性が非常に高くな
ります。
2. サ ポ ー ト 、 お よ び フ ィ ー ド バ ッ ク の お 願 い
2.1. サポートが必要ですか？
本書に説明してある手順で問題があれば、Red Hat カスタマーポータル(http://access.redhat.com)をご覧
ください。カスタマーポータルでは以下を行うことができます。
6
はじめに
Red Hat 製品に関する技術的なサポートの記載をナレッジベースで検索、閲覧することができます。
サポートケースを Red Hat グローバルサポートサービス(GSS)に提出することができます。
他の製品文書を参照することができます。
また、Red Hat は Red Hat のソフトウェアやテクノロジーに関するディスカッションの場として多くの
メーリングリストを設置しています。公開されているメーリングリストについて
はhttps://www.redhat.com/mailman/listinfoで一覧を参照してください。メーリングリストをサブスクライ
ブする、またはメーリングリストのアーカイブを参照する場合はそのメーリングリスト名をクリックしま
す。
2.2. フィードバックをお願いします
誤植、本ガイドの改善案がある場合、ご意見お待ちしております。製品JBoss Enterprise SOA
Platform 、コンポーネントdoc-Data_Services_Client_Developer_GuideとしBugzilla から報
告してください。以下のリンクhttp://bugzilla.redhat.com/から、あらかじめ記入が施されている本製品の
バグレポートへ移動できます。
Bugzilla のDescription フィールドにある以下のテンプレートに記載してください。できるだけ具体的
に問題を説明していただけると、迅速に問題解決へ向けた取り組みが行いやすくなります。
文書URL：
項、項のタイトル：
問題の説明：
改善案：
追加情報：
問題報告の功績が認められるよう、名前を記載するのを忘れないようにしてください 。
7
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
第 1章 Data Services サーバーへの接続
本章では Java Database Connectivity API (JDBC) を使用して Data Services の仮想データベースへ接続
する異なるメソッドについて説明します。ここでは JDBC の基本知識が必要となります。JDBC を使用し
たことがない場合は http://download.oracle.com/javase/tutorial/jdbc/index.html の Java JDBC ドキュメン
トを参照してください。
Data Services の JDBC API は Data Services サーバーにデプロイされたすべての仮想データベース
(VDB) への JDBC によるアクセスを提供します。クライアントアプリケーションは Data Services サー
バーに接続し、Data Services の JDBC API を使用してデプロイされた VDB に対して SQL クエリを発行
することができます。標準の JDBC API クラスを使用してメタデータへ問い合わせをしたり、クエリを実
行することもできます。
Data Services の VDB へ JDBC 接続を作成する以下の 3 つの方法について説明します。
1. org.teiid.jdbc.T eiidDriver ドライバークラスを使用
2. org.teiid.jdbc.T eiidDatasource データソースクラスを使用
3. デプロイされた JBoss データソースを使用
Data Services の VDB に接続する際、次の点を考慮する必要があります。
1. Data Services クライアント JAR — teiid-client.jar — は Data Services VDB に接続してい
るクライアントアプリケーションのクラスパス上に存在する必要があります。 この JAR ファイル
は Data Services サーバーの jbossas/server/PROFILE/lib ディレクトリにあり、JDBC を使
用して Data Services VDB に接続するためのクラスが含まれています。
2. Data Services JDBC API は JDBC 4.0 の仕様と互換性がありますが、すべてのメソッドを完全サ
ポートしているわけではありません。更新可能な結果セットや SQL3 データタイプなどの上級機能
もサポートされません。
サポート対象外のメソッドの詳細は 付録A サポート対象外の JDBC メソッド を参照してくださ
い。
3. Data Services VDB に接続しているクライアントアプリケーションは Java 1.6 JDK が必要になりま
す。Java の以前のバージョンはサポートされません。
4. Data Services サーバーに接続する前に以下の点について確認してください。
a. Data Services サーバーがインストールされ、稼働している。
b. アプリケーションが接続しようとしている仮想データベース (VDB) はデプロイされている。
手順はスタートガイドと Data Services 管理者ガイド を参照してください。
1.1. ド ラ イ バ ー ク ラ ス を 使 用 し た 接 続
Java の java.sql.DriverManager クラスを使用して接続を作成する場合に使用するドライバークラ
スは org.teiid.jdbc.T eiidDriver になります。
完全な例は eds/teiid/exam ples/sim pleclient/ ディレクトリに含まれているソースコードを参
照してください。
手順 1.1 ドライバークラスによる接続の作成
1. Data Services クライアント JAR がクラスパス上に存在するようにする
クライアントアプリケーションでは Data Services クライアント JAR がクラスパス上に存在しなけ
ればなりません。アプリケーションが Data Services がインストールされているアプリケーション
サーバーで稼働しているウェブアプリケーションである場合、Data Services クライアント JAR は
既にクラスパス上に存在しますが、それ以外の場合は Data Services クライアント JAR — teiid-
8
第1章 D ata Services サーバーへの接続
client.jar — をクライアントアプリケーションのクラスパス上に追加する必要がありま
す。teiid-client.jar は Data Services サーバーの jbossas/server/PROFILE/lib ディレ
クトリにあります。
2. 接続オブジェクトの作成
DriverManager.getConnection() メソッドを使用して接続オブジェクトを作成します。
例 1.1 ドライバー接続の作成
public class TeiidClient
{
public Connection getConnection(String user, String password) throws
Exception
{
String url =
"jdbc:teiid:myVDB@mm://localhost:31000;ApplicationName=myApp";
return DriverManager.getConnection(url, user, password);
}
}
接続 URL の形式は 「URL 形式」 を参照してください。
URL 接続プロパティーの一覧は 「URL 接続プロパティー」 を参照してください。
1.1.1. URL 形式
JDBC 接続に次の URL 形式を使用します:
jdbc:teiid:VDB-NAME@mm[s]://HOSTNAME:PORT;[prop-name=prop-value;]*
VDB-NAME
接続している VDB の名前です。VDB 名の中にバージョン情報を含めることもできます。例えば
m yvdb.2 の場合、下記で定義されている version=2 接続プロパティーを提供することと同等
になります。ただし、この形式の VDB 名と version プロパティーを同時に使用することはで
きません。
mm[s]
Data Services の JDBC プロトコルです。m m は通常接続のデフォルトになります。m m s は
adminAPI ツールのデフォルトで、暗号化に SSL を使用します。Data Services で SSL を使用す
る場合の詳細は 5章SSL クライアント接続 を参照してください。
HOST NAME
Data Services サーバーがインストールされているサーバーです。
PORT
Data Services サーバーが着信 JDBC 接続をリッスンするポートです。
[prop-name=prop-value]
セミコロン (;) で区切った追加の名前/値ペアを提供することもできます。? や =、; などの予約
文字が含まれる場合、プロパティー値を URL エンコードしなければなりません。
9
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
サポート対象の URL プロパティーの完全リストは 「URL 接続プロパティー」 を参照してくださ
い。
1.1.2. URL 接続プロパティー
次の表は、Data Services JDBC ドライバーの URL 接続文字列や Data Services の JDBC データソースク
ラスと使用できるサポート対象の接続プロパティーをすべて表しています。
10
第1章 D ata Services サーバーへの接続
表 1.1 接続プロパティー
プロパティー名
タイプ
詳細
ansiQuotedIdentifiers
boolean
SQL の二重引用符で囲まれたエントリーの解析動作
を設定します。デフォルトは true で、二重引用符で
囲まれたエントリーを識別子として解析します。
false に設定すると、有効な文字列リテラルである二
重引用符で囲まれたエントリーは文字列リテラルとし
て解析されます。
ApplicationNam e
String
クライアントアプリケーションの名前です。管理者が
接続を識別できるようにします。
autoCom m itT xn
String
autoCommit が true に設定されている場合のみ適用さ
れます。データの整合性を維持するため、実行された
コマンドをどのように Data Services 内でトランザク
ションとしてラップする必要があるかを判断します。
ON - 常にコマンドを分散トランザクションでラッ
プする
OFF - コマンドを分散トランザクションでラップ
しない
DET ECT (デフォルト) - 実行されたコマンドが 2
つ以上のソースにまたがる場合に自動的に分散ト
ランザクションを使用する
詳細は 4章JDBC でのトランザクション を参照してく
ださい。
autoFailover
boolean
true の場合、コミュニケーションの例外の後に新しい
サーバーインスタンスを自動的に選択します。デフォ
ルトは false です。接続が管理されている場合は接続
をプールよりパージできるため、通常この機能は必要
ではありません。
disableLocalT xn
boolean
true の場合、autoCommit 設定では ローカルトランザ
クションのコミットとロールバックが無視されます。
デフォルトは false です。
FetchSize
int
結果セットのサイズです。デフォルトのサイズは
500 です。<=0 はデフォルトを使用する必要がある
ことを表します。
NoExec
String
(通常、接続プロパティーとして設定されません) ON
または OFF を設定できます。ON の場合、クエリが
実行されないようにしますが、解析やプランニングは
発生します。デフォルトは OFF です。
partialResultsMode
boolean
部分的な結果モードを有効または無効にします。詳細
は 「部分結果モード」 を参照してください。
PassthroughAuthentication
boolean
「ローカル」接続のみに適用されます。このオプショ
ンが true に設定されると、Data Services は呼び出し
スレッド上で既に認証されたセキュリティーコンテキ
ストを検索します。認証されたセキュリティーコンテ
キストが検出された場合、そのユーザーの認証情報を
使用してセッションを作成します。また Data
Services は接続の寿命期間の間、同じユーザーが接
続を使用していることを検証します。呼び出しスレッ
ド上で異なるセキュリティーコンテキストが検出され
11
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
ると、新しいユーザーが Data Services へログインで
きる場合は接続のアイデンティティーを切り替えま
す。ログインできない場合、接続の実行に失敗しま
す。
useCallingT hread
boolean
「ローカル」接続のみに適用されます。このオプショ
ンが true (デフォルト) に設定されると、クエリの処
理に呼び出しスレッドが使用されます。 false の場合
はエンジンスレッドが使用されます。
QueryT im eout
integer
デフォルトのクエリタイムアウト (秒単位) になりま
す。>= 0 である必要があります。0 はタイムアウト
がないことを表しま
す。Statem ent.setQueryT im eout によって上書
きすることが可能です。デフォルトは 0 です。
useJDBC4 Colum nNam eAndLab
elSem antics
boolean
JDBC4 の変更により、エイリアスのない列名を
ResultSetMetadata 列名として返すようになりまし
た。以前は、列の別名が使用されると列名として返さ
れました。このプロパティーを false に設定すると、
JDBC3 やそれ以前 JDBC に対するサポートが必要な
時に後方互換性を有効にします。デフォルトは true
です。
Password
String
ユーザーの認証情報
resultSetCacheMode
boolean
結果セットキャッシングを有効または無効にします。
デフォルトは false です。
SHOWPLAN
String
(通常、接続プロパティーとして設定されません)
ON|OFF|DEBUG を設定できます。ON の場合、 結果
と共にクエリプランを返します。DEBUG の場合、さ
らにクエリプランナーのデバッグ情報をログに出力
し、結果と共に返します。プランとログは JDBC の
API 拡張より入手可能です。デフォルトは OFF で
す。
user
String
ユーザー名
version
integer
VDB のバージョン番号
1.2. デ ー タ ソ ー ス ク ラ ス を 使 用 し た 接 続
org.teiid.jdbc.T eiidDatasource クラスは javax.sql.DataSource ベースの接続ファクトリ
です。これを使用して JDBC DataSource 接続や XADataSource 接続を作成することができます。このク
ラスを使用して管理された接続や XA 接続を作成します。Data Services は XA プロトコルをサポートし、
XA をサポートする Data Services のソースへ XA トランザクションが拡張されます。
また、Data Services の DataSource クラスはシリアライズ可能で、JNDI ネーミングサービスと併用する
ことができます。
完全な例は eds/teiid/exam ples/sim pleclient/ ディレクトリに含まれているソースコードを参
照してください。
手順 1.2 T eiidDatasource クラスを使用した接続の作成
1. Data Services クライアント JAR がクラスパス上に存在するようにする
クライアントアプリケーションでは Data Services クライアント JAR がクラスパス上に存在しなけ
12
第1章 D ata Services サーバーへの接続
ればなりません。アプリケーションが Data Services がインストールされているアプリケーション
サーバーで稼働しているウェブアプリケーションである場合、Data Services クライアント JAR は
既にクラスパス上に存在しますが、それ以外の場合は Data Services クライアント JAR — teiidclient.jar — をクライアントアプリケーションのクラスパス上に追加する必要がありま
す。teiid-client.jar は Data Services サーバーの jbossas/server/PROFILE/lib ディレ
クトリにあります。
2. 接続オブジェクトの作成
org.teiid.jdbc.T eiidDataSource オブジェクトを作成するには、必要なプロパティーを設
定し、T eiidDataSource.getConnection() メソッドを使用して接続オブジェクトを取得し
ます。
例 1.2 ドライバー接続の作成
public class TeiidClient
{
public Connection getConnection(String user, String password) throws
Exception
{
TeiidDataSource ds = new TeiidDataSource();
ds.setUser(user);
ds.setPassword(password);
ds.setServerName("localhost");
ds.setPortNumber(31000);
ds.setDatabaseName("myVDB");
return ds.getConnection();
}
}
接続プロパティーの完全一覧は 「Data Services の DataSource 接続プロパティー」 を参照してくださ
い。
1.2.1. Data Services の DataSource 接続プロパティー
version 以外の 「URL 接続プロパティー」 に記載されている URL 接続プロパティー
は、org.teiid.jdbc.T eiidDataSource に対応する「セットメソッド」を持っていま
す。version は T eiidDataSource で DatabaseVersion として参照されます。
URL より想定されるプロパティーは、 表1.2「Datasource プロパティー」 の通り追加のセットメソッド
を持っています。
13
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
表 1.2 Datasource プロパティー
プロパティー名
タイプ
詳細
AlternateServers
String
「ホスト:ポート」 エントリーのオプションの区切りリス
トです。詳細は 「複数ホストの使用」 を参照してくだ
さい。
AdditionalProperties
String
接続 URL のプロパティー文字列と同じ形式であるプロパ
ティーのオプション設定です。
DatabaseNam e
String
Data Services にデプロイされた仮想データベース
(VDB) の名前です。任意でデータベース名の中に
DatabaseVersion が含まれるようにすることも可能で
す。例えば、「myvdb.2」は値が 2 に設定された
DatabaseVersion プロパティーを設定することと同じに
なります。しかし、この形式のデータベース名を使用
し、同時に DatabaseVersion プロパティーを使用するこ
とはできません。
DatabaseVersion
integer
VDB バージョン
DataSourceNam e
String
このデータソースに付与された名前
PortNum ber
integer
サーバー処理がリッスンするポート番号。
ServerNam e
String
Data Services ランタイムがインストールされている
サーバーのホスト名。
secure
boolean
安全な接続。クライアントサーバー間で SSL (mms) ベー
スの接続を使用するように示すためのフラグです。
1.3. JBoss AS デ ー タ ソ ー ス
Data Services を JDBC データソースとして設定することができます。設定後、JNDI からデータソースへ
接続したり、Java EE アプリケーションへデータソースを挿入することができます。Deta Services の
データソースは他のデータベースリソースのデータソースと同様にデプロイされます。
接続している T eiid インスタンスが JBoss AS インスタンスと同じ VM に存在する場合は特例となりま
す。ご使用のデプロイメントがこれに該当する場合は 「ローカル JDBC 接続」 の指示に従ってくださ
い。
手順 1.3 Data Services データソースのデプロイ
1. 必要な場合は Data Services のクライアントライブラリをデプロイする
データソースをデプロイするアプリケーションサーバーが Data Services が稼働しているアプリ
ケーションサーバーインスタンスと同じでない場合、Data Services のクライアント JAR をインス
トールする必要があります。インストールするには、Data Services のクライアント JAR ファイル
teiid-client.jar を PROFILE/lib/ ディレクトリへコピーします。
Data Services クライアント JAR ファイルは Data Services サーバーの PROFILE/lib/ ディレク
トリにあります。
2. データソースファイルを作成する
データソースファイルはデータソースの設定が含まれる XML ファイルです。命名規則は
DATASOURCE-NAME-ds.xm l となり、DATASOURCE-NAME をデータソースの論理名に置き換えま
す。
下記の通り、ファイルの内容はデプロイメントのタイプ (XADatasource、 Driver、Local) によって
異なります。
14
第1章 D ata Services サーバーへの接続
3. データソースファイルのデプロイ
サーバーの PROFILE/deploy/ ディレクトリへファイルをコピーしてデータソースをデプロイしま
す。
* -ds.xm l ファイルに指定されている JNDI 名を使用してデータソースにアクセスできるようになりま
す。
1.3.1. DataSource 接続
デプロイメント環境に固有する正しい DatabaseName、ServerName、ポート番号、認証情報を把握する
ようにしてください。
例 1.3 Data Services の DataSource クラスを使用する XADataSource
<datasources>
<xa-datasource>
<jndi-name>TEIID-DS</jndi-name>
<xa-datasource-class>org.teiid.jdbc.TeiidDataSource</xa-datasource-class>
<xa-datasource-property name="DatabaseName">myVDB</xa-datasource-property>
<xa-datasource-property name="serverName">localhost</xa-datasourceproperty>
<xa-datasource-property name="portNumber">31000</xa-datasource-property>
<xa-datasource-property name="user">admin</xa-datasource-property>
<xa-datasource-property name="password">password</xa-datasource-property>
<!-- pool and other JBoss datasource properties -->
<check-valid-connection-sql>SELECT 1</check-valid-connection-sql>
<min-pool-size>5</min-pool-size>
<max-pool-size>10</max-pool-size>
</xa-datasource>
</datasources>
1.3.2. ドライバーベースの接続
Data Services の JDBC ドライバークラス org.teiid.jdbc.T eiidDriver を使用してデータソース
を作成することもできます。
<datasources>
<local-tx-datasource>
<jndi-name>TEIID-DS</jndi-name>
<connection-url>jdbc:teiid:myVDB@mm://localhost:31000</connection-url>
<driver-class>org.teiid.jdbc.TeiidDriver</driver-class>
<user-name>admin</user-name>
<password>teiid</password>
<!-- pool and other JBoss datasource properties -->
<check-valid-connection-sql>SELECT 1</check-valid-connection-sql>
<min-pool-size>5</min-pool-size>
<max-pool-size>10</max-pool-size>
</local-tx-datasource>
</datasources>
1.3.3. ローカル JDBC 接続
15
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
T eiid ランタイムがインストールされている JBoss AS インスタンスにクライアントアプリケーションを
デプロイする場合、ソケットベースの JDBC 接続を用いずに接続する方法があります。JDBC API が同じ
VM でローカル T eiid ランタイムをルックアップする「ローカル」接続を確立するには若干変更された
データソースを使用します。
警告
DataSource は T eiid の VDB がデプロイされる前に起動するため、ローカル接続の最小プールサイ
ズをデフォルトの 0 のままにしておきます。最小プールサイズを変更すると、T eiid DataSource
の起動時にエラーが発生します。
注記
デフォルトでは、ローカル接続は呼び出しスレッドを使用して処理操作を実行するため、呼び出し
スレッドのブロック中にエンジンスレッドを使用しません。この動作を無効にするには、接続プロ
パティー useCallingT hreads=false を設定します。
例 1.4 ローカルデータソース
<datasources>
<xa-datasource>
<jndi-name>TEIID-DS</jndi-name>
<xa-datasource-class>org.teiid.jdbc.TeiidDataSource</xa-datasource-class>
<xa-datasource-property name="DatabaseName">myVDB</xa-datasource-property>
<xa-datasource-property name="user">admin</xa-datasource-property>
<xa-datasource-property name="password">password</xa-datasource-property>
<!-- pool and other JBoss datasource properties -->
<max-pool-size>10</max-pool-size>
</xa-datasource>
</datasources>
1.4. 複 数 ホ ス ト の 使 用
フェイルオーバー機能とロードバランシング機能を使用すると、同じクラスターの複数の Data Services
サーバーへ接続することができます。
これらの機能を有効にするには、クライアントが複数のホスト名とポート番号の組み合わせを
host:port のコンマ区切りリストとして URL 接続文字列に指定するのが最も簡単な方法となります。
例 1.5 URL 接続文字列の例
jdbc:teiid:<vdb-name>@mm://host1:31000,host1:31001,host2:31000;version=2
DataSource を使用して Data Services サーバーに接続する場合、AlternateServers プロパティーま
たはメソッドを使用してフェイルオーバーサーバーを定義することができます。この形式も host:port
16
第1章 D ata Services サーバーへの接続
のコンマ区切りリストになります。
クライアントはリストより Data Services サーバーの 1 つを無作為に選択し、そのサーバーとのセッショ
ンを確立します。そのサーバーへ接触できない場合、無作為順に残りの各サーバーへ接続しようとしま
す。これにより、接続時間のフェイルオーバーと無作為サーバー選択のロードバランシングの両方を可能
にします。
1.4.1. フェイルオーバー
管理接続 (AdminShell によって使用される接続など) が使用される場合や、autoFailover 接続プロパ
ティーが true に設定されている場合、接続後のフェイルオーバーが使用されます。接続前のフェイルオー
バーではほぼ毎秒ごとに ping を送信し、使用前に接続をテストします。ping に失敗すると、操作を実行
する前に新しいインスタンスが選択されます。
この場合、クライアントはトランザクションやクエリを再起動せず、セッションスコープが指定された一
時テーブルも再作成しないため、本当の「透過的なアプリケーションフェイルオーバー」とはみなされま
せん。非管理接続と併用する場合は細心の注意を払ってください。
1.4.2. ロードバランシング
接続後のロードバランシングは 2 通りに使用できます。1 つ目は、T eiidDataSource を使用し、Data
Services の PooledConnections によって返された接続の close メソッドが呼び出された場合、新し
いサーバーインスタンスが自動的に選択されます。しかし、ドライバーベースの接続を使用したり、接続
プールで T eiidDataSource を使用する場合、ロードバランシングは自動的に発生しません。2 つ目
は、set ステートメント SET NEWINST ANCE T RUE を使用して明示的にロードバランシングを誘発する
ことができます。通常、このステートメントを手作業で発行する必要はありませんが、DataSource 設定
の接続テストクエリとして使用します。
例 1.6 接続後にロードバランシングを使用する JBoss AS DataSource
<datasources>
<local-tx-datasource>
<jndi-name>TEIID-DS</jndi-name>
<connection-url>
jdbc:teiid:myVDB@mm://localhost:31000,mm://localhost:32000
</connection-url>
<driver-class>org.teiid.jdbc.TeiidDriver</driver-class>
<user-name>admin</user-name>
<password>teiid</password>
<!-- pool and other JBoss datasource properties -->
<check-valid-connection-sql>SET NEWINSTANCE TRUE</check-valid-connectionsql>
<min-pool-size>5</min-pool-size>
<max-pool-size>10</max-pool-size>
</local-tx-datasource>
</datasources>
Data Services は再使用される追加のソケット接続のプールを維持します。ロードバランシングでは接続
を別のサーバーインスタンスに切り替える潜在的なコストを削減できます。デフォルト設定では 16 の接
続を維持します。これはクライアント jar の teiid-client-settings.properties ファイルにある
org.teiid.sockets.m axCachedInstances プロパティーによって設定されます。クライアントア
プリケーションが大量の Data Services インスタンスへ接続し、接続後にロードバランシングが使用され
る場合、キャッシュ済みインスタンスの数を増やすよう考慮してください。設定するに
は、org.teiid.sockets.m axCachedInstances システムプロパティーを作成して必要値を設定す
17
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
るか、新規の teiid-client-settings.properties ファイルを作成してクライアント jar ファイル
の前になるようクラスパスに挿入します。
重要
現在トランザクションを実行しているセッションレベル一時テーブル、セッションレベルのキャッ
シュエントリー、指定セッションの PreparedPlans は他のクラスターのメンバーは使用できませ
ん。そのため、論理接続が閉じられ、実際の接続が再使用された時のみロードバランシングを接続
後に使用することが推奨されます。これは典型的な接続プールのパターンになります。
1.4.3. 詳細設定
サーバーディスカバリー、ロードバランシング、フェイルオーバー、再トライ、再トライの遅延などはデ
フォルトのポリシーが適切でない場合にカスタマイズすることができます。カスタマイズを行う前に
org.teiid.net.socket.ServerDiscovery インターフェースとデフォルト実装の
org.teiid.net.socket.UrlServerDiscovery を参照してください。
UrlServerDiscovery 実装は次を提供します。
URL ホストからのサーバーディスカバリー (DataSource サーバー/alternativeServers)
ロードバランシングやフェイルオーバーの無作為選択
ホストごとに 1 つの接続を試行
バイアスなし
ブラックリスト
その他の上級機能
フォールバックストラテジーとして使用し、必要な changed メソッドのみを実装できるようにするた
め、通常は UrlServerDiscovery を拡張します。接続ごとに 1 つの ServerDiscovery インスタン
スが作成されることを考慮することが重要となります。インスタンス間での情報共有は、静的ステートま
たはその他の共有ルックアップより行います。
カスタマイズしたサーバーディスカバリークラスは、完全なクラス名を使用して discoveryStategy 接続ま
たは DataSource プロパティーによって参照されなければなりません。
haproxy などの外部 tcp ロードバランサーの使用を選択することもできます。通常、ロードバランサーの
単一ホスト/ポートのみを使用するよう T eiid ドライバーや DataSource を設定します。
1.4.4. 再認証
T eiid 接続 (org.teiid.jdbc.T eiidConnection インターフェースによって定義される) は
changeUser メソッドによる接続の再認証をサポートしています。 再認証に成功すると、指定のアイデン
ティティーを用いて現在の接続が使用されます。既存のステートメント/結果セットも以前のアイデンティ
ティーで使用可能です。
18
第2章 準備済みステートメント
第 2章 準備済みステートメント
Data Services は java.sql.PreparedStatem ent の標準実装を提供します。準備されたステートメ
ントによって、サーバーがステートメントの解析や解決、プランニングをスキップできるため、共通ス
テートメントの実行を迅速化するために大変重要です。
準備済みステートメントを使用する際、次の点を考慮してください。
Data Services がサーバー側でプランキャッシングを実行するため、クライアント側の Data Services
PreparedStatem ents をプールする必要はありません。
キャッシュ済みプランの数は設定可能です。プランは LRU の順 (最後に使用されてから未使用の期間
が長い順) にパージされます。
キャッシュ済みプランはクラスターによって分散されません。クラスターメンバーごとに新しいプラ
ンを作成する必要があります。
プランは VDB 全体または特定セッションに対してキャッシュされます。プランの範囲は、プランイン
グ処理中に評価された関数に基づき自動的に検出されます。
現在、コスト情報のランタイム更新は再プランニングを実行しません。現時点ではセッションスコー
プが指定された一時テーブルや内部実体化されたテーブルのみがコスト情報を更新します。
CallableStatem ent より実行される保存されたプロシージャーのプランは
PreparedStatem ent と同様にキャッシュされます。
関数の署名が 1 つのみである場合や戻り値の型が判断される述語で関数が使用された場合、関数署名
のバインド変数タイプ (例: where t.col = abs(?)) を判断することができます。さらに複雑な状
況では、upper(convert(?, string)) のように cast や convert を使用してヒントを追加する必
要がある場合があります。
PreparedStatem ent の使用に関する詳細は
http://download.oracle.com/javase/6/docs/technotes/guides/jdbc/getstart/preparedstatement.html の Java
ドキュメントを参照してください。
19
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
第 3章 JDBC API への Data Services の拡張
3.1. ス テ ー ト メ ン ト の 拡 張
Data Services のステートメント拡張インターフェース org.teiid.jdbc.T eiidStatem ent は JDBC
の標準を越えた機能を提供します。この拡張インターフェースを使用するには、接続によって返されたス
テートメントをキャストまたはアンラップします。拡張インターフェース上で次のメソッドが提供されま
す。
表 3.1 接続プロパティー
メソッド名
詳細
getAnnotations
ステートメントが最後に SHOWPLAN ON|DEBUG で実行された場
合、クエリエンジンアノテーションを取得します。各
org.teiid.client.plan.Annotation には説明やカテゴ
リー、深刻度が含まれ、クエリプランナーによる選択を理解するた
めに使用されるクエリプランニング中に記録されたノートの解決が
含まれることもあります。
getDebugLog
ステートメントが最後に SHOWPLAN DEBUG で実行された場合、
デバッグログを取得します。
getExecutionProperty
ステートメントオブジェクト上に存在する実行プロパティーの現在
の値を取得します。
getPlanDescription
ステートメントが最後に SHOWPLAN ON|DEBUG で実行された場
合、クエリプランの詳細を取得します。プランは
org.teiid.client.plan.PlanNode オブジェクトで構成され
たツリーです。 通常、プランをテキスト形式に変換するために
PlanNode.toString() または PlanNode.toXm l() が使用され
ます。
getRequestIdentifier
このステートメント上で最後に実行されたコマンドの識別子を取得
します。コマンドが実行されていない場合は null が返されます。
setExecutionProperty
このステートメントの実行プロパティーを設定します。詳細は 「実
行プロパティー」 の項を参照してください。実行プロパティーが実
行されたステートメントのみに適用される場合以外は一般的に SET
ステートメントの使用が適切です。詳細は 「SET ステートメント」
を参照してください。
setPayload
トランスレーターに渡すコマンド毎のペイロードを設定します。現
在、ビルトインは Oracle データソースへのヒント送信のみに使用さ
れます。
3.2. 実 行 プ ロ パ テ ィ ー
実行プロパティーはステートメントごとに T eiidStatem ent インターフェースから設定することがで
きます。また、SET ステートメントを使用して接続上で設定することも可能です。プロパティーキーは
org.teiid.jdbc.ExecutionProperties インターフェース上の定数によって定義されます。
詳細は 「ステートメントの拡張」 と 「SET ステートメント」 を参照してください。
20
第3章 JD BC API への D ata Services の拡張
表 3.2 実行プロパティー
プロパティー名 /文字列定数
詳細
PROP_T XN_AUT O_WRAP /
autoCom m itT xn
接続プロパティーと同様。
PROP_PART IAL_RESULT S_MO
DE / partialResultsMode
詳細は 「部分結果モード」 を参照してください。
PROP_XML_FORMAT /
XMLForm at
XML ドキュメントモデルによって返された XML ドキュメントの
フォーマットを決定します。詳細は 「ドキュメントのフォーマッ
ト」 を参照してください。
PROP_XML_VALIDAT ION /
XMLValidation
XML ドキュメントモデルによって返された XML ドキュメントが処理
後にスキーマに対して検証されるかを決定します。詳細はリファレ
ンスガイドの「XML SELECT コマンド」の章と「ドキュメントの検
証」の項を参照してください。
RESULT _SET _CACHE_MODE /
resultSetCacheMode
接続プロパティーと同様。
SQL_OPT ION_SHOWPLAN /
SHOWPLAN
接続プロパティーと同様。
NOEXEC / NOEXEC
接続プロパティーと同様。
JDBC4 COLUMNNAMEANDLABEL
SEMANT ICS /
useJDBC4 Colum nNam eAndLa
belSem antics
接続プロパティーと同様。
3.3. SET ス テ ー ト メ ン ト
SET ステートメントを使用して接続上で実行プロパティーを設定することもできます。現在、SET ス
テートメントは Data Services の言語機能ではなく、JDBC クライアントでのみ処理されます。
SET の構文:
SET (パラメーター|SESSION AUT HORIZ AT ION) 値
構文ルール:
「パラメーター」は引用符で囲まれていない識別子でなければなりません。空白文字は使用できませ
ん。
「値」は引用符で囲まれていない識別子か引用符で囲まれた文字列リテラルの値になります。
SET ステートメントはプランニングや実行を制御するために最も一般的に使用されます。
SET SHOWPLAN (ON|DEBUG|OFF)
SET NOEXEC (ON|OFF)
21
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
例 3.1 プランデバッグを有効にする
Statement s = connection.createStatement();
s.execute("SET SHOWPLAN DEBUG");
...
Statement s1 = connection.createStatement();
ResultSet rs = s1.executeQuery("select col from table");
ResultSet planRs = s1.exeuteQuery("SHOW PLAN");
planRs.next();
String debugLog = planRs.getString("DEBUG_LOG");
SET ステートメントを使用して認証を制御することも可能です。SET SESSION AUT HORIZ AT ION ス
テートメントは認証情報が現在接続上に設定されている場合に 「再認証」 を実行します。SET
PASSWORD ステートメントを発行して接続の認証情報を変更することもできます。 SET PASSWORD
ステートメントは再認証を実行しません。
例 3.2 セッション承認の変更
Statement s = connection.createStatement();
s.execute("SET PASSWORD 'someval'");
s.execute("SET SESSION AUTHORIZATION 'newuser'");
3.4. SHOW ス テ ー ト メ ン ト
SHOW ステートメントを使用するとさまざまな情報を表示することができます。現在、SHOW ステート
メントは Data Services の言語機能ではなく、JDBC クライアントでのみ処理されます。
SHOW PLAN
SHOW PLAN は、clob 列 PLAN_T EXT や xml 列 PLAN_XML、以前実行されたクエリの値が含ま
れる行を持つ clob 列 DEBUG_LOG が含まれる結果セットを返します。SHOWPLAN が OFF で
あったり、プランがない場合、返される行はありません。SHOWPLAN が DEBUG に設定されて
いない場合、DEBUG_LOG は null 値を返します。
SHOW ANNOT AT IONS
SHOW ANNOT AT IONS は文字列 CAT EGORY、PRIORIT Y、ANNOT AT ION、RESOLUT ION お
よび以前実行されたクエリの各アノテーションに対する行が含まれる結果セットを返します。
SHOWPLAN が OFF であったり、プランがない場合、返される行はありません。
SHOW プロパティー
SHOW プロパティーは SET の逆となるプロパティーで、指定されたプロパティーのプロパ
ティー値を表示します。プロパティーキーと一致する名前を持つ単一の文字列が含まれる結果
セットを返します。
SHOW ALL
SHOW ALL は、NAME 文字列とすべてのプロパティー値に対する行エントリーを持つ VALUE 文
字列が含まれる結果セットを返します。
22
第3章 JD BC API への D ata Services の拡張
SHOW ステートメントは、例3.1「プランデバッグを有効にする」 の通りクエリプランの読み出しに最も
一般的に使用されます。
3.5. ト ラ ン ザ ク シ ョ ン ス テ ー ト メ ン ト
JDBC 接続を直接使用できない場合、トランザクションステートメントを使用してローカルトランザク
ションを制御することができます。
ST ART T RANSACT ION
ST ART T RANSACT ION は connection.setAutoCom m it(false) と同じです。
COMMIT
COMMIT は connection.setAutoCom m it(true) と同じです。
ROLLBACK
ROLLBACK は connection.rollback() と同じで、自動コミットモードへ戻ります。
3.6. 部 分 結 果 モ ー ド
Data Service サーバーは「部分結果」クエリモードをサポートします。このモードはクエリプロセッサー
の挙動を変更するため、一部のデータソースがない場合でもサーバーは結果を返します。
例えば、異なるサプライヤーに対して 2 つのデータソースが存在し、データデザイナーによって 2 つのサ
プライヤーからの情報を結合 (union) する仮想グループが作成されたとします。部分結果クエリモードを
使用せずにアプリケーションがクエリを提出し、1 つのサプライヤーのデータベースがダウンした場合、
仮想グループに対するクエリは例外を返します。しかし、アプリケーションが同じクエリを「部分結果」
クエリモードで実行すると、サーバーは稼働しているデータソースよりデータを返し、ダウンしている
データソースからはデータを返しません。
「部分結果」モードを使用する際、処理中にソースが例外をスローしてもユーザーのクエリが失敗する原
因にはなりません。ソースは障害点の後にこれ以上の行を返さないとみなされます。多くの場合でソース
は 0 行を返します。
不足している情報がうまく処理されるため、 UNION クエリや OUT ER JOIN クエリを使用する時のこの
挙動は大変便利です。他のクエリの多くは部分結果モードで使用された時にソースがないと 0 行を返しま
す。
クエリから除外される各ソースに対して、ソースと障害を説明する警告が生成されます。これらの警告は
Statem ent.getWarnings() メソッドより取得できます。このメソッドは SQLWarning オブジェクト
を返しますが、「部分結果」警告の場合はこのオブジェクトが
org.teiid.jdbc.PartialResultsWarning クラスのインスタンスになります。このクラスを使用
すると、名前ごとに失敗したすべてのソースの一覧を取得したり、各リソースアダプターによってスロー
された特定の例外を取得することができます。
23
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
注記
Data Services は結果全体が形成される前にカーソルの使用をサポートするため、結果の最初の
バッチがクライアントに返されるまでデータソースの失敗が判断されない可能性があります。これ
は union による結合の場合に発生しますが、join では発生しません。確実にすべての警告が蓄積さ
れるようにするため、結果セット全体が読み取られた後にステートメントをチェックする必要があ
ります。
部分結果モードはデフォルトで無効になっていますが、DataSource 上に setPartialResultsMode("true")
を設定するか、JDBC URL に partialResultsMode=true を設定すると接続のすべてのクエリに対して有効
にすることができます。いずれの設定方法でも部分結果モードが後に SET ステートメントと切り替わる
ことがあります。詳細は 「SET ステートメント」 を参照してください。
例 3.3 部分結果モードの設定
Statement statement = ...obtain statement from Connection...
statement.execute("set partialResultsMode true");
例 3.4 部分結果の警告の取得
statement.execute("set partialResultsMode true");
ResultSet results = statement.executeQuery("SELECT Name FROM Accounts");
while (results.next())
{
//process the result set
}
SQLWarning warning = statement.getWarnings();
if(warning instanceof PartialResultsWarning)
{
PartialResultsWarning partialWarning = (PartialResultsWarning)warning;
Collection failedConnectors = partialWarning.getFailedConnectors();
Iterator iter = failedConnectors.iterator();
while(iter.hasNext())
{
String connectorName = (String) iter.next();
SQLException connectorException =
partialWarning.getConnectorException(connectorName);
System.out.println(connectorName + ": " + ConnectorException.getMessage();
}
}
3.7. XML 拡 張
XML 拡張はクエリから XML ドキュメントモデルへの XML 結果に適用されますが、SQL/XML によって作
成された XML や他のソースより読み取られた XML には適用されません。
3.7.1. ドキュメントのフォーマット
24
第3章 JD BC API への D ata Services の拡張
PROP_XML_FORMAT 実行プロパティーを設定して、XML ドキュメントモデルから XML ドキュメントが
フォーマットされる方法を変更することができます。定数の有効な値は同じ ExecutionProperties イ
ンターフェースに定義されています。
XML_T REE_FORMAT
XML_T REE_FORMAT は表示向けにフォーマットされた XML のバージョンを返します。XML は
XML をツリーとしてフォーマットするため適切に改行やタブを使用します。フォーマットに要す
る時間が長く、ドキュメントのサイズも大きいため、フォーマットの速度は遅くなります。
XML_COMPACT _FORMAT
XML_COMPACT _FORMAT はパフォーマンスを最適化するためフォーマットされた XML のバー
ジョンを返します。XML は単一の長い文字列で不必要な空白文字は存在しません。
重要
PROP_XML_FORMAT 実行プロパティーが設定されていない場合、元のモデルにおける XML ドキュ
メントのフォーマットフラグが使用されます。この場合、ドキュメントの設定によりドキュメント
のツリーまたはコンパクトが作成されます。
3.7.2. スキーマ検証
PROP_XML_VALIDAT ION 実行プロパティーを設定すると、クライアントに返す前にサーバーが XML ド
キュメントモデルのドキュメントをスキーマに対して検証するよう示すことができます。スキーマ検証が
有効になっている場合、ドキュメントが関連するスキーマに適合しないとサーバーは SQLWarning を送信
します。スキーマ検証を使用すると XML クエリのパフォーマンスが低下します。
25
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
第 4章 JDBC でのトランザクション
Data Services の JDBC API はクライアントの観点からグローバル、ローカル、要求レベルの 3 種類のト
ランザクションをサポートとします。これらのトランザクションはすべて Data Services サーバーによっ
て XA トランザクションとして実装されます。XA トランザクションの詳細は
http://www.oracle.com/technetwork/java/javaee/tech/jta-138684.html の JT A 仕様を参照してください。
4.1. ロ ー カ ル ト ラ ン ザ ク シ ョ ン
接続クラスは autoCom m it フラグを使用してローカルトランザクションを明示的に制御します。デフォ
ルトでは autoCommit は要求レベルまたは黙示的トランザクションの制御を示す true に設定されていま
す。例4.1「autoCommit を使用したローカルトランザクションの制御」 を参照してください。
例 4 .1 autoCommit を使用したローカルトランザクションの制御
// Set auto commit to false and start a transaction
connection.setAutoCommit(false);
try
{
// Execute multiple updates
Statement statement = connection.createStatement();
statement.executeUpdate("INSERT INTO Accounts (ID, Name) VALUES (10,
‘Mike’)");
statement.executeUpdate("INSERT INTO Accounts (ID, Name) VALUES (15,
‘John’)");
statement.close();
// Commit the transaction
connection.commit();
}
catch(SQLException e)
{
// If an error occurs, rollback the transaction
connection.rollback();
}
この例では次の項目が実行されます。
1. autoCom m it フラグを false に設定します。トランザクションの接続へのバインドを開始します。
2. トランザクションのコンテキスト内で複数の更新を実行します。
3. ステートメントが完了すると、com m it() を呼び出してトランザクションがコミットされます。
4. エラーが発生すると rollback() メソッドを使用してトランザクションがロールバックされま
す。
次の操作はいずれもローカルトランザクションを終了します。
1. Connection.setAutoCom m it(true) - 以前 false に設定された場合
2. Connection.com m it()
3. Connection.rollback()
4. タイムアウトするとトランザクションは自動的にロールバックされます。
26
第4章 JD BC でのトランザクション
場合によってはすべてのアクセスが読み取り専用でトランザクションが必要でない時でも Data Services
より上のツールやフレームワークが setAutoCom m it(false) や com m it()、rollback() を呼び出
すことがあります。ローカルトランザクションの範囲では Data Services が起動し、XA トランザクショ
ンをコミットしようとするため、設定が複雑になったりパフォーマンスが劣化する原因となることがあり
ます。
このような場合、デフォルトの JDBC の動作を上書きし、実行されたコマンドに関係なくこれらのメソッ
ドは何も実行しないよう示すことができます。ローカルトランザクションの使用を無効にするには、この
プロパティーを JDBC 接続 URL に追加します。
disableLocalTxn=true
警告
ローカルトランザクションを無効にすると危険な場合があります。読み取り時に結果が不整合と
なったり、書き込み時にデータストアのデータが不整合となることがあります。安全性を保つた
め、呼び出しアプリケーションがローカルトランザクションを必要としないことが確定している場
合のみこのモジュールを使用するようにしてください。
4.2. 要 求 レ ベ ル ト ラ ン ザ ク シ ョ ン
要求レベルトランザクションは、要求がグローバルトランザクションまたはローカルトランザクションの
範囲にない場合 (autoCom m it が true の場合) に使用されます。要求レベルトランザクションではアプ
リケーションが明示的にコミットやロールバックを呼び出す必要はありません。各コマンドは、サーバー
によって自動的にコミットまたはロールバックされる独自のトランザクションとなることが想定されま
す。
Data Services サーバーは仮想テーブルより更新を実行できます。これらの更新によって、アプリケー
ションが単一の仮想テーブルに対して更新コマンドを発行した場合でも複数の物理システムに対して更新
が行われることがあります。ほとんどの場合でユーザーはクエリ済みテーブルが複数のソースを更新しト
ランザクションが必要となることを認識しません。
そのため、Data Services サーバーは必要な場合にアプリケーションがトランザクションでコマンドを自
動的にラップできるようにします。このラッピングはクエリのパフォーマンスに影響するため、複数の
ラッピングモードよりご使用の環境に合ったモードを選択することができます。アプリケーションが必要
とするのは高い整合性か高いパフォーマンスのどちらかであるか選択する必要があります。例えば、デー
タソースがトランザクションに対応していない場合、トランザクションのラッピングを (完全に) 無効にし
てパフォーマンスを最大限に向上するとよいでしょう。
トランザクションラッピングを以下のモードの 1 つに設定することが可能です。
1. ON
このモードは必要性を確認せずに常にトランザクションのコマンドをラップします。これが最も安
全なモードです。
2. OFF
このモードはトランザクションのコマンドを自動的にラップせず、コマンドをラップする必要性も
確認しません。このモードではエラーを出さずにトランザクション外部のソースを複数更新できる
ため、危険な場合があります。このモードでは更新やトランザクションを使用しないアプリケー
ションのパフォーマンスが最良となります。
3. DET ECT
27
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
このモードはトランザクションで複数ソースの更新が実行されることをユーザーが認識しないと想
定します。Data Services サーバーは各コマンドをチェックし、複数ソースの更新であるかを確認
しトランザクション内でラップします。単一ソースの場合はソースレベルのコマンドトランザク
ションを使用します。
実行プロパティーを使用して接続を確立する時やクエリごとにトランザクションモードをプロパティーと
して設定することができます。詳細は 「実行プロパティー」 を参照してください。
4.2.1. 複数挿入バッチ
クエリ表現 (または廃止された SELECT INT O) で INSERT を発行すると、個別のソースの INSERT に
よって処理される複数の挿入バッチが Data Servces サーバーによって処理されることがあります。目的
のソースが XA をサポートしていることを確認してください。サポートしていない場合、障害が発生する
と補正処理が行われます。
4.3. グ ロ ー バ ル ト ラ ン ザ ク シ ョ ン の 使 用
グローバルまたはクライアント XA トランザクションは Data Services JDBC API が単一のクライアントリ
ソースの範囲を越えるトランザクションに参加できるようにします。この場合、接続の確立に Data
Services の DataSource クラスを使用します。
JBoss や WebSphere、Weblogic などのアプリケーションサーバーにおける UserT ransaction のコンテ
キストで DataSource が使用されると、結果として生じる接続には現在の XA トランザクションが関連付
けされます。XA トランザクションとの対話に必要な追加のクライアント JDBC コードはありません。
28
第4章 JD BC でのトランザクション
例 4 .2 手作業による XA トランザクションの使用
XAConnection xaConn = null;
XAResource xaRes = null;
Connection conn = null;
Statement stmt = null;
try
{
xaConn = <XADataSource instance>.getXAConnection();
xaRes = xaConn.getXAResource();
Xid xid = <new Xid instance>;
conn = xaConn.getConnection();
stmt = conn.createStatement();
xaRes.start(xid, XAResource.TMNOFLAGS);
stmt.executeUpdate("insert into …");
// other statements on this connection or other resources enlisted in this
transaction
// ...
xaRes.end(xid, XAResource.TMSUCCESS);
if (xaRes.prepare(xid) == XAResource.XA_OK)
{
xaRes.commit(xid, false);
}
}
catch (XAException e)
{
xaRes.rollback(xid);
}
finally
{
// clean up code
// ...
}
グローバルトランザクションを使用すると複数の Data Services XAConnections が同じトランザクション
に参加することができます。Data Services JDBC XAResource の isSam eRM() メソッドはクラスターの
同じサーバーインスタンスへ接続が確立されている場合に true のみを返すことに注意してください。
Data Services の接続が異なるサーバーインスタンスへ確立されていると、同じクラスターメンバーの場
合とはトランザクションの挙動が異なることがあります。例えば、クライアントトランザクションマネー
ジャーが各接続に同じ XID を使用する場合、異なるクラスターメンバーよりアクセスされた同じ物理ソー
スより重複した XID 例外が発生することがあります。クライアントトランザクションマネージャーが各接
続に異なるブランチ識別子を使用する場合、ブランチ識別子に従って変更をロックしたり分離するソース
に問題が発生することがあります。
4.4. 制 限
4.4.1. アプリケーションの制限
グローバルやローカル、要求レベルのトランザクションの使用はすべて相互排他的です。要求レベルトラ
ンザクションはグローバルまたはローカルトランザクションにない時のみ適用されます。グローバルトラ
ンザクションとローカルトランザクションを同時に組み合わせると例外が発生します。
29
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
4.4.2. エンタープライズ情報システムサポート
エンタープライズ情報システム (EIS) を表す基盤のリソースアダプターや EIS 自体は、XA トランザクショ
ンが Data Services を使用して分散 XA トランザクションに参加できるようサポートしなければなりませ
ん。ソースシステムが XA をサポートしない場合、分散トランザクションには参加できません。しかし、
ソースは XA サポートがなくてもデータの統合には参加することができます。
XA トランザクションへの参加はリソースアダプターの XA 機能に従って自動的に判断されます。分散トラ
ンザクションへの参加が必要な場合、開発者が責任を持って XA リソースを設定するようにしてくださ
い。
30
第5章 SSL クライアント接続
第 5章 SSL クライアント接続
本章ではトランスポートレベルでのデータアクセスの保護を目的とした Data Services で使用できる異な
るセキュリティー設定について説明します。データレベルセキュリティーであるデータロールについての
詳細は、リファレンスガイドのデータロールの章を参照してください。
5.1. デ フ ォ ル ト の セ キ ュ リ テ ィ ー
デフォルトでは、接続ごとにネゴシエートされる http://en.wikipedia.org/wiki/DiffieHellman_key_exchange キーを使用してクライアントサーバー間に存在するすべての JDBC/管理に影響さ
れる (非データ) メッセージが暗号化されます。この暗号化は JdbcSslConfiguration の
clientEncryptionEnabled プロパティーと jboss-beans ファイルの Adm inSslConfiguration
セクションによって制御されます。
ソケット接続を使用している場合、更にチャネルを安全にする必要があります。特に ODBC は現在プレー
ンテキストの認証のみをサポートしているため更なるセキュリティーが必要です。
5.2. SSL モ デ ル
Data Services は クライアント JDBC アプリケーションと Data Services サーバーの間で SSL ベースの
チャネルをサポートします。Data Services は次の SSL モードをサポートします。
1. 匿名 (Anonymous) - 証明書は必要ありませんが、すべての通信が
T LS_DH_anon_WIT H_AES_128_CBC_SHA SSL スイートを使用して暗号化されます。
2. 一方向 (1-way) – サーバーからクライアントへのトラフィックのみが認証されます。サーバーと
キーを認証するクライアントのトラストストアに対して秘密鍵のキーストアを作成する必要があり
ます。SSL スイートがネゴシエートされます。
3. 双方向 (2-way) – クライアントとサーバーの相互認証です。サーバーアプリケーションとクライア
ントアプリケーションはそれぞれ秘密鍵のキーストアと相手側を認証するトラストストアを保有し
ています。
SSL モードによっては組織での秘密鍵の作成や取得のガイドラインに従うようにしてください。組織にお
ける必要条件がない場合、本ガイドに従って対応するキーストアとトラストストアで自己署名証明書を作
成してください。詳細は 付録B Keytool を用いた自己署名証明書の生成 を参照してください。
異なる SSL モードに必要となるキーストアとトラストストアの組み合わせは次の通りです。ファイル名は
例として使用されているため、変更することが可能です。
一方向
server.keystore - サーバーの秘密鍵を保有
server.truststore - サーバーの公開鍵を保有
双方向
server.keystore - サーバーの秘密鍵を保有
server.truststore - サーバーの公開鍵を保有
client.keystore - クライアントの秘密鍵
client.truststore - クライアントの公開鍵を保有
31
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
5.3. ク ラ イ ア ン ト の SSL 設 定
各 SSL モードに必要なプロパティーを定義するセクションは次の通りです。
重要
Data Services の設定ではデフォルトで SSL が有効になっています。SSL が有効な状態で Data
Services サーバーに接続する時、jdbc:teiid:MY-VDB@ m m s://HOST:PORT のように JDBC 接
続 URL の代わりに m m s プロトコルを使用する必要があります。
一方向 SSLや双方向 SSL を有効するためにクライアントが設定できるプロパティーは 2 セットありま
す。
5.3.1. オプション 1: Java SSL プロパティー
JVM 以下に SSL を設定する標準的な Java が定義されたシステムプロパティーがあります。Data
Serivces による SSL の使用は独自なものではありません。次のシステムプロパティーをクライアントの
VM 処理に提供します。
例 5.1 一方向 SSL
-Djavax.net.ssl.trustStore=<dir>/server.truststore (required)
-Djavax.net.ssl.trustStorePassword=<password> (optional)
-Djavax.net.ssl.keyStoreType (optional)
例 5.2 2 方向 SSL
-Djavax.net.ssl.keyStore=<dir>/client.keystore (required)
-Djavax.net.ssl.keyStrorePassword=<password> (optional)
-Djavax.net.ssl.trustStore=<dir>/server.truststore (required)
-Djavax.net.ssl.trustStorePassword=<password> (optioanl)
-Djavax.net.ssl.keyStroreType=<keystore type> (optional)
5.3.2. オプション 2: Deta Services 固有のプロパティー
このオプションは、匿名モードの場合や上記の javax ベースのプロパティーがホストプロセスによって
既に使用されている場合に使用します。例えば、クライアントアプリケーションが HT T PS に対して設定
された T omcat のプロセスで、上記の Java ベースのプロパティーが既に使用されている場合、Data
Services 固有の証明書キーを HT T PS 証明書キーストアへインポートすることはできません。
この場合、異なるセットの Data Services 固有の SSL プロパティーをシステムプロパティーとして設定し
たり、teiid-client-settings.properties ファイルの内部を設定することができます。teiid-clientsettings.properties ファイルはルートの teiid-client.jar ファイルの中にあります。このファイルを
展開するかコピーを作成し、選択した SSL モードに必要なプロパティー値を変更した後、クライアントア
プリケーションのクラスパス上で teiid-client.jar ファイルの前にこのファイルを置きます。
teiid-client-settings.properties 内の SSL プロパティーおよび定義は次の通りです。
32
第5章 SSL クライアント接続
########################################
# SSL Settings
########################################
#
# The key store type.
#
Defaults to JKS
org.teiid.ssl.keyStoreType=JKS
#
# The key store algorithm, defaults to
# the system property "ssl.TrustManagerFactory.algorithm"
#
#org.teiid.ssl.algorithm=
#
#
#
#
#
#
#
#
The classpath or filesystem location of the
key store.
This property is required only if performing 2-way
authentication that requires a specific private
key.
#org.teiid.ssl.keyStore=
#
# The key store password (not required)
#
#org.teiid.ssl.keyStorePassword=
#
#
#
#
#
#
#
#
The classpath or filesystem location of the
trust store.
This property is required if performing 1-way
authentication that requires trust not provided
by the system defaults.
#org.teiid.ssl.trustStore=
#
# The trust store password (not required)
#
#org.teiid.ssl.trustStorePassword=
#
# The cipher protocol, defaults to SSLv3
#
org.teiid.ssl.protocol=SSLv3
#
# Whether to allow anonymous SSL
# (the TLS_DH_anon_WITH_AES_128_CBC_SHA cipher suite)
33
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
# defaults to true
#
org.teiid.ssl.allowAnon=true
例 5.3 一方向 SSL
org.teiid.ssl.trustStore=<dir>/server.truststore (required)
例 5.4 2 方向 SSL
org.teiid.ssl.keyStore=<dir>/client.keystore (required)
org.teiid.ssl.trustStore=<dir>/server.truststore (required)
例 5.5 匿名
org.teiid.ssl.trustStore=NONE
34
第6章 D ata Services を Hibernate と使用する
第 6章 Data Services を Hibernate と使用する
6.1. 制 限
Hibernate の多くのユースケースでは、データソースが CREAT E T ABLE や DROP T ABLE などの DDL
(データ定義言語) ステートメントと SELECT 、UPDAT E、INSERT 、DELET E などの DML (データ操
作言語) ステートメントを処理できる能力 (適切なユーザーパーミッションにより) を持っていること
を前提としています。 T eiid は広範囲の DML に対応できますが、特定ソースに対する DDL を直接サ
ポートしていません。
シーケンスとアイデンティティーの生成はサポートされていません。hilo ジェネレーターなど、テーブ
ル値を基にした識別子の生成には T eiid を介して識別子テーブルを公開する必要があります。GUID 識
別子生成のストラテジーは直接サポートされます。
6.2. 設 定
大部分では、Hibernate より Data Services の VDB (仮想データベース) と対話することは他のタイプの
データソースと動作することと同じになります。最初に Data Services の DBC API クライアント JAR
ファイルと Data Services の Hibernate ダイアレクト JAR を Hibernate のクラスパスに置きます。
下記のファイルは JBOSS_HOME/server/PROFILE/lib ディレクトリにあります。
teiid-client.jar
teiid-hibernate-dialect-7.1.1.jar
これらの JAR ファイルには org.teiid.dialect.T eiidDialect や
org.teiid.jdbc.T eiidDriver、 org.teiid.jdbc.T eiidDataSource クラスがあります。
次に 手順6.1「Hibernate の設定」 に従って hibernate.cfg.xm l ファイルに Hibernate を設定しま
す。VDB-NAME、HOST 、PORT 、USERNAME、 PASSWORD を適切な値に置き換えます。
手順 6.1 Hibernate の設定
1. Data Services のドライバークラスの指定
connection.driver_class プロパティーに Data Services ドライバークラスを指定します。
<property name="connection.driver_class">
org.teiid.jdbc.TeiidDriver
</property>
2. 接続 URL の設定
connection.url プロパティーに VDB の URL を指定します。
<property name="connection.url">
jdbc:teiid:VDB-NAME@mm://HOST:POST;user=USERNAME;password=PASSWORD
</property>
注記
Hibernate が アプリケーションサーバーと同じ VM にある場合、必ず 「ローカル JDBC 接
続」 を使用してください。
35
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
3. dialect プロパティーに Data Services のダイアレクトクラスを指定する
<property name="dialect">
org.teiid.dialect.TeiidDialect
</property>
hibernate.cfg.xm l の代わりに hibernate.properties ファイルに接続プロパティーを追
加することもできます。
hibernate.connection.driver_class=org.teiid.jdbc.TeiidDriver
hibernate.connection.url=jdbc:teiid:VDB-NAME@mm://HOST:PORT
hibernate.connection.username=USERNAME
hibernate.connection.password=PASSWORD
hibernate.dialect=org.teiid.dialect.TeiidDialect
VDB に同じテーブル名を持つ複数のソースモデルやビューモデルが含まれている可能性が高いため、
Hibernate マッピングファイルに完全修飾テーブル名を指定する必要があります。
<class name="CLASSNAME" table="SOURCE/VIEW_MODEL_NAME.[SCHEMA_NAME.]TABLENAME">
...
</class>
例 6.1 マッピング例
<class name="org.teiid.example.Publisher" table="BOOKS.BOOKS.PUBLISHERS">
...
</class>
36
第7章 OD BC サポート
第 7章 ODBC サポート
JBoss Enterprise Data Services は PostgreSQL データベースサーバーをエミュレートして ODBC (Open
DataBase Connectivity) のアクセスをデプロイされた VDB に提供します。 デフォルトでは JBoss
Enterprise Data Services 上の ODBC は 354 32 番ポートで有効になっています。ODBC 準拠のクライア
ントアプリケーションはサポート対象の PostgreSQL ODBC ドライバーを使用して VDB に接続すること
ができます。サポート対象の PostgreSQL ODBC ドライバーは http://access.redhat.com よりダウンロー
ドできます。
注記
ODBC は標準化されたデータベースアクセス方法で、1992 年に SQL Access グループによって開
発されました。Java の JDBC と同様に、使用されているデータベース管理システム (DBMS) に関
係なく一貫性のあるクライアントアクセスを可能にします。
警告
現在、T eiid は ODBC に対してプレーンテキストのパスワード認証のみをサポートしています。ク
ライアントサーバーが SSL を使用するよう設定されていない場合、パスワードはネットワーク上
でプレーンテキストにて送信されます。SSL を使用せずに送信中のパスワードを保護する必要があ
る場合は、クライアントからの安全なパスワード値を許可する (暗号化またはハッシュ化など) セ
キュリティードメインをインストールするようにしてください。
7.1. ODBC ド ラ イ バ ー ク ラ イ ア ン ト の イ ン ス ト ー ル
異なるオペレーティングシステムでサポートされる PostgreSQL ODBC ドライバーのインストールパッ
ケージは http://access.redhat.com よりダウンロードできます。
Red Hat Enterprise Linux や その他サポート対象オペレーティングシステム向けのドライバーパッケージ
をインストールおよび設定する手順は以下の項を参照してください。
重要
ODBC の設定には管理パーミッションを持つユーザーアカウントが必要となります。Red Hat
Enterprise Linux やその他の UNIX オペレーティングシステムでは sudo コマンドの使用や root
ユーザーアカウントへのアクセスを許可する必要があります。Microsoft Windows では管理者アカ
ウント使用する必要があります。
7.1.1. Red Hat Enterprise Linux やその他の UNIX オペレーティングシステムに
ODBC ドライバーをインストールする
手順 7.1 Red Hat Enterprise Linux やその他の UNIX オペレーティングシステムに ODBC ドライ
バーをインストールする
1. ダウンロード
http://access.redhat.com よりご使用のオペレーティングシステム向けの正しい ODBC ドライバー
インストールパッケージをダウンロードします。
2. パッケージの解凍
37
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
/opt ディレクトリにインストールパッケージを展開します。
3. 環境の設定
/opt/redhat/eds-5.x/etc/setenv.sh スクリプトを実行します。
[localhost etc]$ ./setenv.sh
このスクリプトは必要なディレクトリを LD_LIBRARY_PAT H および PAT H 環境変数に追加しま
す。
4. DSN の設定
/opt/redhat/eds-5.x/etc/odbc.ini ファイルを編集し、正しいユーザー名、パスワード、
データベースで更新します。データベース名は VDB 名です。
[<DSN name>]
Driver = /usr/lib/psqlodbc.so
Description = PostgreSQL Data Source
Servername = <Teiid Host name or ip>
Port = 35432
Protocol = 7.4-1
UserName = <user-name>
Password = <password>
Database = <vdb-name>
ReadOnly = no
ServerType = Postgres
ConnSettings =
UseServerSidePrepare=1
ByteaAsLongVarBinary=1
Optimizer=0
Ksqo=0
Debug=0
Fetch = 10000
# enable below when dealing large resultsets
#UseDeclareFetch=1
5. 完了
これで ODBC ドライバーが適切にインストールされ、eds という名前の DSN が使用できるように
なります。
7.1.2. Microsoft Windows に ODBC ドライバーをインストールする
手順 7.2 Microsoft Windows に ODBC ドライバーをインストールする
1. ダウンロード
http://access.redhat.com よりご使用のオペレーティングシステム向けの正しい ODBC ドライバー
インストールパッケージをダウンロードします。
2. インストーラーの解凍および実行
インストールパッケージを解凍し、setup.exe 実行可能ファイルをダブルクリックしてインス
トーラーを開始します。
3. インストール場所の提供
インストーラーより入力を求められたら ODBC ドライバーをインストールするディレクトリを入力
します。
4. 完了
インストーラーが必要なファイルを指定場所へコピーします。これで ODBC ドライバーが使用でき
るようになります。
38
第7章 OD BC サポート
5. DSN の設定
a. ODBC データソース管理者アプレットを開く
Start menu より以下を実行します。
Settings の選択後、Control Panel を選択します。
Administrative T ools をダブルクリックします。
Data Sources (ODBC) をダブルクリックします。
これで ODBC データソース管理者アプレットが表示されます。
b. DSN の追加
追加したい DSN のタイプに関連するタブをクリックします。Create New Data Source
ダイアログボックスが開きます。データソーステーブルのドライバーとして PostgreSQL
Unicode を選択し、Finish をクリックすると PostgreSQL Unicode ODBC Driver
Setup ダイアログボックスが開きます。
図 7.1 PostgreSQL の Unicode ODBC ドライバーの設定
c. 詳細の入力
次の内容を PostgreSQL ODBC Driver Setup ダイアログボックスに入力します。
Data Source フィールドにデータソースに割り当てたい名前を入力します
Database フィールドにこのデータソースを使用してアクセスする VDB の名前を入力し
ます。
Server フィールドに Data Services サーバーのホスト名か IP アドレスを入力します。
ファイアウォールや NAT アドレスを使用して接続する場合はファイアウォールまたは
NAT アドレスを使用します。
Port フィールドに Data Services システムが ODBC 要求をリッスンするポートの番号を
入力します。Data Services によって使用されるデフォルトのポート番号は 354 32 で
す。
User Nam e および Password フィールドに Data Services サーバーへの接続に使用す
るユーザー名とパスワードを入力します。
SSL Mode は disable のままにしておいてください。 現在 SSL 接続はサポートされて
いません。
Description フィールドにデータソースの説明を入力します。
d. オプションページ 1
Datasource ボタンをクリックして Advanced Options ダイアログボックスを表示しま
す。
39
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
図7.2「DSN オプションページ 1」 の通りオプションを設定します。
図 7.2 DSN オプションページ 1
e. オプションページ 2
Page 2 ボタンをクリックしてオプションの 2 ページ目を表示します。
図7.3「DSN オプションページ 2」 の通りオプションを設定し、OK をクリックします。
40
第7章 OD BC サポート
図 7.3 DSN オプションページ 2
f. 保存およびテスト
Save をクリックして変更を保存します。T est ボタンをクリックして接続が有効であるか確
認することもできます。
41
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
サポート対象外の JDBC メソッド
本付録は JDK 1.6 JDBC を基にした Data Services ではサポートされない JDBC メソッドの一覧を提供し
ます。下記に指定がない限り Data Services は他のメソッドをすべてサポートします。
一覧にあるメソッドでコメントのないものは、サポート対象外であることを示し、SQLException タイ
プの例外をスローします。
記載されている通り、例外をスローしないメソッドもありますが、想定外の動作をする可能性がありま
す。引数の指定がない場合、関連 (上書き) するメソッドもすべてサポート対象外となります。引数が指定
されている場合、指定のあるメソッドの形式のみがサポート対象外となります。
A.1. ResultSet の 制 限
T YPE_SCROLL_SENSIT IVE はサポートされません。
UPDAT ABLE ResultSet はサポートされません。
プロシージャの実行より複数の ResultSet を返すことはサポートされません。
A.2. java.sql の サ ポ ー ト 対 象 外 の ク ラ ス お よ び メ ソ ッ ド
42
サポート対象外の JD BC メソッド
表 A.1 接続プロパティー
クラス名
メソッド
Array
Not Supported
Blob
getBinaryStream(long, long) SQLFeatureNotSupportedException をスロー
setBinaryStream(long) - - SQLFeatureNotSupportedException
をスロー
setBytes - - SQLFeatureNotSupportedException をスロー
truncate(long) - SQLFeatureNotSupportedException をスロー
CallableStatem ent
43
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
CallableStatem ent
getArray - SQLFeatureNotSupportedException をスロー
getBigDecimal(String parameterName)SQLFeatureNotSupportedException をスロー
getBlob(String parameterName)SQLFeatureNotSupportedException をスロー
getBoolean(String parameterName)SQLFeatureNotSupportedException をスロー
getByte(String parameterName)SQLFeatureNotSupportedException をスロー
getBytes(String parameterName)SQLFeatureNotSupportedException をスロー
getCharacterStream(String parameterName)SQLFeatureNotSupportedException をスロー
getClob(String parameterName)SQLFeatureNotSupportedException をスロー
getDate(String parameterName, *)SQLFeatureNotSupportedException をスロー
getDouble(String parameterName)SQLFeatureNotSupportedException をスロー
getFloat(String parameterName)SQLFeatureNotSupportedException をスロー
getInt(String parameterName)SQLFeatureNotSupportedException をスロー
getLong(String parameterName)SQLFeatureNotSupportedException をスロー
getNCharacterStream - SQLFeatureNotSupportedException をス
ロー
getNClob - SQLFeatureNotSupportedException をスロー
getNString - SQLFeatureNotSupportedException をスロー
getObject(int parameterIndex, Map<String, Class<?>> map) SQLFeatureNotSupportedException をスロー
getObject(String parameterName) SQLFeatureNotSupportedException をスロー
getRef - SQLFeatureNotSupportedException をスロー
getRowId - SQLFeatureNotSupportedException をスロー
getShort(String parameterName) SQLFeatureNotSupportedException をスロー
getSQLXML(String parameterName) SQLFeatureNotSupportedException をスロー
getString(String parameterName) SQLFeatureNotSupportedException をスロー
getTime(String parameterName, *) SQLFeatureNotSupportedException をスロー
getTimestamp(String parameterName, *) SQLFeatureNotSupportedException をスロー
getURL(String parameterName) SQLFeatureNotSupportedException をスロー
registerOutParameter - 無視
registerOutParameter(String parameterName, *) SQLFeatureNotSupportedException をスロー
setAsciiStream - SQLFeatureNotSupportedException をスロー
setBigDecimal(String parameterName, BigDecimal x)SQLFeatureNotSupportedException をスロー
setBinaryStream(String parameterName, *) SQLFeatureNotSupportedException をスロー
setBlob(String parameterName, *)SQLFeatureNotSupportedException をスロー
setBoolean(String parameterName, boolean x) SQLFeatureNotSupportedException をスロー
setByte(String parameterName, byte x) -
44
サポート対象外の JD BC メソッド
SQLFeatureNotSupportedException をスロー
setBytes(String parameterName, byte[] x) SQLFeatureNotSupportedException をスロー
setCharacterStream - SQLFeatureNotSupportedException をス
ロー
setClob(String parameterName, *) SQLFeatureNotSupportedException をスロー
setDate(String parameterName, *) SQLFeatureNotSupportedException をスロー
setDouble(String parameterName, double x) SQLFeatureNotSupportedException をスロー
setFloat(String parameterName, float x) SQLFeatureNotSupportedException をスロー
setLong(String parameterName, long x) SQLFeatureNotSupportedException をスロー
setNCharacterStream - SQLFeatureNotSupportedException をス
ロー
setNClob - SQLFeatureNotSupportedException をスロー
setNString - SQLFeatureNotSupportedException をスロー
setNull - SQLFeatureNotSupportedException をスロー
setObject(String parameterName, *) SQLFeatureNotSupportedException をスロー
setRowId(String parameterName, RowId x) SQLFeatureNotSupportedException をスロー
setSQLXML(String parameterName, SQLXML xmlObject) SQLFeatureNotSupportedException をスロー
setShort(String parameterName, short x) SQLFeatureNotSupportedException をスロー
setString(String parameterName, String x) SQLFeatureNotSupportedException をスロー
setTime(String parameterName, *) SQLFeatureNotSupportedException をスロー
setTimestamp(String parameterName, *) SQLFeatureNotSupportedException をスロー
setURL(String parameterName, URL val) SQLFeatureNotSupportedException をスロー
Clob
getCharacterStream(long arg0, long arg1) SQLFeatureNotSupportedException をスロー
setAsciiStream(long arg0) - SQLFeatureNotSupportedException
をスロー
setCharacterStream(long arg0) SQLFeatureNotSupportedException をスロー
setString - SQLFeatureNotSupportedException をスロー
truncate - SQLFeatureNotSupportedException をスロー
Connection
45
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
Connection
createArrayOf - SQLFeatureNotSupportedException をスロー
createBlob - SQLFeatureNotSupportedException をスロー
createClob - SQLFeatureNotSupportedException をスロー
createNClob - SQLFeatureNotSupportedException をスロー
createSQLXML - SQLFeatureNotSupportedException をスロー
createStatement(int resultSetType,int resultSetConcurrency,
int resultSetHoldability) - SQLFeatureNotSupportedException
createStruct(String typeName, Object[] attributes) SQLFeatureNotSupportedException をスロー
getClientInfo - SQLFeatureNotSupportedException をスロー
prepareCall(String sql, int resultSetType,int
resultSetConcurrency, int resultSetHoldability) SQLFeatureNotSupportedException をスロー
prepareStatement(String sql, int autoGeneratedKeys) SQLFeatureNotSupportedException をスロー
prepareStatement(String sql, int[] columnIndexes) SQLFeatureNotSupportedException をスロー
prepareStatement(String sql, String[] columnNames) SQLFeatureNotSupportedException をスロー
releaseSavepoint - SQLFeatureNotSupportedException をスロー
rollback(Savepoint savepoint) SQLFeatureNotSupportedException をスロー
setHoldability - SQLFeatureNotSupportedException をスロー
setSavepoint - SQLFeatureNotSupportedException をスロー
setTypeMap - SQLFeatureNotSupportedException をスロー
DatabaseMetaData
getAttributes - SQLFeatureNotSupportedException をスロー
getClientInfoProperties - SQLFeatureNotSupportedException
をスロー
getFunctionColumns - SQLFeatureNotSupportedException をス
ロー
getFunctions - SQLFeatureNotSupportedException をスロー
getRowIdLifetime - SQLFeatureNotSupportedException をスロー
NClob
Not Supported
PreparedStatem ent
execute(String sql) - SQLException をスロー
executeQuery(String sql) - SQLException をスロー
executeUpdate(String sql) - SQLException をスロー
setArray - SQLFeatureNotSupportedException をスロー
setNCharacterStream - SQLFeatureNotSupportedException をス
ロー
setNClob - SQLFeatureNotSupportedException をスロー
setRef - SQLFeatureNotSupportedException をスロー
setRowId - SQLFeatureNotSupportedException をスロー
setUnicodeStream - SQLFeatureNotSupportedException をスロー
Ref
ResultSet
46
Not Im plem ented
サポート対象外の JD BC メソッド
ResultSet
deleteRow - SQLFeatureNotSupportedException をスロー
getArray - SQLFeatureNotSupportedException をスロー
getAsciiStream - SQLFeatureNotSupportedException をスロー
getHoldability - SQLFeatureNotSupportedException をスロー
getNCharacterStream - SQLFeatureNotSupportedException をス
ロー
getNClob - SQLFeatureNotSupportedException をスロー
getNString - SQLFeatureNotSupportedException をスロー
getObject(*, Map<String, Class<?>> map) SQLFeatureNotSupportedException をスロー
getRef - SQLFeatureNotSupportedException をスロー
getRowId - SQLFeatureNotSupportedException をスロー
getUnicodeStream - SQLFeatureNotSupportedException をスロー
getURL - SQLFeatureNotSupportedException をスロー
insertRow - SQLFeatureNotSupportedException をスロー
moveToInsertRow - SQLFeatureNotSupportedException をスロー
refreshRow - SQLFeatureNotSupportedException をスロー
rowDeleted - SQLFeatureNotSupportedException をスロー
rowInserted - SQLFeatureNotSupportedException をスロー
rowUpdated - SQLFeatureNotSupportedException をスロー
setFetchDirection - SQLFeatureNotSupportedException をスロー
update* - SQLFeatureNotSupportedException をスロー
RowId
Not Supported
Savepoint
not Supported
SQLData
Not Supported
SQLInput
not Supported
SQLOutput
Not Supported
Statem ent
execute(String, int)
execute(String, int[])
execute(String, String[])
executeUpdate(String, int)
executeUpdate(String, int[])
executeUpdate(String, String[])
getGeneratedKeys()
getResultSetHoldability()
setCursorName(String)
Struct
Not Supported
A.3. javax.sql の サ ポ ー ト 対 象 外 の ク ラ ス お よ び メ ソ ッ ド
表 A.2 接続プロパティー
クラス名
メソッド
RowSet*
Not Supported
Statem entEventListener
Not Supported
47
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
Keytool を用いた自己署名証明書の生成
自己署名証明書を生成するには、Java SDK のすべてのバージョンに含まれる「keytool」と呼ばれるプロ
グラムが必要となります。以下の手順は、セキュリティーキーを持つ一方向 SSL 設定にキーストアファイ
ルとトラストストアファイルの両方を作成する手順となります。
B.1. 秘 密 鍵 と 公 開 鍵 の ペ ア の 作 成
keytool -genkey -alias teiid -keyalg RSA -validity 365 –keystore
server.keystore –storetype JKS
Enter keystore password: <enter password>
What is your first and last name?
[Unknown]: <user’s name>
What is the name of your organizational unit?
[Unknown]: <department name>
What is the name of your organization?
[Unknown]: <company name>
What is the name of your City or Locality?
[Unknown]: <city name>
What is the name of your State or Province?
[Unknown]: <state name>
What is the two-letter country code for this unit?
[Unknown]: <country name>
Is CN=<user’s name>, OU=<department name>, O="<company name>",
L=<city name>, ST=<state name>, C=<country name> correct?
[no]: yes
Enter key password for <server>
(Return if same as keystore password)
新規作成した秘密鍵を基に server.keystore をキーストアとして使用することができます。
B.2. 公 開 鍵 の 抽 出
上記で作成した server.keystore よりトラストストアを作成するための公開鍵を抽出することができま
す。
keytool -export -alias teiid –keystore server.keystore -rfc -file public.cert
Enter keystore password: <enter passsword>
上記は server.keystore の秘密鍵を基に公開鍵が含まれる public.cert ファイルを作成します。
B.3. ト ラ ス ト ス ト ア の 作 成
48
Keytool を用いた自己署名証明書の生成
keytool -import -alias teiid -file public.cert –storetype JKS -keystore
server.truststore
Enter keystore password: <enter password>
Owner: CN=<user's name>, OU=<dept name>, O=<company name>, L=<city>, ST=<state>,
C=<country>
Issuer: CN=<user's name>, OU=<dept name>, O=<company name>, L=<city>, ST=<state>,
C=<country>
Serial number: 416d8636
Valid from: Fri Jul 31 14:47:02 CDT 2009 until: Sat Jul 31 14:47:02 CDT 2010
Certificate fingerprints:
MD5: 22:4C:A4:9D:2E:C8:CA:E8:81:5D:81:35:A1:84:78:2F
SHA1: 05:FE:43:CC:EA:39:DC:1C:1E:40:26:45:B7:12:1C:B9:22:1E:64:63
Trust this certificate? [no]: yes
これで server.truststore が作成されました。自己署名証明書を作成する方法はたくさんあるため上
記の手順はその1つとなります。openssl を使用して自己署名証明書を作成するには
http://www.akadia.com/services/ssh_test_certificate.html のチュートリアルを参照してください。
49
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
GNU Lesser General Public License 2.1
50
GNU Lesser General Public License 2.1
GNU LESSER GENERAL PUBLIC LICENSE
Version 2.1, February 1999
Copyright (C) 1991, 1999 Free Software Foundation, Inc.
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
[This is the first released version of the Lesser GPL. It also counts
as the successor of the GNU Library Public License, version 2, hence
the version number 2.1.]
Preamble
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public
Licenses are intended to guarantee your freedom to share and change
free software--to make sure the software is free for all its users.
This license, the Lesser General Public License, applies to some
specially designated software packages--typically libraries--of the
Free Software Foundation and other authors who decide to use it. You
can use it too, but we suggest you first think carefully about whether
this license or the ordinary General Public License is the better
strategy to use in any particular case, based on the explanations below.
When we speak of free software, we are referring to freedom of use,
not price. Our General Public Licenses are designed to make sure that
you have the freedom to distribute copies of free software (and charge
for this service if you wish); that you receive source code or can get
it if you want it; that you can change the software and use pieces of
it in new free programs; and that you are informed that you can do
these things.
To protect your rights, we need to make restrictions that forbid
distributors to deny you these rights or to ask you to surrender these
rights. These restrictions translate to certain responsibilities for
you if you distribute copies of the library or if you modify it.
For example, if you distribute copies of the library, whether gratis
or for a fee, you must give the recipients all the rights that we gave
you. You must make sure that they, too, receive or can get the source
code. If you link other code with the library, you must provide
complete object files to the recipients, so that they can relink them
with the library after making changes to the library and recompiling
it. And you must show them these terms so they know their rights.
We protect your rights with a two-step method: (1) we copyright the
library, and (2) we offer you this license, which gives you legal
permission to copy, distribute and/or modify the library.
To protect each distributor, we want to make it very clear that
there is no warranty for the free library. Also, if the library is
modified by someone else and passed on, the recipients should know
that what they have is not the original version, so that the original
author's reputation will not be affected by problems that might be
introduced by others.
Finally, software patents pose a constant threat to the existence of
any free program. We wish to make sure that a company cannot
51
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
effectively restrict the users of a free program by obtaining a
restrictive license from a patent holder. Therefore, we insist that
any patent license obtained for a version of the library must be
consistent with the full freedom of use specified in this license.
Most GNU software, including some libraries, is covered by the
ordinary GNU General Public License. This license, the GNU Lesser
General Public License, applies to certain designated libraries, and
is quite different from the ordinary General Public License. We use
this license for certain libraries in order to permit linking those
libraries into non-free programs.
When a program is linked with a library, whether statically or using
a shared library, the combination of the two is legally speaking a
combined work, a derivative of the original library. The ordinary
General Public License therefore permits such linking only if the
entire combination fits its criteria of freedom. The Lesser General
Public License permits more lax criteria for linking other code with
the library.
We call this license the "Lesser" General Public License because it
does Less to protect the user's freedom than the ordinary General
Public License. It also provides other free software developers Less
of an advantage over competing non-free programs. These disadvantages
are the reason we use the ordinary General Public License for many
libraries. However, the Lesser license provides advantages in certain
special circumstances.
For example, on rare occasions, there may be a special need to
encourage the widest possible use of a certain library, so that it becomes
a de-facto standard. To achieve this, non-free programs must be
allowed to use the library. A more frequent case is that a free
library does the same job as widely used non-free libraries. In this
case, there is little to gain by limiting the free library to free
software only, so we use the Lesser General Public License.
In other cases, permission to use a particular library in non-free
programs enables a greater number of people to use a large body of
free software. For example, permission to use the GNU C Library in
non-free programs enables many more people to use the whole GNU
operating system, as well as its variant, the GNU/Linux operating
system.
Although the Lesser General Public License is Less protective of the
users' freedom, it does ensure that the user of a program that is
linked with the Library has the freedom and the wherewithal to run
that program using a modified version of the Library.
The precise terms and conditions for copying, distribution and
modification follow. Pay close attention to the difference between a
"work based on the library" and a "work that uses the library". The
former contains code derived from the library, whereas the latter must
be combined with the library in order to run.
GNU LESSER GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License Agreement applies to any software library or other
program which contains a notice placed by the copyright holder or
other authorized party saying it may be distributed under the terms of
52
GNU Lesser General Public License 2.1
this Lesser General Public License (also called "this License").
Each licensee is addressed as "you".
A "library" means a collection of software functions and/or data
prepared so as to be conveniently linked with application programs
(which use some of those functions and data) to form executables.
The "Library", below, refers to any such software library or work
which has been distributed under these terms. A "work based on the
Library" means either the Library or any derivative work under
copyright law: that is to say, a work containing the Library or a
portion of it, either verbatim or with modifications and/or translated
straightforwardly into another language. (Hereinafter, translation is
included without limitation in the term "modification".)
"Source code" for a work means the preferred form of the work for
making modifications to it. For a library, complete source code means
all the source code for all modules it contains, plus any associated
interface definition files, plus the scripts used to control compilation
and installation of the library.
Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope. The act of
running a program using the Library is not restricted, and output from
such a program is covered only if its contents constitute a work based
on the Library (independent of the use of the Library in a tool for
writing it). Whether that is true depends on what the Library does
and what the program that uses the Library does.
1. You may copy and distribute verbatim copies of the Library's
complete source code as you receive it, in any medium, provided that
you conspicuously and appropriately publish on each copy an
appropriate copyright notice and disclaimer of warranty; keep intact
all the notices that refer to this License and to the absence of any
warranty; and distribute a copy of this License along with the
Library.
You may charge a fee for the physical act of transferring a copy,
and you may at your option offer warranty protection in exchange for a
fee.
2. You may modify your copy or copies of the Library or any portion
of it, thus forming a work based on the Library, and copy and
distribute such modifications or work under the terms of Section 1
above, provided that you also meet all of these conditions:
a) The modified work must itself be a software library.
b) You must cause the files modified to carry prominent notices
stating that you changed the files and the date of any change.
c) You must cause the whole of the work to be licensed at no
charge to all third parties under the terms of this License.
d) If a facility in the modified Library refers to a function or a
table of data to be supplied by an application program that uses
the facility, other than as an argument passed when the facility
is invoked, then you must make a good faith effort to ensure that,
in the event an application does not supply such function or
table, the facility still operates, and performs whatever part of
53
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
its purpose remains meaningful.
(For example, a function in a library to compute square roots has
a purpose that is entirely well-defined independent of the
application. Therefore, Subsection 2d requires that any
application-supplied function or table used by this function must
be optional: if the application does not supply it, the square
root function must still compute square roots.)
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Library,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works. But when you
distribute the same sections as part of a whole which is a work based
on the Library, the distribution of the whole must be on the terms of
this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote
it.
Thus, it is not the intent of this section to claim rights or contest
your rights to work written entirely by you; rather, the intent is to
exercise the right to control the distribution of derivative or
collective works based on the Library.
In addition, mere aggregation of another work not based on the Library
with the Library (or with a work based on the Library) on a volume of
a storage or distribution medium does not bring the other work under
the scope of this License.
3. You may opt to apply the terms of the ordinary GNU General Public
License instead of this License to a given copy of the Library. To do
this, you must alter all the notices that refer to this License, so
that they refer to the ordinary GNU General Public License, version 2,
instead of to this License. (If a newer version than version 2 of the
ordinary GNU General Public License has appeared, then you can specify
that version instead if you wish.) Do not make any other change in
these notices.
Once this change is made in a given copy, it is irreversible for
that copy, so the ordinary GNU General Public License applies to all
subsequent copies and derivative works made from that copy.
This option is useful when you wish to copy part of the code of
the Library into a program that is not a library.
4. You may copy and distribute the Library (or a portion or
derivative of it, under Section 2) in object code or executable form
under the terms of Sections 1 and 2 above provided that you accompany
it with the complete corresponding machine-readable source code, which
must be distributed under the terms of Sections 1 and 2 above on a
medium customarily used for software interchange.
If distribution of object code is made by offering access to copy
from a designated place, then offering equivalent access to copy the
source code from the same place satisfies the requirement to
distribute the source code, even though third parties are not
compelled to copy the source along with the object code.
5. A program that contains no derivative of any portion of the
54
GNU Lesser General Public License 2.1
Library, but is designed to work with the Library by being compiled or
linked with it, is called a "work that uses the Library". Such a
work, in isolation, is not a derivative work of the Library, and
therefore falls outside the scope of this License.
However, linking a "work that uses the Library" with the Library
creates an executable that is a derivative of the Library (because it
contains portions of the Library), rather than a "work that uses the
library". The executable is therefore covered by this License.
Section 6 states terms for distribution of such executables.
When a "work that uses the Library" uses material from a header file
that is part of the Library, the object code for the work may be a
derivative work of the Library even though the source code is not.
Whether this is true is especially significant if the work can be
linked without the Library, or if the work is itself a library. The
threshold for this to be true is not precisely defined by law.
If such an object file uses only numerical parameters, data
structure layouts and accessors, and small macros and small inline
functions (ten lines or less in length), then the use of the object
file is unrestricted, regardless of whether it is legally a derivative
work. (Executables containing this object code plus portions of the
Library will still fall under Section 6.)
Otherwise, if the work is a derivative of the Library, you may
distribute the object code for the work under the terms of Section 6.
Any executables containing that work also fall under Section 6,
whether or not they are linked directly with the Library itself.
6. As an exception to the Sections above, you may also combine or
link a "work that uses the Library" with the Library to produce a
work containing portions of the Library, and distribute that work
under terms of your choice, provided that the terms permit
modification of the work for the customer's own use and reverse
engineering for debugging such modifications.
You must give prominent notice with each copy of the work that the
Library is used in it and that the Library and its use are covered by
this License. You must supply a copy of this License. If the work
during execution displays copyright notices, you must include the
copyright notice for the Library among them, as well as a reference
directing the user to the copy of this License. Also, you must do one
of these things:
a) Accompany the work with the complete corresponding
machine-readable source code for the Library including whatever
changes were used in the work (which must be distributed under
Sections 1 and 2 above); and, if the work is an executable linked
with the Library, with the complete machine-readable "work that
uses the Library", as object code and/or source code, so that the
user can modify the Library and then relink to produce a modified
executable containing the modified Library. (It is understood
that the user who changes the contents of definitions files in the
Library will not necessarily be able to recompile the application
to use the modified definitions.)
b) Use a suitable shared library mechanism for linking with the
Library. A suitable mechanism is one that (1) uses at run time a
copy of the library already present on the user's computer system,
55
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
rather than copying library functions into the executable, and (2)
will operate properly with a modified version of the library, if
the user installs one, as long as the modified version is
interface-compatible with the version that the work was made with.
c) Accompany the work with a written offer, valid for at
least three years, to give the same user the materials
specified in Subsection 6a, above, for a charge no more
than the cost of performing this distribution.
d) If distribution of the work is made by offering access to copy
from a designated place, offer equivalent access to copy the above
specified materials from the same place.
e) Verify that the user has already received a copy of these
materials or that you have already sent this user a copy.
For an executable, the required form of the "work that uses the
Library" must include any data and utility programs needed for
reproducing the executable from it. However, as a special exception,
the materials to be distributed need not include anything that is
normally distributed (in either source or binary form) with the major
components (compiler, kernel, and so on) of the operating system on
which the executable runs, unless that component itself accompanies
the executable.
It may happen that this requirement contradicts the license
restrictions of other proprietary libraries that do not normally
accompany the operating system. Such a contradiction means you cannot
use both them and the Library together in an executable that you
distribute.
7. You may place library facilities that are a work based on the
Library side-by-side in a single library together with other library
facilities not covered by this License, and distribute such a combined
library, provided that the separate distribution of the work based on
the Library and of the other library facilities is otherwise
permitted, and provided that you do these two things:
a) Accompany the combined library with a copy of the same work
based on the Library, uncombined with any other library
facilities. This must be distributed under the terms of the
Sections above.
b) Give prominent notice with the combined library of the fact
that part of it is a work based on the Library, and explaining
where to find the accompanying uncombined form of the same work.
8. You may not copy, modify, sublicense, link with, or distribute
the Library except as expressly provided under this License. Any
attempt otherwise to copy, modify, sublicense, link with, or
distribute the Library is void, and will automatically terminate your
rights under this License. However, parties who have received copies,
or rights, from you under this License will not have their licenses
terminated so long as such parties remain in full compliance.
9. You are not required to accept this License, since you have not
signed it. However, nothing else grants you permission to modify or
distribute the Library or its derivative works. These actions are
prohibited by law if you do not accept this License. Therefore, by
56
GNU Lesser General Public License 2.1
modifying or distributing the Library (or any work based on the
Library), you indicate your acceptance of this License to do so, and
all its terms and conditions for copying, distributing or modifying
the Library or works based on it.
10. Each time you redistribute the Library (or any work based on the
Library), the recipient automatically receives a license from the
original licensor to copy, distribute, link with or modify the Library
subject to these terms and conditions. You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible for enforcing compliance by third parties with
this License.
11. If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Library at all. For example, if a patent
license would not permit royalty-free redistribution of the Library by
all those who receive copies directly or indirectly through you, then
the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Library.
If any portion of this section is held invalid or unenforceable under any
particular circumstance, the balance of the section is intended to apply,
and the section as a whole is intended to apply in other circumstances.
It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system which is
implemented by public license practices. Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
12. If the distribution and/or use of the Library is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Library under this License may add
an explicit geographical distribution limitation excluding those countries,
so that distribution is permitted only in or among countries not thus
excluded. In such case, this License incorporates the limitation as if
written in the body of this License.
13. The Free Software Foundation may publish revised and/or new
versions of the Lesser General Public License from time to time.
Such new versions will be similar in spirit to the present version,
but may differ in detail to address new problems or concerns.
Each version is given a distinguishing version number. If the Library
specifies a version number of this License which applies to it and
"any later version", you have the option of following the terms and
57
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
conditions either of that version or of any later version published by
the Free Software Foundation. If the Library does not specify a
license version number, you may choose any version ever published by
the Free Software Foundation.
14. If you wish to incorporate parts of the Library into other free
programs whose distribution conditions are incompatible with these,
write to the author to ask for permission. For software which is
copyrighted by the Free Software Foundation, write to the Free
Software Foundation; we sometimes make exceptions for this. Our
decision will be guided by the two goals of preserving the free status
of all derivatives of our free software and of promoting the sharing
and reuse of software generally.
NO WARRANTY
15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Libraries
If you develop a new library, and you want it to be of the greatest
possible use to the public, we recommend making it free software that
everyone can redistribute and change. You can do so by permitting
redistribution under these terms (or, alternatively, under the terms of the
ordinary General Public License).
To apply these terms, attach the following notices to the library. It is
safest to attach them to the start of each source file to most effectively
convey the exclusion of warranty; and each file should have at least the
"copyright" line and a pointer to where the full notice is found.
<one line to give the library's name and a brief idea of what it does.>
Copyright (C) <year> <name of author>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
58
GNU Lesser General Public License 2.1
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
USA
Also add information on how to contact you by electronic and paper mail.
You should also get your employer (if you work as a programmer) or your
school, if any, to sign a "copyright disclaimer" for the library, if
necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the
library `Frob' (a library for tweaking knobs) written by James Random Hacker.
<signature of Ty Coon>, 1 April 1990
Ty Coon, President of Vice
That's all there is to it!
59
JBoss Enterprise D ata Services 5 D ata Services クライアント開発者ガイド
改訂履歴
改訂 5.2.0-2.4 00
2013-10-31
Landmann Rüdiger [FAMILY
Given]
2012-07-18
T owns Anthony [FAMILY
Given]
Rebuild with publican 4.0.0
改訂 5.2.0-2
Rebuild for Publican 3.0
改訂 5.2.0-0
Mon Jun 27 2011
JBoss Enterprise SOA Platform 5.2 向けに更新
Le Sage David [FAMILY Given]
改訂 5.1.0-1
Mon May 23 2011
ODBC ドライバーの説明を更新
Le Sage David [FAMILY Given]
改訂 5.1.0-0
Fri Feb 18 2011
T eiid クライアント開発者ガイドより作成
Mison Darrin [FAMILY Given]
60

DATASHEET PCI AUDIT SERVICES

報告書 - 筑波大学図書館情報メディア系｜図書館情報メディア研究科

シングルマザー・サポートグループ - Japanese Social Services

はじめに

江古田博士とエコ実験サーカスパフォーマンス

トロント大学での半年間 - 慶應義塾大学メディアセンター

download(資料2)