هذه مستندات قديمة وقد لا تكون كاملة. للاطّلاع على أحدث المستندات، يُرجى الرجوع إلى موقع الجهات التسويقية إذا كنت جهة تسويقية. إذا كنت شريك قياس، يُرجى الرجوع إلى الموقع الإلكتروني شركاء القياس.

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

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

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

دوال SQL المسموح بها تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.