すべてのプロダクト
Search
ドキュメントセンター

:GetQueryOptimizeExecErrorStats

最終更新日:Dec 19, 2025

実行に失敗した SQL テンプレートを照会します。

操作説明

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

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

  • この操作は、次のデータベースエンジンをサポートしています:

    • ApsaraDB RDS for MySQL

    • PolarDB for MySQL

    • ApsaraDB RDS 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:GetQueryOptimizeExecErrorStats

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

Engine

string

必須

データベースエンジン。有効な値:

  • MySQL

  • PolarDBMySQL

  • PostgreSQL

MySQL

InstanceIds

string

任意

インスタンス ID。複数の ID はコンマ (,) で区切ります。

rm-2ze8g2am97624****

Keywords

string

任意

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

select update

LogicalOperator

string

任意

複数のキーワード間の論理関係。有効な値:

  • or

  • and

or

DbNames

string

任意

照会するデータベースの名前。

testdb01

Time

string

必須

照会する時間範囲。UNIX タイムスタンプ形式で時間を指定します。単位:ミリ秒。

1642953600000

PageSize

string

必須

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

10

PageNo

string

必須

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

1

OrderBy

string

任意

返されるエントリをソートするためのフィールド。失敗した実行回数に基づいてエントリをソートすることを指定する `error_count` のみがサポートされています。

error_count

Asc

string

任意

返されるエントリを昇順でソートするかどうかを指定します。デフォルト値:true。有効な値:

  • true:返されるエントリを昇順でソートします。

  • false:返されるエントリを昇順でソートしません。

true

Region

string

任意

インスタンスが存在するリージョン。有効な値:

  • cn-china:中国本土

  • cn-hongkong:中国 (香港)

  • ap-southeast-1:シンガポール

このパラメーターは、InstanceIds が空の場合にのみ有効になります。InstanceIds を空のままにすると、システムは Region で設定されたリージョンからデータを取得します。デフォルトでは、Region は cn-china に設定されています。InstanceIds を指定した場合、Region は有効にならず、システムは指定された最初のインスタンスが存在するリージョンからデータを取得します。****

説明

中国本土のリージョンで作成されたインスタンスの場合、このパラメーターを cn-china に設定します。

cn-china

レスポンスフィールド

フィールド

説明

object

Code

string

返される HTTP ステータスコード。

200

Message

string

返されたメッセージ。

Successful

Data

object

エラーコードや返されるエントリ数などの詳細情報。

Total

integer

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

19

PageNo

integer

ページ番号。

1

PageSize

integer

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

10

Extra

string

予約済みのパラメーター。

None

List

array<object>

実行に失敗した SQL テンプレートに関する情報。

object

InstanceId

string

インスタンス ID。

rm-2ze8g2am97624****

InstanceName

string

データベースインスタンスのエイリアス。

test01

Dbname

string

データベースの名前。

testdb01

SqlId

string

SQL テンプレート ID。

2e8147b5ca2dfc640dfd5e43d96a****

SqlText

string

SQL テンプレートのコンテンツ。

select * from test1

ErrorCode

string

リクエストが失敗した場合に返されるエラーコード。

1146

ErrorCount

integer

エラー数。

10

RequestId

string

リクエスト ID。

B6D17591-B48B-4D31-9CD6-9B9796B2****

Success

string

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

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

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

true

成功レスポンス

JSONJSON

{
  "Code": "200",
  "Message": "Successful",
  "Data": {
    "Total": 19,
    "PageNo": 1,
    "PageSize": 10,
    "Extra": "None",
    "List": [
      {
        "InstanceId": "rm-2ze8g2am97624****",
        "InstanceName": "test01",
        "Dbname": "testdb01",
        "SqlId": "2e8147b5ca2dfc640dfd5e43d96a****",
        "SqlText": "select * from test1",
        "ErrorCode": "1146",
        "ErrorCount": 10
      }
    ]
  },
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

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

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

変更履歴

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