Por privacidade, restringimos as funções SQL que podem ser usadas no ADH.
Funções escalares
Todas as funções escalares, exceto as seguintes, são permitidas:
ERRORST_AREAST_ASBINARYST_ASGEOJSONST_ASTEXTST_BOUNDARYST_CENTROIDST_CENTROID_AGGST_CLOSESTPOINTST_CLUSTERDBSCANST_CONTAINSST_CONVEXHULLST_COVEREDBYST_COVERSST_DIFFERENCEST_DIMENSIONST_DISJOINTST_DISTANCEST_DUMPST_DWITHINST_EQUALSST_GEOGFROMGEOJSONST_GEOGFROMTEXTST_GEOGFROMWKBST_GEOGPOINTST_GEOGPOINTFROMGEOHASHST_GEOHASHST_INTERSECTIONST_INTERSECTSST_INTERSECTSBOXST_ISCOLLECTIONST_ISEMPTYST_LENGTHST_MAKELINEST_MAKEPOLYGONST_MAKEPOLYGONORIENTEDST_MAXDISTANCEST_NPOINTSST_NUMPOINTSST_PERIMETERST_SIMPLIFYST_SNAPTOGRIDST_TOUCHESST_UNIONST_UNION_AGGST_WITHINST_XST_Y
Consultas de análise
Para consultas de análise agregadas, restringimos funções que combinam dados de vários usuários. Todas as funções agregadas e analíticas são permitidas ao processar dados de um único usuário. Consulte Agregações no nível do usuário para mais detalhes.
Funções de agregação
As seguintes funções são permitidas para agregação entre usuários:
SUMCOUNTCOUNTIFAPPROX_COUNT_DISTINCTAVG
No modo de privacidade de verificação de diferença, as seguintes funções também são permitidas:
ANY_VALUELOGICAL_ANDLOGICAL_ORMAXMINCORRCOVAR_POPCOVAR_SAMPSTDDEV_POPSTDDEV_SAMPSTDDEVVAR_POPVAR_SAMPVARIANCE
Consulte inserção de ruído para detalhes sobre outras funções e recursos agregados específicos de ruído.
Funções analíticas
Todas as funções analíticas são restritas.
Funções HyperLogLog++
O Ads Data Hub é compatível com funções HyperLogLog++ (HLL++). No entanto, essas funções usam tipos de dados especializados com mais limitações.
Tipos compatíveis
| Tipo | Descrição |
|---|---|
ADH.USER_HLL |
Um esboço agregado de valores do tipo ADH.USER_ID |
ADH.BYTE_HLL |
Um esboço agregado de valores de qualquer tipo sem ID |
Esses tipos são compatíveis com mesclagem e extração para estimativas de cardinalidade, mas não aceitam conversão direta para nenhum outro tipo. Não é possível exportá-los direto do Ads Data Hub, ou seja, eles precisam usar HLL_COUNT.EXTRACT ou HLL_COUNT.MERGE antes de chegar ao resultado da consulta.
Os esboços do HLL habilitam a estimativa de cardinalidade em várias camadas de agregação. No entanto, no Ads Data Hub, eles não resultam em uma melhoria relevante na performance com COUNT(DISTINCT) em uma camada simples.
Funções com suporte
| Nome da função | Tipos compatíveis | Tipo de retorno |
|---|---|---|
HLL_COUNT.EXTRACT
|
ADH.USER_HLL, ADH.BYTE_HLL |
INT64
|
HLL_COUNT.INIT
|
Todos os tipos padrão compatíveis, ADH.USER_ID |
ADH.USER_HLL para entrada de ADH.USER_ID, caso contrário, ADH.BYTE_HLL |
HLL_COUNT.INITNT.MERGE
|
ADH.USER_HLL, ADH.BYTE_HLL |
INT64
|
HLL_COUNT.MERGE_PARTIAL
|
ADH.USER_HLL, ADH.BYTE_HLL |
Igual ao tipo da entrada |
Limitações
Injeção de ruído: as funções HLL++ não funcionam na hora de executar uma query usando a injeção de ruído.
Agregações do usuário
Permitimos todas as funções agregadas e analíticas em instruções SELECT que agrupam ou particionam por user_id. Para que isso funcione, os agrupamentos anteriores precisam deixar claro que os dados são mantidos no nível do usuário com agrupamentos em user_id, como neste exemplo:
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;
Consultas de listas de usuários
Nas consultas de listas de usuários, as funções agregadas são permitidas, e as analíticas não são aceitas.