Platform

Repliki odczytu

Kopie bazy tylko do odczytu, synchronizowane strumieniowo — w tym samym lub innym regionie.

This page is available in Polish only for now. The commands, code and API calls below are the same in every language — an English translation is on its way. Open the Polish page

Replika odczytu to fizyczna kopia Postgresa projektu (streaming replication), aktualizowana na bieżąco z bazy głównej. Kieruj do niej raporty, analitykę i ciężkie zapytania select, aby odciążyć bazę główną; replika w innym regionie (np. Sztokholm dla projektu z Warszawy) skraca opóźnienia użytkowników i daje kopię geograficzną.

Dodasz ją w Baza danych → Repliki odczytu. Replika ma własny identyfikator i adresy: https://<ref-repliki>.host.ulewicz.space (REST/GraphQL, tylko odczyt) oraz db-<ref-repliki>.host.ulewicz.space:5432 (Postgres, TLS). Używa tych samych kluczy API i hasła co projekt główny.

import { createClient } from "@supabase/supabase-js";

export const supabase = createClient(PROJECT_URL, ANON_KEY);          // zapisy, Auth, Storage, Realtime
export const supabaseRead = createClient(REPLICA_URL, ANON_KEY);      // odczyty

const { data } = await supabaseRead.from("orders").select("*").limit(50);
  • Na replice nie działają zapisy, Auth, Storage, Realtime ani Edge Functions — kieruj je do projektu głównego.
  • Dane mogą być opóźnione o kilka sekund; bieżące opóźnienie (lag) widać na wykresie w panelu.
  • Limity: Pro 1, Team 3, Enterprise 10 replik na projekt. Replika jest rozliczana jak compute według swojego rozmiaru.
  • Usunięcie projektu głównego usuwa też jego repliki.
  • Gdy projekt ma ograniczenia sieciowe, adres serwera repliki w innym regionie dopisujemy do listy dozwolonych automatycznie. Replika w tym samym regionie wymaga pustej listy.
GET    /api/v1/projects/{ref}/replicas
POST   /api/v1/projects/{ref}/replicas            {"region": "eu-north-1", "compute_size": "small"}
GET    /api/v1/projects/{ref}/replicas/{replica}
DELETE /api/v1/projects/{ref}/replicas/{replica}

MCP: list_replicas, create_replica, delete_replica.