Funciones de SQL permitidas

Por motivos de privacidad, restringimos las funciones de SQL que puedes utilizar en el CDA.

Funciones escalares

Se permiten todas las funciones escalares, excepto las siguientes:

  • ERROR
  • ST_AREA
  • ST_ASBINARY
  • ST_ASGEOJSON
  • ST_ASTEXT
  • ST_BOUNDARY
  • ST_CENTROID
  • ST_CENTROID_AGG
  • ST_CLOSESTPOINT
  • ST_CLUSTERDBSCAN
  • ST_CONTAINS
  • ST_CONVEXHULL
  • ST_COVEREDBY
  • ST_COVERS
  • ST_DIFFERENCE
  • ST_DIMENSION
  • ST_DISJOINT
  • ST_DISTANCE
  • ST_DUMP
  • ST_DWITHIN
  • ST_EQUALS
  • ST_GEOGFROMGEOJSON
  • ST_GEOGFROMTEXT
  • ST_GEOGFROMWKB
  • ST_GEOGPOINT
  • ST_GEOGPOINTFROMGEOHASH
  • ST_GEOHASH
  • ST_INTERSECTION
  • ST_INTERSECTS
  • ST_INTERSECTSBOX
  • ST_ISCOLLECTION
  • ST_ISEMPTY
  • ST_LENGTH
  • ST_MAKELINE
  • ST_MAKEPOLYGON
  • ST_MAKEPOLYGONORIENTED
  • ST_MAXDISTANCE
  • ST_NPOINTS
  • ST_NUMPOINTS
  • ST_PERIMETER
  • ST_SIMPLIFY
  • ST_SNAPTOGRID
  • ST_TOUCHES
  • ST_UNION
  • ST_UNION_AGG
  • ST_WITHIN
  • ST_X
  • ST_Y

Consultas de análisis

En las consultas de análisis agregadas, restringimos las funciones que combinan datos de varios usuarios. Todas las funciones analíticas y de agregación están permitidas cuando se procesan datos de un solo usuario. Consulta la sección Agregaciones a nivel de usuario que aparece más abajo para obtener más información.

Funciones de agregación

Función ¿Se permite?
ANY_VALUE Sí
APPROX_QUANTILES No
APPROX_TOP_COUNT No
APPROX_TOP_SUM No
ARRAY_AGG No
ARRAY_CONCAT_AGG No
AVG Sí
BIT_AND No
BIT_OR No
BIT_XOR No
COUNT Sí
COUNTIF Sí
LOGICAL_AND Sí
LOGICAL_OR Sí
MAX Sí
MIN Sí
SUM Sí
CORR Sí
COVAR_POP Sí
COVAR_SAMP Sí
STDDEV_POP Sí
STDDEV_SAMP Sí
STDDEV Sí
STRING_AGG No
VAR_POP Sí
VAR_SAMP Sí
VARIANCE Sí
APPROX_COUNT_DISTINCT Sí

Funciones analíticas

Todas las funciones analíticas están restringidas.

Funciones HyperLogLog++

El Centro de Datos de Anuncios admite funciones HyperLogLog++ (HLL++). No obstante, usan tipos de datos especializados con más limitaciones.

Tipos admitidos

Tipo Descripción
ADH.USER_HLL Un esquema agregado de valores del tipo ADH.USER_ID
ADH.BYTE_HLL Un esquema agregado de valores de cualquier tipo sin ID

Estos tipos permiten la fusión y extracción de estimaciones de cardinalidad, pero no la conversión directa a ningún otro tipo. No se pueden exportar directamente desde el Centro de Datos de Anuncios, por lo que deben usar HLL_COUNT.EXTRACT or HLL_COUNT.MERGE antes de formar parte del resultado de una consulta.

Los esquemas HLL permiten hacer estimaciones de cardinalidad de distintas capas de agregación, pero ten en cuenta que en el Centro de Datos de Anuncios no ofrecen una mejora significativa del rendimiento en comparación con COUNT(DISTINCT) en una única capa.

Funciones compatibles

Nombre de la función Tipos admitidos Tipo de resultado devuelto
HLL_COUNT.EXTRACT ADH.USER_HLL y ADH.BYTE_HLL INT64
HLL_COUNT.INIT Todos los tipos estándar admitidos y ADH.USER_ID ADH.USER_HLL con el tipo de entrada ADH.USER_ID y ADH.BYTE_HLL en el resto de los casos
HLL_COUNT.INITNT.MERGE ADH.USER_HLL y ADH.BYTE_HLL INT64
HLL_COUNT.MERGE_PARTIAL ADH.USER_HLL y ADH.BYTE_HLL Igual que el tipo de entrada

Limitaciones

Inyección de ruido: no se pueden usar funciones HLL++ al hacer una consulta con inyección de ruido.

Agregaciones a nivel de usuario

Permitimos todas las funciones analíticas y de agregación en instrucciones SELECT que agrupan o hacen particiones por user_id. Para que esto funcione, cualquier unión anterior debe aclarar que los datos se mantienen a nivel de usuario mediante una unión en user_id, como en este ejemplo:

CREATE TABLE paths AS (
SELECT ARRAY_AGG(campaign_id ORDER BY query_id.time_usec) AS path
FROM
  adh.google_ads_impressions
  LEFT JOIN adh.google_ads_clicks
    USING(query_id, user_id)
GROUP BY user_id)

Consultas de lista de usuarios

En las consultas de lista de usuarios se permiten las funciones de agregación, pero no las funciones analíticas.