语法概览
ResourceQL能够提供类似SQL的服务来灵活地查询您的云资源。
SELECT name, created, updated FROM resources WHERE region_id = 'regionid1'
语句不区分大小写，即'SELECT COUNT(*)' 和'select CoUnT(*)'没有区别。用单引号表示字符串字面量。
ResourceQL支持以下7种数据类型。其中数组类型用'[]'来索引某个位置（标号从'1'开始）。
类型名 |
类型英文 |
|---|---|
整型 |
int/integer |
浮点型 |
float/double |
布尔型 |
boolean |
数组型 |
array |
字符串 |
string |
字典型 |
object |
时刻型 |
date |
您的所有云资源构成了一张表，表名固定为resouces。您的资源聚合器下的资源构成了一张表，表名固定为aggregator_resources。表中每一行记录了一条数据，每一列约定如下：
资源参数 |
参数类型 |
含义 |
|---|---|---|
id |
String |
资源ID。 |
name |
String |
资源名称。 |
provider |
String |
云服务名称。 |
type |
String |
资源类型。 |
region_id |
String |
区域ID。 |
project_id |
String |
项目ID。 |
ep_id |
String |
企业项目ID。 |
checksum |
String |
资源详情校验码。 |
created |
Date |
资源创建时间。 |
updated |
Date |
资源更新时间。 |
provisioning_state |
String |
资源操作状态。 |
tag |
Array(Map<String,String>) |
资源Tag。 |
properties |
Map<String,Object> |
资源详细属性。 |
资源聚合器表aggregator_resources则额外支持资源参数domain_id，类型为String，含义为账号ID。
不同类型的资源可以用'provider'和'type'来区分，它们对应的'properties'字段的结构也就不一样。 例如，ecs的cloudservers拥有包含23个字段的'properties'，而vpc仅有包含3个字段的'properties'。
各个资源类型properties内支持的字段以及类型可以在配置审计控制台的新建查询页面查看，具体请参见新建查询。
对于某个具体的资源类型，我们可以用'.'嵌套的方式去查询'properties'下的具体字段。例如，弹性云服务器的'properties'里有'status'和'addresses'字段，可以用如下语句查询正在运行的弹性云服务器及其地址。
SELECT name, created, updated, properties.addresses FROM resources WHERE provider = 'ecs' AND type = 'cloudservers' AND properties.status = 'ACTIVE'
