Dlaczego zapytanie Supabase zwraca maksymalnie 1000 rekordów — diagnostyka i testy
Poradnik techniczny · Kacper Bernecki
Problem: zapytanie do Supabase (PostgREST) zwraca tylko do 1000 rekordów, nawet gdy w bazie jest ich więcej. To nie jest pojedyncza przyczyna: ograniczenie może wynikać z ustawień serwera PostgREST, konfiguracji proxy, domyślnych zachowań klienta supabase-js, lub z użycia nagłówków Range/Prefer (np. max-rows). W praktyce trzeba sprawdzić źródło ograniczenia krok po kroku — od zapytań SQL i LIMIT, przez nagłówki HTTP stosowane przez bibliotekę, po ustawienia instancji Supabase/Edge. Poniższa procedura daje konkretną listę testów do wykonania, warianty diagnostyczne (jeśli to LIMIT w zapytaniu, jeśli to PostgREST, jeśli to proxy) oraz sprawdzone kroki naprawcze, w tym użycie paginacji po kluczu, kursory lub zmiana ustawień serwera gdy to możliwe.
Jak rozpoznać przyczynę
Klient: sprawdź czy w kodzie nie ustawiono jawnie .limit(1000) lub domyślnego ograniczenia. Biblioteka supabase-js pozwala łączyć .select() z .limit(); sprawdź źródłowy kod zapytania i logi sieciowe w przeglądarce/CLI, czy parametr LIMIT nie jest dołączany.
PostgREST/serwer: PostgREST może stosować limity wyników zależne od konfiguracji serwera (np. max-rows) lub proxy API Gateway może obcinać odpowiedzi. Jeżeli zapytanie bezpośrednio do PostgREST (np. curl) też zwraca 1000 rekordów, to ograniczenie leży po stronie serwera/konfiguracji.
Rozwiązanie krok po kroku
1. Replikacja zapytania przez curl: pobierz URL endpointu REST (z dashboardu lub logs), wykonaj curl -i 'https://.../rest/v1/tablename?select=*' z tymi samymi nagłówkami Authorization; jeśli odpowiedź ma 1000 rekordów, to ograniczenie po stronie serwera.
2. Sprawdź kod klienta: przeglądaj miejsca z .select(), .range() i .limit() w repozytorium. Wyszukaj frazy ".limit(" ".range(" "Prefer:”, upewnij się, że nie ingeruje helper pagination. Usuń lub zmodyfikuj i porównaj wyniki.
3. Test nagłówków Range/Prefer: wyślij zapytanie curl z nagłówkiem Prefer: count=exact i bez niego; następnie dodaj Prefer: params=single-object; porównaj — PostgREST zmienia zachowanie przy określonych preferencjach.
4. Sprawdź logi serwera/API Gateway: jeśli masz dostęp do dashboardu Supabase lub warstwy proxy, sprawdź logi requestów i ewentualne limity odpowiedzi, timeouty lub 413/206 statusy wieloczęściowe, które mogą sugerować obcinanie odpowiedzi.
5. Alternatywna paginacja po kluczu: jeśli baza jest duża, zaimplementuj paginację po kolumnie indexowanej (WHERE id > last_id LIMIT 1000); to omija limit globalny i daje pewne, powtarzalne części wyników.
6. Test bezpośrednio na DB (psql): jeśli masz uprawnienia, uruchom SELECT COUNT(*) i SELECT * LIMIT 1500; jeśli psql zwróci >1000, problem w warstwie HTTP/PostgREST, nie w bazie.
7. Sprawdzenie wersji i dokumentacji: potwierdź wersję PostgREST/Supabase w używanej instancji i porównaj z dokumentacją dotyczącą domyślnych limitów — jeśli limit wynika z konfiguracji hostowanej instancji, zgłoś do wsparcia lub zastosuj paginację.
Jak sprawdzić, czy problem zniknął
Test A — curl bez modyfikacji: wywołaj endpoint REST z tymi samymi nagłówkami co aplikacja; porównaj liczbę rekordów z SELECT COUNT(*) z psql. Różnica wskazuje na layer obcinający odpowiedź.
Test B — paginacja po kluczu: wykonaj serię zapytań WHERE id > last_id LIMIT 500 do wyczerpania; jeśli zebrane rekordy równe liczbie w COUNT, rozwiązanie działa i omija limit 1000.
Test C — usunięcie nagłówków/limitów w kliencie: zmodyfikuj kod testowy tak, by nie używał .limit/.range/.Prefer; jeśli odpowiedź wzrośnie powyżej 1000 przy bezpośrednim curl, to klient był przyczyną.
Czego nie robić
Nie zakładaj, że limit 1000 to błąd aplikacji – najpierw porównaj z bezpośrednim SELECT w DB; przechodzenie od razu do zmian w kodzie bez testów curl/psql spowoduje zbędne zmiany.
Nie zwiększaj LIMIT w nieskończoność w jednym zapytaniu produkcyjnym; duże jednorazowe odpowiedzi mogą powodować timeouty i pamięciowe problemy po stronie klienta/serwera.
Nie pomijaj logów serwera/API Gateway: brak ich analizy to częsty błąd, bo to tam zwykle widać, czy odpowiedź została obcięta, zmieniona czy paginowana przez proxy.