Referencia gramatical de consulta

La siguiente tabla contiene una referencia gramatical completa del lenguaje de consulta de Search Ads 360.

Referencia gramatical
Consulta
Cláusula SELECT
SELECT FIELD_NAME (, FIELD_NAME)*
Cláusula FROM
FROM RESOURCE_NAME
Cláusula WHERE
WHERE CONDITION (AND CONDITION)*
Cláusula ORDER BY
ORDER BY ORDERING (, ORDERING)*
Cláusula LIMIT
LIMIT POSITIVE_INTEGER
Cláusula PARAMETERS
PARAMETERS LITERAL = VALUE (, LITERAL = VALUE)*
Nombre del campo
[a-z] ([a-zA-Z0-9._])*
Nombre del recurso
[a-z] ([a-zA-Z_])*
Condición FIELD_NAME OPERATOR VALUE
Pedidos
FIELD_NAME (ASC | DESC)?
Operador
= | != | > | >= | < | <= | IN | NOT IN | LIKE | NOT LIKE | CONTAINS ANY |
CONTAINS ALL | CONTAINS NONE | IS NULL | IS NOT NULL | DURING | BETWEEN |
REGEXP_MATCH | NOT REGEXP_MATCH
Función
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
Valor
LITERAL | LITERAL_LIST | NUMBER | NUMBER_LIST | STRING | STRING_LIST | FUNCTION
Número entero positivo
[1-9] ([0-9])*
Número
-? [0-9]+ (. [0-9] [0-9]*)?
String
(' Char* ') | (" Char* ")
Literal
[a-zA-Z0-9_]*
Lista de strings
( STRING (, STRING)* )
Lista literal
( LITERAL (, LITERAL)* )
Lista de números
( NUMBER (, NUMBER)* )

Clave:

  • ? indica un elemento opcional.
  • * significa cero o más
  • + significa uno o más.
  • (xxxxxx) indica una agrupación.
  • [a-z0-9] indica un rango de caracteres.
  • Char indica cualquier carácter.
  • | significa "o".
  • El operador REGEXP_MATCH usa la sintaxis RE2.
  • Para hacer coincidir un literal [, ], % o _ con el operador LIKE, encierra el carácter entre corchetes. Por ejemplo, la siguiente condición coincide con todos los valores campaign.name que comienzan con [Earth_to_Mars]:

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