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

Database Autonomy Service:GetPartitionsHeatmap

最終更新日:Dec 19, 2025

PolarDB-X 2.0 インスタンスのパーティションに対するアクセス頻度の統計とホットデータをクエリします。

操作説明

この操作を呼び出すことは推奨しません。データは特殊な形式で返され、解析が複雑です。Database Autonomy Service (DAS) のヒートマップ機能を使用してデータをクエリできます。

今すぐお試しください

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

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ConsoleContext

string

任意

予約パラメーター。

None

InstanceId

string

任意

インスタンス ID。

pxc-hzrciqy62c****

TimeRange

string

任意

クエリする時間範囲。有効な値:

  • LAST_ONE_HOURS:過去 1 時間。

  • LAST_SIX_HOURS:過去 6 時間。

  • LAST_ONE_DAYS:過去 1 日。

  • LAST_THREE_DAYS:過去 3 日間。

  • LAST_SEVEN_DAYS:過去 7 日間。

LAST_SIX_HOURS

Type

string

任意

クエリするデータの種類。有効な値:

  • READ_ROWS:読み取り行。

  • WRITTEN_ROWS:書き込み行。

  • READ_WRITTEN_ROWS:読み取り行と書き込み行。

  • UPDATE_ROWS:更新行。

  • INSERTED_ROWS:挿入行。

  • DELETED_ROWS:削除行。

  • READ_ROWS_WITH_DN:データノードから返される読み取り行。

  • WRITTEN_ROWS_WITH_DN:データノードから返される書き込み行。

  • READ_WRITTEN_ROWS_WITH_DN:データノードから返される読み取り行と書き込み行。

WRITTEN_ROWS_WITH_DN

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーター。

Code

string

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

200

Message

string

返されるメッセージ。

説明

リクエストが成功した場合、Successful が返されます。リクエストが失敗した場合、エラーコードなどの情報を含むエラーメッセージが返されます。

Successful

Data

string

PolarDB-X 2.0 インスタンスのホットデータ。データは JSON 形式で返されます。

{ "boundAxis": [ { "bound": "A,B,C,D", "labels": [ "L1", "L2", "L3", "L4" ], "rows": 3171 }, { "bound": "A,B,C,D", "labels": [ "L1", "L2", "L3", "L4" ], "rows": 277128 } ], "dataMap": { "READ_WRITTEN_ROWS": [ [ 0, 0, 0 ], [ 0, 0, 0 ] ] }, "timeAxis": [ 1671701056070, 1671701116551, 1671701177020 ] }

RequestId

string

リクエスト ID。

D00DB161-FEF6-5428-B37A-8D29A4C2****

Success

string

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

  • true

  • false

true

成功レスポンス

JSONJSON

{
  "Code": "200",
  "Message": "Successful",
  "Data": "{\n    \"boundAxis\": [\n        {\n            \"bound\": \"A,B,C,D\",\n            \"labels\": [\n                \"L1\",\n                \"L2\",\n                \"L3\",\n                \"L4\"\n            ],\n            \"rows\": 3171\n        },\n        {\n            \"bound\": \"A,B,C,D\",\n            \"labels\": [\n                \"L1\",\n                \"L2\",\n                \"L3\",\n                \"L4\"\n            ],\n            \"rows\": 277128\n        }\n    ],\n    \"dataMap\": {\n        \"READ_WRITTEN_ROWS\": [\n            [\n                0,\n                0,\n                0\n            ],\n            [\n                0,\n                0,\n                0\n            ]\n        ]\n    },\n    \"timeAxis\": [\n        1671701056070,\n        1671701116551,\n        1671701177020\n    ]\n}",
  "RequestId": "D00DB161-FEF6-5428-B37A-8D29A4C2****",
  "Success": "true"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

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

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

変更履歴

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