すべてのプロダクト
Search
ドキュメントセンター

Performance Testing:パラメーター命令の使用

最終更新日:Mar 12, 2026

パラメーター命令は、ロードテスト実行中に PTS がパラメーターファイルからデータを読み取り・結合する方法を制御します。グローバルパラメーターのオーバーライド、行揃えの基準列(ベースライン列)の指定、またはデータの単一使用(1 回限りの消費)を強制する場合に使用します。

パラメーター命令は、パラメーターファイルの構成と連携して動作します。パラメーターファイルのアップロードおよび管理に関する詳細は、「データソース」をご参照ください。

データソースパラメーターの構成

データソースパラメーターは、PTS がパラメーターファイルから行を読み取る方法および列間の配置方法を制御します。以下の手順では、2 列(q1 および q2)を持つ user.csv ファイルを使用し、q1 をベースライン列として設定する方法を説明します。

  1. PTS コンソールにログインします。[パフォーマンスンテスト] > [シナリオの作成] を選択し、[PTS] をクリックします。

  2. HTTP ノードの基本リクエストパラメーターを構成します。詳細については、「基本リクエストパラメーター」をご参照ください。

  3. データソースにパラメーターファイルを追加します。詳細については、「データソースへのパラメーターファイルの追加」をご参照ください。

  4. [ビジネスセッション] セクションで、[命令の追加] ドロップダウンリストを開き、[パラメーター] を選択します。

  5. パラメーター を展開します。データソースパラメーター タブで、q1 および q2 のパラメーターを追加します。

  6. 以下の表に記載された設定を構成します。

データソースパラメーター設定

パラメーター

説明

アクセスモード

パラメーターファイルから行を読み取る方法を決定します。ランダム:行がランダムな順序で選択されます。順次:行が上から下へ順に読み取られます。

1 回限りの使用

有効にすると、各データ行はテスト実行中に 1 度だけ消費されます。1 回限りの使用 が有効な列は、自動的にベースライン列になります。ベースライン列 とは相互排他です。

ベースライン列

他のすべての列の配置基準となる列を指定します。PTS は、ベースラインでない列をベースライン列の行数に合わせて調整します。1 回限りの使用 とは相互排他です。

適切なアクセスモードの選択

アクセスモード

使用タイミング

使用例

ランダム

データの順序は問いません。

検索キーワード、プロダクト ID、ランダム化されたテスト入力など。

順次

データを順次消費する必要がある場合、または各行が一意である必要があります。

ログイン認証情報、連番トランザクション ID、時系列データなど。

ベースライン列による配置の仕組み

列をベースラインとして指定すると、PTS は他のすべての列をその行数に合わせて配置します。以下に、q1(ベースライン列)が 100 行ある場合の例を示します。

ベースライン以外の列の行

PTS の処理内容

結果

150 行

ベースラインに合わせて切り捨てます。

先頭の 100 行のみが使用されます。

50 行

行を繰り返してベースラインの行数を満たします。

50 行が 2 回繰り返され、合計 100 行が生成されます。

配置後、PTS は列を行ごとにペアにして、テスト実行時に使用される最終的なデータセットを作成します。

ステップバイステップの例:

q1 の値が [A, B, C](3 行)、q2 の値が [1, 2, 3, 4, 5](5 行)であるとします。q1 をベースライン列とした場合:

  1. PTS は q1 の全 3 行をターゲット行数として使用します。

  2. PTS は q2 を 5 行から 3 行に切り捨てます:[1, 2, 3]

  3. PTS は列を行ごとにペアにします:

q1(ベースライン)

q2(切り捨て済み)

1

A

1

2

B

2

3

C

3

次に、q1 が 3 行、q2 が 2 行([1, 2])であるとします。q1 をベースライン列とした場合:

  1. PTS は q2 を 3 行になるよう繰り返します:[1, 2, 1]

  2. PTS は列を行ごとにペアにします:

q1(ベースライン)

q2(繰り返し済み)

1

A

1

2

B

2

3

C

1

1 回限りの使用 を有効にする場合は、データ量を十分に検討してください。パラメーターファイルには、仮想ユーザー全体で予測される反復回数をカバーできる十分な行数が含まれていることを確認してください。

カスタムパラメーターの作成

カスタムパラメーターを使用すると、ファイルパラメーターを含むグローバルパラメーターを再定義できます。カスタムパラメーターは、ファイルパラメーターの名前変更やテストデータに対するカスタム処理の適用に使用します。

  1. PTS コンソールにログインします。PTS コンソール で、[パフォーマンステスト][シナリオの作成] を選択し、その後 [PTS] をクリックします。

  2. HTTP ノードの基本リクエストパラメーターを構成します。詳細については、「基本リクエストパラメーター」をご参照ください。

  3. データソースへのパラメーターファイルの追加」を行います。

  4. ビジネス セッション」セクションで、[命令の追加] ドロップダウン リストを開き、[パラメーター] を選択します。

  5. パラメーター を展開します。カスタムパラメーター タブで、パラメーター名 および パラメーター論理 フィールドを構成します。

ファイルパラメーター名は、データソースパラメーター タブで直接変更できません。パラメーター名を変更するには、カスタムパラメーター タブでパラメーターを再定義してください。

制限事項

制約

説明

ファイルパラメーターの名前変更

ファイルパラメーター名は、データソースパラメーター タブでは変更できません。代わりに、カスタムパラメーター タブでパラメーターを再定義してください。

「1 回限りの使用」と「ベースライン列」の相互排他性

1 回限りの使用ベースライン列 は相互排他です。一方を有効にすると、他方は無効になります。

下書き状態以外での制限

シナリオが下書き状態でない場合、空のパラメーターを構成することはできません。

スコープ

パラメーター命令は、現在のビジネスセッションにのみ適用されます。