ترتيب النتائج وتحديد حدودها

ترتيب النتائج

يمكنك تحديد ترتيب الصفوف في استجابتك باستخدام العبارة ORDER BY، التي تتألف من تسلسل واحد أو أكثر مفصول بفواصل من:

FieldName ('ASC' | 'DESC')?

إذا لم تحدّد ASC أو DESC بعد اسم الحقل، يتم ضبط Reporting API تلقائيًا على ASC.

يرتّب تعبير ORDER BY التالي تقرير الأداء تنازليًا تبعًا لمرات الظهور وتصاعديًا حسب أرقام تعريف عروض المنتجات:

ORDER BY metrics.impressions DESC, segments.offer_id ASC

لا يُسمح باستخدام ORDER BY مع المقاييس أو الشرائح غير المحدّدة.

الحد من عدد النتائج

يمكنك الحد من إجمالي عدد النتائج التي يتم عرضها باستخدام عبارة LIMIT. من خلال الجمع بين هذا الإجراء وترتيب النتائج، يمكنك إنشاء تقارير "أهم N"، مثل تقرير يحتوي على المنتجات الخمسة التي حقّقت أكبر عدد من مرات الظهور خلال آخر 30 يومًا:

مثال

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-31'
ORDER BY metrics.impressions DESC
LIMIT 5;

لا يُسمح بالفلترة (عبارة WHERE) على المقاييس بدون اختيارها.