Querying Deadlock Relationships

Function

This API is used to query deadlock relationships.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, the permission listed below is required.

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

das::showCloudDBAInfo

read

-

-

-

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
das::showCloudDBAInfo	read	-	-	-	-

URI

GET /v3/{project_id}/instances/{instance_id}/dead-lock/get-dead-lock-relationship

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID of a tenant in a region. To obtain the value, see Obtaining a Project ID. Constraints N/A Range The value can contain 32 characters. Only letters and digits are allowed. Default Value N/A
instance_id	Yes	String	Definition Instance ID, which uniquely identifies an instance. Constraints N/A Range The value can contain 32 characters. Only letters and digits are allowed. Default Value N/A

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
dead_lock_id	Yes	String	Definition Deadlock ID. Constraints N/A Range N/A Default Value N/A
start_time	Yes	Long	Definition Start timestamp (ms). Constraints N/A Range N/A Default Value N/A
end_time	Yes	Long	Definition End timestamp (ms). Constraints N/A Range N/A Default Value N/A

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
process_list	Array of objects in Table 4	Definition Session list. Range N/A
resource_list	Array of objects in Table 5	Definition Resource list. Range N/A

**Table 4** process
Parameter	Type	Description
spid	String	Definition Service process ID. Range N/A
process_id	String	Definition Session ID. Range N/A
host_name	String	Definition Host name. Range N/A
login_name	String	Definition Username. Range N/A
log_used	String	Definition Log space used by a task. Range N/A
sql	String	Definition SQL statement. Range N/A

**Table 5** resource
Parameter	Type	Description
lock_label	String	Definition Deadlock label. Range keylock objectlock ridlock pagelock compilelock
db_id	String	Definition Database ID. Range N/A
db_name	String	Definition Database name. Range N/A
index_name	String	Definition Index name (displayed only for key locks). Range N/A
associated_object_id	String	Definition Associated object ID. Range N/A
object_name	String	Definition Object name, that is, deadlock name. Range N/A
lock_mode	String	Definition Lock mode. Range N/A
owner_list	Array of objects in Table 6	Definition Owner list. Range N/A
waiter_list	Array of objects in Table 6	Definition Waiter list. Range N/A

**Table 6** object
Parameter	Type	Description
process_id	String	Definition Session ID. Range N/A
spid	String	Definition Service process ID. Range N/A
lock_mode	String	Definition Lock mode. Range N/A

Example Requests

GET https://das.cn-north-1.myhuaweicloud.com/v3/052041494800d57c2f02c00275b4c247/instances/47d0524891964dc48cee42c371928777in04/dead-lock/get-dead-lock-relationship?start_time=1761460179597&end_time=1764052179597&dead_lock_id=40DB3062B1662DE9

Example Responses

Status code: 200

Success.

{
    "process_list": [
        {
            "spid": "59",
            "process_id": "process1ec8b6a04e8",
            "host_name": "dbs_das_service2",
            "login_name": "rdsuser",
            "log_used": 252,
            "sql": "BEGIN TRAN  UPDATE dbo.test_deadlock2 SET name = 'CC' WHERE id = 1 ; UPDATE dbo.test_deadlock1 SET name = 'CC' WHERE id = 1 ; COMMIT"
        },
        {
            "spid": "58",
            "process_id": "process1ec4a079468",
            "host_name": "dbs_das_service2",
            "login_name": "rdsuser",
            "log_used": 252,
            "sql": "BEGIN TRAN  UPDATE dbo.test_deadlock1 SET name = 'CC' WHERE id = 1 ; WAITFOR DELAY '00:00:05' UPDATE dbo.test_deadlock2 SET name = 'CC' WHERE id = 1 ; ROLLBACK  "
        }
    ],
    "resource_list": [
        {
            "lock_label": "keylock",
            "db_id": "6",
            "db_name": "test",
            "index_name": "PK__test_dea__3213E83FF9793901",
            "associated_object_id": "72057594045792256",
            "object_name": "test.dbo.test_deadlock1",
            "lock_mode": "X",
            "owner_list": [
                {
                    "process_id": "process1ec4a079468",
                    "spid": "58",
                    "lock_mode": "X"
                }
            ],
            "waiter_list": [
                {
                    "process_id": "process1ec8b6a04e8",
                    "spid": "59",
                    "lock_mode": "X"
                }
            ]
        },
        {
            "lock_label": "keylock",
            "db_id": "6",
            "db_name": "test",
            "index_name": "PK__test_dea__3213E83F09D7C5A8",
            "associated_object_id": "72057594045857792",
            "object_name": "test.dbo.test_deadlock2",
            "lock_mode": "X",
            "owner_list": [
                {
                    "process_id": "process1ec8b6a04e8",
                    "spid": "59",
                    "lock_mode": "X"
                }
            ],
            "waiter_list": [
                {
                    "process_id": "process1ec4a079468",
                    "spid": "58",
                    "lock_mode": "X"
                }
            ]
        }
    ]
}

Status Codes

Status Code	Description
200	Success.
400	Client error.
500	Server error.

Error Codes

See Error Codes.

Parent topic: Intelligent O&M

Previous topic: Obtaining Raw Deadlock Data

Next topic: Querying Deadlock Statistics