この API は、インスタンスのスロークエリログの詳細を照会するために使用されます。
操作説明
サポートされるエンジン
RDS MySQL
RDS PostgreSQL
RDS SQL Server
RDS MariaDB
注意事項
この API のレスポンスパラメーターは 1 分に 1 回更新されます。
この API を呼び出してデータをプルすると、一定の遅延が発生します。応答があるまでしばらくお待ちください。
2024 年 9 月 1 日より、SQL テンプレートアルゴリズムの最適化により、この API を呼び出す際の `SQLHash` フィールドの値が変更されます。詳細については、「【お知らせ】低速 SQL ステートメントのテンプレートアルゴリズムの最適化」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
rds:DescribeSlowLogRecords |
get |
*DBInstance
|
|
なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| DBInstanceId |
string |
必須 |
インスタンスの ID。 DescribeDBInstances 操作を呼び出して、インスタンスの ID を照会できます。 |
rm-uf6wjk5**** |
| SQLHASH |
string |
任意 |
SQL ステートメントの一意の ID。この ID は、SQL ステートメントのスロークエリログを取得するために使用されます。 |
U2FsdGVk**** |
| StartTime |
string |
必須 |
照会する時間範囲の開始時刻。時間は ISO 8601 標準に準拠した yyyy-MM-ddTHH:mm:ssZ 形式で指定する必要があります。時刻は協定世界時 (UTC) である必要があります。 |
2020-06-17T16:00Z |
| EndTime |
string |
必須 |
照会する時間範囲の終了時刻。時間は ISO 8601 標準に準拠した yyyy-MM-ddTHH:mm:ssZ 形式で指定する必要があります。時刻は協定世界時 (UTC) である必要があります。 説明
終了時刻は開始時刻より後である必要があります。 |
2020-06-18T16:00Z |
| DBName |
string |
任意 |
データベースの名前。 |
testdb |
| PageSize |
integer |
任意 |
ページあたりのエントリ数。有効値:30~200。デフォルト値:30。 |
30 |
| PageNumber |
integer |
任意 |
ページ番号。ページは 1 から始まります。デフォルト値:1。 |
1 |
| NodeId |
string |
任意 |
ノードの ID。 説明
このパラメーターは、RDS Cluster Edition を実行するインスタンスでのみ使用できます。このパラメーターを指定して、指定したノードのログを照会できます。このパラメーターを指定しない場合、デフォルトでプライマリノードのログが返されます。 |
rn-p1fm78s90x5**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーター。 |
||
| DBInstanceId |
string |
インスタンスの ID。 |
rm-uf6wjk5**** |
| Engine |
string |
データベースエンジンのタイプ。 |
MySQL |
| Items |
object |
||
| SQLSlowRecord |
array<object> |
各スローログに関する情報で構成される配列。 |
|
|
object |
スロークエリログに関する情報。 |
||
| ApplicationName |
string |
インスタンスに接続されているアプリケーションの名前。 説明
このパラメーターは、SQL Server を実行するインスタンスに対してのみ返されます。 |
example |
| ClientHostName |
string |
クライアントのホスト名。 説明
このパラメーターは、SQL Server を実行するインスタンスに対してのみ返されます。 |
example |
| CpuTime |
integer |
SQL ステートメントが CPU によって処理される時間。単位:ミリ秒。 説明
このパラメーターは、SQL Server を実行するインスタンスに対してのみ返されます。 |
0.002 |
| DBName |
string |
データベースの名前。 |
testDB |
| ExecutionStartTime |
string |
SQL ステートメントの実行が開始された時刻。時間は ISO 8601 標準に準拠した yyyy-MM-ddTHH:mm:ssZ 形式で、協定世界時 (UTC) で表示されます。 |
2020-06-18T01:40:44Z |
| HostAddress |
string |
データベースに接続されているクライアントの名前と IP アドレス。 |
****[****] @ [1XX.XX.XX.XX] |
| LastRowsAffectedCount |
integer |
最後の SQL ステートメントによって影響を受けた行数。 説明
このパラメーターは、SQL Server を実行するインスタンスに対してのみ返されます。 |
2 |
| LockTimes |
integer |
クエリのロック期間。単位:秒。 |
0 |
| LogicalIORead |
integer |
論理読み込みの数。 説明
このパラメーターは、SQL Server を実行するインスタンスに対してのみ返されます。 |
383 |
| ParseRowCounts |
integer |
解析された行数。 |
1 |
| PhysicalIORead |
integer |
物理読み込みの数。 説明
このパラメーターは、SQL Server を実行するインスタンスに対してのみ返されます。 |
200 |
| QueryTimeMS |
integer |
クエリの実行時間。単位:ミリ秒。 |
2001 |
| QueryTimes |
integer |
クエリの実行時間。単位:秒。 |
2 |
| ReturnRowCounts |
integer |
返された行数。 |
1 |
| RowsAffectedCount |
integer |
影響を受けた行数。 説明
このパラメーターは、SQL Server を実行するインスタンスに対してのみ返されます。 |
34 |
| SQLHash |
string |
SQL ステートメントの一意の ID。 |
U2FsdGVk**** |
| SQLText |
string |
SQL ステートメントの詳細。 |
select sleep(2) |
| UserName |
string |
ユーザーの名前。 説明
このパラメーターは、SQL Server を実行するインスタンスに対してのみ返されます。 |
user |
| WriteIOCount |
integer |
I/O 書き込みの数。 説明
このパラメーターは、SQL Server を実行するインスタンスに対してのみ返されます。 |
22 |
| LockTimeMS |
integer |
ロック期間。単位:ミリ秒 (ms)。 |
2001 |
| PageNumber |
integer |
ページ番号。 |
1 |
| PageRecordCount |
integer |
現在のページの SQL ログレポートの数。 |
1 |
| RequestId |
string |
リクエストの ID。 |
4DBB1BB0-E5D8-4D41-B1C9-142364DB**** |
| TotalRecordCount |
integer |
返されたエントリの総数。 |
1 |
例
成功レスポンス
JSONJSON
{
"DBInstanceId": "rm-uf6wjk5****",
"Engine": "MySQL",
"Items": {
"SQLSlowRecord": [
{
"ApplicationName": "example",
"ClientHostName": "example",
"CpuTime": 0.002,
"DBName": "testDB",
"ExecutionStartTime": "2020-06-18T01:40:44Z",
"HostAddress": "****[****] @ [1XX.XX.XX.XX]",
"LastRowsAffectedCount": 2,
"LockTimes": 0,
"LogicalIORead": 383,
"ParseRowCounts": 1,
"PhysicalIORead": 200,
"QueryTimeMS": 2001,
"QueryTimes": 2,
"ReturnRowCounts": 1,
"RowsAffectedCount": 34,
"SQLHash": "U2FsdGVk****",
"SQLText": "select sleep(2)",
"UserName": "user",
"WriteIOCount": 22,
"LockTimeMS": 2001
}
]
},
"PageNumber": 1,
"PageRecordCount": 1,
"RequestId": "4DBB1BB0-E5D8-4D41-B1C9-142364DB****",
"TotalRecordCount": 1
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidSearchTimeRange | search time range cannot be longer than a month. | |
| 400 | IO.Exception | IO exception, retry later. | |
| 400 | Order.ComboInstanceNotAllowOperate | A package instance is not allowed to operate independently. | |
| 400 | Price.PricingPlanResultNotFound | Pricing plan price result not found. | |
| 400 | Order.NoRealNameAuthentication | You have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication. | |
| 400 | InsufficientAvailableQuota | Your account quota limit is less than 0, please recharge before trying to purchase. | |
| 400 | CommodityServiceCalling.Exception | Failed to call commodity service. | |
| 400 | RegionDissolvedEOM | Dear customer, Alibaba Cloud plans to optimize and adjust the current region. Cloud services in this region will cease operations. You are currently unable to operate new purchase orders. Thank you for your understanding and support. | |
| 400 | Commodity.InvalidComponent | The module you purchased is not legal, please buy it again. | |
| 400 | RegionEndTimeDissolvedAustralia | Cloud services in the Australia (Sydney) region will be discontinued. Set the validity date to September 30, 2024 or earlier than September 30, 2024. | |
| 400 | Price.CommoditySys | Commodity system call exception. | |
| 400 | Pay.InsufficientBalance | Insufficient available balance. | |
| 400 | Order.PeriodInvalid | There is a problem with the period you selected, please choose again. | |
| 400 | pay.noCreditCard | Account not bound to credit card. | |
| 400 | Order.InstHasUnpaidOrder | There is an unpaid order for the service you have purchased. Please pay or void it before placing the order. | |
| 400 | noAvailablePaymentMethod | No payment method is specified for your account. We recommend that you add a payment method. | |
| 400 | BasicInfoUncompleted | Your information is incomplete. Complete your information before the operation. | |
| 400 | Risk.RiskControlRejection | Your account is abnormal, please contact customer service for details. | |
| 400 | Api.NotSupport | Specified api is not supported. | |
| 400 | ContainForbiddenLabelError | There is a label that prohibits placing orders. Please contact your distributor for assistance. | |
| 400 | InvalidDBInstanceId.NotFound | The DBInstanceId provided does not exist in records. | |
| 400 | InvalidInstanceLevel.DiskType | Specified instance level not support request disk type | |
| 400 | InvalidParam | Sepcified wal level Parameter is invalid. There are still logical slots in instance, so it can not be set as replica. | |
| 400 | KmsApiError | User secret key invalid. | |
| 400 | System.SaleValidateFailed | Sales expression validation system error. | |
| 400 | Abs.InvalidAccount.NotFound | account is not found. | |
| 400 | SqlExecuteFailedOrTimeout | sql command execution failed or timed out:%s. | |
| 400 | ColdData.EngineVersionNotSupport | The current instance engine version not support coldDataEnabled. | |
| 400 | ColdData.MinorVersionNotSupport | The current instance minor version not support coldDataEnabled. | |
| 400 | IncorrectTargetClasscode | The current instance type does not support this operation. | |
| 400 | InvalidConnectionString.Duplicate | Specified connection string already exists in the RDS. | |
| 400 | RequiredParam.NotFound | Required input param is not found. | |
| 400 | Parameters.Invalid | Parameter error, please check the parameters. | |
| 400 | BackupPolicyNotSupport | Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy. | |
| 400 | InvalideStatus.Format | The instance status does not support this operation. | |
| 400 | InvalidReleasedKeepPolicy.Format | Specified Released Keep Policy is not valid. | |
| 400 | InvalidDBInstanceEngineType.Format | the DB instance engine type does not support this operation. | |
| 400 | Pay.NoCreditCard | No credit cards. | |
| 400 | VpcNetworkTypeNotSupport | The vpc network type instance does not support this operation. | |
| 400 | MirrorInsExists | Specified DB instance mirror ins already existed. | |
| 400 | UnsupportedClassCode | The specified DB instance class stops selling. | |
| 400 | InvalidBackupSet | The specified database does not exist in the backup set. | |
| 400 | OrdTCommodityQueryError | Failed to query for product. | |
| 400 | ProductInstanceReleased | The instance has been released. Please check before placing the order. | |
| 400 | RegionEndTimeDissolvedIndia | The region is no longer supported. | |
| 500 | ExternalFailure | The request processing has failed due to external service failure. | |
| 500 | RequestMetaDataFailed | The service request failed. Please try again later or contact service personnel. | |
| 500 | InvokeProxyFailure | The request processing has failed due to service failure of rds api. | |
| 403 | OrderStatus.UnPaid | The specified db instance has unpaid order. | |
| 403 | InvalidReduceDiskSize | The storage capacity after the scale-down must be larger than the used amount. | |
| 403 | CloudSSDNotSupport | Cloud ssd does not support this operation, please upgrade to essd. | |
| 403 | InvalidUserOperatorPermission | The user permission does not support this operation. | |
| 403 | InvalidVswitchId | Specified conn vswitch id is not valid. | |
| 403 | IncorrectMinorVersion | Current engine minor version does not support operations. | |
| 403 | OperationDenied.ZoneResource | There is no available zone for inventory. | |
| 403 | NotInFlowController | Sorry,no permission. | |
| 403 | InvalidKmsKey | Kms key is disabled. | |
| 403 | InvalidInstanceLevel.Malformed | Current DB instance level does not support this operation. | |
| 404 | InvalidClusterKms | The current instance does not authorized to access the Key Management Service. | |
| 404 | Request.NotFound | The requested resource is not available. | |
| 404 | HostInfo.NotFound | The specified host info is not found. | |
| 408 | RequestTimeout | Query timed out.Please try again or narrow down the query scope. | リクエストタイムアウトです。再試行するか、時間の範囲を縮小してください |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。