Sayfalama

Sayfalama; ürünler, arama sonuçları ya da mesajlar gibi uzun bir sonuç listesini sayfa adı verilen daha küçük parçalara böler. Bir milyon satırı bir anda döndürmek yavaş olur ve çok fazla bellek kullanır; bunun yerine bir API örneğin 20 öğe döndürür ve sonraki 20'yi isteme yolunu da sunar. Aynı fikir; numaralı sayfa bağlantılarına, 'Daha fazla yükle' düğmelerine ve kullanıcı arayüzlerindeki sonsuz kaydırmaya (infinite scrolling) güç verir.

En yaygın iki teknik offset ve cursor sayfalamadır. Offset sayfalama ?limit=20&offset=40 veya ?page=3 gibi parametreler kullanır ve doğrudan SQL'in LIMIT ve OFFSET ifadeleriyle eşleşir; bu da onu kurmayı kolaylaştırır ve kullanıcıların herhangi bir sayfaya atlamasına olanak tanır. Cursor sayfalama, görülen son öğeyi işaret eden ?cursor=abc123 gibi bir token döndürür ve sonraki istek hemen o öğenin ardından devam eder.

Offset sayfalamanın büyük veya hızlı değişen verilerde iki dezavantajı vardır: veritabanı offset'ten önceki her satırı yine de okuyup atlamak zorundadır, bu yüzden derin sayfalar yavaşlar; ayrıca istekler arasında satır eklendiğinde veya silindiğinde öğeler atlanabilir ya da tekrarlanabilir. İmleç bir ID ya da zaman damgası gibi bir sütun değeri olduğunda keyset sayfalama olarak da adlandırılan cursor sayfalama, doğru yere doğrudan atlamak için bir indeks kullanarak bu iki sorunu da önler. Bedeli, doğrudan 50. sayfaya atlayamamanızdır.

İyi bir benzetme uzun bir kitap okumaktır: offset sayfalama '50. sayfaya git' demek, cursor sayfalama ise araya ayraç koyup oradan devam etmek gibidir. API'ler sonraki sayfanın nasıl alınacağını genellikle yanıtta, bir nextCursor alanı, bir hasMore bayrağı veya bir Link başlığıyla belirtir ve istemcilerin her şeyi bir anda istememesi için sayfa boyutuna üst sınır koyar.