Hitachi

Hitachi Advanced Data Binder AP開発ガイド


7.3.3 接続情報の優先順位

〈この項の構成〉

(1) HADBサーバへの接続時に必要となる接続情報

HADBサーバへの接続時に必要となる接続情報を次に示します。

これらの接続情報は,幾つかの方法で設定できます。例えば,HADBサーバのホスト名は,システムプロパティのadb_clt_rpc_srv_hostに指定する方法と,接続用のURLのhostに指定する方法があります。

このように接続情報が複数の方法で設定された場合の指定の優先順位を次の表に示します。

表7‒4 接続情報の指定の優先順位

接続情報

設定方法

優先順位

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

接続時の認可識別子,パスワード

次に示すどちらかの値

  • DriverManagerクラスのgetConnectionメソッドの引数userおよびpasswordの値

  • DriverManagerクラスのgetConnectionメソッドの引数infoに指定したuserおよびpasswordプロパティの値

1

DriverManagerクラスのgetConnectionメソッドの引数urlに指定したuserおよびpasswordの値

2

次に示すどちらかの値

  • DataSourceインタフェースのgetConnectionメソッドの引数usernameおよびpasswordに指定した値

  • ConnectionPoolDataSourceインタフェースのgetPooledConnectionメソッドの引数userおよびpasswordに指定した値

1

  • 接続情報設定および取得インタフェースのsetUserメソッドで設定した認可識別子

  • 接続情報設定および取得インタフェースのsetPasswordメソッドで設定したパスワード

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

次に示すどちらかの値

  • DataSourceインタフェースのsetLoginTimeoutメソッドで指定した値

  • ConnectionPoolDataSourceインタフェースのsetLoginTimeoutメソッドで指定した値

2

各プロパティに指定できる上記以外の項目(次の項目が該当)

  • adb_clt_rpc_sql_wait_time

  • adb_clt_group_name

  • adb_clt_fetch_size

  • adb_clt_sql_text_out

  • adb_clt_trn_iso_lv

  • adb_clt_sql_order_mode

  • adb_sql_prep_dec_div_rs_prior

  • adb_clt_trn_access_mode

  • adb_dbbuff_wrktbl_clt_blk_num

  • adb_sql_prep_delrsvd_use_srvdef

  • adb_sql_exe_max_rthd_num

  • adb_sql_exe_hashgrp_area_size

  • adb_sql_exe_hashtbl_area_size

  • adb_sql_exe_hashflt_area_size

  • adb_clt_sql_parallel_exec

  • adb_clt_passwd_pubkey_path

  • adb_jdbc_exc_trc_out_path

  • adb_jdbc_info_max

  • adb_jdbc_cache_info_max

  • adb_jdbc_trc_out_lv

システムプロパティに指定したプロパティの値

1

1

DriverManagerクラスのgetConnectionメソッドの引数infoに指定したプロパティの値

2

DriverManagerクラスのgetConnectionメソッドの引数urlに指定したプロパティの値

3

(凡例)

DM:DriverManagerクラスを使用して接続した場合

DS:DataSourceクラスを使用して接続した場合

−:接続情報を指定できません。

優先順位の番号が小さいほど優先順位が高くなります。1と2では1の指定が優先されます。

(2) 各プロパティで指定できる接続情報の一覧

HADBサーバへの接続時に必要となる接続情報は,システムプロパティ,ユーザプロパティ,または接続用のURLのプロパティで指定できます。各プロパティで指定できる接続情報の一覧を次の表に示します。

表7‒5 各プロパティで指定できる接続情報の一覧

項番

分類

プロパティ名

各プロパティでの指定可否

システムプロパティ

ユーザプロパティ

接続用の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の指定)」を参照してください。