Oracle® Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理の構成と管理 11gリリース1 (10.3.6) B60997-10 |
|
前 |
次 |
この章では、WebLogic JDBCリソースの概要、構成方法およびWebLogicドメインへの適用方法について説明します。
WebLogic Serverでは、JDBCデータ・ソースとマルチ・データ・ソースを構成してから、WebLogicドメイン内のサーバーまたはクラスタにJDBCリソースをターゲット指定またはデプロイすることで、データベース接続を構成できます。
構成対象の各データ・ソースにはデータベース接続のプールが含まれます。データベース接続は、データ・ソース・インスタンスの作成時(デプロイ時またはターゲット指定時)に作成されるか、サーバー起動時に作成されます。アプリケーションは、オブジェクトをどのように構成およびデプロイするかに応じて、JNDIツリー上のデータ・ソースまたはローカル・アプリケーション・コンテキスト(java:comp/env
)内のデータ・ソースをルックアップし、その後データベース接続をリクエストします。接続の使用後に、アプリケーションは、connection.close()
を呼び出します。これにより、データ・ソースの接続プールに接続が戻されます。WebLogic Serverのデータ・ソースの詳細は、JDBCデータ・ソースの構成に関する項およびGridLinkデータ・ソースの使用に関する項を参照してください。
マルチ・データ・ソースはデータ・ソースの選択されたリストを抽象化したものであり、マルチ・データ・ソースに関連付けられているデータ・ソース間でロード・バランシングやフェイルオーバー処理を提供します。マルチ・データ・ソースは、データ・ソースがJNDIツリーにバインドされるのと同じように、JNDIツリーまたはローカル・アプリケーション・コンテキストにバインドされます。アプリケーションは、データ・ソースの場合と同じようにJNDIツリー上のマルチ・データ・ソースまたはローカル・アプリケーション・コンテキスト(java:comp/env
)内のマルチ・データ・ソースをルックアップし、その後データベース接続をリクエストします。マルチ・データ・ソースは、そのマルチ・データ・ソースの構成内で選択されるアルゴリズムに応じて、リクエストを満たすためにロード・バランシングとフェイルオーバーのうちどちらのデータ・ソースを使用するかを決定します。マルチ・データ・ソースの詳細は、「JDBCマルチ・データ・ソースの構成」を参照してください。
WebLogic JDBCデータ・ソースの構成および管理を理解する上で重要なのは、JDBCリソースの作成者またはJDBCリソースの作成方法によって、リソースがどのようにデプロイおよび変更されるかが決まる、ということです。WebLogic管理者とプログラマのどちらでもJDBCリソースを作成できます。
WebLogic管理者は通常、管理コンソールまたはWebLogic Scripting Tool (WLST)を使用して、JDBCモジュールの作成およびデプロイ(ターゲット)を行います。これらのJDBCモジュールは、システム・モジュールと見なされます。詳細は、「JDBCシステム・モジュール」を参照してください。
プログラマは、XML記述子ファイルの作成をサポートする開発ツールでモジュールを作成し、次にJDBCモジュールをアプリケーションと一緒にパッケージ化して、そのアプリケーションをWebLogic管理者へデプロイ用に渡します。これらのJDBCモジュールは、アプリケーション・モジュールと見なされます。詳細は、「JDBCアプリケーション・モジュール」を参照してください。
表2-1は、JDBCのモジュール・タイプと、それらの構成および変更方法を示しています。
WebLogic JDBCデータ・ソースの構成は、jdbc-data-source.xsd
スキーマ(http://xmlns.oracle.com/weblogic/jdbc-data-source/1.2/jdbc-data-source.xsd
で入手可能)に準拠するXMLドキュメントに格納されます。
JDBCリソースは、システム・モジュールとして、またはアプリケーション・モジュールとして、作成および管理されます。JDBCアプリケーション・モジュールは、Java EEモジュールのWebLogic固有の拡張機能であり、Java EEアプリケーションに含めて構成するか、スタンドアロンのモジュールとして構成できます。
JDBCシステム・モジュールとJDBCアプリケーション・モジュールのどちらを使用しているかに関係なく、各JDBCデータ・ソースまたはマルチ・データ・ソースは、XMLファイル(モジュール)によって表現されます。
JDBCリソース(データ・ソースまたはマルチ・データ・ソース)を、管理コンソールまたはWebLogic Scripting Tool (WLST)を使用して作成すると、WebLogic Serverはドメイン・ディレクトリのサブディレクトリconfig/jdbc
にJDBCモジュールを作成し、ドメインのconfig.xml
ファイルにモジュールへの参照を追加します。JDBCモジュールは、jdbc-data-source.xsd
スキーマ(http://xmlns.oracle.com/weblogic/jdbc-data-source/1.2/jdbc-data-source.xsd
で入手可能)に準拠します。
このようにして構成されるJDBCデータ・ソースは、システム・モジュールと見なされます。システム・モジュールは管理者の所有になります。管理者はいつでも、リソースの削除や修正、同様のリソースの追加を行うことができます。システム・モジュールは、ドメインに構成されたサーバーおよびクラスタのターゲット指定に対して全面的に利用できます。つまり、同じターゲットにデプロイされているすべてのアプリケーションおよびクライアント・アプリケーションで利用できます。システム・モジュールはまた、JDBCSystemResourceMBeans
としてJMXからアクセスすることもできます。
データ・ソース・システム・モジュールは、JDBCSystemResource
要素として、ドメインのconfig.xml
ファイルに含まれています。これには、JDBCモジュール・ファイルの名前と、モジュールのデプロイ先であるターゲット・サーバーおよびクラスタのリストが含まれます。図2-1に、config.xml
ファイル内のデータ・ソース・リストと、そのマップ先となるモジュールの例を示します。
この図では、config.xml
ファイルにexamples-demo
データ・ソースがjdbc-system-resource
要素としてリストされています。これはdomain
\config\jdbc
フォルダ内のexamples-demo-jdbc.xml
モジュールにマップされます。
同様に、マルチ・データ・ソース・システム・モジュールは、jdbc-system-resource
要素として、ドメインのconfig.xml
ファイルに含まれています。マルチ・データ・ソース・モジュールには、マルチ・データ・ソースによって使用されるデータ・ソース・モジュールにマップされるdata-source-list
パラメータが含まれます。config.xml
には、個々のデータ・ソース・モジュールも含まれています。図2-2に、config.xml
ファイル内の要素と、config/jdbc
ディレクトリ内のシステム・モジュールの関係を示します。
図2-2 config.xmlからマルチ・データ・ソースおよびデータ・ソース・システム・モジュールへの参照
この図では、config.xml
ファイル内に、3つのJDBCモジュールがリストされています。1つのマルチ・データ・ソースと、そのマルチ・データ・ソースによって使用される2つのデータ・ソースです。この2つのデータ・ソースも、マルチ・データ・ソース・モジュール内にリストされています。アプリケーションは、これらのモジュールのうち任意のものをJNDIツリー上でルックアップして、データベース接続をリクエストできます。マルチ・データ・ソースをルックアップした場合、そのマルチ・データ・ソースは、data-source-list
パラメータ内のデータ・ソース、データ・ソースのリスト順、およびalgorithm-type
パラメータで指定されているアルゴリズムに応じて、データベース接続の供給に使用する他のデータ・ソースをどれにするかを決定します。マルチ・データ・ソースの詳細は、「JDBCマルチ・データ・ソースの構成」を参照してください。
JDBCリソースは、標準のJava EEモジュールと同様に、アプリケーション・モジュールとしても管理できます。JDBCアプリケーション・モジュールとは、単なるjdbc-data-source.xsd
スキーマ(http://xmlns.oracle.com/weblogic/jdbc-data-source/1.2/jdbc-data-source.xsd
で入手可能)に準拠するXMLファイルであり、データ・ソースを表します。
JDBCモジュールは、パッケージ化されたモジュールとして、エンタープライズ・アプリケーションの一部として含めることができます。パッケージ化されたモジュールは、EARまたは展開されたEARディレクトリにバンドルされ、すべての適切なデプロイメント記述子(weblogic-application.xml
やejb-jar.xml
デプロイメント記述子など)内で参照されます。JDBCモジュールはエンタープライズ・アプリケーションと一緒にデプロイされ、同梱されたアプリケーションのみ、またはすべてのアプリケーションで利用できるように構成できます。パッケージ化したモジュールを使用することにより、アプリケーションは必要なリソースに常にアクセスでき、アプリケーションを新しい環境に移動する処理が簡素化されます。パッケージ化されたJDBCモジュールを使用すると、EARファイルを開いたり、データ・ソースの手動による膨大な再構成を行ったりすることなく、アプリケーションと必要なJDBC構成を、ある環境から別の環境に(たとえば、テスト環境から本番環境に)移行できます。
システム・リソース・モジュールとは対照的に、アプリケーションとパッケージ化されたJDBCモジュールは、そのモジュールを作成およびパッケージ化した開発者が所有者になります。モジュールをデプロイする管理者ではありません。つまり、パッケージ化されたモジュールの場合、管理者の制御が及ぶ範囲が、一段と制限されることになります。リソース・モジュールをデプロイするときに、管理者はモジュールで指定されていたリソース・プロパティを変更できますが、モジュールの追加や削除はできません。(他のJava EEモジュールのように、リソース・モジュールのデプロイメント構成の変更はモジュールのデプロイメント・プランに格納され、元のモジュール自体は変更されません。)
定義により、パッケージ化されたJDBCモジュールは、エンタープライズ・アプリケーションに含まれているため、エンタープライズ・アプリケーションのデプロイ時にデプロイされます。パッケージ化したJDBCモジュールを使用したアプリケーションのデプロイの詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。
JDBCアプリケーション・モジュールは、weblogic.Deployer
ユーティリティまたは管理コンソールを使用してスタンドアロンのリソースとしてもデプロイできます。その場合、リソースは通常、デプロイメント・プロセスにおいてターゲット指定されたサーバーまたはクラスタで使用できます。このようにしてデプロイされたJDBCリソースはスタンドアロン・モジュールと呼ばれ、管理コンソールまたはJSR-88対応のツールを使用して再構成できますが、JMXやWLSTを介しては使用できません。
スタンドアロンJDBCモジュールを使用すると、JDBCリソースの共有と移植が容易になります。データ・ソース構成を作成し、他の開発者に配布できます。スタンドアロンJDBCモジュールを使用して、開発ドメインとステージング・ドメインの間など、ドメイン間でデータ・ソース構成の移動もできます。
注意: JDBCモジュールをスタンドアロン・モジュールとしてデプロイする場合、マルチ・データ・ソースのデプロイメント順序は、そのメンバーのデータ・ソースのデプロイ順序より大きい数値でなければなりません。 |
JDBCアプリケーション・モジュールの構成の詳細は、JDBCアプリケーション・モジュールのデプロイメントの構成を参照してください。
スタンドアロンJDBCモジュールのデプロイの詳細は、『Oracle WebLogic Serverへのアプリケーションのデプロイ』のJDBC、JMS、およびWLDFアプリケーション・モジュールのデプロイに関する項を参照してください。
WebLogic Server 10.3.6以上のリリースでは、アプリケーション・スコープのデータ・ソースを含むEAR/WARファイルのAPP-INF/lib
ディレクトリにデータベース・ドライバを追加できます。これにより、アプリケーションに必要なデータ・ソースとドライバの両方を含む自己包含型EAR/WARファイルをデプロイできます。
注意: ドライバの場所を追加するためにマニフェスト・ファイルの |
EARには独自のクラスローダーがあり、ネストされた全アプリケーション間で使用できるように共有されます。ドライバ・バージョンが異なる、複数のEAR/WARファイルをデプロイできます。ただし、システムのclasspath
内に古いバージョンのドライバがある場合は、web.xml
ファイル内でPREFER-WEB-INF-CLASSES=true
を設定して、アプリケーションとともにパッケージ化されたドライバ・クラスを使用できるようにします。
WebLogic JDBCモジュール・ファイルはすべて、examples-demo-jdbc.xml
のように、末尾に接尾辞-jdbc.xmlを付ける必要があります。WebLogic Serverは、モジュールのデプロイ時にファイル名をチェックします。ファイル名の末尾が-jdbc.xml
でないとデプロイメントは失敗し、サーバーは起動しません。
本番再デプロイメント(バージョニング)を使用して、パッケージ化されたJDBCモジュールを含むアプリケーションの、あるバージョンをデプロイする場合、WebLogic Serverは次の形式で、JDBCモジュールにおいて定義されたデータ・ソースを識別します。
application_id#version_id@module_name@data_source_name
この名前はデータ・ソース・ランタイムMBeanに使用されます。また、WebLogic Serverトランザクション・マネージャにデータ・ソース・インスタンスを登録するためにも使用されます。
リタイア中のバージョンのアプリケーションにおいてトランザクションがタイムアウトし、その後そのバージョンのアプリケーションがアンデプロイされると、リタイアされたバージョンのアプリケーションにおけるデータ・ソース上の保留中または未完了のトランザクションを手動で解決することが必要になる場合があります。データ・ソースが(この場合には、リタイアされたバージョンのアプリケーションとともに)アンデプロイされると、WebLogic Serverトランザクション・マネージャは、保留中または未完了のトランザクションをリカバリできなくなります。
本番再デプロイメントの詳細は、次を参照してください。
『Oracle WebLogic Serverアプリケーションの開発』の本番再デプロイメント用アプリケーションの開発に関する項
『Oracle WebLogic Serverへのアプリケーションのデプロイ』の本番再デプロイメントを使用したアプリケーションの更新に関する項
WebLogic ServerでJDBCリソースのモジュール式デプロイメント・モデルをサポートするために、WebLogic JDBCオブジェクト用のスキーマweblogic-jdbc.xsd
が用意されています。JDBCリソース・モジュール(記述子)を作成する場合は、モジュールをこのスキーマに準拠させる必要があります。IDEなどのツールは、このスキーマを基にJDBCリソース・モジュールを検証できます。
このスキーマはhttp://xmlns.oracle.com/weblogic/jdbc-data-source/1.2/jdbc-data-source.xsd
で取得できます。
注意: アプリケーション・スコープのパッケージ化されたデータ・ソースの場合、スキーマの
これらのデータ・ソース・タイプには、データ・ソースのスコープを指定するアプリケーションや、関連付けられたモジュールはありません。WebLogic Serverでは、 |
管理コンソールまたはWLSTを使用してJDBCリソースを作成すると、WebLogic Serverに各リソースのMBean(マネージドBean)が作成されます。その後、JMXまたはWebLogic Scripting Tool (WLST)を使用してMBeanにアクセスできます。詳細は、『Oracle WebLogic Server JMXによるカスタム管理ユーティリティの開発』および『Oracle WebLogic Scripting Tool』を参照してください。
図2-3は、WebLogicドメイン内のJDBCオブジェクトに対するMBeanの階層を示しています。
JDBCSystemResourceMBean
は、データ・ソース・モジュールから作成されたJavaBeansのコンテナです。ただし、JMXのJDBCデータ・ソースへのアクセスは、すべてJDBCSystemResourceMBean
を使用して行われます。データ・ソース・モジュールから作成された個々のJavaBeansに直接アクセスすることはできません。
WebLogic Server JDBCはJava EE管理モデルを定義するJSR-77をサポートしています。Java EE管理モデルは、Java EE Webアプリケーション・サーバーとそのリソースの実行時状態をモニタリングするために使用されます。Java EE管理モデルにアクセスして、WebLogic JDBCシステム全体、メモリーにロードされたJDBCドライバ、JDBCデータ・ソースなどのリソースをモニターできます。
仕様に準拠するために、WebLogic JDBCサブシステムには次の実行時MBeanタイプが追加されています。
JDBCServiceRuntimeMBean
- JDBCサブシステムを表し、現在システムで使用可能なJDBCDriverRuntimeMBeans
およびJDBCDataSourceRuntimeMBeans
のリストにアクセスするためのメソッドを提供します。
JDBCDriverRuntimeMBean
- サーバーがメモリーにロードしたJDBCドライバを表します。
JDBCDataSourceRuntimeMBeans
- サーバーまたはクラスタにデプロイされたJDBCデータ・ソースを表します。
注意: WebLogic JDBCランタイムMBeanは、JSR-77で指定されている任意の統計プロバイダを実装していません。 |
WebLogic ServerでのJava EE管理モデルの使用については、『Oracle WebLogic Server Java EE管理APIの監視および管理』を参照してください。
WLSTを使用してJDBCリソースを作成するには、次の基本タスクを実行する必要があります。
編集セッションを開始します。
JDBCシステム・リソース(プール、データ・ソース、マルチ・データ・ソース、JDBCドライバなど)を含むJDBCシステム・モジュールを作成します。
JDBCシステム・モジュールをターゲット指定します。
例2-1 JDBCリソースを作成するWLSTスクリプト
#---------------------------------------------------------------------- # Create JDBC Resources #---------------------------------------------------------------------- import sys from java.lang import System print "@@@ Starting the script ..." global props url = sys.argv[1] usr = sys.argv[2] password = sys.argv[3] connect(usr,password, url) edit() startEdit() servermb=getMBean("Servers/examplesServer") if servermb is None: print '@@@ No server MBean found' else: def addJDBC(prefix): print("") print("*** Creating JDBC resources with property prefix " + prefix) # Create the Connection Pool. The system resource will have # generated name of <PoolName>+"-jdbc" myResourceName = props.getProperty(prefix+"PoolName") print("Here is the Resource Name: " + myResourceName) jdbcSystemResource = wl.create(myResourceName,"JDBCSystemResource") myFile = jdbcSystemResource.getDescriptorFileName() print ("HERE IS THE JDBC FILE NAME: " + myFile) jdbcResource = jdbcSystemResource.getJDBCResource() jdbcResource.setName(props.getProperty(prefix+"PoolName")) # Create the DataSource Params dpBean = jdbcResource.getJDBCDataSourceParams() myName=props.getProperty(prefix+"JNDIName") dpBean.setJNDINames([myName]) # Create the Driver Params drBean = jdbcResource.getJDBCDriverParams() drBean.setPassword(props.getProperty(prefix+"Password")) drBean.setUrl(props.getProperty(prefix+"URLName")) drBean.setDriverName(props.getProperty(prefix+"DriverName")) propBean = drBean.getProperties() driverProps = Properties() driverProps.setProperty("user",props.getProperty(prefix+"UserName")) e = driverProps.propertyNames() while e.hasMoreElements() : propName = e.nextElement() myBean = propBean.createProperty(propName) myBean.setValue(driverProps.getProperty(propName)) # Create the ConnectionPool Params ppBean = jdbcResource.getJDBCConnectionPoolParams() ppBean.setInitialCapacity(int(props.getProperty(prefix+"InitialCapacity"))) ppBean.setMaxCapacity(int(props.getProperty(prefix+"MaxCapacity"))) if not props.getProperty(prefix+"ShrinkPeriodMinutes") == None: ppBean.setShrinkFrequencySeconds(int(props.getProperty(prefix+"ShrinkPeriodMinutes"))) if not props.getProperty(prefix+"TestTableName") == None: ppBean.setTestTableName(props.getProperty(prefix+"TestTableName")) if not props.getProperty(prefix+"LoginDelaySeconds") == None: ppBean.setLoginDelaySeconds(int(props.getProperty(prefix+"LoginDelaySeconds"))) # Adding KeepXaConnTillTxComplete to help with in-doubt transactions. xaParams = jdbcResource.getJDBCXAParams() xaParams.setKeepXaConnTillTxComplete(1) # Add Target jdbcSystemResource.addTarget(wl.getMBean("/Servers/examplesServer")) . . .
MBeanから使用できる適切なメソッドを使用すると、JDBCオブジェクトや属性を変更およびモニターできます。
JDBCオブジェクトや属性を変更する場合は、set、target、untargetおよびdeleteメソッドを使用します。
JDBCランタイム・オブジェクトをモニターするには、getメソッドを使用します。
詳細は、『Oracle WebLogic Scripting Tool』のMBeanのナビゲート(WLSTオンライン)に関する項を参照してください。
この項では、WLSTを使用してJDBCリソースを構成する場合のベスト・プラクティスについて説明します。
MBeanオブジェクトを操作する前に、Null MBeanオブジェクト(プール、データ・ソース、ドライバなど)をトラップします。
WLSTをオフラインで使用する場合、管理オブジェクト名で次の文字は無効です: ピリオド(.)、スラッシュ(/)またはバックスラッシュ(\)。『Oracle WebLogic Scripting Tool』のWLSTコマンドの構文に関する項を参照してください。
管理コンソールを使用してJDBCリソース(汎用データ・ソース、マルチ・データ・ソースまたはGridLinkデータ・ソース)をターゲットに指定したり、クラスタ・メンバーにデプロイして、JDBCリソースの可用性やリソース間通信のロード・バランシングを向上させることができます。ただし、なんらかの理由でクラスタ・メンバーが使用できなくなった場合、接続はフェイルオーバーを行いません。新しい接続は、使用可能なクラスタ・メンバーで必要になった場合に作成されます。「サーバーおよびクラスタへのデータ・ソースのデプロイ」を参照してください。
注意: マルチ・データ・ソースで使用できるのは、同じクラスタ・メンバー(同じJVMの)にデプロイされている汎用データ・ソースのみです。 |