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

Performance Testing:パラメーター指示の使用

最終更新日:Sep 09, 2026

パラメーター指示は、ロードテスト中に Performance Testing (PTS) がパラメーターファイルからデータを読み取り、結合する方法を制御します。これらを使用して、グローバルパラメーターのオーバーライド、行アライメントのためのベースライン列の指定、またはデータの使用を 1 回に制限できます。

パラメーター指示は、パラメーターファイル設定と連携して機能します。パラメーターファイルのアップロードと管理の詳細については、「ファイルデータソース」をご参照ください。

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

データソースパラメーターは、PTS がパラメーターファイルから行を読み取る方法と、列を互いにどのように対応させるかを制御します。次の手順では、2 つの列 (q1 と q2) を持つ user.csv ファイルを使用して、q1 をベースライン列として設定する方法を説明します。

  1. PTS コンソールにログインします。[Performance Test] > [Create Scenario] を選択し、[PTS] をクリックします。

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

  3. データソースにパラメーターファイルを追加します。

  4. [Business Session] セクションで、[Add Instruction] ドロップダウンリストを開き、[Parameter] を選択します。

  5. [パラメーター] を展開し、[データソースパラメーター] タブでパラメーター q1 と q2 を追加します。

  6. 次の表で説明されている設定を構成します。

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

パラメーター

説明

[アクセスモード]

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

[1回のみ使用]

有効にすると、テスト中に各データ行は 1 回のみ使用されます。[Use Once] が有効になっている列は、自動的にベースライン列になります。[Baseline Column] とは相互に排他的です。

[ベースライン列]

他のすべての列のアライメントの基準として列を指定します。PTS は、ベースライン列ではない列を調整して、ベースライン列の行数に一致させます。[Use Once] とは相互に排他的です。

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

アクセスモード

使用する状況

シナリオ例

[Random]

データの順序が重要でない場合。

検索キーワード、製品 ID、ランダム化されたテスト入力

[In Order]

データが順次使用される場合、または各行が一意である必要がある場合。

ログイン資格情報、シーケンシャルトランザクション 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 には [1, 2] の 2 行のみがあるとします。q1 を基準列として:

  1. PTS は q2 を繰り返して 3 行に到達します: [1, 2, 1]。

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

行

q1 (ベースライン)

q2 (繰り返し)

1

A

1

2

B

2

3

C

1

[Use Once] が有効な場合は、データ量を慎重に計画してください。すべての仮想ユーザーの合計予想反復回数をカバーできるよう、パラメーターファイルに十分な行数があることを確認してください。

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

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

  1. PTS コンソールにログインします。[Performance Test] > [Create Scenario] を選択し、[PTS] をクリックします。

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

  3. データソースにパラメーターファイルを追加します。

  4. [Business Session] セクションで、[Add Instruction] ドロップダウンリストを開き、[Parameter] を選択します。

  5. [Parameter] を展開します。[Custom Parameters] タブで、[Parameter Name] フィールドと [Parameter Logic] フィールドを設定します。

ファイルパラメーター名は、[Data Source Parameters] タブで直接変更することはできません。パラメーター名を変更するには、[Custom Parameters] タブでパラメーターを再定義します。

制約

制約

説明

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

ファイルパラメーター名は、[Data Source Parameters] タブでは変更できません。代わりに [Custom Parameters] タブでパラメーターを再定義してください。

[Use Once] と [Baseline Column] の排他性

[Use Once] と [Baseline Column] は相互に排他的です。一方を有効にすると、もう一方は無効になります。

下書き状態以外の制約

シナリオが下書き状態でない場合、空のパラメーターは設定できません。

スコープ

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