本文导读

展开导读

文档首页/ 数据管理服务 DAS/ API参考/ API（公测中）/ 云DBA/ 开启/关闭全量SQL、慢SQL开关

开启/关闭全量SQL、慢SQL开关

更新时间：2024-11-13 GMT+08:00

功能介绍

打开或者关闭DAS收集全量SQL开关，开启后，实例的性能损耗在5%以内。开启全量SQL后，本服务会对SQL的文本内容进行存储，以便进行分析。用户可自行设置全量SQL的保存时间范围，到期后会自动删除；如果未设置，数据默认保留7天。打开或者关闭DAS收集慢SQL开关。开启慢SQL后，本服务会对慢SQL的文本内容进行存储，以便进行分析。用户可自行设置慢SQL的保存时间范围，到期后会自动删除；如果未设置，数据默认保留7天。该功能仅支持付费实例。

URI

POST /v3/{project_id}/instances/{instance_id}/sql/switch

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。获取方法请参见获取项目ID。
instance_id	是	String	实例ID。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。
X-Language	否	String	请求语言类型。枚举值： en-us zh-cn

表3 请求Body参数
参数	是否必选	参数类型	描述
type	是	String	开关类型。取值DAS SQL Explorer和DAS Slow Query Log，分别表示DAS收集全量SQL开关和DAS收集慢SQL开关。
status	是	Integer	开关状态，取值0和1，分别代表要关闭和开启。
datastore_type	是	String	数据库类型。当前全量SQL支持的数据库类型包括MySQL和TaurusDB，慢SQL支持的类型：MySQL、TaurusDB、PostgreSQL。
retention_days	否	Long	SQL数据保存时长（天）。默认为7天，最长可保留30天，到期后数据自动删除。如果要保留30天以上，请到DAS页面进行操作。

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
status	String	开关状态。取值： Enabled：已开启， Disabled：已关闭， Switching：开关切换中。

状态码： 400

表5 响应Body参数
参数	参数类型	描述
error_code	String	错误码。最小长度：8 最大长度：36
error_msg	String	错误描述。最小长度：2 最大长度：512

状态码： 500

表6 响应Body参数
参数	参数类型	描述
error_code	String	错误码。最小长度：8 最大长度：36
error_msg	String	错误描述。最小长度：2 最大长度：512

请求示例

开启全量SQL开关。

POST https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/da304cd5bbb944de828759bc7be3d3fein01/sql/switch

{
  "type" : "DAS SQL Explorer",
  "status" : 1,
  "datastore_type" : "MySQL",
  "retention_days" : 8
}

响应示例

状态码： 200

返回体。

{
  "status" : "Enabled"
}

状态码

状态码	描述
200	返回体。
400	客户端错误。
500	服务器错误。

错误码

请参见错误码。

父主题： 云DBA

上一篇：查询InnoDB锁等待列表

下一篇：查询全量SQL和慢SQL的开关状态

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消