スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド

[目次][索引][前へ][次へ]

18.11 接続情報の優先順位

<この節の構成>
(1) 接続情報の優先順位一覧
(2) そのほかのクライアント環境定義の優先順位

(1) 接続情報の優先順位一覧

JDBCドライバでは,意味が同じ接続情報を複数の設定方法で指定できます(例:URL中に指定するDBHOSTと,HiRDBクライアント環境定義のPDHOST)。このような複数の設定方法を持つ接続情報と,同時に複数の設定方法で設定された場合の優先順位を次の表に示します。

表18-82 接続情報の優先順位

接続情報の意味 設定方法 優先順位
A B C
HiRDBのホスト名称 システムプロパティに設定したHiRDB_for_Java_PDHOST 1 1 1
DriverManager.getConnectionのProperties引数中のプロパティHiRDB_for_Java_DBHOST 2 − −
URL中のDBHOST 3 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_ENV_VARIABLESで指定したHiRDBクライアント環境定義のPDHOST 4 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_DBIDに指定したHiRDB環境変数グループ内のPDHOST 5 − −
URL中のDBIDに指定したHiRDB環境変数グループ内のPDHOST 6 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_HiRDB_INIに指定したHiRDB.iniファイル内のPDHOST 7 − −
URL中のHiRDB_INIに指定したHiRDB.iniファイル内のPDHOST 8 − −
DataSource系インタフェースのsetDBHostNameメソッド − 2 2
DataSource系インタフェースのsetEnvironmentVariablesメソッドで指定したHiRDBクライアント環境定義のPDHOST − 3 3
DataSource系インタフェースのsetDescriptionメソッドで指定したHiRDB環境変数グループ内のPDHOST − 4 −
XADataSource.setXAOpenStringで指定したHiRDB環境変数グループ内のPDHOST − − 4
DataSource系インタフェースのsetHiRDBINIメソッドで指定したHiRDB.iniファイル内のPDHOST − 5 5
HiRDBのポート番号 システムプロパティに設定したHiRDB_for_Java_ PDNAMEPORT 1 1 1
DriverManager.getConnectionのProperties引数中のプロパティHiRDB_for_Java_DBID 2 − −
URL中のDBID 3 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_ENV_VARIABLESで指定したHiRDBクライアント環境定義のPDNAMEPORT 4 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_DBIDに指定したHiRDB環境変数グループ内のPDNAMEPORT 5 − −
URL中のDBIDに指定したHiRDB環境変数グループ内のPDNAMEPORT 6 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_HiRDB_INIに指定したHiRDB.iniファイル内のPDNAMEPORT 7 − −
URL中のHiRDB_INIに指定したHiRDB.iniファイル内のPDNAMEPORT 8 − −
DataSource系インタフェースのsetDescriptionメソッド − 2 2
DataSource系インタフェースのsetEnvironmentVariablesメソッドで指定したHiRDBクライアント環境定義のPDNAMEPORT − 3 3
DataSource系インタフェースのsetDescriptionメソッドで指定したHiRDB環境変数グループ内のPDNAMEPORT − 4 −
XADataSource.setXAOpenStringで指定したHiRDB環境変数グループ内のPDNAMEPORT − − 4
DataSource系インタフェースのsetHiRDBINIメソッドで指定したHiRDB.iniファイル内のPDNAMEPORT − 5 5
接続時のユーザ名,パスワード※1 システムプロパティに設定したHiRDB_for_Java_PDUSER 1 1 1
DriverManager.getConnectionのuser引数及びpassword引数,又はProperties引数中のuser及びpassword 2 − −
URL中のUSER及びPASSWORD 3 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_ENV_VARIABLESで指定したHiRDBクライアント環境変数内のPDUSER 4 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_DBIDに指定したHiRDB環境変数グループ内のPDUSER 5 − −
URL中のDBIDに指定したHiRDB環境変数グループ内のPDUSER 6 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_HiRDB_INIに指定したHiRDB.iniファイル内のPDUSER 7 − −
URL中のHiRDB_INIに指定したHiRDB.iniファイル内のPDUSER 8 − −
DataSourceインタフェースのgetConnectionメソッドの引数,又はConnectionPoolDataSourceインタフェースのgetPooledConnectionメソッドの引数 − 2 −
XADataSourceインタフェースのgetXAConnectionメソッドの引数 − − 2
DataSource系インタフェースのsetUserメソッド及びsetPasswordメソッド − 3 3
DataSource系インタフェースのsetEnvironmentVariablesメソッドで指定したHiRDBクライアント環境変数内のPDUSER − 4 4
DataSource系インタフェースのsetDescriptionメソッドで指定したHiRDB環境変数グループ内のPDUSER − 5 −
XADataSource.setXAOpenStringで指定したHiRDB環境変数グループ内のPDUSER − − 5
DataSource系インタフェースのsetHiRDBINIメソッドで指定したHiRDB.iniファイル内のPDUSER − 6 6
UAP名称※2 システムプロパティに設定したHiRDB_for_Java_ PDCLTAPNAME 1 1 1
DriverManager.getConnectionのProperties引数中のプロパティUAPNAME 2 − −
URL中のUAPNAME 3    
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_ENV_VARIABLESで指定したHiRDBクライアント環境定義のPDCLTAPNAME 4 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_DBIDに指定したHiRDB環境変数グループ内のPDCLTAPNAME 5 − −
URL中のDBIDに指定したHiRDB環境変数グループ内のPDCLTAPNAME 6 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_HiRDB_INIに指定したHiRDB.iniファイル内のPDCLTAPNAME 7 − −
URL中のHiRDB_INIに指定したHiRDB.iniファイル内のPDCLTAPNAME 8 − −
DataSource系インタフェースのsetUapNameメソッド − 2 2
DataSource系インタフェースのsetEnvironmentVariablesメソッドで指定したHiRDBクライアント環境定義のPDCLTAPNAME − 3 3
DataSource系インタフェースのsetDescriptionメソッドで指定したHiRDB環境変数グループ内のPDCLTAPNAME − 4 −
XADataSource.setXAOpenStringで指定したHiRDB環境変数グループ内のPDCLTAPNAME − − 4
DataSource系インタフェースのsetHiRDBINIメソッドで指定したHiRDB.iniファイル内のPDCLTAPNAME − 5 5
変換文字セット DriverManager.getConnectionのProperties引数中のプロパティENCODELANG 1 − −
URL中のENCODELANG 2 − −
DataSource系インタフェースのsetEncodeLang − 1 1
カーソル動作モード DriverManager.getConnectionのProperties引数中のプロパティHIRDB_CURSOR 1 − −
URL中のHIRDB_CURSOR 2 − −
DataSource系インタフェースのsetHiRDBCursorMode − 1 1
ステートメントのコミット実行後の状態 システムプロパティに設定したHiRDB_for_Java_ DAB_STATEMENT_COMMIT_BEHAVIOR 1 1 1
DriverManager.getConnectionのProperties引数中のプロパティHiRDB_for_Java_STATEMENT_COMMIT_BEHAVIOR 2 − −
URL中のSTATEMENT_COMMIT_BEHAVIOR 3 − −
DataSource系インタフェースのsetStatementCommitBehavior − 2 2
ログイン待ち時間 システムプロパティに設定したHiRDB_for_Java_PDCONNECTWAITTIME 1 1 1
DriverManager.setLoginTimeout 2 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_ENV_VARIABLESで指定したHiRDBクライアント環境定義のPDCONNECTWAITTIME 3 − −
DriverManager.getConnectionのProperties引数中のDBIDに指定したHiRDB環境変数グループ内のPDCONNECTWAITTIME 4 − −
URL中のDBIDに指定したHiRDB環境変数グループ内のPDCONNECTWAITTIME 5 − −
DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_HiRDB_INIに指定したHiRDB.iniファイル内のPDCONNECTWAITTIME 6 − −
URL中のHiRDB_INIに指定したHiRDB.iniファイル内のPDCONNECTWAITTIME 7 − −
DataSource系インタフェースのsetLoginTimeout − 2 2
DataSource系インタフェースのsetEnvironmentVariablesメソッドで指定したHiRDBクライアント環境定義のPDCONNECTWAITTIME − 3 3
DataSource系インタフェースのsetDescriptionメソッドで指定したHiRDB環境変数グループ内のPDCONNECTWAITTIME − 4 −
XADataSource.setXAOpenStringで指定したHiRDB環境変数グループ内のPDCONNECTWAITTIME − − 4
DataSource系インタフェースのsetHiRDBINIメソッドで指定したHiRDB.iniファイル内のPDCONNECTWAITTIME − 5 5

(凡例)
A:DriverManagerを使用した接続の場合
B:DataSource系インタフェースを使用した非XA接続の場合
C:XADataSourceインタフェースを使用したXA接続の場合
−:接続方法によって指定できない

注※1
ユーザ名を指定してパスワードを指定していない場合,パスワード指定がないものとみなします。ユーザ名を指定しないでパスワードを指定した場合,パスワードの指定は無効になり,次に優先順位の高い指定が有効になります。

注※2
この表で示した設定方法で設定されない場合は,JDBCドライバの製品名称である「HiRDB_Type4_JDBC_Driver」が設定されたものとして動作します。

(2) そのほかのクライアント環境定義の優先順位

そのほかのHiRDBクライアント環境定義の優先順位を示します。

優先順位 クライアント環境変数
1 システムプロパティの指定
2 DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_ENV_VARIABLESで指定したHiRDBクライアント環境定義
3 DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_DBIDに指定したHiRDB環境変数グループファイル内のクライアント環境変数
4 DriverManager.getConnectionのURL中のDBIDに指定したHiRDB環境変数グループファイル内のクライアント環境定義
5 DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_HiRDB_INIに指定したディレクトリ下のHiRDB.iniファイルに指定されたHiRDBクライアント環境変数
6 DriverManager.getConnectionのURL中のHiRDB_INIに指定したディレクトリ下のHiRDB.iniファイルに指定されたHiRDBクライアント環境変数

注
  • DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_DBID及びURL中のDBIDにHiRDB環境変数グループファイルを指定した場合,URL中のDBIDの指定は無効となります。
  • DriverManager.getConnectionのProperties引数中のHiRDB_for_Java_HiRDB_INI及びURL中のHiRDB_INIを指定した場合,URL中のHiRDB_INIの指定は無効になります。