DescribeSlowLogRecords を呼び出してスロークエリログの詳細を取得 - AnalyticDB

AnalyticDB for MySQL クラスターのスロークエリログの詳細を照会します。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

adb:DescribeSlowLogRecords

get

*DBCluster

acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
DBClusterId	string	必須	AnalyticDB for MySQL データウェアハウスエディション (V3.0) クラスターの ID。説明 DescribeDBClusters 操作を呼び出して、ターゲットリージョン内のすべての AnalyticDB for MySQL データウェアハウスエディション (V3.0) クラスターの ID を照会できます。	am-bp1rqvm70uh2****
StartTime	string	必須	照会する時間範囲の開始時刻。 yyyy-MM-ddTHH:mm:ssZ 形式で時刻を指定します。時刻は UTC である必要があります。	2021-05-20T16:00:00Z
EndTime	string	必須	照会する時間範囲の終了時刻。 yyyy-MM-ddTHH:mm:ssZ 形式で時刻を指定します。時刻は UTC である必要があります。説明終了時刻は開始時刻より後である必要があります。開始時刻と終了時刻の間の時間範囲は 7 日を超えることはできません。	2021-05-27T16:00:00Z
DBName	string	任意	データベースの名前。	adb_demo
PageSize	integer	任意	各ページに返すエントリ数。有効値：30 (デフォルト)、50、100。	30
PageNumber	integer	任意	ページ番号。値は 0 より大きい整数である必要があります。デフォルト値：1。	1
ProcessID	string	任意	プロセス ID。	2021052716044317201616624903453******
Order	string	任意	結果のソート順。値は順序付けられた JSON 配列です。結果は、配列内のオブジェクトの順序でソートされます。各オブジェクトには `Field` と `Type` パラメーターが含まれます。例：`[{"Field":"ExecutionStartTime","Type":"Desc"},{"Field":"ScanRows","Type":"Asc"}]`。 `Field`：ソートの基準となるフィールド。有効値： HostAddress：データベースへの接続に使用されるクライアントの IP アドレス。 UserName：ユーザー名。 ExecutionStartTime：SQL 文の実行開始時刻。 QueryTime：SQL 文の実行時間。 PeakMemoryUsage：SQL 文の実行におけるピークメモリ使用量。 ScanRows：データソースからスキャンされた行数。 ScanSize：スキャンされたデータ量。 ScanTime：データのスキャンに費やされた合計時間。 PlanningTime：実行計画の生成に費やされた時間。 WallTime：各ノードのクエリ内のすべてのオペレーターによって消費された合計 CPU 時間。 ProcessID：プロセス ID。 `Type`：ソートの種類。有効値： Desc：降順。 Asc：昇順。	[{"Field":"ExecutionStartTime","Type":"Desc"},{"Field":"ScanRows","Type":"Asc"}]
Range	string	任意	フィールドの最大値 (`Max`) と最小値 (`Min`) に基づいて、指定された範囲で結果をフィルターします。値は JSON 配列です。例：`[{"Field":"ScanSize","Min":"1000000","Max":"10000000"},{"Field":"QueryTime","Min":"1000","Max":"10000"}]`。 `Field` パラメーターは、フィルターするフィールドを指定します。有効値： ScanSize：スキャンされたデータ量。単位：KB。 QueryTime：実行時間。単位：ミリ秒 (ms)。 PeakMemoryUsage：SQL 文の実行におけるピークメモリ使用量。単位：KB。説明 `Min` はクエリ範囲の最小値 (左オペランド) を指定します。 `Max` はクエリ範囲の最大値 (右オペランド) を指定します。両方のパラメーターのデータの型は文字列です。	[{"Field":"ScanSize","Min":"1000000","Max":"10000000"},{"Field":"QueryTime","Min":"1000","Max":"10000"}]
State	string	任意	クエリの状態。有効値： Successed：クエリは成功しました。 Failed：クエリは失敗しました。	Successed

レスポンスフィールド

フィールド	型	説明	例
	object	パラメーターのリスト。
TotalCount	string	エントリの総数。	100
PageSize	string	現在のページのエントリ数。	30
RequestId	string	リクエスト ID。	D7559209-7EC3-41E1-8F78-156990******
PageNumber	string	ページ番号。	1
DBClusterId	string	AnalyticDB for MySQL データウェアハウスエディション (V3.0) クラスターの ID。	am-bp1rqvm70uh2****
Items	object
SlowLogRecord	array<object>	スロークエリログの詳細のリスト。
	object	パラメーターのリスト。
HostAddress	string	データベースへの接続に使用されるクライアントの IP アドレス。	172.16..
ScanTime	integer	データのスキャンに費やされた合計時間。この値は、すべてのノードの TableScanNode タスクによって消費された時間の合計です。単位：ミリ秒 (ms)。	10
SQLText	string	SQL 文の詳細。	INSERT OVERWRITE INTO hdfs_import_external\nSELECT *\nFROM adb_hdfs_import_source
OutputSize	string	タスクによって生成された出力データ量。単位：バイト。	0.009
PeakMemoryUsage	string	SQL 文の実行におけるピークメモリ使用量。単位：KB。	431.447
State	string	SQL 文の実行状態。	SUCCESSED
WallTime	integer	すべてのノードのクエリ内のすべてのオペレーターによって消費された合計 CPU 時間。単位：ミリ秒 (ms)。	6100
ScanSize	string	スキャンされたデータ量。単位：KB。	0.035
ExecutionStartTime	string	実行の開始時刻。時刻は yyyy-MM-ddTHH:mm:ssZ 形式です。時刻は UTC で表示されます。	2021-05-27T08:04:43Z
QueryTime	integer	SQL 文の実行時間。単位：ミリ秒 (ms)。	2344
ReturnRowCounts	integer	返された行数。	1
ScanRows	integer	データソースからスキャンされた行数。	3
ParseRowCounts	integer	解析された行数。	0
DBName	string	データベースの名前。	adb_demo
PlanningTime	integer	実行計画の生成に費やされた時間。単位：ミリ秒 (ms)。	12
QueueTime	integer	クエリが実行前にキューで待機した時間。単位：ミリ秒 (ms)。	0
UserName	string	ユーザー名。	test
ProcessID	string	プロセス ID。	2021052716044317201616624903453******

例

成功レスポンス

JSONJSON

{
  "TotalCount": "100",
  "PageSize": "30",
  "RequestId": "D7559209-7EC3-41E1-8F78-156990******",
  "PageNumber": "1",
  "DBClusterId": "am-bp1rqvm70uh2****",
  "Items": {
    "SlowLogRecord": [
      {
        "HostAddress": "172.16.**.**",
        "ScanTime": 10,
        "SQLText": "INSERT OVERWRITE INTO hdfs_import_external\\nSELECT *\\nFROM adb_hdfs_import_source",
        "OutputSize": "0.009",
        "PeakMemoryUsage": "431.447",
        "State": "SUCCESSED",
        "WallTime": 6100,
        "ScanSize": "0.035",
        "ExecutionStartTime": "2021-05-27T08:04:43Z",
        "QueryTime": 2344,
        "ReturnRowCounts": 1,
        "ScanRows": 3,
        "ParseRowCounts": 0,
        "DBName": "adb_demo",
        "PlanningTime": 12,
        "QueueTime": 0,
        "UserName": "test",
        "ProcessID": "2021052716044317201616624903453******"
      }
    ]
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	The DBClusterId provided does not exist in our records.

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

変更履歴

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