DescribeWorkerDetection によるストレージ異常の検出 - 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:DescribeWorkerDetection

get

DBCluster

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
DBClusterId	string	必須	AnalyticDB for MySQL Data Warehouse Edition (AnalyticDB for MySQL) クラスターの ID。説明 DescribeDBClusters 操作を呼び出して、リージョン内のすべての AnalyticDB for MySQL クラスターの情報 (クラスター ID を含む) をクエリできます。	am-xxxxx
RegionId	string	必須	リージョン ID。説明 DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。	cn-hangzhou
StartTime	string	任意	クエリする時間範囲の開始時刻。時間は ISO 8601 標準に準拠した yyyy-MM-ddTHH:mmZ 形式で指定する必要があります。時刻は UTC である必要があります。説明過去 15 日以内のデータのみをクエリできます。	2011-06-01T16:00Z
EndTime	string	任意	クエリする時間範囲の終了時刻。時間は ISO 8601 標準に準拠した yyyy-MM-ddTHH:mmZ 形式で指定する必要があります。時刻は UTC である必要があります。終了時刻は開始時刻より後である必要があります。	2024-04-25T02:04Z
Lang	string	任意	リクエストと応答内のコンテンツの言語。デフォルト値：zh。有効な値： zh：中国語。 en：英語。	zh

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
TotalCount	string	返されたエントリの総数。	144
RequestId	string	リクエスト ID。	37A6F56E-B970-50AF-AF33-C71E57AB2C8E
DBClusterId	string	クラスター ID。	amv-xxx
DetectionItems	array<object>	クエリされた検出項目と検出結果。
	array<object>	クエリされた検出項目と検出結果。
Name	string	検出項目の名前。	指标检测
Results	object	検出結果の項目。
SkewedTables	array<object>	データが偏っているテーブルの検出結果項目。
	object	データが偏っているテーブルの検出結果項目。
SchemaName	string	データベースの名前。	kp_ods
TableName	string	テーブルの名前。	train_data_test
DDL	string	テーブルの作成に使用される SQL 文。	create table(id varchar)
PartitionCount	integer	パーティションの数。	3
TotalDataSize	integer	テーブルの合計データサイズ。単位：バイト。	2345
TotalRowCount	integer	テーブルの合計行数。	2335
TotalPkSize	integer	プライマリキーのデータサイズ。単位：バイト。	1234
TotalRemoteDataSize	integer	コールドデータのサイズ。単位：バイト。	23456
TotalLocalDataSize	string	ホットデータのサイズ。単位：バイト。	211
ShardSkewedRows	string	テーブル内の偏りのある行数。	345
PartitionedTables	array<object>	不適切なパーティションテーブルの検出結果項目。
	object	不適切なパーティションテーブルの検出結果項目。
SchemaName	string	データベースの名前。	kp_ods
TableName	string	テーブルの名前。	lake_count
DDL	string	テーブルの作成に使用される SQL 文。	create table user(id varchar)
PartitionCount	string	パーティションの数。	4
PartitionIds	string	不適切なパーティションの ID。	[2025,2026]
TotalDataSize	integer	テーブルの合計データサイズ。単位：バイト。	[2024,2025]
TopAccessTables	array<object>	テーブルアクセスの検出結果項目。
	array<object>	テーブルアクセスの検出結果項目。
MetricName	string	検出メトリックの名前。	表访问次数
SearchResults	array<object>	テーブルアクセスの検出結果項目。
	object	テーブルアクセスの検出結果項目。
TableName	string	テーブルの名前。	adb_lake_logs_pgsql
MaxScanCost	integer	スキャンの最大時間。単位：ミリ秒。	2345
AvgScanCost	number	スキャンの平均時間。単位：ミリ秒。	234
MaxScanSize	integer	スキャンの最大データサイズ。単位：バイト。	234
AvgScanSize	number	スキャンの平均データサイズ。単位：バイト。	234
AccessCount	integer	テーブルへのアクセス数。	345
OperatorDetails	array<object>	異常なオペレーターの検出結果項目。
	array<object>	異常なオペレーターの検出結果項目。
MetricName	string	検出メトリックの名前。	峰值内存
SearchResults	array<object>	異常なオペレーターの検出結果項目。
	object
ProcessId	string	診断に使用できるクエリ ID。	2024072416154919216812815303453136244
StageId	string	ステージ ID。	Stage[7]
OperatorName	string	オペレーターの名前。	TableScan
PeakMemory	integer	ピークメモリ。単位：バイト。	234
OperatorCost	integer	ステージ内のすべてのオペレーターによって消費された合計 CPU 時間。これはステージの合計 CPU 時間に相当します。このパラメーターを使用して、ステージのどの部分が大量のコンピューティングリソースを消費しているかを判断できます。単位：ミリ秒。	235
InputRows	integer	オペレーターによって入力された行数。	235
OutputRows	integer	オペレーターによって出力された行数。	345
InputSize	integer	オペレーターによって入力されたデータ量。単位：バイト。	2345
OutputSize	integer	オペレーターによって出力されたデータ量。単位：バイト。	323
OperatorInfo	string	オペレーターに関するプロパティ情報。	聚合函数：count
OperatorAgg	array<object>	オペレーターメトリック集約の検出結果項目。
	array<object>	オペレーターメトリック集約の検出結果項目。
MetricName	string	検出メトリックの名前。	OperatorCost
SearchResults	array<object>	オペレーターメトリック集約の検出結果項目。
	object	オペレーターメトリック集約の検出結果項目。
OperatorName	string	オペレーターの名前。	StageOutput
MaxValue	integer	オペレーターメトリックの最大値。	3
TotalValue	integer	オペレーターメトリックの累積値。	3333
AvgValue	number	オペレーターメトリックの平均値。	234
OperatorCount	integer	オペレーターの発生回数。	345
Message	string	検出結果に関する情報。	检测到存在多个指标异常算子
Status	string	検出結果の重大度レベル。有効な値： NORMAL WARNING CRITICAL	WARNING

例

成功レスポンス

JSONJSON

{
  "TotalCount": "144",
  "RequestId": "37A6F56E-B970-50AF-AF33-C71E57AB2C8E",
  "DBClusterId": "amv-xxx",
  "DetectionItems": [
    {
      "Name": "指标检测",
      "Results": {
        "SkewedTables": [
          {
            "SchemaName": "kp_ods",
            "TableName": "train_data_test",
            "DDL": "create table(id varchar)",
            "PartitionCount": 3,
            "TotalDataSize": 2345,
            "TotalRowCount": 2335,
            "TotalPkSize": 1234,
            "TotalRemoteDataSize": 23456,
            "TotalLocalDataSize": "211",
            "ShardSkewedRows": "345"
          }
        ],
        "PartitionedTables": [
          {
            "SchemaName": "kp_ods",
            "TableName": "lake_count",
            "DDL": "create table user(id varchar)",
            "PartitionCount": "4",
            "PartitionIds": "[2025,2026]",
            "TotalDataSize": 0
          }
        ],
        "TopAccessTables": [
          {
            "MetricName": "表访问次数",
            "SearchResults": [
              {
                "TableName": "adb_lake_logs_pgsql",
                "MaxScanCost": 2345,
                "AvgScanCost": 234,
                "MaxScanSize": 234,
                "AvgScanSize": 234,
                "AccessCount": 345
              }
            ]
          }
        ],
        "OperatorDetails": [
          {
            "MetricName": "峰值内存",
            "SearchResults": [
              {
                "ProcessId": "2024072416154919216812815303453136244",
                "StageId": "Stage[7]",
                "OperatorName": "TableScan",
                "PeakMemory": 234,
                "OperatorCost": 235,
                "InputRows": 235,
                "OutputRows": 345,
                "InputSize": 2345,
                "OutputSize": 323,
                "OperatorInfo": "聚合函数：count"
              }
            ]
          }
        ],
        "OperatorAgg": [
          {
            "MetricName": "OperatorCost",
            "SearchResults": [
              {
                "OperatorName": "StageOutput",
                "MaxValue": 3,
                "TotalValue": 3333,
                "AvgValue": 234,
                "OperatorCount": 345
              }
            ]
          }
        ]
      },
      "Message": "检测到存在多个指标异常算子",
      "Status": "WARNING"
    }
  ]
}

エラーコード

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

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

変更履歴

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