付録B ConnectionStringプロパティのキーワード

ConnectionStringプロパティに指定可能なキーワードを説明します。

キーワード	既定値	説明
Data Source または Host または Server または Address または Addr または Network Address	なし	接続するサーバのホスト名またはIPアドレスを指定します。ホスト名を指定する場合、63バイト以内で指定してください。ホスト名、またはIPアドレスは、必ず指定してください。
Port	26551	RDB2_TCP連携で使用するポート番号を指定します。
User ID または User または UID	なし	データベースに接続するユーザIDを指定します。ユーザIDは、必ず指定してください。
Password または Pwd	なし	データベースに接続するユーザIDのパスワードを指定します。パスワードは必ず指定してください。
Initial Catalog または Database	なし	接続するデータベース名を指定します。
schema	なし	アプリケーションで使用するSQL文のデフォルトスキーマ名を指定します。
eventlog	OFF(取得しない)	EventLogの取得の有無やログの取得レベルを指定します。詳細は、“B.1 eventlogキーワード”を参照してください。
connect timeout または connection timeout	15	サーバへの接続を待機する時間を指定します。指定した待機時間を過ぎると、接続を切断し、エラーを返します。待機時間の単位は秒です。 0を指定した場合、待機時間に無制限が指定されます。接続が永続的に待機することになるので、0は指定しないようにしてください。
connectionlifetime	0(最大値)	サーバと接続した時から、コネクションプールで保持している間も含めたコネクションの保持時間を指定します。プーリング中または、SymfowareConnectionクラスのcloseメソッドが実行されたコネクションが、connectionlifetimeを超えた場合、コネクションは解放されます。 poolingがtrue、かつ、Max Pool Sizeが1以上の場合に有効となります。 0～2147483647の範囲で指定します。保持時間の単位は秒です。 0を指定した場合、保持時間に最大値が指定されます。
pooling	true	コネクションをプーリングするかどうかを指定します。 trueが指定された場合、コネクションをプーリングします。 falseが指定された場合、コネクションをプーリングしません。
Max Pool Size または maxpooledconnections	100	同じ内容のConnectionStringプロパティ(接続先情報)ごとに、接続が可能なコネクション数（再利用可能なコネクション数）の上限を指定します。Max Pool Sizeまたはmaxpooledconnectionsを超えるコネクションの接続要求(SymfowareConnectionクラスのopenメソッド)は、connect timeoutパラメタで指定した待機時間の間、再利用可能なコネクションの空きがでるのを待ちます。 poolingがtrueの場合に有効となります。 0～32767の範囲で指定することができます。 0を指定した場合、コネクション数は無制限となり、コネクションは再利用されずに切断されます。 1以上を指定した場合、SymfowareConnectionクラスのcloseメソッドを実行しても、データベースとの接続は切断されません。コネクションは再利用可能な状態になります。また、32768以上が指定された場合、32767が指定されたとみなします。(注1)
Min Pool Size または minpooledconnections	0	同じ内容のConnectionStringプロパティ(接続先情報)ごとに、再利用可能なコネクション数の下限を指定します。最初の接続要求が届いた段階で、Min Pool Sizeまたはminpooledconnectionsに指定された数まで接続し再利用可能なコネクションを保持します。Connectionlifetimeの上限時間により切断され、保持しているコネクションの数がMin Pool Sizeまたはminpooledconnectionsより少なくなった場合には、再接続しコネクションを保持しなおします。接続要求のあったアプリケーションのプロセス終了まで、Min Pool Sizeまたはminpooledconnections分のコネクションは保持されます。 poolingがtrueの場合に有効となります。 0～32767の範囲で指定することができます。ただし、32768以上が指定された場合は、32767が指定されたとみなします。(注2)
tuneparam	なし	Symfoware Serverのクライアント用の動作環境ファイルの実行パラメタを指定します。指定可能な実行パラメタ、および指定形式の詳細は、“B.2 tuneparamキーワード”を参照してください。

注1) Min Pool Sizeまたはminpooledconnectionsに指定された値よりも小さい値は指定できません。

注2) Max Pool Sizeまたはmaxpooledconnectionsに指定された値よりも大きい値は指定できません。