すべてのプロダクト
Search

このプロダクト

    Database Autonomy Service:DescribeSqlLogRecords

    ドキュメントセンター

    Database Autonomy Service:DescribeSqlLogRecords

    最終更新日:Apr 08, 2026

    DescribeSqlLogRecords を呼び出して、DAS Enterprise Edition のログ詳細を照会します。

    操作説明

    この操作を呼び出す前に、次の点にご注意ください。

    • Alibaba Cloud または Database Autonomy Service (DAS) SDK を使用する場合は、最新バージョンを使用することを推奨します。

    • SDK を使用して DAS サービスを呼び出す場合は、リージョンを cn-shanghai に設定する必要があります。

    今すぐお試しください

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

    list

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    必須

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

    pc-2ze8g2am97624****

    NodeId

    string

    任意

    ノード ID。

    • このパラメーターは、ApsaraDB RDS for MySQL および PolarDB for MySQL クラスターインスタンスにのみ適用されます。このパラメーターを省略した場合、デフォルトでプライマリノードのログ詳細が返されます。

    • PolarDB-X 2.0 の場合、このパラメーターを polarx_cn (コンピュートノード) または polarx_dn (データノード) に設定します。

    pi-uf6k5f6g3912i****
    Role

    string

    任意

    PolarDB-X 2.0 データベースインスタンスにおけるノードのロール。

    • polarx_cn：コンピュートノード。

    • polarx_dn：データノード。

    polarx_cn

    Filters

    array<object>

    任意

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

    object

    任意

    フィルター条件。

    Key

    string

    任意

    フィルターキー。

    説明

    サポートされているフィルターキーとその値の詳細については、「リクエストパラメーターに関する追加情報」をご参照ください。

    keyWords
    Value

    string

    任意

    フィルター値。

    select
    StartTime

    integer

    任意

    照会する時間範囲の開始時刻。これは、1970 年 1 月 1 日 00:00:00 (協定世界時) から経過したミリ秒数を表す UNIX タイムスタンプです。

    1596177993000
    EndTime

    integer

    任意

    照会する時間範囲の終了時刻。これは、1970 年 1 月 1 日 00:00:00 (協定世界時) から経過したミリ秒数を表す UNIX タイムスタンプです。

    1608888296000
    PageNo

    integer

    任意

    ページ番号。ページは 1 から始まります。デフォルト値：1。

    1
    PageSize

    integer

    任意

    1 ページあたりのエントリ数。最大値：100。デフォルト値：10。

    10

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

    • KeyWords：クエリのキーワード。複数のキーワードはスペースで区切ります。

    • LogicalOperator：キーワードを接続する論理演算子。有効な値：and および or。

    • AccountName：データベースのユーザー名。最大 5 つのユーザー名をコンマで区切って指定できます。

    • dbName：データベース名。最大 5 つのデータベース名をコンマで区切って指定できます。

    • HostAddress：クライアント IP アドレス。最大 5 つの IP アドレスをコンマで区切って指定できます。

    • MaxConsume：最大実行時間 (マイクロ秒)。

    • MinConsume：最小実行時間 (マイクロ秒)。

    • MaxScanRows：スキャンされた行の最大数。

    • MinScanRows：スキャンされた行の最小数。

    • SqlType：SQL タイプ。有効な値：select、update、insert、delete。

    • State：実行状態。有効な値：0 (成功) および 1 (失敗)。

    • ThreadId：スレッド ID。

    • SortKey：ソートキー。有効な値：ScanRows (スキャンされた行数)、UpdateRows (更新された行数)、Consume (実行時間)、ExecuteTime (実行時刻)、ReturnRows (返された行数)、LockTime (ロック待ち時間)、Frows (コンピュートノード (CN) によってプルされた行数)、Scnt (CN からデータノード (DN) へのリクエスト数)、CpuTime (CPU 実行時間)、PhysicalRead (物理読み込み)。

    • SortMethod：ソート順。有効な値：DESC (降順) および ASC (昇順)。デフォルト値：DESC。

    • TraceId：トレース ID。

    • MinRows：更新された行の最小数。

    • MaxRows：更新された行の最大数。

    • MinScnt：CN から DN へのリクエストの最小数。

    • MaxScnt：CN から DN へのリクエストの最大数。

    • TrxId：トランザクション ID。

    • Fail：エラーコード。

    • SqlId：SQL ID。

    • JobId：非同期タスク ID。この ID を使用して、タスクの実行結果を照会します。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    ルートノード。

    Code

    string

    HTTP ステータスコード。

    200
    Message

    string

    返されたメッセージ。

    説明

    リクエストが成功した場合、Successful が返されます。それ以外の場合は、エラーメッセージが返されます。

    Successful
    RequestId

    string

    リクエスト ID。

    F43E7FB3-CE67-5FFD-A59C-EFD278BCD7BE
    Success

    string

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

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

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

    true
    Data

    object

    返されたデータ。

    StartTime

    integer

    クエリの開始時刻。この値は UNIX タイムスタンプです。単位：ミリ秒。

    1596177993000
    EndTime

    integer

    クエリの終了時刻。この値は UNIX タイムスタンプです。単位：ミリ秒。

    1608888296000
    TotalRecords

    integer

    返されたエントリの総数。

    1
    Items

    object

    SQL ログの詳細。

    SQLLogRecord

    array<object>

    SQL ログデータ。

    object

    SQL ログデータ。

    Ext

    string

    拡張情報。このパラメーターは予約済みです。

    None
    ExecuteTime

    string

    実行時刻。時刻は協定世界時 (UTC) です。フォーマット：yyyy-MM-ddTHH:mm:ssZ。

    2023-12-07T02:15:32Z
    OriginTime

    integer

    実行時刻。この値は UNIX タイムスタンプです。単位：ミリ秒。

    1701886532000
    HostAddress

    string

    クライアント IP アドレス。

    11.197.XX.XX
    UpdateRows

    integer

    更新された行数。

    0
    LogicRead

    integer

    論理読み込みの数。

    0
    SqlText

    string

    SQL ステートメント。

    select resource_id as cluster_id, tpl_name \n\tfrom dbfree_alert_resource_tpl_ref\n\twhere user_id=? and type='cluster' group by resource_id, tpl_name
    LockTime

    integer

    ロック待ち時間。単位：ミリ秒。

    0
    ScanRows

    integer

    スキャンされた行数。

    0
    ThreadId

    integer

    スレッド ID。

    None
    State

    string

    実行状態。有効な値：

    • 0：実行は成功しました。

    • 1：実行は失敗しました。

    0
    DBName

    string

    データベース名。

    testdb
    SqlType

    string

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

    select
    AccountName

    string

    データベースアカウント。

    testname
    PhysicSyncRead

    integer

    同期物理読み込みの数。

    0
    PhysicAsyncRead

    integer

    非同期物理読み込みの数。

    0
    TrxId

    string

    トランザクション ID。

    200000
    ReturnRows

    integer

    返された行数。

    0
    Consume

    integer

    実行時間。単位：マイクロ秒 (μs)。

    58
    Vip

    string

    クエリ接続文字列から解決されるエンドポイント。

    100.115.XX.XX
    NodeId

    string

    ノード ID。

    pi-uf6k5f6g3912i****
    SqlId

    string

    SQL ID。

    c67649d4a7fb62c4f8c7a447c52b5b17
    UseImciEngine

    string

    PolarDB for MySQL インスタンスでインメモリ列指向インデックス (IMCI) が使用されているかどうかを示します。

    • true

    • false

    true
    ParallelQueueTime

    string

    PolarDB for MySQL インスタンスの並列キュー時間。単位：ミリ秒。

    2
    ParallelDegree

    string

    PolarDB for MySQL インスタンスの並列処理の次数 (DOP)。

    10
    Scnt

    integer

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

    10
    Rows

    integer

    PolarDB-X 2.0 インスタンスのコンピュートノード (CN) によって更新または返された行の総数。

    10
    Frows

    integer

    PolarDB-X 2.0 インスタンスのコンピュートノード (CN) によってフェッチされた行数。

    10
    TraceId

    string

    PolarDB-X 2.0 インスタンスのトレース ID。これは、データノード (DN) で実行された SQL ステートメントの ID です。

    14c93b7c7bf00000

    PhysicRead

    integer

    物理読み込みの数。

    0
    CpuTime

    integer

    CPU 実行時間。単位：マイクロ秒 (μs)。

    100
    Writes

    integer

    ApsaraDB RDS for SQL Server インスタンスでの書き込み操作の数。

    10
    Collection

    string

    このパラメーターは予約済みです。

    None
    TableName

    string

    SQL ステートメントが参照するテーブルの名前。

    das
    ConnectionId

    string

    接続 ID。

    ld-******
    Protocol

    string

    プロトコルタイプ。

    MySQL
    Params

    string

    SQL パラメーター。

    [1, "das"]
    ClientIp

    string

    クライアント IP アドレス。

    10.0.0.1xx
    ClientPort

    integer

    クライアントポート。

    3306
    RowKey

    string

    SQL ログレコードの行キー。

    23
    AffectColumns

    string

    影響を受ける列。

    ["col1"]
    Finish

    string

    タスクが完了したかどうかを示します。有効な値：

    • 0：タスクは進行中です。

    • 1：タスクは完了しました。

    説明

    このパラメーターが 0 で、JobId パラメーターが返された場合、現在のリクエストは非同期リクエストであり、返された結果を取得できません。JobId の値を使用して別のリクエストを開始する必要があります。Filters パラメーターを JobId の値に設定します。例：Filters=[{"Key": "JobId", "Value": "******"}]。

    1
    JobId

    string

    非同期タスク ID。

    MzI4NTZfUUlOR0RBT19DTTlfTlUyMF9NWVNRTF9PREJTX0xWU18zMjg1Nl9teXNxbF9XZWQgTWFyIDA2IDE0OjUwOjQ3IENTVCAyMDI0XzBfMzBfRXhlY3V0ZVRpbWVfREVTQ19XZWQgTWFyIDA2IDE0OjM1OjQ3IENTVCAyMDI0Xw==_1709708406465

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "200",
  "Message": "Successful",
  "RequestId": "F43E7FB3-CE67-5FFD-A59C-EFD278BCD7BE",
  "Success": "true",
  "Data": {
    "StartTime": 1596177993000,
    "EndTime": 1608888296000,
    "TotalRecords": 1,
    "Items": {
      "SQLLogRecord": [
        {
          "Ext": "None",
          "ExecuteTime": "2023-12-07T02:15:32Z",
          "OriginTime": 1701886532000,
          "HostAddress": "11.197.XX.XX",
          "UpdateRows": 0,
          "LogicRead": 0,
          "SqlText": "select resource_id as cluster_id, tpl_name \\n\\tfrom dbfree_alert_resource_tpl_ref\\n\\twhere user_id=? and type='cluster' group by resource_id, tpl_name",
          "LockTime": 0,
          "ScanRows": 0,
          "ThreadId": 0,
          "State": "0",
          "DBName": "testdb",
          "SqlType": "select",
          "AccountName": "testname",
          "PhysicSyncRead": 0,
          "PhysicAsyncRead": 0,
          "TrxId": "200000",
          "ReturnRows": 0,
          "Consume": 58,
          "Vip": "100.115.XX.XX",
          "NodeId": "pi-uf6k5f6g3912i****",
          "SqlId": "c67649d4a7fb62c4f8c7a447c52b5b17",
          "UseImciEngine": "true",
          "ParallelQueueTime": "2",
          "ParallelDegree": "10",
          "Scnt": 10,
          "Rows": 10,
          "Frows": 10,
          "TraceId": "14c93b7c7bf00000 ",
          "PhysicRead": 0,
          "CpuTime": 100,
          "Writes": 10,
          "Collection": "None",
          "TableName": "das",
          "ConnectionId": "ld-******",
          "Protocol": "MySQL",
          "Params": "[1, \"das\"]",
          "ClientIp": "10.0.0.1xx",
          "ClientPort": 3306,
          "RowKey": "23",
          "AffectColumns": "[\"col1\"]"
        }
      ]
    },
    "Finish": "1",
    "JobId": "MzI4NTZfUUlOR0RBT19DTTlfTlUyMF9NWVNRTF9PREJTX0xWU18zMjg1Nl9teXNxbF9XZWQgTWFyIDA2IDE0OjUwOjQ3IENTVCAyMDI0XzBfMzBfRXhlY3V0ZVRpbWVfREVTQ19XZWQgTWFyIDA2IDE0OjM1OjQ3IENTVCAyMDI0Xw==_1709708406465"
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

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

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

    変更履歴

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