すべてのプロダクト
Search

このプロダクト

    ApsaraDB for OceanBase (Deprecated):DescribeOasSQLHistoryList

    ドキュメントセンター

    ApsaraDB for OceanBase (Deprecated):DescribeOasSQLHistoryList

    最終更新日:May 26, 2026

    この API を呼び出すと、SQL 実行履歴を参照できます。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    oceanbase:DescribeOasSQLHistoryList

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    必須

    OceanBase クラスターの ID です。

    ob317v4uif****
    TenantId

    string

    必須

    テナントの ID です。

    t4louaeei****
    StartTime

    string

    必須

    SQL ステートメントの実行履歴の照会期間の開始時刻です。
    値は、YYYY-MM-DDThh:mm:ssZ フォーマットの UTC 時刻である必要があります。

    2023-04-12T04:38:38Z
    EndTime

    string

    必須

    SQL ステートメントの実行履歴の照会期間の終了時刻です。
    値は、YYYY-MM-DDThh:mm:ssZ フォーマットの UTC 時刻である必要があります。

    2023-04-12T05:38:38Z
    DbName

    string

    任意

    データベースの名前です。

    test_db
    SqlId

    string

    必須

    SQL ID です。

    8D6E84****0B8FB1823D199E2CA1****
    NodeIp

    string

    任意

    ノードの IP アドレスです。

    i-bp19y05uq6x*********
    AcceptLanguage

    string

    任意

    レスポンスの言語です。有効な値は次のとおりです。

    • zh：中国語

    • en：英語

    zh-CN
    DynamicSql

    boolean

    任意

    SQL ステートメントが動的であるかどうかを指定します。

    false

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    返されるレスポンス。

    RequestId

    string

    リクエスト ID。

    EE205C00-30E4-****-****-87E3A8A2AA0C
    Data

    array<object>

    SQL 実行履歴のリスト。

    object

    実行履歴に関する情報。

    SQLId

    string

    SQL ID。

    8D6E84****0B8FB1823D199E2CA1****
    DbName

    string

    データベース名。

    test_db
    AvgAffectedRows

    integer

    実行期間中の平均更新行数。

    9978.75
    AvgBlockCacheHit

    integer

    実行期間中の平均ブロックキャッシュヒット数。

    0.0
    AvgBlockIndexCacheHit

    integer

    実行期間中の平均ブロックインデックスキャッシュヒット数。

    0.0
    AvgBloomFilterCacheHit

    integer

    実行期間中の平均ブルームフィルターキャッシュヒット数。

    0.0
    Executions

    integer

    実行期間中の総実行回数。

    1
    FailCount

    integer

    実行期間中の総失敗数。

    0
    AvgRpcCount

    integer

    実行期間中の平均RPC送信数。

    8.0
    RemotePlans

    integer

    リモートプラン数。

    0
    MissPlans

    integer

    プランミス数。

    0
    AvgReturnRows

    integer

    実行期間中の平均返された行数。

    0.0
    AvgLogicalReads

    integer

    実行期間中の平均論理読み込み回数。

    0.0
    RetryCount

    integer

    実行期間中の総リトライ回数。

    0
    AvgRowCacheHit

    integer

    実行期間中の平均行キャッシュヒット数。

    0.0
    AvgDiskReads

    integer

    実行期間中の平均物理読み込み回数。

    0.0
    AvgMemstoreReadRows

    integer

    実行期間中の平均 MemStore 読み取り行数。

    0.0
    AvgSsstoreReadRows

    integer

    実行期間中の平均 SSStore 読み取り行数。

    0.0
    AvgApplicationWaitTime

    number

    クライアント待機期間中のアプリケーションイベントの平均待機時間 (ミリ秒)。

    0.0
    AvgElapsedTime

    number

    実行期間中の平均応答時間 (ミリ秒)。

    1876.78
    AvgExecuteTime

    number

    実行期間中の平均プラン実行時間 (ミリ秒)。

    1895.7
    AvgQueueTime

    number

    実行期間中の平均キュー時間 (ミリ秒)。

    0.01
    AvgConcurrencyWaitTime

    number

    実行期間中のコンカレンシーイベントの平均待機時間 (ミリ秒)。

    0.0
    AvgCpuTime

    number

    実行期間中の平均 CPU 時間 (ミリ秒)。

    1875.34
    AvgDecodeTime

    number

    実行期間中の平均構文解析時間 (ミリ秒)。

    0.0
    AvgNetWaitTime

    number

    ネットワーク待機期間中のネットワークエンキューの平均時間 (ミリ秒)。

    0.0
    AvgUserIoWaitTime

    number

    実行期間中のユーザー I/O イベントの平均待機時間 (ミリ秒)。

    0.0
    AvgGetPlanTime

    number

    実行期間中の平均プラン生成時間 (ミリ秒)。

    0.0
    MaxElapsedTime

    number

    最大応答時間。

    13643.3
    SumWaitTime

    number

    内部待機期間中の総待機時間 (ミリ秒)。

    9421.73
    AvgScheduleTime

    number

    スケジューリング期間中のスケジュールイベントの平均待機時間 (ミリ秒)。

    0.0
    MaxCpuTime

    number

    最大 CPU 時間。

    13641.9
    SumElapsedTime

    number

    実行期間中の総応答時間 (ミリ秒)。

    11452126.36
    Timestamp

    string

    サンプルのタイムスタンプ。

    2023-04-12T04:46:38Z
    Server

    string

    SQL が実行されたサーバー。

    i-bp1db1****8uemejio
    UserName

    string

    ユーザー名。

    test_user
    AvgPartitionCount

    number

    実行期間中にアクセスされたパーティションの平均数。

    1
    FailPercentage

    number

    実行期間中のエラー率。

    0
    RetCode4012Count

    number

    実行期間中のリターンコード 4012 の発生回数。

    0
    RetCode4013Count

    number

    実行期間中のリターンコード 4013 の発生回数。

    0
    RetCode5001Count

    number

    実行期間中のリターンコード 5001 の発生回数。

    0
    RetCode5024Count

    number

    実行期間中のリターンコード 5024 の発生回数。

    0
    RetCode5167Count

    number

    実行期間中のリターンコード 5167 の発生回数。

    0
    RetCode5217Count

    number

    実行期間中のリターンコード 5217 の発生回数。

    0
    RetCode6002Count

    number

    実行期間中のリターンコード 6002 の発生回数。

    0
    AvgWaitTime

    number

    実行期間中の平均待機時間 (ミリ秒)。

    1442.49
    AvgWaitCount

    number

    実行期間中の平均待機回数。

    0
    LocalPlanPercentage

    number

    実行期間中のローカルプランの割合。

    0
    RemotePlanPercentage

    number

    実行期間中のリモートプランの割合。

    0
    DistPlanPercentage

    number

    実行期間中の分散プランの割合。

    100
    AvgNetTime

    number

    実行期間中の平均ネットワーク転送時間 (ミリ秒)。

    8
    AvgExecutorRpcCount

    number

    実行期間中の平均RPCリクエスト実行数。

    0
    MissPlanPercentage

    number

    実行期間中のプランミス率。

    0
    TableScanPercentage

    number

    実行期間中のテーブルスキャンの割合。

    0
    StrongConsistencyPercentage

    number

    実行期間中の強い整合性トランザクションの割合。

    100
    WeakConsistencyPercentage

    number

    実行期間中の結果整合性トランザクションの割合。

    0
    MaxAffectedRows

    number

    実行期間中の最大更新行数。

    10000
    MaxReturnRows

    number

    実行期間中に返された行の最大数。

    0
    MaxWaitTime

    number

    実行期間中の最大待機時間 (ミリ秒)。

    3.4
    MaxApplicationWaitTime

    number

    実行期間中のアプリケーションイベントの最大待機時間 (ミリ秒)。

    0
    MaxConcurrencyWaitTime

    number

    実行期間中のコンカレンシーイベントの最大待機時間 (ミリ秒)。

    0
    MaxUserIoWaitTime

    number

    実行期間中のユーザー I/O イベントの最大待機時間 (ミリ秒)。

    0
    MaxDiskReads

    number

    実行期間中の最大物理読み込み回数。

    0
    AvgExpectedWorkerCount

    number

    実行期間中の平均並列度。

    3
    AvgUsedWorkerCount

    number

    実行期間中に SQL が使用したスレッドの平均数。

    3
    SumLogicalReads

    number

    総論理読み込み回数。

    0
    ExecPs

    number

    実行期間中の 1 秒あたりの平均実行回数。

    0.31
    AvgDbTime

    number

    平均 DB 時間 (ミリ秒)。

    100
    SumDbTime

    number

    総 DB 時間 (ミリ秒)。

    100
    WaitEvent

    string

    待機イベント。

    none

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
  "Data": [
    {
      "SQLId": "8D6E84****0B8FB1823D199E2CA1****",
      "DbName": "test_db",
      "AvgAffectedRows": 9978.75,
      "AvgBlockCacheHit": 0,
      "AvgBlockIndexCacheHit": 0,
      "AvgBloomFilterCacheHit": 0,
      "Executions": 1,
      "FailCount": 0,
      "AvgRpcCount": 8,
      "RemotePlans": 0,
      "MissPlans": 0,
      "AvgReturnRows": 0,
      "AvgLogicalReads": 0,
      "RetryCount": 0,
      "AvgRowCacheHit": 0,
      "AvgDiskReads": 0,
      "AvgMemstoreReadRows": 0,
      "AvgSsstoreReadRows": 0,
      "AvgApplicationWaitTime": 0,
      "AvgElapsedTime": 1876.78,
      "AvgExecuteTime": 1895.7,
      "AvgQueueTime": 0.01,
      "AvgConcurrencyWaitTime": 0,
      "AvgCpuTime": 1875.34,
      "AvgDecodeTime": 0,
      "AvgNetWaitTime": 0,
      "AvgUserIoWaitTime": 0,
      "AvgGetPlanTime": 0,
      "MaxElapsedTime": 13643.3,
      "SumWaitTime": 9421.73,
      "AvgScheduleTime": 0,
      "MaxCpuTime": 13641.9,
      "SumElapsedTime": 11452126.36,
      "Timestamp": "2023-04-12T04:46:38Z",
      "Server": "i-bp1db1****8uemejio",
      "UserName": "test_user",
      "AvgPartitionCount": 1,
      "FailPercentage": 0,
      "RetCode4012Count": 0,
      "RetCode4013Count": 0,
      "RetCode5001Count": 0,
      "RetCode5024Count": 0,
      "RetCode5167Count": 0,
      "RetCode5217Count": 0,
      "RetCode6002Count": 0,
      "AvgWaitTime": 1442.49,
      "AvgWaitCount": 0,
      "LocalPlanPercentage": 0,
      "RemotePlanPercentage": 0,
      "DistPlanPercentage": 100,
      "AvgNetTime": 8,
      "AvgExecutorRpcCount": 0,
      "MissPlanPercentage": 0,
      "TableScanPercentage": 0,
      "StrongConsistencyPercentage": 100,
      "WeakConsistencyPercentage": 0,
      "MaxAffectedRows": 10000,
      "MaxReturnRows": 0,
      "MaxWaitTime": 3.4,
      "MaxApplicationWaitTime": 0,
      "MaxConcurrencyWaitTime": 0,
      "MaxUserIoWaitTime": 0,
      "MaxDiskReads": 0,
      "AvgExpectedWorkerCount": 3,
      "AvgUsedWorkerCount": 3,
      "SumLogicalReads": 0,
      "ExecPs": 0.31,
      "AvgDbTime": 100,
      "SumDbTime": 100,
      "WaitEvent": "none"
    }
  ]
}

    エラーコード

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

    変更履歴

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