すべてのプロダクト
Search

このプロダクト

    Database Autonomy Service:GetPfsSqlSummaries

    ドキュメントセンター

    Database Autonomy Service:GetPfsSqlSummaries

    最終更新日:Mar 20, 2026

    GetPfsSqlSummaries API を呼び出して、データベースインスタンスの Performance Insight (新バージョン) の SQL ID ディメンションを使用して、すべてのリクエストデータをクエリします。

    操作説明

    この API を使用するための前提条件は次のとおりです。

    • 最新バージョンの Alibaba Cloud SDK または DAS SDK を使用します。

    • SDK を使用して DAS サービスを呼び出すときは、リージョンとして中国 (上海) を指定します。

    • 対象のデータベースインスタンスは RDS MySQL または PolarDB MySQL です。

    • 対象のデータベースインスタンスで Performance Insight (新バージョン) が有効になっている必要があります。詳細については、「Performance Insight (新バージョン)」をご参照ください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    hdm:GetPfsSqlSummaries

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    任意

    データベースインスタンスの ID。

    rm-uf61swc4cru0b****
    NodeId

    string

    任意

    ノード ID。

    説明

    RDS MySQL Cluster Edition または PolarDB for MySQL データベースインスタンスの場合は、ノード ID を指定する必要があります。

    r-****-db-0
    SqlId

    string

    任意

    SQL ID。

    説明

    SQL ID を指定すると、その SQL ID の統計情報のみが返されます。このパラメーターを空のままにすると、データベースインスタンス全体の統計情報が返されます。

    651b56fe9418d48edb8fdf0980ec****
    Keywords

    string

    任意

    SQL テキスト内のキーワード。複数のキーワードはスペースで区切ります。

    select update
    StartTime

    integer

    任意

    クエリの開始時刻。ミリ秒単位の UNIX タイムスタンプ形式。

    1675833788056
    EndTime

    integer

    任意

    クエリの終了時刻。ミリ秒単位の UNIX タイムスタンプ形式。

    説明

    終了時刻は開始時刻より後である必要があります。過去 30 日以内の任意の 7 日間のデータをクエリできます。

    1679297005999
    OrderBy

    string

    任意

    ソートするフィールド。デフォルトは count です。

    • count：実行回数。

    • avgLatency：平均実行時間。

    • rowsExamined：スキャンされた行の総数。

    • rowsExaminedAvg：スキャンされた行の平均数。

    • rowsSentAvg：返された行の平均数。

    count
    Asc

    boolean

    任意

    昇順でソートします。デフォルトは false です。

    • true：はい。

    • false：いいえ。

    false
    PageNo

    integer

    任意

    ページ分割クエリのページ番号。1 から始まります。デフォルトは 1 です。

    1
    PageSize

    integer

    任意

    ページ分割クエリのページあたりの最大レコード数。デフォルトは 10 です。最大値は 100 です。

    10

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    SQL サマリーのリスト。

    Message

    string

    応答メッセージ。

    説明

    リクエストが成功した場合、このパラメーターは Successful を返します。失敗した場合は、エラーコードなどのエラー詳細を返します。

    Successful
    RequestId

    string

    リクエスト ID。

    54F3DBAE-9420-511A-9C29-265E8C04****
    Data

    object

    応答データ。

    Total

    integer

    レコードの総数。

    264
    List

    array<object>

    詳細情報リスト。

    object

    返された項目のリスト。

    UserId

    string

    ユーザー ID。

    196278346919****
    Psql

    string

    SQL テンプレート。

    select ?
    InstanceId

    string

    インスタンス ID。

    rm-2ze8g2am97624****
    NodeId

    string

    ノード ID。

    説明

    このパラメーターは、ApsaraDB RDS for MySQL Cluster Edition または PolarDB for MySQL データベースインスタンスに対して返されます。

    r-x****-db-0
    SqlType

    string

    SQL タイプ。有効な値：

    • SELECT

    • UPDATE

    • DELETE

    SELECT
    LogicId

    integer

    論理データベース ID。

    58275984
    SqlId

    string

    SQL テンプレート ID。

    2e8147b5ca2dfc640dfd5e43d96a****
    Timestamp

    integer

    データタイムスタンプ。ミリ秒単位の UNIX タイムスタンプ形式。

    1643040000000
    RtRate

    number

    総実行時間に占める割合。

    0.1384
    CountRate

    number

    総実行回数に占める割合。

    0.0586
    FullScan

    boolean

    フルテーブルスキャンが発生したかどうかを示します。有効な値：

    • true：はい。

    • false：いいえ。

    true
    Count

    integer

    実行総数。

    100000
    ErrCount

    integer

    エラー数。

    0
    WarnCount

    integer

    警告数。

    0
    TotalLatency

    number

    総実行時間 (ミリ秒)。

    60913.256
    MaxLatency

    number

    最大実行時間 (ミリ秒)。

    36.233
    AvgLatency

    number

    平均 SQL 実行時間 (ミリ秒)。

    0.1717
    RowsSent

    integer

    返された行数。

    0
    RowsSendAvg

    number

    送信された行の平均数。

    0
    RowsExamined

    integer

    スキャンされた行の総数。

    100
    RowsExaminedAvg

    number

    スキャンされた行の平均数。

    0
    RowsAffected

    integer

    影響を受けた行数。

    0
    RowsAffectedAvg

    number

    影響を受けた行の平均数。

    0
    TmpTables

    integer

    一時テーブルの数。

    0
    TmpDiskTables

    integer

    一時ディスクテーブルの数。

    0
    RowsSorted

    integer

    ソートされた行数。

    0
    SortMergePasses

    integer

    ソートアルゴリズムで必要とされるマージパスの数。

    0
    PhysicalReads

    integer

    物理ノード数。

    0
    PhysicalAsyncReads

    integer

    物理非同期ノード数。

    0
    SemisyncDelayTime

    number

    準同期レプリケーションの遅延 (ミリ秒)。

    0.12
    RowsSentAvg

    number

    SQL ステートメントごとに返される行の平均数。

    0.52
    LogicReads

    integer

    論理ノード数。

    0
    RedoWrites

    integer

    REDO ノード数。

    0
    DataWriteTime

    number

    データ書き込み時間 (ミリ秒)。

    0
    DataWrites

    integer

    書き込み可能なデータノード数。

    0
    DataReadTime

    number

    データ読み取り時間 (ミリ秒)。

    0
    DataReads

    integer

    読み取り可能なデータノード数。

    0
    RwlockOsWaits

    integer

    読み書き分離が有効になっているかどうかを示します。有効な値：

    • 0：無効。

    • 1：有効。

    0
    RwlockSpinRounds

    integer

    読み書き分離パラメーター。

    0
    RwlockSpinWaits

    integer

    複数インデックススキャンが有効になっているかどうかを示します。有効な値：

    • 0：無効。

    • 1：有効。

    0
    MutexWaits

    integer

    mutex 待機数。

    1
    MutexSpins

    integer

    mutex スピン数。

    1
    TransactionLockTime

    number

    トランザクションロック時間 (ミリ秒)。

    0
    ServerLockTime

    number

    サーバーロック時間 (ミリ秒)。

    0
    CpuTime

    number

    CPU ランタイム (ミリ秒)。

    0
    ElapsedTime

    number

    実際のランタイム (ミリ秒)。

    0
    Id

    integer

    プライマリキー ID。

    26186357
    SelectScanAvg

    number

    平均スキャン数。

    0
    SelectRangeAvg

    number

    平均範囲選択。

    0
    SelectFullJoinAvg

    number

    インデックスを使用せずにテーブルスキャンを実行する接続の平均数。

    重要 このパラメーター値が 0 でない場合は、テーブルのインデックスを注意深く確認してください。

    0
    SelectFullRangeJoinAvg

    number

    平均範囲結合数。

    0
    SortScanAvg

    number

    平均ソートスキャン数。

    0
    SortRowsAvg

    number

    平均ソート行数。

    0
    TmpTablesAvg

    number

    平均一時テーブル数。

    0
    TmpDiskTablesAvg

    number

    平均一時ディスクテーブル数。

    0
    FirstTime

    integer

    初回実行時間。ミリ秒単位の UNIX タイムスタンプ形式。

    1659308149000
    LastTime

    integer

    最終更新時間。ミリ秒単位の UNIX タイムスタンプ形式。

    1661306520000
    LockLatencyAvg

    number

    平均ロック待機時間 (ミリ秒)。

    0
    TimerWaitAvg

    number

    予約済みパラメーター。

    None
    SortRangeAvg

    number

    範囲ベースのソートの平均数。

    0
    CpuRate

    number

    総 SQL 実行時間に対する CPU 実行時間の比率。

    0
    Db

    string

    データベース名。

    testDB
    Tables

    array

    データベーステーブル名。

    string

    データベーステーブル名。

    test_table
    PageNo

    integer

    ページ番号。

    1
    PageSize

    integer

    ページあたりの最大レコード数。

    10
    Extra

    any

    予約済みパラメーター。

    None
    Code

    integer

    応答ステータスコード。

    200
    Success

    boolean

    リクエストが成功したかどうかを示します。

    • true：成功。

    • false：失敗。

    true

    例

    成功レスポンス

    JSONJSON

    {
  "Message": "Successful",
  "RequestId": "54F3DBAE-9420-511A-9C29-265E8C04****",
  "Data": {
    "Total": 264,
    "List": [
      {
        "UserId": "196278346919****",
        "Psql": "select ?",
        "InstanceId": "rm-2ze8g2am97624****",
        "NodeId": "r-x****-db-0",
        "SqlType": "SELECT",
        "LogicId": 58275984,
        "SqlId": "2e8147b5ca2dfc640dfd5e43d96a****",
        "Timestamp": 1643040000000,
        "RtRate": 0.1384,
        "CountRate": 0.0586,
        "FullScan": true,
        "Count": 100000,
        "ErrCount": 0,
        "WarnCount": 0,
        "TotalLatency": 60913.256,
        "MaxLatency": 36.233,
        "AvgLatency": 0.1717,
        "RowsSent": 0,
        "RowsSendAvg": 0,
        "RowsExamined": 100,
        "RowsExaminedAvg": 0,
        "RowsAffected": 0,
        "RowsAffectedAvg": 0,
        "TmpTables": 0,
        "TmpDiskTables": 0,
        "RowsSorted": 0,
        "SortMergePasses": 0,
        "PhysicalReads": 0,
        "PhysicalAsyncReads": 0,
        "SemisyncDelayTime": 0.12,
        "RowsSentAvg": 0.52,
        "LogicReads": 0,
        "RedoWrites": 0,
        "DataWriteTime": 0,
        "DataWrites": 0,
        "DataReadTime": 0,
        "DataReads": 0,
        "RwlockOsWaits": 0,
        "RwlockSpinRounds": 0,
        "RwlockSpinWaits": 0,
        "MutexWaits": 1,
        "MutexSpins": 1,
        "TransactionLockTime": 0,
        "ServerLockTime": 0,
        "CpuTime": 0,
        "ElapsedTime": 0,
        "Id": 26186357,
        "SelectScanAvg": 0,
        "SelectRangeAvg": 0,
        "SelectFullJoinAvg": 0,
        "SelectFullRangeJoinAvg": 0,
        "SortScanAvg": 0,
        "SortRowsAvg": 0,
        "TmpTablesAvg": 0,
        "TmpDiskTablesAvg": 0,
        "FirstTime": 1659308149000,
        "LastTime": 1661306520000,
        "LockLatencyAvg": 0,
        "TimerWaitAvg": 0,
        "SortRangeAvg": 0,
        "CpuRate": 0,
        "Db": "testDB",
        "Tables": [
          "test_table"
        ]
      }
    ],
    "PageNo": 1,
    "PageSize": 10,
    "Extra": "None"
  },
  "Code": 200,
  "Success": true
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParams The request parameters are invalid.
    403 NoPermission You are not authorized to do this action.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。