すべてのプロダクト
Search

このプロダクト

    :DescribeSlowLogRecords

    ドキュメントセンター

    :DescribeSlowLogRecords

    最終更新日:Dec 12, 2025

    データベースインスタンスのスローログレコードをクエリします。さまざまな条件に基づいてレコードをフィルターおよびソートできます。

    操作説明

    • InstanceId パラメーターは必須です。このパラメーターは、インスタンスの ID を指定します。

    • StartTime および EndTime パラメーターは必須です。これらのパラメーターは、クエリの時間範囲を指定します。

    • PageNumber および PageSize パラメーターを設定して、結果をページ分割できます。

    • OrderBy パラメーターを使用して結果をソートできます。ソート可能なフィールドの詳細については、ドキュメントをご参照ください。

    • Filters パラメーターを使用して、ホストアドレスや SQL ID によるフィルタリングなど、クエリ条件を絞り込むことができます。
      重要 RDS for PostgreSQL や PolarDB for PostgreSQL などの一部のデータベースタイプは、特定のソートメソッドをサポートしていません。ご利用のデータベースタイプに基づいて適切なパラメーターを選択してください。

    今すぐお試しください

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

    任意

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

    10
    Filters

    array<object>

    任意

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

    object

    任意

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

    Key

    string

    任意

    フィルターキー。

    説明

    詳細については、「Key でサポートされるパラメーター」セクションをご参照ください。

    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、および RDS for SQL Server ではソートはサポートされていません。

    QueryTimeSeconds
    Asc

    boolean

    任意

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

    • true：結果は昇順でソートされます。

    • false：結果は降順でソートされます。

    true

    Key パラメーターでは、次の値がサポートされています：

    • 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 でデータをクエリできます。最大 20 個の sqlId 値をコンマで区切って指定できます。

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

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Code

    string

    HTTP ステータスコード。

    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 から始まります。デフォルト値は 1 です。

    1
    MaxRecordsPerPage

    integer

    1 ページあたりの最大エントリ数。有効な値：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

    クエリの開始時刻。時刻は `yyyy-MM-dd hh:mm:ss` 形式で、UTC です。

    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

    操作中にスキャンされたドキュメント数。このパラメーターは MongoDB インスタンスの場合にのみ返されます。

    100
    KeysExamined

    string

    スキャンされたインデックスエントリ数。このパラメーターは MongoDB インスタンスの場合にのみ返されます。

    valueA
    TableName

    string

    テーブル名。

    tableNameExample
    LockTime

    number

    ロック待ち時間。

    100
    RowsExamined

    integer

    スキャンされた行数。

    100
    RowsSent

    integer

    返された行数。

    10
    ThreadId

    string

    スレッド ID。

    57472578
    Timestamp

    integer

    UNIX タイムスタンプ。

    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 時間。

    説明

    このパラメーターは RDS for SQL Server インスタンスの場合にのみ返されます。

    50
    IOWrites

    integer

    I/O 書き込み数。

    説明

    このパラメーターは RDS for SQL Server インスタンスの場合にのみ返されます。

    1
    LastRowsCountAffected

    integer

    最後の文で影響を受けた行数。

    説明

    このパラメーターは RDS for SQL Server インスタンスの場合にのみ返されます。

    10
    LogicalIOReads

    integer

    論理読み取り数。

    説明

    このパラメーターは RDS for SQL Server インスタンスの場合にのみ返されます。

    1
    PhysicalIOReads

    integer

    物理読み取り数。

    説明

    このパラメーターは RDS for SQL Server インスタンスの場合にのみ返されます。

    1
    RowsCountAffected

    integer

    影響を受けた行数。

    説明

    このパラメーターは RDS for SQL Server インスタンスの場合にのみ返されます。

    10
    Command

    string

    スロークエリ文。

    説明

    このパラメーターは Tair インスタンスの場合にのみ返されます。

    SELECT
    Namespace

    string

    名前空間。

    説明

    このパラメーターは MongoDB インスタンスの場合にのみ返されます。

    pro-test
    QueryId

    string

    クエリ ID。

    説明

    このパラメーターは MongoDB インスタンスの場合にのみ返されます。

    sq-1pzcdMwRb
    ReturnNum

    string

    返された行数。

    説明

    このパラメーターは MongoDB インスタンスの場合にのみ返されます。

    20
    ApplicationName

    string

    アプリケーション名。

    説明

    このパラメーターは RDS for SQL Server インスタンスの場合にのみ返されます。

    MyApp
    CPUTimeSeconds

    number

    クエリによって消費された CPU 時間 (秒)。

    説明

    このパラメーターは RDS for SQL Server インスタンスの場合にのみ返されます。

    100
    Rows

    integer

    PolarDB-X 2.0 インスタンスの計算ノードによって更新または返された行の総数。

    説明

    このパラメーターは PolarDB-X 2.0 インスタンスの場合にのみ返されます。

    20
    Frows

    integer

    PolarDB-X 2.0 インスタンスの計算ノード (CN) によってプルされた行数。

    説明

    このパラメーターは PolarDB-X 2.0 インスタンスの場合にのみ返されます。

    10
    Scnt

    integer

    PolarDB-X 2.0 インスタンスの計算ノード (CN) からデータノード (DN) に送信されたリクエスト数。

    説明

    このパラメーターは PolarDB-X 2.0 インスタンスの場合にのみ返されます。

    10
    TraceId

    string

    PolarDB-X 2.0 インスタンスのトレース ID。トレース ID は、データノード上の SQL 文の実行 ID です。

    説明

    このパラメーターは PolarDB-X 2.0 インスタンスの場合にのみ返されます。

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

    string

    PolarDB-X 2.0 インスタンスのテンプレート ID。

    説明

    このパラメーターは PolarDB-X 2.0 インスタンスの場合にのみ返されます。

    6a63b6ac4572abfaef7d1163f684****
    NodeId

    string

    Cmd

    string

    Rt

    integer

    RequestSize

    integer

    ResponseSize

    integer

    ClientIp

    string

    DbId

    string

    OriginTime

    string

    OpType

    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": ""
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

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

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

    変更履歴

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