DescribeSlowLogHistogramAsync API 概要 - Database Autonomy Service - Alibaba Cloud - Database Autonomy Service

インスタンスのスロークエリログの傾向データを非同期で取得します。

操作説明

この操作を使用する前に、DAS の課金方法と料金を十分に理解していることを確認してください。

開始する前に:

リクエストされたインスタンスで DAS Enterprise Edition または Alibaba Cloud マネージドサービス (まだオンラインではありません) が有効になっていること。
Alibaba Cloud SDK または DAS SDK を使用する場合は、最新バージョンを使用してください。
SDK を使用して DAS を呼び出す場合は、リージョンを cn-shanghai にセットしてください。

この操作は非同期呼び出しを使用するため、完全な結果がすぐに返されるわけではありません。応答内の isFinish の値が false の場合は、1 秒待ってから再度操作を呼び出してください。isFinish の値が true になれば、完全な結果が返されたことを示します。

今すぐお試しください

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

get

*すべてのリソース。

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
InstanceId	string	必須	データベースインスタンスの ID。	rm-2ze8g2am97624****
NodeId	string	任意	ノードの ID。説明 PolarDB for MySQL インスタンスの場合は、ノード ID を指定してください。	r-****-db-0
StartTime	integer	必須	クエリの開始時刻。UNIX タイムスタンプをミリ秒単位で指定します。	1596177993000
EndTime	integer	必須	クエリの終了時刻。UNIX タイムスタンプをミリ秒単位で指定します。説明終了時刻は開始時刻より後である必要があります。	1662518540764
Filters	array<object>	任意	クエリフィルター条件のリスト。
	object	任意	Key でサポートされているパラメーターと値: hostAddress: ソースアドレス。複数の値はカンマ (,) で区切ります。 sqlId: SQL ID。複数の値はカンマ (,) で区切ります。 user: ユーザー名。複数の値はカンマ (,) で区切ります。 dbName: データベース名。複数の値はカンマ (,) で区切ります。
Key	string	任意	フィルターパラメーター。	None
Value	string	任意	フィルターパラメーターの値。	None

レスポンスフィールド

フィールド	型	説明	例
	object
Code	string	返される状態コード。	200
Message	string	リクエストに対して返されるメッセージ。説明リクエストが成功した場合、このパラメーターは Successful を返します。リクエストが失敗した場合、例外メッセージ（エラーコードなど）が返されます。	Successful
RequestId	string	リクエスト ID。	B6D17591-B48B-4D31-9CD6-9B9796B2****
Success	string	リクエストが成功したかどうかを示します。 true: リクエストが成功しました。 false: リクエストが失敗しました。	true
Data	object	AsyncResult。
RequestKey	string	リクエストパラメーターのキー。	None
ResultId	string	結果の ID。	async__20ee808e72257f16a4fe024057ca****
State	string	現在の状態。有効な値: RUNNING: 実行中。 SUCCESS: 成功。 FAIL: 失敗。	SUCCESS
IsFinish	boolean	タスクが完了しているかどうかを示します。	true
Data	object	データ。
Total	integer	照会されたレコードの総数。	1
Count	array	スロークエリログ数の推移。
	integer	スロークエリログの数。	100
Ts	array	リレーショナルデータベース専用。
	integer	最初のイベントが発生した時間（UNIX タイムスタンプ）。単位: ミリ秒。	[ 1735098480000, 1735098540000, 1735098600000, 1735098660000, 1735098720000, 1735098780000 ]
TsEnd	array	未使用。予約フィールド。
	integer	クエリの終了タイムスタンプ。	None
Item	array<object>	推移メトリクス。
	array<object>	特定の項目名。
NodeId	string	ノードの ID。	r-bp1hi0wg57s3n0i3n8-db-0
Count	array	スロークエリログの数。
	integer	スロークエリログの数。	100
InsItems	array<object>	推移メトリクス。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
	object	推移メトリクス。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
InsId	string	インスタンスロールの ID。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。	2492
InsRole	string	インスタンスロール。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。	userAdmin
Count	array	実行回数。
	integer	実行回数。	1
TotalCount	integer	物理ノード上のスロークエリログの数。	10
TotalCount	integer	スロークエリログの総数。	20
InsRole	string	インスタンスロール。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
Rt	array	合計実行時間。単位: 秒。
	number	合計実行時間。単位: 秒。	[ 2.306, 1.141, 0.0, 4.538, 1.247, 1.972 ]
AvgRt	array	平均実行時間。
	number	平均実行時間。	[ 1.593, 2.306, 1.141, 0.0, 1.5127, 1.247 ]
MaxRt	array	最大実行時間。単位: 秒。
	number	最大実行時間。単位: 秒。	[ 1.593, 2.306, 1.141, 14.115 0.0, 1.972 ]
LockTime	array	合計ロック待ち時間。単位: 秒。
	number	合計ロック待ち時間。単位: 秒。	[ 1.051, 1.007, 0.0, 0.755, 0.096, 0.0 ]
AvgLockTime	array	平均ロック待ち時間。単位: 秒。
	number	平均ロック待ち時間。単位: 秒。	[ 1.051, 0.0, 0.3357, 0.755, 0.324, 0.814 ]
MaxLockTime	array	最大値のロック待ち時間。単位: 秒。
	number	最大値のロック待ち時間。単位: 秒。	[ 1.051, 1.007, 0.755, 0.0, 0.05, 0.656 ]
RowsExamined	array	スキャンされた行の総数。説明現在このフィールドをサポートしているデータベース: ApsaraDB RDS for MySQL、ApsaraDB RDS for PostgreSQL、PolarDB for MySQL。
	integer	スキャンされた行の総数。説明現在このフィールドをサポートしているデータベース: ApsaraDB RDS for MySQL、ApsaraDB RDS for PostgreSQL、PolarDB for MySQL。	[ 256, 1, 512, 0, 1476678, 24430 ]
AvgRowsExamined	array	スキャンされた行の平均数。
	number	スキャンされた行の平均数。	[ 256.0, 256.3333, 512.0, 370860.1111, 0.0, 1.0 ]
MaxRowsExamined	array	スキャンされた行の最大値。
	integer	スキャンされた行の最大値。	[ 256, 1, 512, 0, 1476678, 24430 ]
RowsSent	array	返された行数。
	integer	返された行数。	[ 384, 256, 0, 207030, 4, 256 ]
AvgRowsSent	array	返された行の平均数。
	number	返された行の平均数。	[ 128.0, 0.0, 256.0, 25878.75, 192.0, 72.7778 ]
MaxRowsSent	array	返された行の最大値。
	integer	返された行の最大値。	[ 256, 207023, 0, 128, 0, 0 ]
KeysExamined	array	スキャンされたインデックス行数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
	integer	スキャンされたインデックス行数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。	[ 384, 256, 0, 207030, 4, 256 ]
AvgKeysExamined	array	スキャンされたインデックス行の平均数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
	number	スキャンされたインデックス行の平均数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。	[ 128.0, 0.0, 256.0, 25878.75, 192.0, 72.7778 ]
MaxKeysExamined	array	スキャンされたインデックス行の最大値。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
	integer	スキャンされたインデックス行の最大値。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。	[ 384, 256, 0, 207030, 4, 256 ]
DocExamined	array	スキャンされたドキュメント行数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
	integer	スキャンされたドキュメント行数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。	[ 256, 207023, 0, 128, 0, 0 ]
AvgDocExamined	array	スキャンされたドキュメント行の平均数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
	number	スキャンされたドキュメント行の平均数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。	[ 128.0, 0.0, 256.0, 25878.75, 192.0, 72.7778 ]
MaxDocExamined	array	スキャンされたドキュメント行の最大値。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
	integer	スキャンされたドキュメント行の最大値。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。	[ 256, 207023, 0, 128, 0, 0 ]
ReturnNum	array	返された行数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
	integer	返された行数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。	[ 256, 207023, 0, 128, 0, 0 ]
AvgReturnNum	array	返された行の平均数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
	number	返された行の平均数。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。	[ 128.0, 0.0, 256.0, 25878.75, 192.0, 72.7778 ]
MaxReturnNum	array	返された行数の最大値。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。
	integer	返された行数の最大値。説明 ApsaraDB for MongoDB インスタンスのみでサポートされています。	[ 256, 207023, 0, 128, 0, 0 ]
IOWrites	array	I/O 書き込み回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	integer	I/O 書き込み回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 256, 207023, 0, 128, 0, 0 ]
AvgIOWrites	array	I/O 書き込みの平均回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	number	I/O 書き込みの平均回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 384, 256, 0, 207030, 4, 256 ]
MaxIOWrites	array	I/O 書き込み回数の最大値。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	integer	I/O 書き込み回数の最大値。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 256, 1, 512, 0, 1476678, 24430 ]
LastRowsCountAffected	array	最後の文によって影響を受けた行数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	integer	最後の文によって影響を受けた行数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 256, 207023, 0, 128, 0, 0 ]
AvgLastRowsCountAffected	array	最後の文によって影響を受けた平均行数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	number	最後の文によって影響を受けた平均行数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 1.593, 2.306, 1.141, 0.0, 1.5127, 1.247 ]
MaxLastRowsCountAffected	array	最後の文によって影響を受けた行数の最大値。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	integer	最後の文によって影響を受けた平均行数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 1, 1, 3, 1, 2, 3 ]
LogicalIOReads	array	論理読み込み回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	integer	論理読み込み回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 384, 256, 0, 207030, 4, 256 ]
AvgLogicalIOReads	array	論理読み込みの平均回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	number	論理読み込みの平均回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 1.593, 2.306, 1.141, 0.0, 1.5127, 1.247 ]
MaxLogicalIOReads	array	論理読み込み回数の最大値。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	integer	論理読み込み回数の最大値。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 124, 2, 24, 251, 191, 721 ]
PhysicalIOReads	array	物理読み込み回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	integer	物理読み込み回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 324, 22, 254, 251, 191, 721 ]
AvgPhysicalIOReads	array	物理読み込みの平均回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	number	物理読み込みの平均回数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 128.0, 0.0, 256.0, 25878.75, 192.0, 72.7778 ]
MaxPhysicalIOReads	array	物理読み込み回数の最大値。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	integer	物理読み込み回数の最大値。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 314, 242, 114, 351, 191, 721 ]
RowsCountAffected	array	影響を受けた行数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	integer	影響を受けた行数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 34, 42, 14, 51, 91, 71 ]
AvgRowsCountAffected	array	影響を受けた平均行数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	number	影響を受けた平均行数。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 1.593, 2.306, 1.141, 14.115, 0.0, 1.783, 0.0, 1.972 ]
MaxRowsCountAffected	array	影響を受けた行数の最大値。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	integer	影響を受けた行数の最大値。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 714, 442, 314, 151, 291, 521 ]
CPUTime	array	CPU 処理の持続時間。単位: 秒 (s)。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	number	CPU 処理の持続時間。単位: 秒 (s)。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 1.051, 1.007, 0.755, 0.0, 0.05, 0.656 ]
AvgCPUTime	array	CPU の平均処理持続時間。単位: 秒 (s)。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	number	CPU の平均処理持続時間。単位: 秒 (s)。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 2.306, 1.141, 0.0, 4.538, 1.247, 0.0 ]
MaxCPUTime	array	CPU 処理持続時間の最大値。単位: 秒 (s)。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。
	number	CPU 処理持続時間の最大値。単位: 秒 (s)。説明 ApsaraDB RDS for SQL Server インスタンスのみでサポートされています。	[ 2.306, 1.141, 0.0, 4.538, 1.247, 0.0 ]
Rows	array	PolarDB-X 2.0 データベースインスタンスのコンピュートノードによって更新または返された行の総数。説明 ApsaraDB PolarDB-X 2.0 インスタンスのみでサポートされています。
	integer	PolarDB-X 2.0 データベースインスタンスのコンピュートノードによって更新または返された行の総数。説明 ApsaraDB PolarDB-X 2.0 インスタンスのみでサポートされています。	[]
AvgRows	array	行数の平均値。
	number	行数の平均値。
MaxRows	array	行数の最大値。
	integer	行数の最大値。
Frows	array	PolarDB-X 2.0 データベースインスタンスのコンピュートノード (CN) によってフェッチされた行数。説明 ApsaraDB PolarDB-X 2.0 インスタンスのみでサポートされています。
	integer	PolarDB-X 2.0 データベースインスタンスのコンピュートノード (CN) によってフェッチされた行数。説明 ApsaraDB PolarDB-X 2.0 インスタンスのみでサポートされています。
AvgFrows	array	フェッチされた行数の平均値。
	number	フェッチされた行数の平均値。
MaxFrows	array	フェッチされた行数の最大値。
	integer	フェッチされた行数の最大値。
Scnt	array	PolarDB-X 2.0 データベースインスタンスのコンピュートノード (CN) からの DN リクエスト数。説明 ApsaraDB PolarDB-X 2.0 インスタンスのみでサポートされています。
	integer	PolarDB-X 2.0 データベースインスタンスのコンピュートノード (CN) からの DN リクエスト数。説明 ApsaraDB PolarDB-X 2.0 インスタンスのみでサポートされています。
AvgScnt	array	リクエスト数の平均値。
	number	リクエスト数の平均値。
MaxScnt	array	リクエスト数の最大値。
	integer	リクエスト数の最大値。
TotalCount	integer	スロークエリログの総数。	5
ErrorCode	integer	エラーコード。	10910
Message	string	エラーメッセージ。	Successful
Timestamp	integer	リクエスト時刻。	1645668213000

例

成功レスポンス

JSONJSON

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true",
  "Data": {
    "RequestKey": "无",
    "ResultId": "async__20ee808e72257f16a4fe024057ca****",
    "State": "SUCCESS",
    "IsFinish": true,
    "Data": {
      "Total": 1,
      "Count": [
        100
      ],
      "Ts": [
        0
      ],
      "TsEnd": [
        0
      ],
      "Item": [
        {
          "NodeId": "r-bp1hi0wg57s3n0i3n8-db-0",
          "Count": [
            100
          ],
          "InsItems": [
            {
              "InsId": "2492",
              "InsRole": "userAdmin",
              "Count": [
                1
              ],
              "TotalCount": 10
            }
          ],
          "TotalCount": 20,
          "InsRole": ""
        }
      ],
      "Rt": [
        0
      ],
      "AvgRt": [
        0
      ],
      "MaxRt": [
        0
      ],
      "LockTime": [
        0
      ],
      "AvgLockTime": [
        0
      ],
      "MaxLockTime": [
        0
      ],
      "RowsExamined": [
        0
      ],
      "AvgRowsExamined": [
        0
      ],
      "MaxRowsExamined": [
        0
      ],
      "RowsSent": [
        0
      ],
      "AvgRowsSent": [
        0
      ],
      "MaxRowsSent": [
        0
      ],
      "KeysExamined": [
        0
      ],
      "AvgKeysExamined": [
        0
      ],
      "MaxKeysExamined": [
        0
      ],
      "DocExamined": [
        0
      ],
      "AvgDocExamined": [
        0
      ],
      "MaxDocExamined": [
        0
      ],
      "ReturnNum": [
        0
      ],
      "AvgReturnNum": [
        0
      ],
      "MaxReturnNum": [
        0
      ],
      "IOWrites": [
        0
      ],
      "AvgIOWrites": [
        0
      ],
      "MaxIOWrites": [
        0
      ],
      "LastRowsCountAffected": [
        0
      ],
      "AvgLastRowsCountAffected": [
        0
      ],
      "MaxLastRowsCountAffected": [
        0
      ],
      "LogicalIOReads": [
        0
      ],
      "AvgLogicalIOReads": [
        0
      ],
      "MaxLogicalIOReads": [
        0
      ],
      "PhysicalIOReads": [
        0
      ],
      "AvgPhysicalIOReads": [
        0
      ],
      "MaxPhysicalIOReads": [
        0
      ],
      "RowsCountAffected": [
        0
      ],
      "AvgRowsCountAffected": [
        0
      ],
      "MaxRowsCountAffected": [
        0
      ],
      "CPUTime": [
        0
      ],
      "AvgCPUTime": [
        0
      ],
      "MaxCPUTime": [
        0
      ],
      "Rows": [
        0
      ],
      "AvgRows": [
        0
      ],
      "MaxRows": [
        0
      ],
      "Frows": [
        0
      ],
      "AvgFrows": [
        0
      ],
      "MaxFrows": [
        0
      ],
      "Scnt": [
        0
      ],
      "AvgScnt": [
        0
      ],
      "MaxScnt": [
        0
      ],
      "TotalCount": 5
    },
    "ErrorCode": 10910,
    "Message": "Successful",
    "Timestamp": 1645668213000
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidParams	The request parameters are invalid.	リクエストパラメーターが無効です。
403	NoPermission	You are not authorized to do this action.	この操作を実行する権限がありません。

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

変更履歴

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