■データベース（Database）

□データベースの定義

TGにおけるデータベースとは、負荷がけの対象となるデータベースを指します。

□データベースの属性（基本）

データベースは、以下の基本属性をもちます。

・データベースタイプ（Database Type）

データベースのタイプを選択します。選択可能なデータベースは以下の4タイプです。

- MySQL

- PostgreSQL

- ORACLE

- Other databases

□データベースの属性（追加）

選択したデータベースタイプにより、指定すべき追加属性が異なります。

・データベース・タイプ："MySQL"

接続先となるMySQLサーバを特定するため、以下の情報を指定します。

- MySQLが稼動しているホスト名（Hostname）

- ポート番号（Port Number）

- データベース名（Database name）

これらの情報により、JDBCドライバに渡されるJDBC URLが自動生成されます。なお、JDBCドライバ固有の機能を使用したい場合には、「Edit "JDBC URL" Manually」をチェックし、JDBC URLを直接手動で編集することも可能です。

・データベース・タイプ："PostgreSQL"

接続先となるPostgreSQLサーバを特定するため、以下の情報を指定します。

- PostgreSQLが稼動しているホスト名（Hostname）

- ポート番号（Port Number）

- データベース名（Database name）

これらの情報により、JDBCドライバに渡されるJDBC URLが自動生成されます。なお、JDBCドライバ固有の機能を使用したい場合には、「Edit "JDBC URL" Manually」をチェックし、JDBC URLを直接手動で編集することも可能です。

・データベース・タイプ："ORACLE"

使用するJDBCドライバのタイプを「Driver Type」パラメータより選択します。選択可能な値は"Type 4(Thin)"と"Type 2(OCI)"、"Type 2(OCI8)"です。"Type 4(Thin)"を選択した場合には、接続先となるORACLEサーバを以下の情報により特定します。

- ORACLEリスナーがリスンしているアドレス（Hostname）

- ORACLEリスナーがリスンしているポート番号（Port Number）

- SID名（SID name）

"Type 2(OCI)"または"Type 2(OCI8)"を選択した場合には、以下の情報を指定します。

- tnsnames.oraに記載されている接続記述子（TNS names）

※上記tnsnames.ora内に接続先データベースについての情報が適切に記載されていることが前提となります。

なお、JDBCドライバ固有の機能を使用したい場合には、「Edit "JDBC URL" Manually」をチェックし、JDBC URLを直接手動で編集することも可能です。

・データベース・タイプ："Other databases"

データベースの接続に使用するJDBCドライバを指定するため、「Driver Class」を手動で入力します。続いて「JDBC URL」を指定してください。

■エージェント（Agents）

□エージェントの定義

TG におけるエージェントとは、SQL文を実行してデータベースへ負荷がけを行う仮想クライアントです。エージェントの実体はJavaのスレッドで形成されており、TGはトランザクションを実行する際にこのエージェントを複数生成し、大量のユーザによる同時実行環境をエミュレートします。

□エージェントの属性（基本）

エージェントは、以下の基本属性をもちます。

・ユーザ名（User Name）

エージェントがデータベースに接続する際に使用するユーザ名です。

・パスワード（Password）

エージェントがデータベースに接続する際に使用するパスワードです。

・ログオンオプション（Agent logon option）

エージェントがデータベースに接続する際に使用する接続オプションを指定します。指定可能なオプションは「Normal」、「Sysdba」、「Sysoper」の中から選択します。

・セッション（Sessions）

エージェントを生成する数を指定します。入力可能な値は1～2000です。

・シンクタイム（Thinktime）

エージェントが各トランザクションを実行する間のウェイト時間を指定します。単位はミリ秒（1/1000秒）です。

※「Sessions」パラメータと「Thinktime」パラメータにより、トランザクションの多重度と実行頻度を調節すること可能です。

□エージェントの属性（追加）

エージェントは、以下の追加属性をもちます。本追加属性の設定は必須ではありません。高度なエージェントの制御を行いたい際に使用します。

・「Execution Count」、「Reconnect Wait」

本パラメータは、データベースへの接続・切断が繰り返し実行されるような状態を再現する際に使用します。

エージェントは「Execution Count」で指定された回数トランザクションを実行し、データベースから切断します。その後「Reconnect Wait」パラメータで指定された期間ウェイトし、再度データベースに接続します。

なお、「Execution Count」のデフォルト値は"-1"です。"-1"が設定された場合、エージェントは無制限にトランザクションを実行し、自動的にデータベースから切断することは行いません。

また、「Reconnect Wait」パラメータはミリ秒（1/1000秒）で正の整数値を指定します。

・「Delay Start」

本パラメータはエージェントのトランザクション実行タイミングをずらしたいときに使用します。

本パラメータに"true"を指定した場合、各エージェントはTGCからの「Activate agents」コマンド受信後、乱数を使用してトランザクションを開始するまでの時間を最大20秒遅延させます。

・「Error Retry Count」、「Error Retry Wait」

本パラメータはトランザクション実行中にSQLエラーが発生した場合のエージェントの動作を制御します。

SQLエラーが発生した場合、エージェントは「Error Retry Wait」パラメータで指定した期間ウェイトし、再度トランザクションの実行を試みます。トランザクションの再実行回数は「Error Retry Count」パラメータで指定します。

なお、「Error Retry Wait」パラメータはミリ秒（1/1000秒）で正の整数値を指定します。

・「Error Reconnect Count」、「Error Reconnect Wait」

本パラメータはトランザクション実行中に何らかの原因でデータベースとのセッションが切断された場合のエージェントの動作を制御します。

セッションが切断された際、エージェントは「Error Reconnect Wait」パラメータで指定された期間ウェイトし、データベースへ再接続を試みます。再接続を試みる回数は「Error Reconnect Count」パラメータで指定します。

なお、「Error Reconnect Wait」パラメータはミリ秒（1/1000秒）で正の整数値を指定します。

・「Auto commit」

本パラメータはJDBCの「AUTO COMMIT」機能の使用有無を指定します。本設定値が"false"の場合、トランザクションを確定させるために明示的にコミット（commit）を行う必要があります。

・「Isolation level」

本パラメータはトランザクションの分離レベル（SQL Transaction isolation level）を指定します。指定可能な値は「Read UnCommitted」、「Read Committed」、「Repeatable Read」、「Serializable」です。なお、本設定値を「Default」とした場合、使用しているJDBCドライバのデフォルト値が採用されます。

■乱数（Variables）

□乱数の定義

TGにおける乱数（Variable）とは、Agentが異なるデータに簡単にアクセスするためのメカニズムです。乱数はトランザクションを構成する SQL文中に埋め込むかたちで利用します。TGに登録可能な乱数の合計数は20です。

□乱数の属性

乱数は、以下の属性をもちます。

・乱数名（Variable Name）

乱数を一意に識別する名前です。なお乱数名は":"（コロン）で始まる必要があります。

・乱数型（Variable Type）

乱数の型です。乱数型には以下6つの種類があります。

　- 整数型 [Number]

　　ランダムな整数値を生成します。

　- 文字列型 [Character]

　　ランダムな長さの半角英数文字列を生成します。

　- 日付型 [Date]

　　ランダムな日付（日付書式：YYYY/MM/DD）を生成します。

　- リスト（数値）型 [List(integer)]

　　ユーザが任意に定義した数値をランダムに生成します。

　- リスト（文字列）型 [List(string)]

　　ユーザが任意に定義した文字列をランダムに生成します。

　- AgentのID値 [AgentID]

　　Agentに割り当てられたスレッドIDです。

・最小値（Minimum Value）・最大値（Maximum Value）

乱数が生成する値の範囲を制御します。

以下に各乱数型ごとの最小値と最大値の動作について示します。

- 整数型（Number）

生成する整数値の最小値と最大値を指定します。例えば、最小値を「10」、最大値を「100」と設定すると、「10～100」までの範囲でランダムな整数が生成されます。

- 文字列型（Character）

生成する文字列の長さの最小値と最大値を指定します。例えば、最小値を「10」、最大値を「255」と設定すると、半角英数字を最小10文字から最大255文字の範囲で生成します。

- 日付型（Date）

生成する日付の最小値と最大値を指定します。なお書式は「YYYY/MM/DD」です。例えば、最小値を「2000/01/01」、最大値を「2001 /12/31」と設定すると、2000年1月1日から2001年12月31日までの間でランダムな日付を生成します。

- リスト型（List）

※最小値と最大値は使用しません。リスト型を選択した場合、以下の「生成値（Values）」を使用します。

- AgentのID値（AgentID）

トランザクションを実行しているAgentのスレッドID値です。

・生成値（Values）

乱数型に「リスト型（List）」を選択した場合に使用します。ひとつ以上の文字列を「"」（ダブルクォート）で囲み、「,」（カンマ）で区切って記述します。以下に例を示します。

例）

"Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"

上記例では、「Sunday」から「Saturday」までの文字列がランダムに生成されます。

□変数への置換

SQL文中に埋め込まれた乱数は、実際にはTG内部で変数に置換されます（具体的にはJDBCの「prepareStatement」句における"?"です）。Agentによるトランザクション実行時、該当する変数に乱数の生成値がセットされます。

※Oracleの場合、乱数は「バインド変数」として処理されます。

■トランザクション（Transactions）

□トランザクションの定義

TGにおけるトランザクション（Transaction）とは、データベースサーバへの負荷を構成する一連のSQL文のセットです。トランザクション内に登録されたSQL文は、データベースに接続したAgentによって順次実行されます。TGに登録可能なトランザクションの合計数は30です。

□トランザクションの属性

トランザクションは、以下の属性を持ちます。

・トランザクション名（Transaction Name）

トランザクションを一意に識別する名前です。

・実行確立（Average of Execution）

TGに複数のトランザクションが登録されている場合、Agentはこの実行確立に従って実行するトランザクションを選択します。例えば、A・B・Cの3つのトランザクションが登録され、それぞれ70%・20%・10%の実行確立が設定されているとき、Aのトランザクションは70%の確立で実行されることになります。

なお、登録されたすべてのトランザクションの実行確立が合計100%になる必要はありません。これはAgentが各トランザクションに設定された実行確率をトランザクション選択のための相対的な比率として扱うためです。

・SQL文（SQL statements）

トランザクションを構成するSQL文です。ひとつのトランザクション内には最大20個のSQL文を登録することができます。複数のSQL文が登録された場合、SQL文は登録された順番にシーケンシャルに実行されます。またSQL文中には乱数（Variable）を埋め込むことが可能です。

□トランザクション内の乱数値の再計算について

トランザクションを構成するSQL文中には、乱数（Variable）を使用することができます。例えば、乱数をWhere区の条件に設定することで、 Agentはトランザクションを実行するたびに異なるデータにアクセスします。

なお、ひとつのトランザクション内に同一名の乱数を複数回使用した場合、これらに割り当てられる値はすべて同じになります。これは、乱数の値がAgentのトランザクション選択時に再計算されるためです。

□トランザクションのコミット

TGはデフォルトの状態では、JDBCの「AUTO COMMIT」機能を"false"に設定しており、トランザクションを確定させるために明示的にコミット（commit;）、ロールバック（rollback;）を実行する必要があります。

なお、「AUTO COMMIT」の使用有無の切り替えは、エージェントの追加属性にて指定することが可能です。

■ジョブ（Jobs）

□ジョブの定義

TGにおけるジョブ（Jobs）とは、定型化された一連のOSコマンドやSQLを実行するための機能です。繰り返し使用するOSコマンドやSQLをTGに登録しておくことで、負荷がけに付随する諸所の作業を効率的に実行することができます。TGに登録可能なジョブの合計数は20です。

□ジョブの属性（基本）

ジョブは以下の基本属性を持ちます。

・ジョブタイプ（Job Type）

ジョブのタイプを選択します。選択可能なジョブタイプは以下の4タイプです。

- Command : TGが動作しているホストにてOSコマンドを実行します

- Telnet : TGが動作しているホストからリモートのホストにTelnet接続し、コマンドを実行します

- SQL : 指定されたデータベースに接続し、SQLを実行します

- PL/SQL : 指定されたデータベースに接続し、PL/SQLを実行します

※PL/SQLはデータベースが「ORACLE」の際に有効となります。

・トリガー（Trigger）

ジョブを実行するタイミングを指定します。指定可能な値は以下の4つです。

- on Agents connecting : エージェントがデータベースに接続する際にジョブを実行します

- on Agents disconnecting : エージェントがデータベースから切断する際にジョブを実行します

- on Monitor starting : モニター開始時にジョブを実行します

- on Monitor finishing : モニター終了時にジョブを実行します

□ジョブの属性（追加）

選択したジョブタイプにより、指定すべき追加属性が異なります。

・ジョブ・タイプ："Command"

ジョブとして実行するコマンドを設定します、以下の情報を指定します。

- Command

Commandには実行したいコマンドをフルパスで入力してください。

・ジョブ・タイプ："Telnet"

Telnetの接続対象となるホストの特定や実行するコマンドを設定するため、以下の情報を指定します。

- Hostname : Telnet接続の対象となるホスト名かIPアドレスを指定します

- Port : Telnet接続に使用されるポート番号を指定します

- Username : Telnet接続を行うOSユーザ名を指定します

- Password : Telnet接続を行うOSユーザのパスワードを指定します

- Script : 実行したい一連のコマンドを入力します

なお、「Import category "database" parameters」をチェックすることにより、Telnet接続を行うホスト名をデータベースタブのパラメータ「Hostname」より流用することが可能です。

・ジョブ・タイプ："SQL"

SQLの実行対象となるデータベースの特定や実行するSQLを設定するため、以下の情報を指定します。

- Username : 接続対象となるデータベースのユーザ名を指定します

- Password : 接続対象となるデータベースのユーザのパスワードを指定します

- Logon option : データベースへ接続する際の接続オプションを指定します（ORACLEのみ）

- Driver class : データベースへの接続に使用するJDBCドライバクラスを指定します

- JDBC URL : JDBCドライバに受け渡す接続URLを指定します

- Script : 実行したい一連のSQLを入力します

なお、「Import category "database" parameters」をチェックすることにより、JDBCドライバクラス（Driver class）とJDBC URLをデータベースタブのパラメータ「Driver class」・「JDBC URL」から流用することが可能です。この機能は、負荷がけ対象のデータベースとジョブの実行対象となるデータベースが同一であるときに役立ちます。

・ジョブ・タイプ："PL/SQL"

SQLの実行対象となるデータベースの特定や実行するPL/SQLを設定するため、以下の情報を指定します。

- Username : ※ジョブ・タイプ"SQL"と同一です

- Password : ※ジョブ・タイプ"SQL"と同一です

- Logon option : ※ジョブ・タイプ"SQL"と同一です

- Driver class : ※ジョブ・タイプ"SQL"と同一です

- JDBC URL : ※ジョブ・タイプ"SQL"と同一です

- Script : 実行したい一連のPL/SQLを入力します

なお、ジョブタイプが"PL/SQL"の場合も、「Import category "database" parameters」をチェックすることにより、設定値をデータベースタブのパラメータから流用することが可能です。本機能はジョブの実行対象であるデータベースが「ORACLE」のときのみ有効な機能です。