Fonctions SQL autorisées

Pour des raisons de confidentialité, nous limitons les fonctions SQL que vous pouvez utiliser dans ADH.

Fonctions scalaires

Toutes les fonctions scalaires sont autorisées, à l'exception des suivantes :

• 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

Requêtes d'analyse

Pour les requêtes d'analyse agrégées, nous limitons les fonctions combinant des données provenant de plusieurs utilisateurs. Toutes les fonctions d'agrégation et analytiques sont autorisées lors du traitement des données d'un seul utilisateur. Pour en savoir plus, consultez la section Agrégations au niveau de l'utilisateur ci-dessous.

Fonctions d'agrégation

Fonction	autorisée ?
ANY_VALUE	Oui
APPROX_QUANTILES	Non
APPROX_TOP_COUNT	Non
APPROX_TOP_SUM	Non
ARRAY_AGG	Non
ARRAY_CONCAT_AGG	Non
AVG	Oui
BIT_AND	Non
BIT_OR	Non
BIT_XOR	Non
COUNT	Oui
COUNTIF	Oui
LOGICAL_AND	Oui
LOGICAL_OR	Oui
MAX	Oui
MIN	Oui
SUM	Oui
CORR	Oui
COVAR_POP	Oui
COVAR_SAMP	Oui
STDDEV_POP	Oui
STDDEV_SAMP	Oui
STDDEV	Oui
STRING_AGG	Non
VAR_POP	Oui
VAR_SAMP	Oui
VARIANCE	Oui
APPROX_COUNT_DISTINCT	Oui

Fonctions analytiques

Toutes les fonctions analytiques sont limitées.

Fonctions HyperLogLog++

Ads Data Hub est compatible avec les fonctions HyperLogLog++ (HLL++). Toutefois, celles-ci utilisent des types de données spécifiques avec des limites supplémentaires.

Types acceptés

Type	Description
ADH.USER_HLL	Résumé agrégé à partir de valeurs de type ADH.USER_ID
ADH.BYTE_HLL	Résumé agrégé à partir de valeurs autres que de type "ID"

Ces types acceptent la fusion et l'extraction pour les estimations de cardinalité, mais pas la conversion directe vers un autre type. Comme ils ne peuvent pas être directement exportés à partir d'Ads Data Hub, ils doivent utiliser HLL_COUNT.EXTRACT ou HLL_COUNT.MERGE avant d'obtenir le résultat de la requête.

Les résumés HLL permettent d'estimer la cardinalité dans plusieurs couches d'agrégation. Toutefois, notez que dans Ads Data Hub, ils ne génèrent pas de gains de performances importants par rapport à COUNT(DISTINCT) dans une couche unique.

Fonctions compatibles

Nom de la fonction	Types acceptés	Type renvoyé
HLL_COUNT.EXTRACT	ADH.USER_HLL, ADH.BYTE_HLL	INT64
HLL_COUNT.INIT	Tous les types acceptés standards, ADH.USER_ID	ADH.USER_HLL pour l'entrée de ADH.USER_ID (sinon, ADH.BYTE_HLL)
HLL_COUNT.INITNT.MERGE	ADH.USER_HLL, ADH.BYTE_HLL	INT64
HLL_COUNT.MERGE_PARTIAL	ADH.USER_HLL, ADH.BYTE_HLL	Identique au type d'entrée

Limites

Injection de bruit : les fonctions HLL++ ne sont pas acceptées lorsque l'injection de bruit est utilisée pour exécuter une requête.

Agrégations au niveau de l'utilisateur

Nous autorisons toutes les fonctions d'agrégation et analytiques dans les instructions SELECT qui effectuent des regroupements ou des partitionnements par user_id. Pour que cela fonctionne, toutes les jointures précédentes doivent indiquer clairement que les données sont conservées au niveau de l'utilisateur en effectuant une jointure sur user_id, comme dans l'exemple :

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_creative_conversions
    USING(query_id, user_id)
GROUP BY user_id)

Requêtes de liste d'utilisateurs

Dans les requêtes de liste d'utilisateurs, les fonctions d'agrégation sont autorisées, mais les fonctions analytiques ne sont pas compatibles.