目次

タイトルおよび著作権情報

はじめに

• ドキュメントのアクセシビリティについて
• 表記規則

1 概要とロードマップ

• ドキュメントの範囲および対象読者
• このドキュメントの手引き
• 関連ドキュメント
• JDBCサンプルとチュートリアル
  • Avitek医療記録アプリケーション(MedRec)とチュートリアル
  • WebLogic Serverディストリビューションに含まれるJDBCのサンプル
• このリリースにおけるJDBCデータ・ソースの新機能と変更された機能

2 WebLogic JDBCリソースの構成

• WebLogic ServerにおけるJDBCリソースの理解
• 構成されたJDBCリソースの所有権
• データ・ソース構成ファイル
  • JDBCシステム・モジュール
    • 汎用データ・ソース・モジュール
    • Active GridLinkデータ・ソースのシステム・モジュール
    • マルチ・データ・ソース・システム・モジュール
  • JDBCアプリケーション・モジュール
    • 標準のJava EEアプリケーション・モジュール
    • 独自のJDBCアプリケーション・モジュール
      • EAR/WARファイルへのドライバの追加
  • 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コードを使用したデータベース接続の初期化
• 詳細な接続プロパティ
  • 致命的エラー・コードの定義
  • エディションベースの再定義の使用
• Oracleパラメータの構成
• ONSクライアントの構成
• 汎用データ・ソース接続プールのチューニング
• Oracle RACの停止に対する汎用データ・ソースの処理
• ドライバ・レベル・フェイルオーバーの汎用データ・ソースの処理

4 デフォルト・データ・ソースの使用

• デフォルト・データ・ソースとは
• カスタム・デフォルト・データ・ソースの定義
• デフォルト・データ・ソースを使用する場合の互換性の制限

5 JDBCマルチ・データ・ソースの構成

• マルチ・データ・ソースの機能
  • データベース・ノードの削除
  • データベース・ノードの追加
• マルチ・データ・ソースの作成と構成
• マルチ・データ・ソース・アルゴリズムの選択
  • フェイルオーバー
  • ロード・バランシング
• マルチ・データ・ソースのフェイルオーバーの制限と要件
  • 予約時の接続テストによるフェイルオーバーの有効化
  • 使用中の接続に対するフェイルオーバーの実施不可能
• マルチ・データ・ソース・フェイルオーバー機能の拡張
  • 汎用データ・ソースの障害発生時における接続リクエストのルーティング機能の拡張
  • マルチ・データ・ソース内の障害が発生した汎用データ・ソースがリカバリした場合の自動的な再有効化
  • マルチ・データ・ソース内のビジー状態の汎用データ・ソースのフェイルオーバーの有効化
  • コールバックによるマルチ・データ・ソース・フェイルオーバーの制御
    • コールバック・ハンドラの要件
    • コールバック・ハンドラの構成
    • フェイルオーバーの仕組み
  • コールバックによるマルチ・データ・ソース・フェイルバックの制御
    • フェイルバックの仕組み
• サーバーおよびクラスタへのJDBCマルチ・データ・ソースのデプロイ
• マルチ・データ・ソースでの計画データベース・メンテナンス
  • データ・ソースの停止

6 Active GridLinkデータ・ソースの使用方法

• Active GridLinkデータ・ソースとは
  • 高速接続フェイルオーバー
  • 実行時接続ロード・バランシング
  • GridLinkアフィニティ
    • セッション・アフィニティ・ポリシー
    • XAアフィニティ・ポリシー
  • SCANアドレス
  • Oracleウォレットを使用したONSリスナーとのセキュアな通信
  • Active Data Guardのサポート
• Active GridLinkデータ・ソースの作成
  • JDBCデータ・ソースのプロパティ
    • データ・ソース名
    • データ・ソース・スコープ
    • JNDI名
    • ドライバの選択
  • トランザクション・オプションの構成
  • 接続プロパティの構成
    • 接続プロパティの入力
    • 完全なURLの入力
    • サポートされるAGLデータソースURL形式
  • 接続のテスト
  • ONSクライアント構成
    • FANイベントの有効化
    • ONSホストおよびポートの構成
    • セキュアなONSクライアント通信
  • ONSクライアント構成のテスト
  • データ・ソースのターゲット設定
• ソケット・ダイレクト・プロトコルの使用
  • SDPを使用したランタイム・ロード・バランシングの構成
• Active GridLink接続プール機能の構成
  • JDBCドライバ・レベルの機能の有効化
  • 接続ベースのシステム・プロパティの有効化
  • SQLコードを使用したデータベース接続の初期化
• Oracleパラメータの構成
• WLSTを使用したONSクライアントの構成
• Active GridLinkデータ・ソースの接続プールのチューニング
• Active GridLink JDBCリソースのモニタリング
  • 実行時統計の表示
    • JDBCOracleDataSourceRuntimeMBean
    • JDBCOracleDataSourceInstanceRuntimeMBean
    • ONSDaemonRuntimeMBean
  • Active GridLinkデータ・ソースのデバッグ
    • JDBCのデバッグ範囲
    • UCP JDKロギング
    • コマンド行を使用したデバッグの有効化
• FAN通知を使用しないActive GridLinkデータ・ソースの使用方法
  • ActiveGridlink属性の理解
• Active GridLinkデータ・ソースのベスト・プラクティス
  • 例外のキャッシュと処理
  • Active Gridlinkデータ・ソースによる接続の作成
• Active GridLinkとマルチ・データ・ソースの比較
• マルチ・データ・ソースからActive GridLinkへの移行
  • マルチ・データ・ソースからの移行に伴うアプリケーションの変更
  • マルチ・データ・ソースからの移行に伴う構成の変更
  • マルチ・データ・ソースからActive GridLinkデータ・ソースへの移行の基本ステップ
• Active GridLinkデータ・ソースでのデータベース停止時間の管理
  • データベースの停止に対応するActive GridLink構成
  • 計画停止の手順
  • 計画外停止
• 段階的排出

7 Proxyデータ・ソースの使用

• プロキシ・データ・ソースとは
• プロキシ・データ・ソースの作成
  • WebLogic Server管理コンソールでのプロキシ・データ・ソースの構成
  • WLSTを使用したプロキシ・データ・ソースの構成
• プロキシ・データ・ソースJDBCリソースのモニタリング

8 ユニバーサル接続プール・データ・ソースの使用

• ユニバーサル接続プール・データ・ソースとは
• ユニバーサル接続プール・データ・ソースの作成
  • WebLogic Server管理コンソールでのUCPデータ・ソースの構成
  • WLSTを使用したUCPデータ・ソースの構成
• UCP MT共有プールのサポート
• ユニバーサル接続プールJDBCリソースのモニタリング
• Oracle Shardingのサポート
• 接続プールの初期容量の拡張

9 接続収集の使用

• 接続収集とは
• 接続収集の有効化
• 接続を収集可能としてマーキング
• 収集した接続のリカバリ

10 共有プールのデータ・ソースの使用

• 共有プールの仕組み
• 共有プールのデータ・ソースを使用する場合の要件および考慮事項
• 共有プールの構成
  • 共有プール用のWebLogic Server固有のドライバ・プロパティの構成
  • 共有プール用のデータベース構成
  • 共有プールの構成用のWLSTスクリプトの例

11 Oracleドライバおよびデータベースの詳細な構成

• アプリケーション・コンティニュイティ
  • アプリケーション・コンティニュイティの機能
  • 要件および考慮事項
  • アプリケーション・コンティニュイティの構成
    • アプリケーション・コンティニュイティ対応ドライバの選択
    • 接続コールバックの使用方法
      • 初期化コールバックの作成
      • 初期化コールバックの登録
      • 初期化コールバックの登録解除
    • リプレイのタイムアウトの設定
    • 特定の接続に対するアプリケーション・コンティニュイティの無効化
    • アプリケーション・コンティニュイティのロギングの構成
    • JDBCドライバ・デバッグの有効化
  • アプリケーション・コンティニュイティの実行時統計の表示
  • アプリケーション・コンティニュイティの監査
  • Oracle 12cデータベースにおけるアプリケーション・コンティニュイティに関する制限
• データベース常駐接続プーリング
  • 要件および考慮事項
  • DRCPの構成
    • DRCP対応データ・ソースの構成
    • DRCP対応データベースの構成
• Global Database Services
  • 要件および考慮事項
  • GDS接続対応のGridLinkデータソースの作成
• プラガブル・データベースを使用するコンテナ・データベース
  • PDBアクセス対応サービスの作成
  • DRCPおよびCDB/PDB
  • JDBCを使用したPDBの設定
• サービスの切替え

12 WebLogic ServerでのOracle Databaseの使用

• Oracle Database 12.1に対するWebLogic JDBC機能
  • JDK 7に対するJDBC 4.1サポート
  • アプリケーション・コンティニュイティのサポート
  • データベース常駐接続プーリングのサポート
  • プラガブル・データベースを使用するコンテナ・データベース
  • Global Database Servicesのサポート
  • 自動ONSリスナー
• Oracle Database 12.2に対するWebLogic JDBC機能

13 接続のラベル付け

• 接続ラベリングとは
• ラベリング・コールバックの実装
• ラベリング・コールバックの作成
  • ラベリング・コールバックの例
• ラベリング・コールバックの登録
  • ラベリング・コールバックの削除
  • 接続ラベルの適用
• ラベル付けされた接続の予約
• 不一致ラベルのチェック
• 接続ラベルの削除
• 初期化および再初期化コストを使用した接続の選択
  • 初期化および再初期化コストを使用する場合の考慮事項
• パッケージ・アプリケーションによる接続ラべリングの使用
  • パッケージ・アプリケーションでラベル付けされた接続を使用する場合の考慮事項

14 JDBCデータ・ソース・トランザクション・オプション

• 非XA JDBCドライバでのグローバル・トランザクションのサポートの有効化
• 「ロギング・ラスト・リソース」トランザクション・オプションの理解
  • ロギング・ラスト・リソース最適化を使用する利点
  • ロギング・ラスト・リソース・トランザクション最適化の有効化
  • LLRデータ・ソースに関するプログラミング上の考慮事項と制限事項
  • LLRデータ・ソースに関する管理上の考慮事項と制限事項
• 2フェーズ・コミットのエミュレート・トランザクション・オプションの理解
  • 非XAドライバを使用して2フェーズ・コミットをエミュレートする際の制限およびリスク
    • ヒューリスティックな終了とデータの矛盾
    • 保留中のトランザクションを回復できない
    • 複数サーバー構成における非XAリソースのパフォーマンス低下の可能性
    • 複数の非XA登録
• 接続クローズ時のローカル・トランザクションの完了

15 データ・ソースのセキュリティの理解

• WebLogicデータ・ソース・セキュリティのオプションの概要
• WebLogicデータ・ソース・セキュリティのオプション
  • 資格証明マッピングとデータベース資格証明
  • 接続へのクライアント識別子の設定
  • Oracleプロキシ・セッション
  • IDベースの接続プール
• トランザクション内の接続
• WebLogicデータ・ソース・リソースのパーミッション
• データ・ソース・セキュリティの例
• 暗号化された接続プロパティの使用
  • 管理コンソールの使用時に接続プロパティを暗号化するためのベスト・プラクティス
  • 接続プロパティを暗号化するためのWLSTの例
    • WLSTを使用して、暗号化されたプロパティで既存のデータ・ソースを更新する方法
    • WLSTを使用して、暗号化されたプロパティを作成する方法
• データ・ソースおよびOracleドライバでのSSLと暗号化の使用
  • データ・ソースおよびOracleドライバでのSSLの使用
    • OracleウォレットでのSSLの使用
    • Active GridLink ONS over SSL
  • データ・ソースおよびOracleドライバでのデータ暗号化の使用

16 Oracleウォレットの作成および管理

• Oracleウォレットとは
• ウォレットを保持する場所
• 外部パスワード・ストアの作成方法
• ウォレットを使用するWebLogic Serverデータ・ソースの定義
  • ウォレット・ファイルのコピー
  • データ・ソース構成の更新
• DB接続文字列のかわりにTNS別名を使用

17 サーバーおよびクラスタへのデータ・ソースのデプロイ

• サーバーおよびクラスタへのデータ・ソースのデプロイ
• 無応答データベースが原因で発生するサーバー起動ハングアップの最小化

18 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を使用する場合の追加考慮事項

19 WebLogic ServerでのJDBCドライバの使用方法

• JDBCドライバのサポート
• WebLogic ServerとともにインストールされるJDBCドライバ
• WebLogic Serverとともにインストールされていないサード・パーティJDBCドライバの追加
• Oracle Thinドライバのグローバリゼーション・サポート
• デバッグ・モードでのOracle Thinドライバの使用方法

20 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処理

21 WebLogic JDBCリソースの管理

• データ・ソースおよびデータベース接続のテスト
• データ・ソースの文キャッシュの管理
  • データ・ソースの文キャッシュのクリア
  • 単一接続用の文キャッシュのクリア
• 接続プールの縮小
• 接続プールのリセット
• 接続プールの中断
• 接続プールの再開
• データ・ソースの停止
• データ・ソースの起動
• DBMSネットワーク障害の管理

22 データ・ソース接続プールのチューニング

• 文キャッシュによるパフォーマンスの向上
  • 文キャッシュのアルゴリズム
    • LRU(最近最も使用されていない)
    • 固定
  • 文キャッシュ・サイズ
  • 文キャッシュに対する使用制限
    • 格納済の文をデータベース変更後にコールした場合のエラー
    • プリコンパイルされた文でのsetNullの使用
    • キャッシュ内の文によるデータベース・カーソルの予約
    • 文キャッシュを使用する際のその他の考慮事項
• データ・ソースの接続テスト・オプション
  • データベース接続テストのセマンティクス
    • データベース接続の作成時における接続テスト
    • 定期的な接続テスト
    • 予約済の接続のテスト
    • データベース接続切断後の接続テスト遅延の最小化
    • DBMS接続の切断後の接続リクエスト遅延の最小化
    • アイドル・プール接続を信頼する秒数による接続リクエストの遅延の最小化
  • データベース接続テスト構成の推奨事項
  • デフォルトのテスト対象の表名を使用したデータベース接続テスト
  • データベース接続テストのオプション
• 接続作成の再試行の有効化
• 接続リクエストにおける接続待機の有効化
  • 接続予約のタイムアウト
  • 接続リクエスト待機数の制限
• リークした接続の自動リカバリ
• 適切な接続数によるサーバーのロック回避
• 文タイムアウトによる文の処理時間の制限
• スレッドに固定のプロパティの使用によるパフォーマンス向上
  • PinnedToThreadが有効になっている場合の接続プール管理操作の変更
  • PinnedToThreadが有効になっている場合のデータベース・リソースの追加コスト
• アンラップされたデータ型オブジェクトの使用
  • ラップを無効にする方法
    • 管理コンソールを使用したラップの無効化
    • WLSTを使用したラップの無効化
• メンテナンス・タイマーのチューニング

A JDBCアプリケーション・モジュールのデプロイメントの構成

• エンタープライズ・アプリケーションによるJDBCモジュールのパッケージ化: 主要ステップ
• パッケージ化JDBCモジュールの作成
  • 管理コンソールを使用したJDBCデータ・ソース・モジュールの作成
  • JDBCパッケージ化モジュールの要件
  • JDBCアプリケーション・モジュールの制限
  • 汎用データ・ソース・モジュールの作成
  • Active GridLinkデータ・ソース・モジュールの作成
  • マルチ・データ・ソース・モジュールの作成
  • JDBCモジュールでのデータベース・パスワードの暗号化
    • JDBCモジュールの新規ドメインへのデプロイ
  • パッケージ化されたJDBCモジュールのアプリケーション・スコープ
• Java EEディスクリプタ・ファイルでのJDBCモジュールの参照
  • weblogic-application.xml内のパッケージ化されたJDBCモジュール参照
  • その他のディスクリプタにおいてパッケージ化されたJDBCモジュール参照
• JDBCモジュールによるエンタープライズ・アプリケーションのパッケージ化
• JDBCモジュールによるエンタープライズ・アプリケーションのデプロイ
• パッケージ化されたJDBCモジュールからのデータベース接続の取得

B Oracle RACでのマルチ・データ・ソースの使用

• Oracle RACの概要
  • 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接続に対する自動再試行

C Oracle RACでの高速接続フェイルオーバーの使用

• Oracle高速接続フェイルオーバーを使用する場合のJDBCドライバの構成