すべてのプロダクト
Search

このプロダクト

    Database Autonomy Service:DescribeSlowLogRecords

    ドキュメントセンター

    Database Autonomy Service:DescribeSlowLogRecords

    最終更新日:Jun 10, 2026

    この API では、複数の条件に基づいて、データベースインスタンスからスローログレコードをクエリ、フィルター、ソートできます。

    操作説明

    • InstanceId は必須のインスタンス ID です。

    • StartTime と EndTime には、必須のクエリ時間範囲を指定します。

    • PageNumber と PageSize を使用して、結果をページ分割します。

    • OrderBy を使用して、結果をソートします。ソート可能なフィールドの一覧については、ドキュメントを参照してください。

    • Filters
      重要 RDS for PostgreSQL や PolarDB for PostgreSQL などの一部のデータベースタイプでは、特定のソート方法をサポートしていません。お使いのデータベースタイプと互換性のあるパラメーターを選択してください。
      を使用して、ホストアドレスや SQL ID によるフィルタリングなど、クエリ条件を絞り込みます。

    今すぐお試しください

    この 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:DescribeSlowLogRecords

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    必須

    インスタンス ID。

    rm-8vbk4xz99su8****
    NodeId

    string

    任意

    ノード ID。

    pi-d9j9fe7wq7t9i****

    StartTime

    integer

    必須

    クエリ対象の時間範囲の開始時刻。値はミリ秒単位の UNIX タイムスタンプである必要があります。

    1596177993000
    EndTime

    integer

    必須

    クエリ対象の時間範囲の終了時刻。値はミリ秒単位の UNIX タイムスタンプである必要があります。

    1634972640000
    PageNumber

    integer

    任意

    ページ番号。1 から始まります。

    1
    PageSize

    integer

    任意

    ページあたりのエントリ数。

    10
    Filters

    array<object>

    任意

    フィルター条件のリスト。

    object

    任意

    フィルター条件。

    Key

    string

    任意

    フィルターキー。

    説明

    詳細については、補足情報を参照してください。

    None
    Value

    string

    任意

    フィルターキーの値。

    None
    OrderBy

    string

    任意

    • MySQL

      • QueryTimeSeconds：クエリ実行時間 (秒単位)。

      • LockTimeSeconds：ロック時間 (秒単位)。

      • RowsSent：送信された行数。

      • RowsExamined：スキャンされた行数。

    • Redis

      • QueryTime：クエリ実行時間。

      • Timestamp：クエリ実行の終了時刻。

    • MongoDB

      • QueryTime：クエリ実行時間。

      • Timestamp：クエリ実行の終了時刻。

      • KeysExamined：スキャンされたキーの数。

      • DocExamined：スキャンされたドキュメント数。

      • ReturnNum：返された行数。

    重要 RDS for PostgreSQL、PolarDB for PostgreSQL、SQL Server はソートをサポートしていません。

    QueryTimeSeconds
    Asc

    boolean

    任意

    結果を昇順でソートするかどうかを指定します。デフォルト値は true です。

    • true：結果を昇順でソートします。

    • false：結果を降順でソートします。

    true

    キー パラメーターは、次の値をサポートしています：

    • RDS for MySQL、PolarDB for MySQL、RDS for PostgreSQL、および PolarDB for PostgreSQL

      • hostAddress ：ソース IP アドレス。複数の値はカンマで区切ります。

      • sqlId ：SQL ID。複数の値はカンマで区切ります。

      • user ：ユーザー。複数の値はカンマで区切ります。

      • dbName ：データベース名。複数の値はカンマで区切ります。

      • tags ：タグ。複数の値はカンマで区切ります。

    • MongoDB

      • hostInsId ：ロール ID。複数の値はカンマで区切ります。

      • insRole ：インスタンスロール。複数の値はカンマで区切ります。

      • opType ：オペレーションタイプ。複数の値はカンマで区切ります。

      • namespace ：名前空間。複数の値はカンマで区切ります。

      • nodeType ：ノードタイプ。複数の値はカンマで区切ります。

      • queryId ：クエリ ID。複数の値はカンマで区切ります。

    • Tair

      • hostAddress ：ソース IP アドレス。

      • user ：ユーザー。

      • dbName ：データベース名。

      • nodeType ：ノードタイプ。

    • RDS for SQL Server

      • hostAddress ：ソース IP アドレス。複数の値はカンマで区切ります。

      • sqlId ：SQL ID。複数の値はカンマで区切ります。

      • user ：ユーザー。複数の値はカンマで区切ります。

      • dbName ：データベース名。複数の値はカンマで区切ります。

      • tags ：タグ。複数の値はカンマで区切ります。

    • PolarDB-X

      • traceId ：トレース ID。

      • role ：ノードロール (必須)。有効な値： CN (コンピュートノード) および DN (データノード)。

      • hostAddress ：ソース IP アドレス。複数の値はカンマで区切ります。

      • sqlId ：SQL ID。複数の値はカンマで区切ります。

      • user ：ユーザー。複数の値はカンマで区切ります。

      • dbName ：データベース名。複数の値はカンマで区切ります。

      • tags ：タグ。複数の値はカンマで区切ります。

    説明

    • SQL エンジンの場合、sqlId でデータをクエリできます。カンマ区切りの SQL ID を最大 20 個まで指定できます。

    • MongoDB の場合、queryId でデータをクエリできます。カンマ区切りのクエリ ID を最大 20 個まで指定できます。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Code

    string

    返されたステータスコード。

    200
    Message

    string

    応答メッセージ。

    説明

    リクエストが成功した場合、 Successful が返されます。リクエストが失敗した場合、エラーメッセージが返されます。

    Successful
    RequestId

    string

    リクエスト ID。

    A1C79EE2-D04D-571B-8C60-961FAF8E****
    Success

    string

    リクエストが成功したかどうかを示します。有効な値：

    • true：リクエストは成功しました。

    • false：リクエストは失敗しました。

    true
    Data

    object

    スロークエリログの詳細。

    DbInstanceName

    string

    インスタンス ID。

    rm-bp157g54vy772****
    NodeId

    string

    ノード ID。

    node123
    ItemsNumbers

    integer

    現在のページのスローログレコード数。

    10
    StartTime

    string

    クエリの時間範囲の開始時刻。

    1672531200000
    EndTime

    string

    クエリの時間範囲の終了時刻。

    1672617600000
    DbInstanceId

    integer

    インスタンスの数値 ID。

    100
    TotalRecords

    integer

    検出されたスローログレコードの総数。

    100
    PageNumbers

    integer

    返された結果のページ番号。

    1
    MaxRecordsPerPage

    integer

    ページあたりの最大エントリ数。有効な値： 5 ~ 100。

    20
    Logs

    array<object>

    スロークエリログのリスト。

    array<object>

    スロークエリログの詳細。

    SqlId

    string

    SQL ID。

    sqlId
    Scheme

    string

    データスキーマ。

    HTTPS
    SubInstanceId

    string

    サブインスタンス ID。

    r-8vb219d10038****
    DbInstanceName

    string

    インスタンス ID。

    rm-2zebg30mk056g****
    InsName

    string

    インスタンス名。

    test
    AccountName

    string

    ユーザー名。

    user1
    HostAddress

    string

    送信元 IP アドレス。

    192.168.1.1
    QueryStartTime

    string

    クエリの開始時刻。この値は UTC 時刻です。時刻は yyyy-MM-dd hh:mm:ss 形式で表示されます。

    2024-04-01 11:00:00
    SQLText

    string

    SQL ステートメント。

    SELECT * FROM my_table WHERE ROWNUM <= 10
    Psql

    string

    SQL テンプレート。

    SELECT * FROM my_table WHERE ROWNUM <= 10

    DBName

    string

    データベース名。

    test
    QueryTime

    integer

    クエリ実行時間。

    121
    ReturnItemNumbers

    string

    返されたアイテム数。

    test
    DocsExamined

    string

    ApsaraDB for MongoDB でスキャンされたドキュメント数。

    100
    KeysExamined

    string

    ApsaraDB for MongoDB でスキャンされたインデックスキーの数。

    valueA
    TableName

    string

    テーブル名。

    tableNameExample
    LockTime

    number

    ロック待機時間。

    100
    RowsExamined

    integer

    スキャンされた行数。

    100
    RowsSent

    integer

    クライアントに送信された行数。

    10
    ThreadId

    string

    スレッド ID。

    57472578
    Timestamp

    integer

    タイムスタンプ。

    1747118812
    SqlTag

    object

    タグ。

    SqlId

    string

    SQL ID。

    8ad7069f236bcdaaa9b3ae4b6299****
    Tags

    string

    タグ (カンマ区切り)。

    DAS_IMPORTANT,DAS_IN_PLAN
    Comments

    string

    コメント。

    test
    LockTimeSeconds

    number

    ロック待機時間 (秒単位)。

    100
    QueryTimeSeconds

    number

    クエリ実行時間 (秒単位)。

    100
    SqlType

    string

    SQL ステートメントのタイプ。

    • SELECT

    • UPDATE

    • DELETE

    SELECT
    CPUTime

    number

    クエリが消費した CPU 時間。

    説明

    このパラメーターは、ApsaraDB RDS for SQL Server インスタンスに対してのみ返されます。

    50
    IOWrites

    integer

    I/O 書き込み。

    説明

    このパラメーターは、ApsaraDB RDS for SQL Server インスタンスに対してのみ返されます。

    1
    LastRowsCountAffected

    integer

    最後のステートメントで影響を受けた行数。

    説明

    このパラメーターは、ApsaraDB RDS for SQL Server インスタンスに対してのみ返されます。

    10
    LogicalIOReads

    integer

    論理読み取り。

    説明

    このパラメーターは、ApsaraDB RDS for SQL Server インスタンスに対してのみ返されます。

    1
    PhysicalIOReads

    integer

    物理読み取り。

    説明

    このパラメーターは、ApsaraDB RDS for SQL Server インスタンスに対してのみ返されます。

    1
    RowsCountAffected

    integer

    影響を受けた行数。

    説明

    このパラメーターは、ApsaraDB RDS for SQL Server インスタンスに対してのみ返されます。

    10
    Command

    string

    実行された低速なコマンド。

    説明

    このパラメーターは、ApsaraDB for Tair インスタンスに対してのみ返されます。

    SELECT
    Namespace

    string

    名前空間。

    説明

    このパラメーターは、ApsaraDB for MongoDB インスタンスに対してのみ返されます。

    pro-test
    QueryId

    string

    クエリ ID。

    説明

    このパラメーターは、ApsaraDB for MongoDB インスタンスに対してのみ返されます。

    sq-1pzcdMwRb
    ReturnNum

    string

    返されたドキュメント数。

    説明

    このパラメーターは、ApsaraDB for MongoDB インスタンスに対してのみ返されます。

    20
    ApplicationName

    string

    アプリケーション名。

    説明

    このパラメーターは、ApsaraDB RDS for SQL Server インスタンスに対してのみ返されます。

    MyApp
    CPUTimeSeconds

    number

    クエリが消費した CPU 時間 (秒単位)。

    説明

    このパラメーターは、ApsaraDB RDS for SQL Server インスタンスに対してのみ返されます。

    100
    Rows

    integer

    コンピューティングノードが更新または返した行の総数。

    説明

    このパラメーターは、PolarDB-X 2.0 インスタンスに対してのみ返されます。

    20
    Frows

    integer

    コンピューティングノード (CN) が取得した行数。

    説明

    このパラメーターは、PolarDB-X 2.0 インスタンスに対してのみ返されます。

    10
    Scnt

    integer

    コンピューティングノード (CN) からデータノード (DN) に送信されたリクエストの数。

    説明

    このパラメーターは、PolarDB-X 2.0 インスタンスに対してのみ返されます。

    10
    TraceId

    string

    トレース ID (データノードにおける SQL ステートメントの実行 ID)。

    説明

    このパラメーターは、PolarDB-X 2.0 インスタンスに対してのみ返されます。

    074ce334-5247-40b9-b0c1-158aea5d****
    TemplateId

    string

    SQL テンプレート ID。

    説明

    このパラメーターは、PolarDB-X 2.0 インスタンスに対してのみ返されます。

    6a63b6ac4572abfaef7d1163f684****
    NodeId

    string

    Cmd

    string

    Rt

    integer

    RequestSize

    integer

    ResponseSize

    integer

    ClientIp

    string

    DbId

    string

    OriginTime

    string

    OpType

    string

    Fail

    string

    Params

    string

    Reason

    string

    ReqId

    string

    ExtText

    string

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "200",
  "Message": "Successful",
  "RequestId": "A1C79EE2-D04D-571B-8C60-961FAF8E****",
  "Success": "true",
  "Data": {
    "DbInstanceName": "rm-bp157g54vy772****",
    "NodeId": "node123",
    "ItemsNumbers": 10,
    "StartTime": "1672531200000",
    "EndTime": "1672617600000",
    "DbInstanceId": 100,
    "TotalRecords": 100,
    "PageNumbers": 1,
    "MaxRecordsPerPage": 20,
    "Logs": [
      {
        "SqlId": "sqlId",
        "Scheme": "HTTPS",
        "SubInstanceId": "r-8vb219d10038****",
        "DbInstanceName": "rm-2zebg30mk056g****",
        "InsName": "test",
        "AccountName": "user1",
        "HostAddress": "192.168.1.1",
        "QueryStartTime": "2024-04-01 11:00:00",
        "SQLText": "SELECT * FROM my_table WHERE ROWNUM <= 10",
        "Psql": "SELECT * FROM my_table WHERE ROWNUM <= 10\n",
        "DBName": "test",
        "QueryTime": 121,
        "ReturnItemNumbers": "test",
        "DocsExamined": "100",
        "KeysExamined": "valueA",
        "TableName": "tableNameExample",
        "LockTime": 100,
        "RowsExamined": 100,
        "RowsSent": 10,
        "ThreadId": "57472578",
        "Timestamp": 1747118812,
        "SqlTag": {
          "SqlId": "8ad7069f236bcdaaa9b3ae4b6299****",
          "Tags": "DAS_IMPORTANT,DAS_IN_PLAN",
          "Comments": "test"
        },
        "LockTimeSeconds": 100,
        "QueryTimeSeconds": 100,
        "SqlType": "SELECT",
        "CPUTime": 50,
        "IOWrites": 1,
        "LastRowsCountAffected": 10,
        "LogicalIOReads": 1,
        "PhysicalIOReads": 1,
        "RowsCountAffected": 10,
        "Command": "SELECT",
        "Namespace": "pro-test",
        "QueryId": "sq-1pzcdMwRb",
        "ReturnNum": "20",
        "ApplicationName": "MyApp",
        "CPUTimeSeconds": 100,
        "Rows": 20,
        "Frows": 10,
        "Scnt": 10,
        "TraceId": "074ce334-5247-40b9-b0c1-158aea5d****",
        "TemplateId": "6a63b6ac4572abfaef7d1163f684****",
        "NodeId": "",
        "Cmd": "",
        "Rt": 0,
        "RequestSize": 0,
        "ResponseSize": 0,
        "ClientIp": "",
        "DbId": "",
        "OriginTime": "",
        "OpType": "",
        "Fail": "",
        "Params": "",
        "Reason": "",
        "ReqId": "",
        "ExtText": ""
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

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

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

    変更履歴

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