LIMIT و OFFSET في SQLite: تقسيم النتائج وترقيم الصفحات

LIMIT في SQLite: تحديد عدد النتائج المُرجَعة

تُعدّ LIMIT أبسط أداة تحكّم في SQL، فهي ببساطة تُخبر SQLite: "أعطني هذا العدد من الصفوف كحدٍّ أقصى". ضعها في نهاية جملة SELECT وستحصل على عدد النتائج المطلوب أو أقل — لن يتجاوزها أبدًا، وقد يكون أقل إن لم يحتوِ الجدول على صفوف كافية لتلبية الطلب.

CREATE TABLE books (
    id INTEGER PRIMARY KEY,
    title TEXT,
    year INTEGER
);

INSERT INTO books (title, year) VALUES
    ('The Pragmatic Programmer', 1999),
    ('Code', 1999),
    ('Refactoring', 1999),
    ('Clean Code', 2008),
    ('Designing Data-Intensive Applications', 2017);

SELECT title, year FROM books LIMIT 3;

ستحصل على أول ثلاثة صفوف. لكن أي ثلاثة بالضبط؟ هنا تكمن المشكلة — فبدون ORDER BY، يختار SQLite الترتيب الذي يناسبه في تلك اللحظة. قد يكون اليوم ترتيب الإدراج، وغداً — بعد عملية تحديث أو تغيير في الفهرس — قد يتغير. استخدام LIMIT وحده لا بأس به إذا أردت "عينة سريعة"، لكن متى ما كان الترتيب مهماً، فلا بد من تحديده صراحةً.

تخطي الصفوف من البداية باستخدام OFFSET

عند دمج LIMIT مع OFFSET، يمكنك طلب شريحة من منتصف النتائج. الجملة OFFSET k تتجاهل أول k صف، ثم تُرجع LIMIT n ما يصل إلى n صف مما تبقى.

CREATE TABLE books (
    id INTEGER PRIMARY KEY,
    title TEXT,
    year INTEGER
);

INSERT INTO books (title, year) VALUES
    ('The Pragmatic Programmer', 1999),
    ('Code', 1999),
    ('Refactoring', 1999),
    ('Clean Code', 2008),
    ('Designing Data-Intensive Applications', 2017);

SELECT title, year
FROM books
ORDER BY year, title
LIMIT 2 OFFSET 2;

هذا يعني: «تخطَّ صفّين، ثم أعِد الصفّين التاليين» — أي الصفّين الثالث والرابع من النتيجة المرتّبة. تخيّل الأمر هكذا: WHERE يُرشِّح، وORDER BY يُرتِّب، وOFFSET يتخطّى، وLIMIT يُحدِّد السقف. تُنفَّذ بهذا الترتيب، وكلٌّ منها له دور مهم.

ترقيم الصفحات في SQLite يحتاج دائمًا إلى ORDER BY

أكثر استخدام شائع لـ LIMIT وOFFSET هو ترقيم الصفحات، أي تقسيم قائمة طويلة إلى صفحات تحتوي مثلًا على 20 صفًّا لكلٍّ منها. الصفحة الأولى تكون LIMIT 20 OFFSET 0، والصفحة الثانية LIMIT 20 OFFSET 20، وهكذا.

CREATE TABLE posts (
    id INTEGER PRIMARY KEY,
    title TEXT,
    created_at TEXT
);

INSERT INTO posts (title, created_at) VALUES
    ('المنشور الأول', '2024-01-01'),
    ('المنشور الثاني', '2024-01-02'),
    ('المنشور الثالث', '2024-01-03'),
    ('المنشور الرابع', '2024-01-04'),
    ('المنشور الخامس', '2024-01-05');

-- الصفحة 2، مع منشورين في كل صفحة
SELECT id, title, created_at
FROM posts
ORDER BY created_at DESC, id DESC
LIMIT 2 OFFSET 2;

هناك أمران تجب ملاحظتهما. أولاً، وجود ORDER BY ليس اختيارياً — بدونه لا معنى لـ"الصفحة الثانية"، إذ قد يتغير ترتيب الصفوف بين كل تحميل وآخر. ثانياً، مفتاح الترتيب يتضمن id كفاصل عند التساوي. فإذا كان لتدوينتين نفس قيمة created_at، فأنت بحاجة إلى عمود فريد يضمن ترتيباً ثابتاً بينهما، وإلا فقد تتبادلان مواقعهما ويتسرب صف من صفحة إلى أخرى.

القاعدة الذهبية: رتّب حسب عمود فريد، أو حسب عمود الترتيب مضافاً إليه فاصل فريد عند التساوي.

اختصار: LIMIT n, m

تدعم SQLite صيغة قديمة بالفاصلة للحفاظ على التوافق مع MySQL، وهي: LIMIT offset, count. معناها مطابق تماماً لـ LIMIT count OFFSET offset، لكن ترتيب القيمتين معكوس، ومن السهل الخلط بينهما عند القراءة.

-- هاتان الجملتان متكافئتان:
SELECT * FROM books LIMIT 10 OFFSET 20;
SELECT * FROM books LIMIT 20, 10;     -- الإزاحة أولاً، ثم العدد

الصيغة الثانية مختصرة، لكنها توقع كثيرين ممن يتوقعون أن يكون الرقم الأول هو عدد الصفوف. الأفضل أن تلتزم بـ LIMIT n OFFSET k — فهي صريحة وتُقرأ بالترتيب الطبيعي.

استخدام OFFSET بدون LIMIT: حيلة LIMIT -1

لا يمكن استخدام OFFSET وحده — فقواعد SQLite تشترط أن يأتي بعد LIMIT. إذًا كيف تعبّر عن "تخطَّ أول 10 صفوف وأعطني كل ما يليها"؟ الحيلة المتعارف عليها هي LIMIT -1، حيث يفسّرها SQLite بمعنى "بلا حد أعلى".

CREATE TABLE numbers (n INTEGER);
INSERT INTO numbers (n) VALUES (1), (2), (3), (4), (5), (6), (7), (8);

-- تخطّ أول 3 صفوف، وأعد الباقي
SELECT n FROM numbers ORDER BY n LIMIT -1 OFFSET 3;

أي قيمة سالبة لـ LIMIT تؤدي نفس الغرض، لكن -1 هو الاصطلاح المتعارف عليه. ستراها غالبًا في السكربتات التي تتنقل عبر النتائج صفحةً صفحة، وتحتاج في الدفعة الأخيرة استعلامًا يقول "أعطني الباقي".

فخ أداء OFFSET في SQLite

إليك ما لا يذكره أحد إلا بعد أن تصطدم به: OFFSET لا يجعل SQLite يتخطى العمل فعليًا، بل يجعله يتخطى الإخراج فقط. فلكي يُرجع لك الصفوف من 10,001 إلى 10,020، يظل المحرك يمر داخليًا على العشرة آلاف صف الأولى قبل أن يبدأ بإصدار النتائج. القيم الصغيرة من OFFSET لا تكلّف شيئًا، لكن حين تصل إلى عشرات أو مئات الآلاف يصبح البطء ملحوظًا.

للتنقل العميق بين الصفحات، الحل المعتاد هو الترقيم بالمفتاح (keyset pagination): بدلًا من "تخطَّ N صفًا"، تحتفظ بمفتاح الفرز للصف الأخير، ثم تطلب "الصفوف التي تأتي بعد هذا الصف".

CREATE TABLE events (
    id INTEGER PRIMARY KEY,
    created_at TEXT,
    message TEXT
);

INSERT INTO events (created_at, message) VALUES
    ('2024-01-01 10:00', 'تسجيل الدخول'),
    ('2024-01-01 10:05', 'عرض'),
    ('2024-01-01 10:10', 'نقرة'),
    ('2024-01-01 10:15', 'تسجيل الخروج'),
    ('2024-01-01 10:20', 'تسجيل الدخول');

-- بعد استلام id=2، الصفحة التالية هي:
SELECT id, created_at, message
FROM events
WHERE id > 2
ORDER BY id
LIMIT 2;

كل صفحة تعتمد على بحث مفهرس بدل ما تمر على كل الصفوف التي قبلها. المقابل لذلك: ما تقدر تقفز مباشرة إلى "الصفحة 47" — تقدر تتنقّل للأمام فقط داخل البيانات. وهذا بالضبط التي تحتاجه في خلاصات التمرير اللانهائي ومؤشرات الـ API.

ترقيم الصفحات بـ OFFSET يفي بالغرض في لوحات الإدارة والنتائج الصغيرة. لكن لما تكون البيانات قابلة للنمو بلا حدود، الأفضل تروح إلى keyset pagination.

مثال تطبيقي كامل

نجمع كل التي فات في استعلام واحد مرقّم بصفحات، مع تصفية وترتيب ومُرجِّح حاسم لفك التعادل:

CREATE TABLE products (
    id INTEGER PRIMARY KEY,
    name TEXT,
    category TEXT,
    price REAL
);

INSERT INTO products (name, category, price) VALUES
    ('قلم', 'office', 1.50),
    ('دفتر', 'office', 4.00),
    ('دباسة', 'office', 8.00),
    ('كوب', 'kitchen', 6.00),
    ('غلاية', 'kitchen', 25.00),
    ('محمصة', 'kitchen', 30.00);

-- الصفحة 1: أرخص عنصرين من المكتب، مع ترتيب أبجدي عند تساوي السعر
SELECT name, price
FROM products
WHERE category = 'office'
ORDER BY price ASC, name ASC
LIMIT 2 OFFSET 0;

فلتَر النتائج لتقتصر على منتجات المكتب، ثم رتّبها تصاعديًا حسب السعر مع الاسم كمعيار لفك التعادل، وخُذ أول صفّين. ولعرض الصفحة الثانية، غيّر OFFSET 0 إلى OFFSET 2. الاستعلام قصير، لكن كل جملة فيه تؤدي دورًا حقيقيًا.

الخطوة التالية: DISTINCT

LIMIT يتحكم في عدد الصفوف العائدة، أما DISTINCT فيتحكم في ظهور التكرارات من الأساس. إنها الجملة التالية في صندوق أدوات SELECT، وقد تبدو سهلة لكنها خادعة عند الاستخدام الخاطئ — وهذا ما سنتناوله في الصفحة التالية.