すべてのプロダクト
Search

このプロダクト

    Performance Testing:JDBC リクエストパラメーターの設定

    ドキュメントセンター

    Performance Testing:JDBC リクエストパラメーターの設定

    最終更新日:Mar 11, 2026

    クエリ、挿入、更新、削除などのデータベース操作のパフォーマンスをテストする必要がある場合は、Performance Testing (PTS) の JDBC API を使用して、シミュレートされた負荷状況下で SQL ステートメントをデータベースに直接送信します。このトピックでは、JDBC テストシナリオのデータベース接続、認証情報、および SQL 構成を設定する方法について説明します。

    PTS は、MySQL、PostgreSQL、MariaDB、SQL Server などのデータベースタイプをサポートしています。

    前提条件

    開始する前に、以下を準備してください。

    • PTS コンソールへのアクセス

    • ターゲットデータベースインスタンスのエンドポイント、ポート、およびデータベース名

    • SQL ステートメントに必要な権限を持つデータベースアカウント

    JDBC テストシナリオの作成

    1. PTS コンソールにログインします。

    2. 左側のナビゲーションウィンドウで、[パフォーマンステスト] ＞ [シナリオの作成] を選択し、[PTS] をクリックします。

    3. デフォルトの HTTP API を削除し、JDBC API を追加します。

    4. 基本的なリクエストパラメーターを設定します。パラメーターの説明については、以下のパラメーター表をご参照ください。

      JDBC basic request configuration

      以下の表にパラメーターを示します。

      パラメーター

      説明

      例

      API Name

      API のサービス定義を識別する名前です。最大長: 20 文字。

      API-1

      Database Type

      接続するデータベースのタイプです。有効な値: MySQL、PostgreSQL、MariaDB、SQL Server。

      MySQL

      Database URL

      <host>:<port>/<database_name> の形式のデータベース接続文字列です。以下の「データベース URL の形式」をご参照ください。

      rm-bp1xxxxxxx.mysql.rds.aliyuncs.com:3306/mydb

      Username

      データベース認証のユーザー名です。

      test_user

      Password

      データベース認証のパスワードです。

      your_password

      SQL

      実行する SQL ステートメントです。SELECT、UPDATE、INSERT、または DELETE のいずれかのキーワードで始まる必要があります (大文字と小文字は区別されません)。以下の「SQL ステートメントのガイドライン」をご参照ください。

      select * from test_users;

      Timeout Duration

      PTS がデータベースサーバーからの応答を待機する最大時間 (ミリ秒) です。

      5000

      limit

      結果セットから読み取る最大行数です。SELECT ステートメントにのみ適用されます。最大値: 1,000,000。

      1000

    データベース URL の形式

    [データベース URL] は、ホストアドレス、ポート番号、データベース名を 1 つにまとめた接続文字列です。ご使用のデータベース タイプに応じたフォーマットを使用してください。

    データベースタイプデフォルトポート例 URL
    MySQL3306rm-bp1xxxxxxx.mysql.rds.aliyuncs.com:3306/mydb
    PostgreSQL5432pgm-bp1xxxxxxx.pg.rds.aliyuncs.com:5432/mydb
    MariaDB3306rm-bp1xxxxxxx.mariadb.rds.aliyuncs.com:3306/mydb
    SQL Server1433rm-bp1xxxxxxx.sqlserver.rds.aliyuncs.com:1433/mydb

    プレースホルダーを実際の値に置き換えてください。

    プレースホルダー説明例
    <host>ご利用のデータベースインスタンスのエンドポイントまたは IP アドレスrm-bp1xxxxxxx.mysql.rds.aliyuncs.com
    <port>ポート番号 (デフォルトポートまたは構成済みのカスタムポートを使用)3306
    <database_name>ターゲットデータベースの名前mydb

    注: 上記のポート番号はデフォルトです。ご利用のデータベースがカスタムポートを使用している場合は、それに応じてポート番号を置き換えてください。

    SQL ステートメントのガイドライン

    [SQL] フィールドは、以下のキーワードのいずれかで始まる文（大文字と小文字を区別しない）を受け入れます。

    キーワード操作例
    SELECTデータクエリselect * from test_users where status = 'active';
    INSERTレコードの追加insert into test_users (name, email) values ('test', 'test@example.com');
    UPDATEレコードの変更update test_users set email = 'new@example.com' where id = 1;
    DELETEレコードの削除delete from test_users where id = 1;

    負荷テストに関する考慮事項

    • SELECT 文には limit パラメーターを設定してください。大規模な結果セットは、負荷テスト中にメモリを消費し、パフォーマンスメトリクスを歪める可能性があります。[limit] は、テストシナリオに適した値に設定してください。

    • 現実的な SQL ステートメントを使用します。有意義なパフォーマンスデータを取得するために、WHERE 句や結合を含む、実際の運用環境のクエリを反映したステートメントを記述してください。

    • タイムアウト値を監視します。 SQL ステートメントで large テーブルや重い結合が使用される場合、ロードテスト中の誤検出の失敗を回避するために、[タイムアウト期間] を増加させます。