symjddefdsコマンドを使用することで、GUIを表示しないで、JDBCデータソースを登録することができます。
symjddefdsコマンドでは、JDBCデータソース定義ファイルの内容を参照して、JDBCデータソースを登録します。
symjddefdsコマンドを使用した、JDBCデータソース登録の概要について説明します。
参照
symjddefdsコマンドの詳細については、“コマンドリファレンス”を参照してください。
JDBCデータソース定義ファイルとは、symjddefdsコマンドを使用してJDBCデータソースを定義する際に使用する、任意のファイルです。接続先情報や、オプションを記入します。
jdbc:symford://myhost:2050/COMPANY;user=USER1;password=PASS1
(1) (2)(1) 接続先情報
(2) オプション
接続先情報の指定方法は、“5.2.4.2 接続先情報の設定”を参照してください。
オプションの指定方法は、“5.2.4.3 オプションの設定”を参照してください。
JDBCデータソース定義ファイルで、JDBCデータソースの接続先を特定します。
指定方法は、データベースへの接続方法によって異なります。
記述形式
jdbc:symfold:///[<db_sys>.]<db_env>[;<options>]
jdbc:symford://<host>:<port_no>/<db_env>[;<options>]
jdbc:symforda://<host>:<port_no>/<db_env>[;<options>]
接続するサーバの18バイト以内のホスト名またはIPアドレスを指定します。
省略することはできません。
Symfoware/RDBまたはRDA-SVのポート番号を指定します。
ポート番号については、システム管理者に確認してください。
省略することはできません。
RDBシステム名を指定します。
このパラメタは、Symfoware/RDBにRDBシステム名を付けて運用する場合にだけ指定します。
RDBシステム名については、システム管理者に確認してください。
省略した場合は、システム名なしになります。
データ資源名を指定します。
データ資源名については、システム管理者に確認してください。
省略することはできません。
JDBCドライバのオプションを以下の形式で指定します。
オプション名 = 指定する値
指定可能なオプションについては、“5.2.4.3 オプションの設定”を参照してください。
オプションは以下のような形式で複数指定することができます。
例
user=UID;password=PWD
記述例
jdbc:symfold:///COMPANY
jdbc:symford://myhost:2050/COMPANY;user=UID;password=PWD
jdbc:symforda://myhost:2002/COMPANY;schema=GENERAL
注意
1つのJDBCデータソース定義ファイルに、複数の接続先情報は指定できません。接続先情報の違うJDBCデータソースを作成する場合は、JDBCデータソース定義ファイルを複数作成してください。
JDBCドライバで指定可能なオプションは、以下のとおりです。
ステートメントキャッシュ機能の利用時に、PreparedStatementオブジェクトおよびCallableStatementオブジェクトのクローズをJDBCドライバが自動的に行うかどうかを指定します。
autoclosestatement={YES|NO}
autoclosestatement=NO
YES：ステートメントキャッシュ機能利用時に、PreparedStatementオブジェクトやCallableStatementオブジェクトを自動でクローズします。
NO ：自動クローズは行いません。
注意
このオプションは、ステートメントキャッシュ数に1～32000が指定された場合に指定可能です。
実行した文の数が、オプションstatementcacheで設定されたキャッシュ数に達した場合、以降実行される文はキャッシュしませんが、自動クローズの対象にもなりません。
autoclosestatementオプションは、ローカルアクセスまたはリモートアクセス(RDB2_TCP連携)時に指定可能です。
サーバから1回で読み込むデータの最大長を指定します。
単位はキロバイトです。
buffersize=データ最大長
buffersize=4
データ最大長：サーバから1回で読み込むデータの最大長を、4～32で指定します。
注意
buffersizeオプションは、リモートアクセス(RDA-SV連携)時に指定可能です。
クライアントで使用する文字コードを指定します。
codeconversion={ASCII|KANA|EIJIS}
codeconversion=ASCII
注意
codeconversionオプションは、リモートアクセス(RDA-SV連携)時に指定可能です。
ctuneparamオプションには、Symfoware Serverのクライアント用の動作環境ファイルに相当する指定をすることができます。詳細は、“5.2.3.4 ctuneparamオプションについて”を参照してください。
ctuneparam=パラメタ名
ctuneparamオプションで指定するパラメタ
ctuneparam='CLI_MAX_SQL=(255);CLI_WAIT_TIME=(30)'
注意
ctuneparamオプションに複数のパラメタを指定する場合、値を“;”(セミコロン)で区切って設定します。
ctuneparamオプションは、ローカルアクセスまたはリモートアクセス(RDB2_TCP連携)時に指定可能です。
独立性水準の初期値を指定します。
default_isolation={READ_UNCOMMITTED | READ_COMMITTED | REPEATABLE_READ | SERIALIZABLE}
default_isolation=SERIALIZABLE
独立性水準の初期値をREAD UNCOMMITTEDとします。
独立性水準の初期値をREAD COMMITTEDとします。
独立性水準の初期値をREPEATABLE READとします。
独立性水準の初期値をSERIALIZABLEとします。
注意
default_isolationオプションは、ローカルアクセスまたはリモートアクセス(RDB2_TCP連携)時に指定可能です。
システム用の動作環境ファイルのR_LOCKがNO、またはctuneparamオプションのCLI_R_LOCKがNOの場合、default_isolationにREPEATABLE_READを指定しても、独立性水準はSERIALIZABLEとなります。
システム用の動作環境ファイルのR_LOCKがYES、またはctuneparamオプションのCLI_R_LOCKがYESの場合、default_isolationにSERIALIZABLEを指定しても、独立性水準は REPEATABLE READとなります。
サーバ用の動作環境ファイルのDSO_LOCKまたはctuneparamオプションのCLI_DSO_LOCKを指定して、default_isolationを指定した場合は、サーバ接続時にエラーが発生します。
トランザクションアクセスモードの初期値を指定します。
default_readonly={false | true}
default_readonly=false
トランザクションアクセスモードの初期値をREAD WRITEとします。
トランザクションアクセスモードの初期値をREAD ONLYとします。
注意
default_readonlyオプションは、ローカルアクセスまたはリモートアクセス(RDB2_TCP連携)時に指定可能です。
サーバ用の動作環境ファイルのDSO_LOCKまたはctuneparamオプションのCLI_DSO_LOCKを指定して、default_readonlyを指定した場合は、サーバ接続時にエラーが発生します。
1回の検索で問合せを行う最大行数を指定します。単位は行です。
fetchrows=最大行数
fetchrows=0
1回の検索で問合せを行う最大行数を、0～2147483647で指定します。
0を指定した場合、1回の検索で問合せを行う最大行数は、自動設定されます。自動設定された場合の行数は、buffersizeオプションで指定された値に依存します。
0以外の値(N)を指定したとき、fetchrowsオプションに指定した行数のデータ長の合計が、buffersizeオプションの指定値以下の場合、N行が先読みされます。buffersizeオプションの指定値を超える場合、buffersizeオプションの指定値におさまる行数分が先読みされます。
注意
fetchrowsオプションは、リモートアクセス(RDA-SV連携)時に指定可能です。
JDBCドライバがコード変換時に使用する、Javaのエンコーディングを指定します。
javaconverter=エンコーディング名
省略された場合、JDBCドライバが動作しているJava実行環境に合わせて、自動設定されます。
JDBCドライバがコード変換時に使用する、Javaのエンコーディングを指定します。
JavaVMでサポートされているエンコーディング名を指定してください。
アプリケーション実行環境のロケールがCで、ASCIIコード範囲外の文字データを利用する場合、javaconverterオプションで、対象データのエンコーディングを指定してください。
JDBCドライバで返却するエラーメッセージの言語を指定します。
lang={ JA | EN }
日本語のOS環境で本オプションが省略された場合、JAが指定されたとみなします。
その他のOS環境で本オプションが省略された場合、ENが指定されたとみなします。
JDBCドライバで返却するエラーメッセージの言語を指定します。
JAが指定された場合、日本語のエラーメッセージを出力します。
ENが指定された場合、英語のエラーメッセージを出力します。
列名に全角小文字を使用していて、ResultSet.getXXXメソッドを使用する場合に、指定した列名を正しく認識させるために指定します。
lowercasename={ YES | NO }
lowercasename=NO
YES:Symfoware/RDBの表定義で、列名に全角小文字を使用している場合に指定します。
NO:Symfoware/RDBの表定義で、列名に全角小文字を使用していない場合に指定します。
データソースごとに、同時に接続可能なコネクション数の上限を指定します。
maxconnections=最大コネクション数
maxconnections=4
データソースごとに、同時に接続可能なコネクション数の上限を、1～2147483647の範囲で指定します。
注意
maxconnectionsオプションは、DataSourceインタフェースを利用した接続で、利用可能です。
データソースごとに、再利用可能なコネクション数の上限を指定します。
maxpooledconnections=最大プールコネクション数
maxpooledconnections=4
データソースごとに、再利用可能なコネクション数の上限を、0～2147483647の範囲で指定します。
0を指定した場合、コネクションは再利用されずに切断されます。
1以上を指定した場合、Connectionインタフェースのcloseメソッドを実行しても、データベースとの接続は切断されません。コネクションは再利用可能な状態になります。
ただし、maxpooledconnectionsオプションの指定値を超えるコネクションは、切断されます。
注意
maxconnectionsオプションに指定された値よりも大きい値は指定できません。
maxpooledconnectionsオプションは、DataSourceインタフェースを利用した接続で、利用可能です。
データベースに接続するためのパスワードを指定します。
省略した場合、getConnectionメソッドの引数に、必ず指定してください。
password=パスワード
アプリケーション内で使用する、SQL文に対するデフォルトスキーマ名を指定します。
schema=スキーマ名
デフォルトスキーマ名なし
ステートメントキャッシュ機能でキャッシュする、文の上限を指定します。
statementcache=キャッシュ数
statementcache=0
ステートメントキャッシュ機能でキャッシュするSQL文の上限を、0～32000の範囲で指定します。
0を指定した場合、ステートメントキャッシュ機能は無効になり、SQL文はキャッシュされません。
キャッシュする文の数の見積りは、以下となります。
キャッシュする文の数 = prepareStatementメソッドまたは、 prepareCallメソッドで指定するSQL文の数
注意
同じSQL文でも以下の場合は別のSQL文として計算してください。
大文字と小文字の違いがある場合
結果セットのタイプが異なる場合
結果セットの並行処理のタイプが異なる場合
statementcacheオプションは、ローカルアクセスまたはリモートアクセス(RDB2_TCP連携)時に指定可能です。
サーバからの応答に対する待ち時間を、秒単位で指定します。
tcptimer=待ち時間
tcptimer=300
サーバからの応答に対する待ち時間を、0～2147483の範囲で指定します。
注意
tcptimerオプションは、リモートアクセス(RDA-SV連携)時に指定可能です。
データベースに接続するためのユーザIDを指定します。
省略した場合、getConnectionメソッドの引数に、必ず指定してください。
user=ユーザID