このトピックには以下のセクションが含まれています。
これらのプロパティー設定方式は、すべての接続が同じデータ・ソース用であり、アプリケーションのすべてのユーザーが同じ特権のセットを持っている場合にのみ使用します。
pdq.properties という名前のプレーン・テキスト・ファイルがクラスパス内にまだない場合は、作成してください。
プロパティーを設定する際には、次の例のようにプロパティーの前に接頭部 pdq を付けてください。
pdq.captureMode=ON pdq.executionMode=STATIC pdq.allowDynamicSQL=TRUE
db2.jcc.pdqProperties=""
Web アプリケーションを開発する場合、pdq.properties ファイルをご使用のアプリケーションの WEB-INF/classes フォルダー内に置くか、WEB-INF/lib フォルダーの JAR ファイル内に置いてください。
スタンドアロン・アプリケーションを開発する場合には、そのアプリケーションのクラスパス内にある任意のフォルダーまたは JAR ファイルに pdq.properties ファイルを配置してください。
.---------------------------------------. V | >>-java---- -Dpdq.--property--=--+-value-------+-+------------->< '-"--value--"-'
プロパティーに複数のストリング値を指定する場合は区切り文字として引用符を使用する必要があります。
db2.jcc.pdqProperties=""
DB2JccConfiguration.properties は、独立のファイルであっても、JAR ファイルに含まれていても構いません。
DB2JccConfiguration.properties ファイルが ISO 8859-1 (Latin-1) コード化スキームでエンコードされている場合、または一部の Unicode でエンコードされた (\udddd) 文字を含む Latin-1 コード化スキームでエンコードさされている場合は、事前に文字変換を行わなくても IBM DB2 Driver for JDBC and SQLJ がこのファイルを使用できます。DB2JccConfiguration.properties が他の何らかのコード化スキームでエンコードされている場合は、Java native2ascii コンバーターを使用して、内容を、Latin-1 または Unicode でエンコードされた文字に変換する必要があります。
DB2JccConfiguration.properties が独立したファイルである場合は、DB2JccConfiguration.properties のパスが CLASSPATH 連結に含まれていなければなりません。
DB2JccConfiguration.properties が JAR ファイル内にある場合は、JAR ファイルが CLASSPATH 連結に含まれていなければなりません。
SQL Outline のプロパティーの設定には次の構文を使用します。
.-,--------------------. V | >>-db2.jcc.pdqProperties--=----+-key----value-----+-+---------->< '-key--(--value--)-'
enableDynamicSQLReplacement プロパティーをこの方式で設定することはできません。
これらのプロパティーは、db2.jcc.propertiesFile Java システム・プロパティーで指定した名前のリソース・ファイル内で設定できます。
例えば、db2.jcc.propertiesFile 値の絶対パス名を指定できます。 独立した Java アプリケーションの場合、java コマンドの実行時に -Ddb2.jcc.propertiesFile=path オプションを指定することで構成プロパティーを設定できます。
.-,--------------------. V | >>-java -Ddb2.jcc.pdqProperties--=----+-key----value-----+-+--->< '-key--(--value--)-'
3つの方式とは、2 とおりです。
.-,--------------------. V | >>-jdbc--:--db2--:--subsystem--:--pdqProperties--=----+-key----value-----+-+->< '-key--(--value--)-'
java.util.Properties myPdqProperties = new java.util.Properties(); myPdqProperties.put("pdq.captureMode","ON");
DB2SimpleDataSource dbsrc = new DB2SimpleDataSource (); dbsrc.setServerName ("serv1.jke.com"); dbsrc.setDatabaseName ("STLEC1"); dbsrc.setPortNumber (446); dbsrc.setUser ("sysadm"); dbsrc.setPassword ("passw0rd"); dbsrc.setDriverType (4); dbsrc.setPdqProperties("captureMode(on),pureQueryXml(Sample22.xml),executionMode(DYNAMIC)"); Connection con = dbsrc.getConnection ();
pureQuery は、SQL Outline の実行時プロパティーの値を検索する際には、可能性のある場所を以下の順序で検索します。
pureQuery は、プロパティーの値を見つけると、他の場所でのそのプロパティーの値の検索を停止します。pureQuery がプロパティーの値を見つけられなかった場合は、そのプロパティーのデフォルト値を使用します。