查詢文法參考資料

下表提供完整的 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 表示任何字元。
  • | 代表「or」。
  • REGEXP_MATCH 運算子使用 RE2 語法。

  • 如要使用 LIKE 運算子比對 [、]、% 或 _ 常值，請用方括號括住字元。舉例來說，以下條件會比對所有開頭為 [Earth_to_Mars] 的 campaign.name 值：

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