ストレージ分析タスクのステータスと結果を照会します。
操作説明
物理ファイルサイズは、取得したファイルの実際のサイズを示します。データベースインスタンスの特定のデプロイメントモードのみが、物理ファイルサイズの表示をサポートしています。テーブルの統計は information_schema.tables から取得されます。MySQL の統計はリアルタイムで更新されないため、物理ファイルサイズと異なる場合があります。最新のデータを取得したい場合は、オフピーク時間に関連テーブルで ANALYZE TABLE ステートメントを実行できます。
この操作は、ApsaraDB RDS for MySQL インスタンス、PolarDB for MySQL クラスター、および ApsaraDB for MongoDB インスタンスにのみ適用されます。
ApsaraDB RDS for MySQL インスタンスおよび PolarDB for MySQL クラスターの場合、この操作は以前のバージョンのストレージ分析機能と同様に機能します。この操作によって生成されたタスクは、Database Autonomy Service (DAS) コンソールの新しいバージョンのストレージ分析ページでは表示できません。タスクと結果を表示したい場合は、関連する API 操作を呼び出してデータを取得し、ご利用のコンピューターにデータを保存してください。
Alibaba Cloud SDK または DAS SDK を使用してこの操作を呼び出す場合は、最新バージョンの SDK を使用することを推奨します。
SDK を使用して DAS の操作を呼び出す場合、リージョン ID を cn-shanghai に設定する必要があります。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
hdm:GetStorageAnalysisResult |
none |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| InstanceId |
string |
必須 |
インスタンス ID。 |
rm-bp10xxxxxxxxx |
| NodeId |
string |
任意 |
ノード ID。 説明
このパラメーターは予約済みです。 |
202**** |
| TaskId |
string |
必須 |
タスク ID。CreateStorageAnalysisTask 操作の応答からタスク ID を取得できます。 |
910f83f4b96df0524ddc5749f615**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| Code |
integer |
返された HTTP ステータスコード。 |
200 |
| Message |
string |
返されたメッセージ。 説明
リクエストが成功した場合、Successful が返されます。それ以外の場合は、エラーコードなどのエラーメッセージが返されます。 |
Successful |
| Data |
object |
返されたデータ。 |
|
| TaskId |
string |
タスク ID。 |
910f83f4b96df0524ddc5749f615**** |
| TaskFinish |
boolean |
タスクが完了したかどうかを示します。 |
true |
| TaskSuccess |
boolean |
タスクが成功したかどうかを示します。 |
true |
| TaskState |
string |
ストレージ分析タスクのステータス。有効な値：
|
RUNNING |
| TaskProgress |
integer |
タスクの進捗状況。 説明
有効な値は 0 から 100 までの整数です。 |
50 |
| TotalDbCount |
integer |
ストレージ分析タスクで分析する必要があるデータベースの数。 |
32 |
| AnalyzedDbCount |
integer |
分析されたデータベースの数。 |
2 |
| StorageAnalysisResult |
object |
ストレージ分析の詳細。 |
|
| TotalStorageSize |
integer |
インスタンスストレージの合計サイズ。 説明
単位：バイト。 |
214748364800 |
| TotalUsedStorageSize |
integer |
使用済みストレージのサイズ。 説明
単位：バイト。 |
68345135104 |
| TotalFreeStorageSize |
integer |
残りのストレージのサイズ。 説明
単位：バイト。 |
146403229696 |
| DailyIncrement |
integer |
過去 7 日間の使用済みストレージ領域の推定平均日次増加量。単位：バイト。 |
0 |
| EstimateAvailableDays |
integer |
残りのストレージ領域が利用可能であると推定される日数。 |
99 |
| AnalysisSuccess |
boolean |
データベースとテーブルの分析が成功したかどうかを示します。 |
true |
| AnalysisErrorType |
string |
データベースとテーブルの分析が失敗した理由。
|
DB_NOT_EXIST |
| NeedOptimizeItemList |
array<object> |
DAS のデフォルトルールに基づいて生成される、最適化が必要な項目。ビジネス要件に基づいてこれらの項目を無視し、返された他の基本データに基づいて最適化が必要な項目を生成するためのカスタムルールを作成できます。 |
|
|
object |
|||
| DbName |
string |
データベースの名前。 |
testdb01 |
| TableName |
string |
テーブルの名前。 |
test_table |
| OptimizeItemName |
string |
最適化する項目。有効な値：
|
NEED_OPTIMIZE_TABLE |
| OptimizeAdvice |
string |
最適化の提案。有効な値：
|
NEED_OPTIMIZE_TABLE |
| AssociatedData |
string |
最適化する項目に関連するデータ。JSON 形式です。 |
{ "autoIncrementCurrentValue": 2147483647, "autoIncrementRatio": 1, "dbName": "testdb01", "maximumValue": 2147483647, "columnName": "id", "tableName": "test_table" } |
| TableStats |
array<object> |
テーブルに関する情報。 |
|
|
object |
|||
| DbName |
string |
データベースの名前。 |
testdb01 |
| TableName |
string |
テーブルの名前。 |
test_table |
| TableType |
string |
テーブルのタイプ。 説明
このパラメーターは、ApsaraDB RDS for MySQL インスタンスと PolarDB for MySQL クラスターにのみ適用されます。 |
BASE TABLE |
| Engine |
string |
テーブルが使用するストレージエンジンのタイプ。 説明
このパラメーターは、ApsaraDB RDS for MySQL インスタンスと PolarDB for MySQL クラスターにのみ適用されます。 |
InnoDB |
| PhysicalFileSize |
integer |
テーブルの物理ファイルサイズ。単位：バイト。 説明
このパラメーターは、ApsaraDB RDS for MySQL インスタンスと PolarDB for MySQL クラスターにのみ適用されます。特定のデータベースインスタンスのデータは、デプロイメントモードのために取得できません。 |
3057655808 |
| PhyTotalSize |
integer |
テーブルのストレージ領域。単位：バイト。 説明
ApsaraDB RDS for MySQL インスタンスおよび PolarDB for MySQL クラスターの場合、パラメーターの値は DataSize、IndexSize、および DataFree の合計です。ApsaraDB for MongoDB インスタンスの場合、このパラメーターの値は DataSize と IndexSize の合計です。 |
3012493312 |
| TotalSize |
integer |
|
3005153280 |
| IndexSize |
integer |
インデックスが占有するストレージ領域。単位：バイト。 |
1022296064 |
| DataSize |
integer |
|
1982857216 |
| DataFree |
integer |
スペースフラグメントのサイズ。単位：バイト。 説明
このパラメーターは、ApsaraDB RDS for MySQL インスタンスと PolarDB for MySQL クラスターにのみ適用されます。テーブルの断片化率は通常、次の数式に基づいて計算されます： |
7340032 |
| TableRows |
integer |
テーブルの行数。 |
12794732 |
| AvgRowLength |
integer |
平均行長。単位：バイト。 |
154 |
| FragmentSize |
integer |
再利用可能な領域のサイズ。単位：バイト。 説明
このパラメーターは ApsaraDB for MongoDB インスタンスにのみ適用されます。 |
362221568 |
| RequestId |
string |
リクエスト ID。 |
B6D17591-B48B-4D31-9CD6-9B9796B2**** |
| Success |
boolean |
リクエストが成功したかどうかを示します。有効な値：
|
true |
例
成功レスポンス
JSONJSON
{
"Code": 200,
"Message": "Successful",
"Data": {
"TaskId": "910f83f4b96df0524ddc5749f615****",
"TaskFinish": true,
"TaskSuccess": true,
"TaskState": "RUNNING",
"TaskProgress": 50,
"TotalDbCount": 32,
"AnalyzedDbCount": 2,
"StorageAnalysisResult": {
"TotalStorageSize": 214748364800,
"TotalUsedStorageSize": 68345135104,
"TotalFreeStorageSize": 146403229696,
"DailyIncrement": 0,
"EstimateAvailableDays": 99,
"AnalysisSuccess": true,
"AnalysisErrorType": "DB_NOT_EXIST",
"NeedOptimizeItemList": [
{
"DbName": "testdb01",
"TableName": "test_table",
"OptimizeItemName": "NEED_OPTIMIZE_TABLE",
"OptimizeAdvice": "NEED_OPTIMIZE_TABLE",
"AssociatedData": "{\n \"autoIncrementCurrentValue\": 2147483647,\n \"autoIncrementRatio\": 1,\n \"dbName\": \"testdb01\",\n \"maximumValue\": 2147483647,\n \"columnName\": \"id\",\n \"tableName\": \"test_table\"\n}"
}
],
"TableStats": [
{
"DbName": "testdb01",
"TableName": "test_table",
"TableType": "BASE TABLE",
"Engine": "InnoDB",
"PhysicalFileSize": 3057655808,
"PhyTotalSize": 3012493312,
"TotalSize": 3005153280,
"IndexSize": 1022296064,
"DataSize": 1982857216,
"DataFree": 7340032,
"TableRows": 12794732,
"AvgRowLength": 154,
"FragmentSize": 362221568
}
]
}
},
"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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。