دوال 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

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

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

دوال التجميع

يُسمح بالوظائف التالية للتجميع بين المستخدمين:

  • SUM
  • COUNT
  • COUNTIF
  • APPROX_COUNT_DISTINCT
  • AVG

في وضع الخصوصية الخاص بميزة "التحقُّق من الاختلافات"، يُسمح أيضًا بالوظائف التالية:

  • ANY_VALUE
  • LOGICAL_AND
  • LOGICAL_OR
  • MAX
  • MIN
  • CORR
  • COVAR_POP
  • COVAR_SAMP
  • STDDEV_POP
  • STDDEV_SAMP
  • STDDEV
  • VAR_POP
  • VAR_SAMP
  • VARIANCE

يمكنك الاطّلاع على إضافة التشويش لمعرفة تفاصيل حول الوظائف والميزات المجمّعة الإضافية الخاصة بالتشويش.

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

يتم حظر جميع وظائف التحليلات.

دوال 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 تقدير عدد العناصر في الحقل على مستوى طبقات تجميع متعددة، ولكن يُرجى العِلم أنّها لا تحقّق تحسّنًا كبيرًا في الأداء مقارنةً بـ COUNT(DISTINCT) في طبقة واحدة ضمن Ads Data Hub.

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

اسم الوظيفة الأنواع المتوافقة نوع القيمة التي تم إرجاعها
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_creative_conversions
    USING(query_id, user_id)
GROUP BY user_id;

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

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