查询语法参考文档

下表包含完整的 Search Ads 360 查询语言语法参考。

语法参考文档
查询
SELECT 子句
SELECT FIELD_NAME (, FIELD_NAME)*
FROM 子句
FROM RESOURCE_NAME
WHERE 子句
WHERE CONDITION (AND CONDITION)*
ORDER BY 子句
ORDER BY ORDERING (, ORDERING)*
LIMIT 子句
LIMIT POSITIVE_INTEGER
PARAMETERS 子句
PARAMETERS LITERAL = VALUE (, LITERAL = VALUE)*
字段名称
[a-z] ([a-zA-Z0-9._])*
资源名称
[a-z] ([a-zA-Z_])*
条件 FIELD_NAME OPERATOR VALUE
排序
FIELD_NAME (ASC | DESC)?
运算符
= | != | > | >= | < | <= | IN | NOT IN | LIKE | NOT LIKE | CONTAINS ANY |
CONTAINS ALL | CONTAINS NONE | IS NULL | IS NOT NULL | DURING | BETWEEN |
REGEXP_MATCH | NOT REGEXP_MATCH
函数
LAST_14_DAYS | LAST_30_DAYS | LAST_7_DAYS | LAST_BUSINESS_WEEK | LAST_MONTH |
LAST_WEEK_MON_SUN | LAST_WEEK_SUN_SAT | THIS_MONTH | THIS_WEEK_MON_TODAY |
THIS_WEEK_SUN_TODAY | TODAY | YESTERDAY
LITERAL | LITERAL_LIST | NUMBER | NUMBER_LIST | STRING | STRING_LIST | FUNCTION
正整数
[1-9] ([0-9])*
数字
-? [0-9]+ (. [0-9] [0-9]*)?
字符串
(' Char* ') | (" Char* ")
字面量
[a-zA-Z0-9_]*
字符串列表
( STRING (, STRING)* )
字面量列表
( LITERAL (, LITERAL)* )
数值列表
( NUMBER (, NUMBER)* )

键:

  • ? 表示可选元素。
  • * 表示 0 个或更多个
  • + 表示一个或多个。
  • (xxxxxx) 表示分组。
  • [a-z0-9] 表示字符范围。
  • Char 表示任意字符。
  • | 代表“或”。
  • REGEXP_MATCH 运算符使用 RE2 语法
  • 如需使用 LIKE 运算符匹配 []%_ 字面量,请将相应字符括在方括号中。例如,以下条件会匹配以 [Earth_to_Mars] 开头的所有 campaign.name 值:

    WHERE campaign.name LIKE '[[]Earth[_]to[_]Mars[]]%'