プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの管理
12
c
(12.2.1)
E70015-01
ライブラリ
製品
次
目次
タイトルおよび著作権情報
はじめに
ドキュメントのアクセシビリティについて
表記規則
1
概要とロードマップ
ドキュメントの範囲および対象読者
このドキュメントの手引き
関連ドキュメント
JDBCサンプルとチュートリアル
Avitek医療記録アプリケーション(MedRec)とチュートリアル
WebLogic Serverディストリビューションに含まれるJDBCのサンプル
このリリースにおけるJDBCデータ・ソースの新機能と変更された機能
デフォルト・データ・ソース
簡略化されたドライバ・インストール/更新
プロキシ・データ・ソースのサポート
UCPデータ・ソースのサポート
マルチテナント用のJDBCデータ・ソースのサポート
接続リークのプロファイリングの拡張
接続ベースのシステム・プロパティの拡張
アプリケーション・コンティニュイティの実行時統計
ONSノード・リスト構成の拡張
DRCPネットワーク・タイムアウト・プロパティ
エディションベースの再定義(EBR)のドキュメントの拡張
計画メンテナンスとデータベース停止のガイドライン
ONSおよびJDBCデバッグの変更の有効化
接続時フェイルオーバーのサポートの削除
2
WebLogic JDBCリソースの構成
WebLogic ServerにおけるJDBCリソースの理解
構成されたJDBCリソースの所有権
データ・ソース構成ファイル
JDBCシステム・モジュール
汎用データ・ソース・モジュール
Active GridLinkデータ・ソースのシステム・モジュール
マルチ・データ・ソース・システム・モジュール
JDBCアプリケーション・モジュール
標準のJava EEアプリケーション・モジュール
独自のJDBCアプリケーション・モジュール
JDBCモジュール・ファイルのネーミング要件
バージョニングされたアプリケーションのJDBCモジュール
JDBCスキーマ
JDBCデータ・ソース・タイプ
JMXおよびWLSTのJDBCリソースへのアクセス
システム・リソース用のJDBC MBeans
Java EE管理モデルにおけるJDBC管理オブジェクト(JSR-77のサポート)
WLSTを使用したJDBCシステム・リソースの作成
JDBCリソースの変更およびモニタリングの方法
WLSTを使用してJDBCリソースを構成する場合のベスト・プラクティス
可用性の高いJDBCリソースの作成
3
JDBCデータ・ソースの構成
JDBCデータ・ソースの理解
WebLogic Server JDBCデータ・ソースのタイプ
JDBCデータ・ソースの作成
JDBCデータ・ソースのプロパティ
データ・ソース名
データ・ソース・スコープ
JNDI名
データベース・タイプの選択
JDBCドライバの選択
トランザクション・オプションの構成
接続プロパティの構成
Oracle BI Serverの接続プロパティの構成
接続のテスト
データ・ソースのターゲット設定
汎用の接続プール機能の構成
JDBCドライバ・レベルの機能の有効化
接続ベースのシステム・プロパティの有効化
接続ベースの暗号化されたプロパティの有効化
SQLコードを使用したデータベース接続の初期化
詳細な接続プロパティ
致命的エラー・コードの定義
エディションベースの再定義の使用
JDBC接続でのEBRの使用
エディションを使用するためのWebLogicデータ・ソースの構成
Oracleパラメータの構成
ONSクライアントの構成
汎用データ・ソース接続プールのチューニング
Oracle RACの停止に対する汎用データ・ソースの処理
ドライバ・レベル・フェイルオーバーの汎用データ・ソースの処理
4
デフォルト・データ・ソースの使用
デフォルト・データ・ソースとは
デフォルト・データ・ソースの特性
WebLogic Serverのデフォルト・データ・ソースの定義
カスタム・デフォルト・データ・ソースの定義
カスタム・デフォルト・データ・ソース・ディスクリプタの作成
デフォルト・データ・ソースのオーバーライド
デフォルト・データ・ソースを使用する場合の互換性の制限
5
JDBCマルチ・データ・ソースの構成
マルチ・データ・ソースの機能
データベース・ノードの削除
データベース・ノードの追加
マルチ・データ・ソースの作成と構成
マルチ・データ・ソース・アルゴリズムの選択
フェイルオーバー
ロード・バランシング
マルチ・データ・ソースのフェイルオーバーの制限と要件
予約時の接続テストによるフェイルオーバーの有効化
使用中の接続に対するフェイルオーバーの実施不可能
マルチ・データ・ソース・フェイルオーバー機能の拡張
汎用データ・ソースの障害発生時における接続リクエストのルーティング機能の拡張
マルチ・データ・ソース内の障害が発生した汎用データ・ソースがリカバリした場合の自動的な再有効化
マルチ・データ・ソース内のビジー状態の汎用データ・ソースのフェイルオーバーの有効化
コールバックによるマルチ・データ・ソース・フェイルオーバーの制御
コールバック・ハンドラの要件
コールバック・ハンドラの構成
フェイルオーバーの仕組み
コールバックによるマルチ・データ・ソース・フェイルバックの制御
フェイルバックの仕組み
サーバーおよびクラスタへのJDBCマルチ・データ・ソースのデプロイ
マルチ・データ・ソースでの計画データベース・メンテナンス
プロセスの概要
データ・ソースの停止
WLSTの例
重要な考慮事項
6
Active GridLinkデータ・ソースの使用方法
Active GridLinkデータ・ソースとは
高速接続フェイルオーバー
実行時接続ロード・バランシング
GridLinkアフィニティ
セッション・アフィニティ・ポリシー
XAアフィニティ・ポリシー
SCANアドレス
Oracleウォレットを使用したONSリスナーとのセキュアな通信
Active Data Guardのサポート
Active GridLinkデータ・ソースの作成
JDBCデータ・ソースのプロパティ
データ・ソース名
データ・ソース・スコープ
JNDI名
ドライバの選択
トランザクション・オプションの構成
接続プロパティの構成
接続プロパティの入力
完全なURLの入力
接続のテスト
ONSクライアント構成
FANイベントの有効化
ONSホストおよびポートの構成
セキュアなONSクライアント通信
ONSクライアント構成のテスト
データ・ソースのターゲット設定
ソケット・ダイレクト・プロトコルの使用
SDPを使用したランタイム・ロード・バランシングの構成
AGL接続プール機能の構成
JDBCドライバ・レベルの機能の有効化
接続ベースのシステム・プロパティの有効化
SQLコードを使用したデータベース接続の初期化
Oracleパラメータの構成
WLSTを使用したONSクライアントの構成
Active GridLinkデータ・ソースの接続プールのチューニング
GridLink JDBCリソースのモニタリング
実行時統計の表示
JDBCOracleDataSourceRuntimeMBean
JDBCOracleDataSourceInstanceRuntimeMBean
ONSDaemonRuntimeMBean
Active GridLinkデータ・ソースのデバッグ
JDBCのデバッグ範囲
UCP JDKロギング
コマンド行を使用したデバッグの有効化
FAN通知を使用しないActive GridLinkデータ・ソースの使用方法
ActiveGridlink属性の理解
Active GridLinkデータ・ソースのベスト・プラクティス
例外のキャッシュと処理
Active Gridlinkデータ・ソースによる接続の作成
AGLとマルチ・データ・ソースの比較
マルチ・データ・ソースからActive GridLinkへの移行
マルチ・データ・ソースからの移行に伴うアプリケーションの変更
マルチ・データ・ソースからの移行に伴う構成の変更
マルチ・データ・ソースからActive GridLinkデータ・ソースへの移行の基本手順
AGLデータ・ソースでのデータベース停止時間の管理
データベースの停止に対応するActive GridLink構成
計画停止の手順
計画外停止
7
Proxyデータ・ソースの使用
プロキシ・データ・ソースとは
プロキシ・データ・ソースの作成
WebLogic Server管理コンソールでのプロキシ・データ・ソースの構成
プロキシ・データ・ソース・プロパティの設定
ターゲットの選択
WLSTを使用したプロキシ・データ・ソースの構成
プロキシ・データ・ソースJDBCリソースのモニタリング
8
ユニバーサル接続プール・データ・ソースの使用
ユニバーサル接続プール・データ・ソースとは
ユニバーサル接続プール・データ・ソースの作成
WebLogic Server管理コンソールでのUCPデータ・ソースの構成
JDBCデータ・ソースのプロパティの設定
接続プロパティの設定
データベース接続のテスト
ターゲットの選択
WLSTを使用したUCPデータ・ソースの構成
ユニバーサル接続プールJDBCリソースのモニタリング
9
接続収集
接続収集とは
接続収集の有効化
接続を収集可能としてマーキング
収集した接続のリカバリ
10
Oracleドライバおよびデータベースの詳細な構成
アプリケーション・コンティニュイティ
アプリケーション・コンティニュイティの機能
要件および考慮事項
アプリケーション・コンティニュイティの構成
アプリケーション・コンティニュイティ対応ドライバの選択
接続コールバックの使用方法
リプレイのタイムアウトの設定
アプリケーション・コンティニュイティの無効化
アプリケーション・コンティニュイティのロギングの構成
JDBCドライバ・デバッグの有効化
アプリケーション・コンティニュイティの実行時統計の表示
WLSTのサンプル
Javaのサンプル
Oracle 12cデータベースにおけるアプリケーション・コンティニュイティに関する制限
データベース常駐接続プーリング
要件および考慮事項
DRCPの構成
DRCP対応データ・ソースの構成
DRCP対応データベースの構成
Global Database Services
要件および考慮事項
GDS接続対応のGridLinkデータ・ソースの作成
プラガブル・データベースを使用するコンテナ・データベース
PDBアクセス対応サービスの作成
DRCPおよびCDB/PDB
JDBCを使用したPDBの設定
テナントの切替えに関する制限
11
接続のラベル付け
接続ラベリングとは
ラベリング・コールバックの実装
ラベリング・コールバックの作成
ラベリング・コールバックの例
ラベリング・コールバックの登録
ラベリング・コールバックの削除
接続ラベルの適用
ラベル付けされた接続の予約
不一致ラベルのチェック
接続ラベルの削除
初期化および再初期化コストを使用した接続の選択
初期化および再初期化コストを使用する場合の考慮事項
パッケージ・アプリケーションによる接続ラべリングの使用
パッケージ・アプリケーションでラベル付けされた接続を使用する場合の考慮事項
12
JDBCデータ・ソース・トランザクション・オプション
非XA JDBCドライバでのグローバル・トランザクションのサポートの有効化
「ロギング・ラスト・リソース」トランザクション・オプションの理解
ロギング・ラスト・リソース最適化を使用する利点
ロギング・ラスト・リソース・トランザクション最適化の有効化
LLRデータ・ソースに関するプログラミング上の考慮事項と制限事項
LLRデータ・ソースに関する管理上の考慮事項と制限事項
2フェーズ・コミットのエミュレート・トランザクション・オプションの理解
非XAドライバを使用して2フェーズ・コミットをエミュレートする際の制限およびリスク
ヒューリスティックな終了とデータの矛盾
保留中のトランザクションを回復できない
複数サーバー構成における非XAリソースのパフォーマンス低下の可能性
複数の非XA登録
接続クローズ時のローカル・トランザクションの完了
13
データ・ソースのセキュリティの理解
WebLogicデータ・ソース・セキュリティのオプションの概要
WebLogicデータ・ソース・セキュリティのオプション
資格証明マッピングとデータベース資格証明
接続へのクライアント識別子の設定
Oracleプロキシ・セッション
IDベースの接続プール
トランザクション内の接続
WebLogicデータ・ソース・リソースのパーミッション
データ・ソース・セキュリティの例
暗号化された接続プロパティの使用
管理コンソールの使用時に接続プロパティを暗号化するためのベスト・プラクティス
接続プロパティを暗号化するためのWLSTの例
WLSTを使用して、暗号化されたプロパティで既存のデータ・ソースを更新する方法
WLSTを使用して、暗号化されたプロパティを作成する方法
データ・ソースおよびOracleドライバでのSSLと暗号化の使用
データ・ソースおよびOracleドライバでのSSLの使用
OracleウォレットでのSSLの使用
Active GridLink ONS over SSL
データ・ソースおよびOracleドライバでのデータ暗号化の使用
14
Oracleウォレットの作成および管理
Oracleウォレットとは
ウォレットを保持する場所
外部パスワード・ストアの作成方法
ウォレットを使用するWebLogic Serverデータ・ソースの定義
ウォレット・ファイルのコピー
データ・ソース構成の更新
DB接続文字列のかわりにTNS別名を使用
15
サーバーおよびクラスタへのデータ・ソースのデプロイ
サーバーおよびクラスタへのデータ・ソースのデプロイ
無応答データベースが原因で発生するサーバー起動ハングアップの最小化
16
WebLogic ServerでのOracle RACの使用
Oracle Real Application Clustersの概要
ソフトウェア要件
JDBCドライバ要件
ハードウェア要件
WebLogic Serverクラスタ
Oracle RACクラスタ
共有ストレージ
WebLogic ServerでOracle RACを使用するための構成オプション
Oracle RACを使用するためのWebLogic Server構成の選択
WebLogic ServerでOracle RACを使用する場合の接続の検証
WebLogic ServerでOracle RACを使用する場合の追加考慮事項
17
WebLogic ServerでのJDBCドライバの使用方法
JDBCドライバのサポート
WebLogic ServerとともにインストールされるJDBCドライバ
WebLogic Serverとともにインストールされていないサード・パーティJDBCドライバの追加
DOMAIN_HOME/libのサード・パーティJARファイルの使用
データ・ソースのサポート
/libのサード・パーティJARファイルの使用の例
Oracle Thinドライバのグローバリゼーション・サポート
デバッグ・モードでのOracle Thinドライバの使用方法
18
WebLogic JDBCリソースのモニタリング
実行時統計の表示
データ・ソースの統計
プリコンパイルされた文のキャッシュの統計
プロファイル・ロギング
プロファイル情報の収集
プロファイル・タイプ
接続使用状況(WEBLOGIC.JDBC.CONN.USAGE)
待機中の接続予約(WEBLOGIC.JDBC.CONN.RESV.WAIT)
失敗した接続予約(WEBLOGIC.JDBC.CONN.RESV.FAIL)
接続リーク(WEBLOGIC.JDBC.CONN.LEAK)
接続の最終使用状況(WEBLOGIC.JDBC.CONN.LAST_USAGE)
マルチスレッド接続使用状況(WEBLOGIC.JDBC.CONN.MT_USAGE)
文キャッシュ・エントリ(WEBLOGIC.JDBC.STMT_CACHE.ENTRY)
文使用状況(WEBLOGIC.JDBC.STMT.USAGE)
接続アンラップ(WEBLOGIC.JDBC.CONN.UNWRAP)
クローズ済JDBCオブジェクトの使用状況(WEBLOGIC.JDBC.CLOSED_USAGE)
ローカル・トランザクション接続リーク(WEBLOGIC.JDBC.CONN.LOCALTX_LEAK)
プロファイル情報レコード・ログの例
診断データへのアクセス
ドライバ・レベルの統計をモニタリングするためのコールバック(非推奨)
JDBCデータ・ソースのデバッグ
デバッグの有効化
コマンド行を使用したデバッグの有効化
WebLogic Server管理コンソールを使用してデバッグを有効化
WebLogic Scripting Toolを使用してデバッグを有効化
config.xmlファイルへの変更
JDBCのデバッグ範囲
UCP/ONSのデバッグの設定
UCPのデバッグ
ONSのデバッグ
リクエストのDye処理
19
WebLogic JDBCリソースの管理
データ・ソースおよびデータベース接続のテスト
データ・ソースの文キャッシュの管理
データ・ソースの文キャッシュのクリア
単一接続用の文キャッシュのクリア
接続プールの縮小
接続プールのリセット
接続プールの中断
接続プールの再開
データ・ソースの停止
データ・ソースの起動
DBMSネットワーク障害の管理
20
データ・ソース接続プールのチューニング
文キャッシュによるパフォーマンスの向上
文キャッシュのアルゴリズム
LRU(最近最も使用されていない)
固定
文キャッシュ・サイズ
文キャッシュに対する使用制限
格納済の文をデータベース変更後にコールした場合のエラー
プリコンパイルされた文でのsetNullの使用
キャッシュ内の文によるデータベース・カーソルの予約
文キャッシュを使用する際のその他の考慮事項
データ・ソースの接続テスト・オプション
データベース接続テストのセマンティクス
データベース接続の作成時における接続テスト
定期的な接続テスト
予約済の接続のテスト
データベース接続切断後の接続テスト遅延の最小化
DBMS接続の切断後の接続リクエスト遅延の最小化
アイドル・プール接続を信頼する秒数による接続リクエストの遅延の最小化
データベース接続テスト構成の推奨事項
デフォルトのテスト対象の表名を使用したデータベース接続テスト
データベース接続テストのオプション
接続作成の再試行の有効化
接続リクエストにおける接続待機の有効化
接続予約のタイムアウト
接続リクエスト待機数の制限
リークした接続の自動リカバリ
適切な接続数によるサーバーのロック回避
文タイムアウトによる文の処理時間の制限
スレッドに固定のプロパティの使用によるパフォーマンス向上
PinnedToThreadが有効になっている場合の接続プール管理操作の変更
PinnedToThreadが有効になっている場合のデータベース・リソースの追加コスト
アンラップされたデータ型オブジェクトの使用
ラップを無効にする方法
管理コンソールを使用したラップの無効化
WLSTを使用したラップの無効化
メンテナンス・タイマーのチューニング
A
Oracle 12cデータベースの使用
Oracle 12cデータベースに対するWebLogic JDBC機能
JDK 7に対するJDBC 4.1サポート
アプリケーション・コンティニュイティのサポート
データベース常駐接続プーリングのサポート
プラガブル・データベースを使用するコンテナ・データベース
Global Database Servicesのサポート
自動ONSリスナー
WebLogic Serverでの12Cデータベース機能サポートのサマリー
B
JDBCアプリケーション・モジュールのデプロイメントの構成
エンタープライズ・アプリケーションによるJDBCモジュールのパッケージ化: 主要手順
パッケージ化JDBCモジュールの作成
管理コンソールを使用したJDBCデータ・ソース・モジュールの作成
JDBCパッケージ化モジュールの要件
JDBCアプリケーション・モジュールの制限
汎用データ・ソース・モジュールの作成
Active GridLinkデータ・ソース・モジュールの作成
マルチ・データ・ソース・モジュールの作成
JDBCモジュールでのデータベース・パスワードの暗号化
JDBCモジュールの新規ドメインへのデプロイ
パッケージ化されたJDBCモジュールのアプリケーション・スコープ
Java EEディスクリプタ・ファイルでのJDBCモジュールの参照
weblogic-application.xml内のパッケージ化されたJDBCモジュール参照
その他のディスクリプタにおいてパッケージ化されたJDBCモジュール参照
JDBCモジュールによるエンタープライズ・アプリケーションのパッケージ化
JDBCモジュールによるエンタープライズ・アプリケーションのデプロイ
パッケージ化されたJDBCモジュールからのデータベース接続の取得
C
Oracle RACでのマルチ・データ・ソースの使用
Oracle Real Application Clustersの概要
WebLogic Serverマルチ・データ・ソースによるOracle RACのスケーラビリティ
WebLogic Serverマルチ・データ・ソースによるOracle RACの可用性
WebLogic Serverマルチ・データ・ソースによるOracle RACロード・バランシング
ソフトウェア要件
JDBCドライバ要件
ハードウェア要件
WebLogic Serverクラスタ
Oracle RACクラスタ
共有ストレージ
Oracle RACでのマルチ・データ・ソースの構成
Oracle RACで使用するマルチ・データ・ソース構成の選択
Oracle RACで使用するマルチ・データ・ソースの構成
マルチ・データ・ソースの属性
フェイルオーバーに関する構成の考慮事項
マルチ・データ・ソースで管理されるフェイルオーバーおよびロード・バランシング
フェイルオーバー時の遅延
グローバル・トランザクションに対する失敗処理の手順
Oracle RACインスタンス別のリスナー・プロセスの構成
リモート・リスナー有効時または無効時のマルチ・データ・ソースの構成
構成に関する追加の考慮事項
グローバル・トランザクションを使用したマルチ・データ・ソースの使用
グローバル・トランザクションを使用する場合のマルチ・データ・ソース内のデータ・ソースのルール
グローバル・トランザクションを使用する場合のマルチ・データ・ソース内のデータ・ソースの必須属性
構成コードのサンプル
グローバル・トランザクションを使用しないマルチ・データ・ソースの使用
グローバル・トランザクションを使用しない場合のマルチ・データ・ソース内のデータ・ソースの属性
構成コードのサンプル
Oracle RACノード上のサービスへの接続の構成
サービスに接続するようにデータ・ソースを構成
サービス接続の構成
ワークロード管理
ロード・バランシング
接続プールのキャパシティ・プランニング
マルチ・データ・ソースを使用したSCANアドレスの使用
Oracle RACでマルチ・データ・ソースを使用する際のXAの考慮事項と制限
マルチ・データ・ソースを使用する際のOracle RACのXA要件
マルチ・データ・ソースの使用
グローバル・トランザクションをOracle RACクラスタの同一インスタンスで開始、準備、完結させる必要性
トランザクションIDがOracle RACクラスタ内で一意であることの必要性
マルチ・データ・ソースでOracle RACを使用する際の既知の制限事項
一部の失敗シナリオにおけるデータのデッドロックの可能性
トランザクションが順序外で終了する可能性
データベース・サーバーのクラッシュ後に発生する既知の問題
Oracle RACによるJDBCストアのリカバリ
Oracle RACで使用するJDBCストアの構成
JMS接続に対する自動再試行
D
Oracle RACでの高速接続フェイルオーバーの使用
Oracle高速接続フェイルオーバーを使用する場合のJDBCドライバの構成
E
JDBCのスマート・アップグレードのサポート