Przejdź do treści
Logo Aurabase
aurabaza

Baza danych

PostgreSQL 18, dedykowana baza danych dla każdego projektu w klastrze Twojej organizacji, izolowane schematy, automatycznie generowane typy TypeScript, natywny RLS. Żadnych rozwidleń, żadnych serwerów proxy do przepisywania — Twoje rozszerzenia, wyzwalacze i PL/pgSQL działają bez zmian.

Objaśnienie8 min przeczytanePoziom mediatorZmieniono 15 kwi 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

Postgres 18, bez abstrakcji#

Usługa aura-db udostępnia ogólny CRUD na wierzchu PostgreSQL 18: każdy projekt ma własną bazę danych hostowaną w klastrze PostgreSQL Twojej organizacji (klaster w całości poświęcony pojedynczemu projektowi w ofercie korporacyjnej). Każde wywołanie SDK jest tłumaczone na natywny SQL za pomocą cienkiej warstwy, która uwzględnia RLS policies wstrzyknięty do sesji.

Możesz także ominąć SDK i wskazać psql, Prisma, Drizzle, Kysely, Metabase lub pg_dump w swojej bazie danych: standardowy protokół przewodowy PostgreSQL, TLS, rola, która może dotrzeć tylko do bazy danych Twojego projektu. Zobacz Połącz bezpośrednio poniżej. (Wdrożenie, które nie publikuje portu PostgreSQL, mówi o tym w Studio > Ustawienia > Połączenie: użyj zestawu SDK, interfejsu API REST, edytora SQL lub interfejsu CLI, aura db raw.)

Wskazówka

pg_dump zapewnia pełną bazę danych (schemat, dane, rozszerzenia, zasady). Żadnych blokad, banalna migracja wychodząca.

Zestaw SDK wywołuje PostgREST, który wywołuje Postgres#

Pod maską zestaw SDK serializuje wywołania .from().select()… w żądaniu HTTP do aura-db, które deleguje do wózka bocznego PostgREST. PostgREST tłumaczy na SQL i otwiera połączenie w puli poprzez PgBouncer z search_path wstrzykniętego projektu.

przepływ wewnętrznytext
SDK        → HTTPS    GET /v1/db/sensors?select=id,name
Gateway    → aura-db  Session verification & routing
aura-db    → PgBouncer → PostgreSQL 18

# Połączenie z projektem search_path
SET LOCAL search_path = project_a7f3_, public;
SET LOCAL request.jwt.claims = '{ "sub": "u_9k2", "tenant": "t_4c" }';
SELECT id, name, temperature FROM sensors WHERE active = true LIMIT 50;
Informacje

Zasady RLS mają dostęp do auth.uid(), auth.role(), auth.tenant(). Pomocnicy ci odczytują request.jwt.claims wstrzyknięty przez bramę — niemożliwe do manipulacji po stronie klienta.

Sześć rodzimych umiejętności#

  • Schemat na projekt. Partycjonowanie zastosowane przez PostgreSQL: brak kolumny najemcy, jedna rola połączenia na projekt, prawa nigdy nie są udostępniane PUBLIC.
  • Migracje wersjonowane. Wersjonowany SQL, atomowe wycofywanie, zero przestojów. Typy TypeScript regenerują się przy każdej migracji.
  • Kodowanie TypeScript i Rust. Automatyczne generowanie typów tabel, widoków, wyliczeń i funkcji RPC na podstawie aktywnego schematu.
  • Natywny RLS. Testowalne zasady deklaratywne. Zestaw SDK wstawia dzierżawę roszczeń do każdego połączenia.
  • Rozszerzenia z listy dozwolonych. 14 rozszerzeń instalowanych przez platformę podczas tworzenia projektu: pgvector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql, pg_stat_statements, citext, hstore, ltree, unaccent, btree_gin, btree_gist, fuzzystrmatch, intarray.
  • Gałęzie bazy danych. aura branch create kopiuje projekt (schemat, zasady, funkcje, wyzwalacze, widoki i wiersze) do nowego projektu z własnym adresem URL i kluczami, usuwanymi automatycznie po upływie określonego czasu. Kopia wykonana w momencie tworzenia, a nie żywa replika.

CRUD ukończony, wpisany#

Cztery podstawowe operacje mają tę samą powierzchnię .from(table). Zwracane typy są wywnioskowane z Twojego schematu — otwórz swoje IDE, autouzupełnianie działa na kolumnach, złączeniach i zwrotach.

queries.tstypescript
// Lista ostatnich 50 aktywnych czujników
const { data, error } = await aura
  .from('sensors')
  .select('id, name, temperature, location!inner(city)')
  .eq('active', true)
  .order('captured_at', { ascending: false })
  .limit(50)
Wskazówka

Potrzebujesz bardziej złożonego SQL? Utwórz funkcję Postgres i wywołaj ją poprzez aura.rpc('function_name', args). Funkcje korzystają z tych samych zasad RLS co tabele.

Gotowych jest 14 dozwolonych rozszerzeń#

14 dozwolonych rozszerzeń, gotowych do każdego nowego projektu

Platforma instaluje je po utworzeniu projektu (rola projektu nie może sama uruchomić CREATE EXTENSION, więc nie ma konieczności zapominania o kroku aktywacji). Lista elementów zainstalowanych z aura db extensions list lub Studio › Baza danych › Rozszerzenia; aura db extensions enable <name> i POST /v1/db/{project_id}/schema/extensions ponownie zastosuj dozwolony.

  • pgvector (vector)
  • pg_graphql (instalowany, gdy włączysz GraphQL)
  • pg_stat_statements
  • pgkrypto
  • uuid-ossp
  • pg_trgm
  • cytat
  • sklep
  • drzewo
  • nieakcentowy
  • btree_gin
  • btree_gist
  • fuzzystrmatch
  • międzywarstwowy
Informacje

postgis, pg_cron, timescaledb, pgmq i pg_partman nie są zawarte w standardowym obrazie zarządzanym. W przypadku zaplanowanych obciążeń uruchom funkcję Edge zgodnie z harmonogramem cron w Cron. Projekt utworzony przed tą zmianą ma tylko pięć rozszerzeń historycznych (vector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql) do czasu uruchomienia przez platformę kolejnej aktualizacji schematu; pozostałych nie możesz dodać samodzielnie, ponieważ tylko operator bazy danych może je zainstalować.

Połącz się bezpośrednio: psql, Prisma, Drizzle, pg_dump#

Każdy projekt ma swoją własną rolę logowania PostgreSQL (proj_xxxxxxxx) i hosta w postaci <project-slug>.db.<your-domain> na porcie 5432. Hasło to wydawane na żądanie i pokazywane raz: platforma nie przechowuje go w sposób przejrzysty, więc utracone hasło jest zastępowane i nigdy nie odzyskiwane.

connect.shbash
# Host, port, baza danych i rola połączonego projektu (bez hasła)
aura db connection

# Wydaj hasło i wydrukuj pełny ciąg połączenia (unieważnia poprzednie hasło)
aura db connection --new-password

# Otwórz na nim psql (psql prosi o hasło)
aura connect

aura db connection --new-password drukuje ciąg, który możesz wkleić w dowolnym miejscu:

ciąg połączeniatext
postgresql://proj_ef13db60:<password>@my-app-ab12cd34.db.example.com:5432/project_694efb7f_...?sslmode=require

Ta sama karta istnieje w Studio > Ustawienia > Połączenie > Baza danych (Generuj hasło / Resetuj hasło).

  • Wymagany jest protokół TLS. Punkt końcowy odrzuca połączenia w postaci zwykłego tekstu (sslmode=require). Na lokalnym stosie k3d certyfikat jest z podpisem własnym (*.db.localhost), więc sslmode=verify-full tam z założenia zawodzi; produkcja korzysta z certyfikatu wydanego dla *.db.<your-domain>.
  • Ograniczony do projektu. Router wybiera Twoją bazę danych na podstawie nazwy roli i wymusza ją: prośba o podanie innej nazwy bazy danych nadal trafia do Twojej, a prezentowanie Twojej roli na hoście innego projektu jest odrzucane. Twoja rola nie jest superużytkownikiem i nie omija RLS; aby uruchomić migrację jako właściciel tabeli, użyj BEGIN; SET LOCAL ROLE tenant_<project-uuid>_admin; …; COMMIT;.
  • Tabele, które tu utworzysz, są prywatne dla platformy. Zabezpieczenia na poziomie wiersza nie mogą zostać włączone automatycznie dla tabeli utworzonej przez to połączenie (która wymaga superużytkownika PostgreSQL, którego zarządzany projekt nigdy nie ujawnia), więc klucze publiczne nie mają żadnych przywilejów: interfejs API REST odpowiada permission denied na klucz anon i zalogowanym użytkownikom, podczas gdy klucz service_role, Studio i Twoja własna rola czytają i zapisują go. Aby udostępnić go SDK, włącz RLS, przyznaj, a następnie dodaj politykę (patrz Zabezpieczenia na poziomie wiersza): ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT ON posts TO aura_anon; CREATE POLICY …. PostgREST dowiaduje się o nowej tabeli po uruchomieniu NOTIFY pgrst, 'reload schema'. Tabele utworzone za pośrednictwem tego połączenia przed istnieniem tej reguły zostaną zamknięte przy następnym wydaniu hasła (aura db connection --new-password), chyba że mają już włączoną opcję RLS.
  • Pula transakcji. Połączenia przechodzą przez PgBouncer w trybie transakcyjnym. Stan sesji nie jest przenoszony z jednej transakcji na następną: użyj SET LOCAL wewnątrz transakcji i spodziewaj się, że nazwane przygotowane instrukcje, LISTEN i blokady doradcze na poziomie sesji nie będą niezawodne (Prisma: dodaj pgbouncer=true do adresu URL).
  • Wersja klienta. pg_dump odrzuca serwer nowszy od siebie: użyj klienta PostgreSQL 18 (pg_dump --version).
Informacje

Dostęp bezpośredni zależy od wdrożenia publikującego port PostgreSQL. Jest włączony dla lokalnego stosu k3d i dla wdrożeń, których wartości Helm to umożliwiają (ingress.tcp.enabled za ingress-nginx lub pgproxy.nodePort); Studio i aura db connection poinformują Cię, kiedy tak nie jest.

Aby pójść dalej#