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

Database Autonomy Service:GetDeadLockDetail

最終更新日:Mar 13, 2026

単一のデッドロックイベントの詳細情報を取得します。

操作説明

この API は、関与するトランザクション、SQL ステートメント、保持されているロックと待機中のロックなど、特定のデッドロックの完全な詳細をフェッチします。デッドロックは、最近の分析または完全な履歴分析のいずれかから取得できます。詳細については、「デッドロック分析」をご参照ください。

この操作を呼び出す前に、以下を確認してください。

  • サポートされているエンジン

    • 最近のデッドロック分析の場合:ApsaraDB RDS for MySQL、セルフマネージド MySQL、PolarDB for MySQL、PolarDB-X 2.0。

    • 完全なデッドロック分析の場合:DAS Economy Edition または DAS Professional Edition が有効になっている ApsaraDB RDS for MySQL または PolarDB for MySQL。

  • SDK バージョン:最新バージョンの Alibaba Cloud SDK を使用します。

  • リージョン:SDK 経由で API を呼び出す場合は、リージョン ID を cn-shanghai に設定します。

今すぐお試しください

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

none

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

InstanceId

string

必須

データベースインスタンスの ID。

pc-bp1u5mas9exx7****

NodeId

string

任意

ノード ID。

説明

PolarDB for MySQL クラスターインスタンスには必須です。

pi-bp16v3824rt73****

TextId

string

必須

デッドロックテキストの ID。この値は GetDeadLockHistory 操作から返されます。

a0e390cd5aca9ae964448f040153****

Source

string

任意

分析タスクのソース:

  • MANUAL または 未指定:最近のデッドロック分析タスクをクエリします。

  • AUTO:完全なデッドロック分析タスクをクエリします。

AUTO

レスポンスフィールド

フィールド

説明

object

RequestId

string

一意のリクエスト ID。

9CB97BC4-6479-55D0-B9D0-EA925AFE****

Message

string

応答メッセージ。

説明
  • リクエストが成功すると、Successful が返されます。

  • リクエストが失敗すると、エラー情報 (エラーコードなど) が返されます。

Successful

Synchro

string

予約済みパラメーター。

None

Data

string

JSON 形式で返されるデータ:

  • accountId: ユーザー ID。

  • textId: デッドロックテキスト ID。

  • gmtModified: 診断が生成された時間。

  • originText: LATEST DETECTED DEADLOCK の元のデッドロックテキスト、またはエラーログ内の元のデッドロックテキスト。

  • deadlock: デッドロックの詳細:

    • occurTime: デッドロックが発生した時間。

    • originTextId: デッドロックテキスト ID。

    • rollbackTrxId: ロールバックされたトランザクションの ID。

    • transactions:

      • deadlockIdInDB: データベース内のデッドロック ID。

      • ip: アクセス IP アドレス。

      • queryId: クエリ ID。

      • queryType: クエリタイプ。

      • relatedTables: 関連テーブル。

      • tableNamesString: 関連テーブル。

      • sqlText: SQL テキスト。

      • threadId: スレッド ID。

      • transactionId: トランザクション ID。

      • trxIdInLock: デッドロック内のトランザクション ID。

      • userName: データベースユーザー名。

      • waitLockIndexName: ロックが待機しているインデックスの名前。

      • waitLockMode: 待機中のロックのタイプ。

      • lockWait: 待機中のロック。

      • holdLockIndexName: ロックが保持されているインデックスの名前。

      • holdLockMode: 保持されているロックのタイプ。

      • lockHold: 保持されているロック。

    • trxNum: トランザクション数。

  • gmtCreate: 診断が作成された時間。

  • nodeId: ノード ID。

  • uuid: インスタンス ID。

{ "accountId": "108************", "textId": "35303d12d52d29ba73bb************", "gmtModified": 1732712680000, "originText": "LATEST DETECTED DEADLOCK****", "deadlock": "{\"id\":0,\"occurTime\":1732687047000,\"originTextId\":\"35303d12d52d29ba73bb************\",\"rollbackTrxId\":\"2\",\"transactions\":[{\"deadlockIdInDB\":0,\"ip\":\"100.***.***.***\",\"lockWait\":\"index PRIMARY of table `das`.`students` trx id 15989454 lock_mode X locks rec but not gap waiting\",\"queryId\":\"386737457\",\"queryType\":\"updating\",\"relatedTables\":[\"`das`.`students`\"],\"sqlText\":\"update students set name=UUID() where id = 2 \",\"tableNamesString\":\"`das`.`students`\",\"threadId\":\"9194526\",\"transactionId\":\"15989454\",\"trxIdInLock\":1,\"userName\":\"das\",\"waitLockIndexName\":\"PRIMARY \",\"waitLockMode\":\"X locks rec but not gap waiting\"},{\"deadlockIdInDB\":0,\"holdLockIndexName\":\"PRIMARY \",\"holdLockMode\":\"X locks rec but not gap\",\"ip\":\"100.***.***.***\",\"lockHold\":\"index PRIMARY of table `das`.`students` trx id 15989451 lock_mode X locks rec but not gap\",\"lockWait\":\"index PRIMARY of table `das`.`students` trx id 15989451 lock_mode X locks rec but not gap waiting\",\"queryId\":\"386737566\",\"queryType\":\"updating\",\"relatedTables\":[\"`das`.`students`\"],\"sqlText\":\"update students set name=UUID() where id = 3 \",\"tableNamesString\":\"`das`.`students`\",\"threadId\":\"9194501\",\"transactionId\":\"15989451\",\"trxIdInLock\":2,\"userName\":\"das\",\"waitLockIndexName\":\"PRIMARY \",\"waitLockMode\":\"X locks rec but not gap waiting\"}],\"trxNum\":2}", "gmtCreate": 1732712680000, "nodeId": "pi-8****************", "uuid": "pc-8v***************" }

Code

string

返された状態コード。

200

Success

string

リクエストが成功したかどうかを示します。有効な値は次のとおりです。

  • true:リクエストは成功しました。

  • false:リクエストは失敗しました。

true

成功レスポンス

JSONJSON

{
  "RequestId": "9CB97BC4-6479-55D0-B9D0-EA925AFE****",
  "Message": "Successful",
  "Synchro": "None",
  "Data": "{\n    \"accountId\": \"108************\",\n    \"textId\": \"35303d12d52d29ba73bb************\",\n    \"gmtModified\": 1732712680000,\n    \"originText\": \"LATEST DETECTED DEADLOCK****\",\n    \"deadlock\": \"{\\\"id\\\":0,\\\"occurTime\\\":1732687047000,\\\"originTextId\\\":\\\"35303d12d52d29ba73bb************\\\",\\\"rollbackTrxId\\\":\\\"2\\\",\\\"transactions\\\":[{\\\"deadlockIdInDB\\\":0,\\\"ip\\\":\\\"100.***.***.***\\\",\\\"lockWait\\\":\\\"index PRIMARY of table `das`.`students` trx id 15989454 lock_mode X locks rec but not gap waiting\\\",\\\"queryId\\\":\\\"386737457\\\",\\\"queryType\\\":\\\"updating\\\",\\\"relatedTables\\\":[\\\"`das`.`students`\\\"],\\\"sqlText\\\":\\\"update students set name=UUID() where id = 2 \\\",\\\"tableNamesString\\\":\\\"`das`.`students`\\\",\\\"threadId\\\":\\\"9194526\\\",\\\"transactionId\\\":\\\"15989454\\\",\\\"trxIdInLock\\\":1,\\\"userName\\\":\\\"das\\\",\\\"waitLockIndexName\\\":\\\"PRIMARY \\\",\\\"waitLockMode\\\":\\\"X locks rec but not gap waiting\\\"},{\\\"deadlockIdInDB\\\":0,\\\"holdLockIndexName\\\":\\\"PRIMARY \\\",\\\"holdLockMode\\\":\\\"X locks rec but not gap\\\",\\\"ip\\\":\\\"100.***.***.***\\\",\\\"lockHold\\\":\\\"index PRIMARY of table `das`.`students` trx id 15989451 lock_mode X locks rec but not gap\\\",\\\"lockWait\\\":\\\"index PRIMARY of table `das`.`students` trx id 15989451 lock_mode X locks rec but not gap waiting\\\",\\\"queryId\\\":\\\"386737566\\\",\\\"queryType\\\":\\\"updating\\\",\\\"relatedTables\\\":[\\\"`das`.`students`\\\"],\\\"sqlText\\\":\\\"update students set name=UUID() where id = 3 \\\",\\\"tableNamesString\\\":\\\"`das`.`students`\\\",\\\"threadId\\\":\\\"9194501\\\",\\\"transactionId\\\":\\\"15989451\\\",\\\"trxIdInLock\\\":2,\\\"userName\\\":\\\"das\\\",\\\"waitLockIndexName\\\":\\\"PRIMARY \\\",\\\"waitLockMode\\\":\\\"X locks rec but not gap waiting\\\"}],\\\"trxNum\\\":2}\",\n    \"gmtCreate\": 1732712680000,\n    \"nodeId\": \"pi-8****************\",\n    \"uuid\": \"pc-8v***************\"\n}",
  "Code": "200",
  "Success": "true"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

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

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

変更履歴

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