دوال لغة الاستعلامات البنيوية (SQL) المسموح بها

لأسباب تتعلّق بالخصوصية، نحظر دوال SQL التي يمكنك استخدامها في Ads Data Hub.

الدوال العددية

يُسمَح بجميع الدوال العددية باستثناء ما يلي:

  • 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

طلبات البحث عن التحليل

بالنسبة إلى استعلامات التحليل المجمّعة، نقيد الدوال التي تجمع البيانات من عدة مستخدمين. يُسمح بجميع الدوال التجميعية والتحليلية عند المعالجة. بيانات مستخدم واحد. راجِع التجميعات على مستوى المستخدم أدناه للاطّلاع على التفاصيل.

تجميع الدوال

الوظيفة هل المنتَج مسموح به؟
ANY_VALUE نعم
APPROX_QUANTILES لا
APPROX_TOP_COUNT لا
APPROX_TOP_SUM لا
ARRAY_AGG لا
ARRAY_CONCAT_AGG لا
AVG نعم
BIT_AND لا
BIT_OR لا
BIT_XOR لا
COUNT نعم
COUNTIF نعم
LOGICAL_AND نعم
LOGICAL_OR نعم
MAX نعم
MIN نعم
SUM نعم
CORR نعم
COVAR_POP نعم
COVAR_SAMP نعم
STDDEV_POP نعم
STDDEV_SAMP نعم
STDDEV نعم
STRING_AGG لا
VAR_POP نعم
VAR_SAMP نعم
VARIANCE نعم
APPROX_COUNT_DISTINCT نعم

الدوال التحليلية

كل الإحصاءات الدوال مقيَّدة.

دوال HyperLogLog++

يتوافق Ads Data Hub مع بروتوكول HyperLogLog++ (HLL++) الأخرى. ومع ذلك، فإنها تستخدم أنواع بيانات متخصصة مع المزيد من القيود.

الأنواع المتوافقة

النوع الوصف
ADH.USER_HLL رسم تخطيطي مجمّع من قيم من النوع ADH.USER_ID
ADH.BYTE_HLL رسم تخطيطي مجمّع من قيم من أي نوع غير مستند تعريف الهوية

وتسمح هذه الأنواع بدمج تقديرات عدد القيم الفريدة للسمة واستخراجها، ولا تتيح التحويل المباشر إلى أي نوع آخر. ولا يمكن تصديرها مباشرةً. من Ads Data Hub، لذا يجب أن يستخدموا HLL_COUNT.EXTRACT أو HLL_COUNT.MERGE. قبل الوصول إلى مخرجات الاستعلام.

تمكن رسومات HLL من تقدير عدد القيم الفريدة عبر طبقات متعددة من تجميع البيانات، ولكن لاحظ أن Ads Data Hub لا يمنحان تحسين الأداء خلال COUNT(DISTINCT) في طبقة واحدة.

الدوال المتوافقة

اسم الوظيفة الأنواع المتوافقة نوع الإرجاع
HLL_COUNT.EXTRACT ADH.USER_HLL, ADH.BYTE_HLL INT64
HLL_COUNT.INIT جميع المعايير العادية والأنواع المتوافقة ADH.USER_ID ADH.USER_HLL مقابل إدخال ADH.USER_ID، وبخلاف ذلك ADH.BYTE_HLL
HLL_COUNT.INITNT.MERGE ADH.USER_HLL, ADH.BYTE_HLL INT64
HLL_COUNT.MERGE_PARTIAL ADH.USER_HLL, ADH.BYTE_HLL مثل نوع الإدخال

القيود

إضافة التشويش: لا تتوفّر دوال HLL++ عند تنفيذ طلب بحث. استخدام إضافة التشويش.

التجميعات على مستوى المستخدم

نسمح بجميع الدوال التجميعية والتحليلية في عبارات SELECT التي تجمع أو التقسيم بحلول user_id. لكي تنجح هذه الطريقة، يجب أن تجعل أي عمليات ضم سابقة توضيح أنه يتم الاحتفاظ بالبيانات على مستوى المستخدم من خلال الانضمام في user_id، كما في هذا المثال:

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)

طلبات البحث لقائمة المستخدمين

في طلبات بحث قائمة المستخدمين، يُسمح بالدوال التجميعية والدوال التحليلية غير مدعومة.