高级搜索支持基于自然语言或者 SQL 查询当前账号下的所有资源，同时可以将查询条件存为模板进行管理，让您不再受限于传统搜索方式，可以根据需求和偏好定制搜索条件，快速提供准确且完整的资源查询结果，帮助您全面深入地分析资源数据。

快捷入口：资源中心-高级搜索。

自然语言搜索

在高级搜索框下选择“自然语言”选项

输入资源相关问题，如“查询所有所有资源”、“查询所有打了 k1:v1 标签的资源”、“查询近一个月创建的资源”等

生成的 SQL 可以进行二次编辑并发起新的查询

可以切换至图表选项，支持按照项目、地域、资源类型分类查看，以柱状图、饼图、折线图形式提供

SQL 搜索

在高级搜索框下选择“SQL 编辑器”选项

直接输入 SQL 语句进行查询，SQL 编辑器支持参数推荐和自动补全

查询分为两种模式：智能模式和直接模式

选择智能模式时，AI 将优化 SQL 内容，智能修订 SQL 错误，提升查询成功率。

选择直接模式时，将直接通过 OpenAPI 执行编辑器内的 SQL，不做任何修改，执行效率更高。

可以通过点击“新会话”唤起 SQL 编辑器。

模板管理

高级搜索提供了查询模板简化查询操作，包括自定义模板和系统预制的示例查询模板，示例查询模板包含了常见的查询语句，示例模板不可编辑。

您也可以将编写的查询语句保存为自定义查询模板，后续可以直接使用自定义查询模板，无需重新编写，保证了查询的准确性和一致性。点击“新建自定义模板”，编辑模板名称、描述和查询语句，即可保存查询模板

点击“打开查询模板”，将在高级搜索框中展示 sql，默认按照直接模式进行查询

点击模板右上角图标，可以对模板进行编辑、复制、删除等操作

表结构

资源属性表名称为：resources，包含公共属性和不同资源类型独有的属性信息。公共属性为所有资源类型的公共属性字段，包括 account_id、type_name、resource_region 等属性信息。

resources 表是高级搜索中的核心数据表，所有的查询都是通过对 resources 表中的字段进行查询、筛选和排序等操作来实现的。resources 表的结构如下表所示。

字段	类型	描述
account_id	varchar	账号 ID
type_name	varchar	资源类型
resource_region	varchar	资源 Region
identifier	varchar	资源标识，account_id+resource_type+resource_region+identifier 能全局标识资源的唯一性
resource_id	varchar	资源 ID
resource_name	varchar	资源名称
description	string	资源描述/备注
created_time	varchar	资源创建时间
updated_time	varchar	资源更新时间
resource_status	varchar	资源状态
project_name	varchar	项目名称。项目是一组资源的集合，用户可将资源添加进项目中并按项目维度进行管理。基于项目可衍生出分账、分权等能力
tags	json	标签，由标签键值对组成，同一资源可以同时绑定多个标签键值对，但是绑定的 Key 不可重复，且每个 Key 只能有一个 Value。此字段存储格式为 map，如：{"tagkey1":"tagvalue1","tagkey2":"tagvalue2"}
private_ip_address	json	私有 IP 地址，数组。如：["192.168.0.10","192.168.0.12"]
public_ip_address	json	公有 IP 地址，数组。如：["33.233.xx.xx"]
properties	json	资源完整的属性信息，如资源状态、计费类型等，不同资源类型的 properties 不同

表结构展示所有资源类型的属性信息，鼠标置于字段上可以看到属性字段释义、SQL 表示和数据类型，便于写出定制搜索条件的 SQL 语句

SQL 语法

注意：

当前仅支持 Select 语句，对应关键字如上。

支持子查询，但不支持公共表的 CTE 操作。

字符串常量需要使用单引号进行标识。

为了避免超时，您可以通过以下方式降低查询的复杂性：

增加限制条件。例如：当有较大规模的数据需要查询时，可以通过 ORDER BY 指定按 resource_type、resource_id 排序。

限制返回数据。例如：使用 LIMIT 限制返回结果的最大条目数。

常用函数

	函数	语法	描述
聚合	MAX	MAX(<expr>)	返回表达式的最大值
		MIN	MIN(expr)	返回表达式的最小值。
		AVG	AVG([DISTINCT] <expr>)	计算指定列或表达式的所有非 NULL 值的平均值。
		COUNT	COUNT(DISTINCT <expr> [,<expr>,...]) COUNT(*) COUNT(<expr>)	返回指定列的非 NULL 记录数，或者记录总数
		SUM	SUM(<expr>)	用于返回选中字段所有值的和。
字符	CONCAT	CONCAT ( <expr> [ , <expr> ... ] )	将多个字符串连接起来
		CONCAT_WS	CONCAT_WS ( <sep> , <str> [ , <str> ] ) CONCAT_WS ( <sep> , <array> [ , <array> ])	使用参数 sep 作为连接符，将其余参数字符串拼接成一个字符串
		LENGTH	LENGTH ( <str> )	返回字符串的字节数。
		CHAR_LENGTH	CHAR_LENGTH ( <str> )	计算字符串的长度，对于多字节字符，返回字符数。
		SUBSTRING	SUBSTRING(<str>, <pos> [, <len>])	指定起始位置和长度，从字符串中提取子字符串支持正向、反向提取，字符串中起始字符的位置下标为 1
		TRIM	TRIM( <str> [ , <rhs>])	删除字符串两端的空格或指定字符。rhs 参数默认为空格，即没有 rhs 参数时，去掉参数 str 中两侧连续出现的空格
		LOWER	LOWER ( <str> )	将参数中的字符转换成小写。
		UPPER	UPPER( <str> )	将参数中的字符转换成大写。
		STARTS_WITH	STARTS_WITH(<str>, <prefix>)	检查字符串是否以指定的前缀开头。如果字符串以指定的前缀开头，返回 true；否则返回 false
JSON	JSON_EXTRACT	JSON_EXTRACT (<json_str>, <path>[, path] ...)	从 JSON 类型的数据中提取 json_path 指定的字段
		JSON_LENGTH	JSON_LENGTH(<json_str> [ , <json_path>])	返回给定 JSON 文档的长度或元素个数：若为 JSON 数组，返回数组中元素的个数若为 JSON 对象，返回对象中键值对的个数若为空或无效，返回 NULL
		JSON_UNQUOTE	JSON_UNQUOTE (<a>)	去掉 JSON 值中的引号，并将结果作为 utf8mb4 字符串返回。若参数为 NULL，返回 NULL。
		JSON_QUOTE	JSON_QUOTE (<a>)	为 JSON 值添加双引号（"）
		JSON_KEYS	JSON_KEYS(<str> [, <path>])	返回 JSON 对象的顶级值中的键值，返回结果为数组，若给定了路径参数，则返回所选路径的顶级键
		JSON_CONTAINS	JSON_CONTAINS(<json_str>, <candidate> [, <json_path>])	判断 JSON 文档中是否包含指定的 JSON 元素，若存在则返回 1，否则返回 0。如果 JSON 文档或查询的元素无效，则返回 NULL。
Date/Time	CURRENT_DATE	CURDATE()	获取当前的日期，以 DATE 类型返回。
		CURRENT_TIME	CURTIME()	获得当前的时间，以 TIME 类型返回
		NOW	NOW([<precision>])	获取当前系统时间，返回值为DATETIME类型。可以选择性地指定精度以调整返回值的小数秒部分的位数。
		CURRENT_TIMESTAMP	CURRENT_TIMESTAMP([<precision>])	同 NOW
		LOCALTIMESTAMP	LOCALTIMESTAMP([<precision>])	同 NOW
		STR_TO_DATE	STR_TO_DATE(<datetime_str>, <format>)	将日期时间字符串根据指定的格式转换为 DATETIME 类型值
		DATE_FORMAT	DATE_FORMAT(<date>, <format>)	将日期类型按照 format 的类型转化为字符串。

资源管理