Para proteger a privacidade, restringimos as funções SQL que podem ser usadas no Ads Data Hub.
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:
SUMCOUNTCOUNT(DISTINCT)COUNTIFAPPROX_COUNT_DISTINCTAVG
No modo de privacidade de verificação de diferenças, as seguintes funções também são permitidas:
ANY_VALUE(não compatível com entradasSTRING,BYTES,JSON,ARRAYouSTRUCT)LOGICAL_ANDLOGICAL_ORMAX(não compatível com as entradasSTRING,BYTES,JSON,ARRAYouSTRUCT)MIN(não compatível com entradasSTRING,BYTES,JSON,ARRAYouSTRUCT)CORRCOVAR_POPCOVAR_SAMPSTDDEV_POPSTDDEV_SAMPSTDDEVVAR_POPVAR_SAMPVARIANCE
Consulte injeção de ruído para mais detalhes sobre funções de agregação e recursos 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
|
INT64, NUMERIC,
STRING, BYTES,
ADH.USER_ID |
ADH.USER_HLL para entrada de ADH.USER_ID, caso contrário, ADH.BYTE_HLL |
HLL_COUNT.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 consulta 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.