
# 查询SQL堆栈信息 - QueryingSQLStackInformation
#### 功能介绍
查询等待事件的SQL堆栈信息。
- 调用接口前，您需要了解API [认证鉴权](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_011.html)。
- 调用接口前，您需要提前获取到[地区和终端节点](https://developer.huaweicloud.com/endpoint)。
 
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=GaussDBforopenGauss&api=ShowSlowSqlStack)中调试该接口。
#### 接口约束
仅支持包含有CN或DN（主、备）组件的节点。
#### URI
GET /v3/{project_id}/instances/{instance_id}/slow-sql/optimization/stack
表1参数说明 
| 名称          | 是否必选 | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| project_id  | 是    | String | **参数解释：** 租户在某一Region下的项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_196.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**： 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| instance_id | 是    | String | **参数解释：** 实例ID，此参数是用户创建实例的唯一标识。请参考[查询数据库实例列表 - QueryingDBInstances](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_328.html)接口获取实例ID。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为36个字符。 **默认取值** **：** 不涉及。 |
   
表2请求Body参数说明 
| 名称      | 是否必选 | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| pid     | 是    | String | **参数解释：** 线程ID。获取方式请参考[查询实时会话 - QueryingReal-TimeSessions](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_047.html)。 **约束限制：** 不涉及。 **取值范围** **：** 不涉及。 **默认取值** **：** 不涉及。                     |
| node_id | 是    | String | **参数解释：** 节点ID。获取方式请参考[查询实例的组件列表 - QueryingtheComponentsofaDBInstance](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_028.html)。 **约束限制：** 不涉及。 **取值范围** **：** 不涉及。 **默认取值** **：** 不涉及。     |
| comp_id | 否    | String | **参数解释：** 节点上的组件ID。获取方式请参考[查询实例的组件列表 - QueryingtheComponentsofaDBInstance](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_028.html)。 **约束限制：** 不涉及。 **取值范围** **：** 不涉及。 **默认取值** **：** 不涉及。 |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取。 请求响应成功后在响应消息头中包含的"X-Subject-Token"的值即为Token值。 **约束限制：** 不涉及。 **取值范围** **：** 不涉及。 **默认取值** **：** 不涉及。 |
| X-Language   | 否    | String | **参数解释：** 指定接口返回信息的语言类型。 **约束限制：** 不涉及。 **取值范围** **：** - **zh-cn：**中文  - **en-us** **：**英文   **默认取值** **：** **en-us**                 |
   
#### 响应参数
表4响应Body参数 
| 参数       | 参数类型   | 描述                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| gs_stack | String | **参数解释：** 堆栈信息。 **取值范围** **：** 不涉及。 |
   
#### 请求示例
```
GET https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/cc6fd964d93f4003851dfc29d57d30a5in14/slow-sql/optimization/stack?pid=139898020947520&node_id=7bae4d3eedb840da95545569bd662d5ano14&comp_id=dn_6001
```
#### 响应示例
```
{
    "gs_stack": "__select + 0x14d\npg_usleep(long) + 0x59\npg_sleep(FunctionCallInfoData*) + 0xca\nunsigned long exec_make_nosets_funcresult<false, false>(FuncExprState*, ExprContext*, bool*, ExprDoneCond*) + 0x501\nexec_targetlist(List*, ExprContext*, unsigned long*, bool*, ExprDoneCond*, ExprDoneCond*) + 0x1c5\nexec_project_byrec(ProjectionInfo*, ExprDoneCond*) + 0xf3\nResultOperator::get_next() + 0x37d\nPlanState::get_next() + 0x115\nexec_standard_executor_run(QueryDesc*, ScanDirection, long) + 0x266\nsqlcmd_explain_executor_run(QueryDesc*, ScanDirection, long) + 0x115\nexec_executor_run(QueryDesc*, ScanDirection, long) + 0xe3\nPortalRunSelect(PortalData*, bool, long, _DestReceiver*) + 0x4ee\nPortalRun(PortalData*, long, bool, _DestReceiver*, _DestReceiver*, char*, SnapshotData*) + 0x798\nexec_simple_query(char const*, MessageType, GsStringData*) [clone .constprop.0] + 0x4aa\ngs_process_command(int, GsStringData*, bool volatile*) + 0x109\nPostgresMain(int, char**, char const*, char const*) + 0x185b\nbackend_run(Port*) + 0x222\nint gauss_db_thread_main<(knl_thread_role)2>(knl_thread_arg*) + 0x348\ninternal_thread_func(void*) + 0x1a\nunknown\nunknown\n"
}
```
#### 状态码
- 正常 200
  
- 异常 请参见[状态码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_194.html)。
  
 
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_195.html)。
