7.3.3 接続情報の優先順位
(1) HADBサーバへの接続時に必要となる接続情報
HADBサーバへの接続時に必要となる接続情報を次に示します。
-
HADBサーバのホスト名
-
HADBサーバのポート番号
-
HADBサーバに接続する認可識別子とパスワード
-
AP識別子
-
各プロパティに指定できる上記以外の項目
これらの接続情報は,幾つかの方法で設定できます。例えば,HADBサーバのホスト名は,システムプロパティのadb_clt_rpc_srv_hostに指定する方法と,接続用のURLのhostに指定する方法があります。
このように接続情報が複数の方法で設定された場合の指定の優先順位を次の表に示します。
接続情報 |
設定方法 |
優先順位 |
|
---|---|---|---|
DM |
DS |
||
HADBサーバのホスト名 |
システムプロパティadb_clt_rpc_srv_hostの値 |
1 |
1 |
DriverManagerクラスのgetConnectionメソッドの引数infoに指定したadb_clt_rpc_srv_hostプロパティの値 |
2 |
− |
|
DriverManagerクラスのgetConnectionメソッドの引数urlに指定したhostの値 |
3 |
− |
|
接続情報設定および取得インタフェースのsetHostNameメソッドで設定したホスト名 |
− |
2 |
|
HADBサーバのポート番号 |
システムプロパティadb_clt_rpc_srv_portの値 |
1 |
1 |
DriverManagerクラスのgetConnectionメソッドの引数infoに指定したadb_clt_rpc_srv_portプロパティの値 |
2 |
− |
|
DriverManagerクラスのgetConnectionメソッドの引数urlに指定したportの値 |
3 |
− |
|
接続情報設定および取得インタフェースのsetPortメソッドで設定したポート番号 |
− |
2 |
|
接続時の認可識別子,パスワード |
次に示すどちらかの値
|
1 |
− |
DriverManagerクラスのgetConnectionメソッドの引数urlに指定したuserおよびpasswordの値 |
2 |
− |
|
次に示すどちらかの値
|
− |
1 |
|
|
− |
2 |
|
AP識別子 |
システムプロパティadb_clt_ap_nameの値 |
1 |
1 |
DriverManagerクラスのgetConnectionメソッドの引数infoに指定したadb_clt_ap_nameプロパティの値 |
2 |
− |
|
DriverManagerクラスのgetConnectionメソッドの引数urlに指定したadb_clt_ap_nameの値 |
3 |
− |
|
接続情報設定および取得インタフェースのsetApNameメソッドで設定したAP識別子 |
− |
2 |
|
HADBサーバへの接続処理のタイムアウト時間 |
システムプロパティadb_clt_rpc_con_wait_timeの値 |
1 |
1 |
DriverManagerクラスのgetConnectionメソッドの引数infoに指定したadb_clt_rpc_con_wait_timeの値 |
2 |
− |
|
DriverManagerクラスのgetConnectionメソッドの引数urlに指定したadb_clt_rpc_con_wait_timeの値 |
3 |
− |
|
DriverManagerクラスのsetLoginTimeoutメソッドで指定した値 |
4 |
− |
|
次に示すどちらかの値
|
− |
2 |
|
各プロパティに指定できる上記以外の項目(次の項目が該当)
|
システムプロパティに指定したプロパティの値 |
1 |
1 |
DriverManagerクラスのgetConnectionメソッドの引数infoに指定したプロパティの値 |
2 |
− |
|
DriverManagerクラスのgetConnectionメソッドの引数urlに指定したプロパティの値 |
3 |
− |
- (凡例)
-
DM:DriverManagerクラスを使用して接続した場合
DS:DataSourceクラスを使用して接続した場合
−:接続情報を指定できません。
- 注
-
優先順位の番号が小さいほど優先順位が高くなります。1と2では1の指定が優先されます。
(2) 各プロパティで指定できる接続情報の一覧
HADBサーバへの接続時に必要となる接続情報は,システムプロパティ,ユーザプロパティ,または接続用のURLのプロパティで指定できます。各プロパティで指定できる接続情報の一覧を次の表に示します。
項番 |
分類 |
プロパティ名 |
各プロパティでの指定可否 |
||
---|---|---|---|---|---|
システムプロパティ |
ユーザプロパティ |
接続用のURLのプロパティ |
|||
1 |
クライアント定義と同じ名称,同じ機能を持つプロパティ※1 |
adb_clt_rpc_srv_host |
○ |
○ |
△※2 |
2 |
adb_clt_rpc_srv_port |
○ |
○ |
△※3 |
|
3 |
adb_clt_rpc_con_wait_time |
○ |
○ |
○ |
|
4 |
adb_clt_rpc_sql_wait_time |
○ |
○ |
○ |
|
5 |
adb_clt_ap_name |
○ |
○ |
○ |
|
6 |
adb_clt_group_name |
○ |
○ |
○ |
|
7 |
adb_clt_fetch_size |
○ |
○ |
○ |
|
8 |
adb_dbbuff_wrktbl_clt_blk_num |
○ |
○ |
○ |
|
9 |
adb_sql_exe_max_rthd_num |
○ |
○ |
○ |
|
10 |
adb_sql_exe_hashgrp_area_size |
○ |
○ |
○ |
|
11 |
adb_sql_exe_hashtbl_area_size |
○ |
○ |
○ |
|
12 |
adb_sql_exe_hashflt_area_size |
○ |
○ |
○ |
|
13 |
adb_clt_sql_parallel_exec |
○ |
○ |
○ |
|
14 |
adb_sql_prep_delrsvd_use_srvdef |
○ |
○ |
○ |
|
15 |
adb_clt_trn_iso_lv |
○ |
○ |
○ |
|
16 |
adb_clt_trn_access_mode |
○ |
○ |
○ |
|
17 |
adb_clt_sql_text_out |
○ |
○ |
○ |
|
18 |
adb_clt_sql_order_mode |
○ |
○ |
○ |
|
19 |
adb_sql_prep_dec_div_rs_prior |
○ |
○ |
○ |
|
20 |
adb_clt_passwd_pubkey_path |
○ |
○ |
○ |
|
21 |
Exceptionトレースログに関するプロパティ |
adb_jdbc_exc_trc_out_path |
○ |
○ |
○ |
22 |
adb_jdbc_info_max |
○ |
○ |
○ |
|
23 |
adb_jdbc_cache_info_max |
○ |
○ |
○ |
|
24 |
adb_jdbc_trc_out_lv |
○ |
○ |
○ |
|
25 |
上記以外のプロパティ |
user |
× |
○ |
○ |
26 |
password |
× |
○ |
○ |
|
27 |
encodelang |
× |
○ |
○ |
|
28 |
methodtrace |
× |
○ |
○ |
|
29 |
tracenum |
× |
○ |
○ |
|
30 |
sqlwarningkeep |
× |
○ |
○ |
- (凡例)
-
○:指定できるプロパティ
△:指定できないプロパティではあるが,代替となる指定あり
×:指定できないプロパティ
- 注※1
-
これらのプロパティは,クライアント定義のオペランド名と同じプロパティ名であり,クライアント定義のオペランドと同じ機能を持っています。
- 注※2
-
接続用のURLのプロパティでは,接続先のHADBサーバのホスト名をadb_clt_rpc_srv_hostで指定できません。接続先のHADBサーバのホスト名は,接続用のURLのhostで指定します。
- 注※3
-
接続用のURLのプロパティでは,HADBサーバのポート番号をadb_clt_rpc_srv_portで指定できません。HADBサーバのポート番号は,接続用のURLのportで指定します。
- 重要
-
JDBCドライバを使用している場合,クライアント定義のオペランドの指定は適用されません。システムプロパティ,ユーザプロパティ,または接続用のURLのプロパティの指定が適用されます。
システムプロパティについては,「3.1.6 システムプロパティの設定」を参照してください。
ユーザプロパティについては,「7.3.1 DriverManagerクラスのgetConnectionメソッドでHADBサーバに接続する方法」の「(2) getConnectionメソッドによるHADBサーバへの接続」の「(d) 引数infoの指定内容(ユーザプロパティの指定)」を参照してください。
接続用のURLのプロパティについては,「7.3.1 DriverManagerクラスのgetConnectionメソッドでHADBサーバに接続する方法」の「(2) getConnectionメソッドによるHADBサーバへの接続」の「(a) 引数urlの指定内容(接続用のURLの指定)」を参照してください。