데이터베이스
PostgreSQL 18, 조직 클러스터의 프로젝트별 전용 데이터베이스, 격리된 스키마, 자동 생성된 TypeScript 유형, 기본 RLS. 포크도 없고 프록시 재작성도 없습니다. 확장, 트리거, PL/pgSQL은 그대로 작동합니다.
Postgres 18, 추상화 없음#
aura-db 서비스는 PostgreSQL 18 위에 일반 CRUD를 노출합니다. 각 프로젝트에는 조직의 PostgreSQL 클러스터(엔터프라이즈 제품의 단일 프로젝트 전용 클러스터)에서 호스팅되는 자체 데이터베이스가 있습니다. 각 SDK 호출은 세션에 주입된 RLS policies를 존중하는 얇은 계층을 통해 기본 SQL로 변환됩니다.
SDK를 우회하고 데이터베이스에서 psql, Prisma, Drizzle, Kysely, Metabase 또는 pg_dump를 지정할 수도 있습니다. 표준 PostgreSQL 유선 프로토콜, TLS는 프로젝트의 데이터베이스에만 연결할 수 있는 역할입니다. 아래의 직접 연결을 참조하세요. (PostgreSQL 포트를 게시하지 않는 배포는 Studio › 설정 › 연결: SDK, REST API, SQL 편집기 또는 CLI, aura db raw사용에 명시되어 있습니다.)
pg_dump는 완전한 데이터베이스(스키마, 데이터, 확장, 정책)를 제공합니다. 종속이 없고 간단한 아웃바운드 마이그레이션이 가능합니다.
SDK는 Postgres를 호출하는 PostgREST를 호출합니다.#
내부적으로 SDK는 .from().select()… 호출을 PostgREST 사이드카에 위임하는 aura-db에 대한 HTTP 요청으로 직렬화합니다. PostgREST는 SQL로 변환되고 주입된 프로젝트의 search_path와 함께 PgBouncer를 통해 풀링된 연결을 엽니다.
SDK → HTTPS GET /v1/db/sensors?select=id,name
Gateway → aura-db Session verification & routing
aura-db → PgBouncer → PostgreSQL 18
# 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;
RLS 정책은 auth.uid(), auth.role(), auth.tenant()에 액세스할 수 있습니다. 이러한 도우미는 게이트웨이에 의해 주입된 request.jwt.claims를 읽습니다. 클라이언트 측에서는 조작이 불가능합니다.
6가지 기본 능력#
- 프로젝트별 스키마. PostgreSQL에 의해 적용된 파티셔닝:tenant_id 열이 없고 프로젝트당 하나의 연결 역할이 있으며 권한은 PUBLIC에 열리지 않습니다.
- 버전이 지정된 마이그레이션. 버전이 지정된 SQL, 원자성 롤백, 가동 중지 시간 없음. TypeScript 유형은 마이그레이션할 때마다 다시 생성됩니다.
- 코드 생성 TypeScript 및 Rust. 라이브 스키마에서 테이블, 뷰, 열거형 및 RPC 함수에 대한 유형을 자동으로 생성합니다.
- 네이티브 RLS. 테스트 가능한 선언적 정책. SDK는 각 연결에 클레임 테넌트를 삽입합니다.
- 허용 목록에 있는 확장 프로그램입니다. 프로젝트 생성 시 플랫폼에 의해 설치되는 14개 확장:
pgvector,pgcrypto,uuid-ossp,pg_trgm,pg_graphql,pg_stat_statements,citext,hstore,ltree,unaccent,btree_gin,btree_gist,fuzzystrmatch,intarray. - 데이터베이스 분기.
aura branch create는 자체 URL과 키를 사용하여 프로젝트(스키마, 정책, 함수, 트리거, 보기 및 행)를 새 프로젝트에 복사하며 수명이 지나면 자동으로 삭제됩니다. 라이브 복제본이 아닌 생성 시 만들어진 복사본입니다.
CRUD 완료, 입력됨#
네 가지 기본 작업은 동일한 .from(table)표면을 공유합니다. 반환된 유형은 스키마에서 유추됩니다. IDE를 열고 자동 완성 기능이 열, 조인 및 반환에 대해 작동합니다.
// 최근 50개의 활성 센서 나열
const { data, error } = await aura
.from('sensors')
.select('id, name, temperature, location!inner(city)')
.eq('active', true)
.order('captured_at', { ascending: false })
.limit(50)
더 복잡한 SQL이 필요하십니까? Postgres 함수를 생성하고 aura.rpc('function_name', args)를 통해 호출합니다. 함수는 테이블과 동일한 RLS 정책의 이점을 얻습니다.
허용 목록에 있는 확장 프로그램 14개 준비됨#
14개의 허용 목록 확장 프로그램, 새 프로젝트마다 준비됨
플랫폼은 프로젝트가 생성될 때 이를 설치합니다(프로젝트 역할은 CREATE EXTENSION 자체를 실행할 수 없으므로 잊어버릴 활성화 단계가 없습니다). aura db extensions list 또는 Studio와 함께 설치된 항목 나열 › 데이터베이스 › 확장; aura db extensions enable <name> 및 POST /v1/db/{project_id}/schema/extensions는 허용된 항목을 다시 적용합니다.
- pgvector (
vector) - pg_graphql( GraphQL을 활성화할 때 설치됨)
- pg_stat_statements
- pgcrypto
- uuid-ossp
- pg_trgm
- 인용문
- hstore
- l트리
- 악센트가 없는
- btree_gin
- btree_gist
- fuzzystrmatch
- 인타레이
postgis, pg_cron, timescaledb, pgmq및 pg_partman는 표준 관리형 이미지에 번들로 제공되지 않습니다. 예약된 워크로드의 경우 Cron의 cron 일정에 따라 Edge Function을 트리거합니다. 이 변경 이전에 생성된 프로젝트에는 플랫폼이 다음 스키마 업데이트를 실행할 때까지 5개의 기록 확장(vector, pgcrypto, uuid-ossp, pg_trgm, pg_graphql)만 있습니다. 다른 항목은 데이터베이스 운영자만 설치할 수 있으므로 직접 추가할 수 없습니다.
직접 연결: psql, Prisma, Drizzle, pg_dump#
각 프로젝트에는 자체 PostgreSQL 로그인 역할(proj_xxxxxxxx)과 포트 5432에 <project-slug>.db.<your-domain> 형식의 호스트가 있습니다. 비밀번호는 요청 시 발급되며 한 번 표시됩니다. 플랫폼은 비밀번호를 명확하게 유지하지 않으므로 분실한 비밀번호는 교체되고 복구되지 않습니다.
# 연결된 프로젝트의 호스트, 포트, 데이터베이스 및 역할(비밀번호 없음)
aura db connection
# 비밀번호를 발급하고 전체 연결 문자열을 인쇄합니다(이전 비밀번호 취소).
aura db connection --new-password
# psql을 엽니다(psql이 비밀번호를 묻습니다).
aura connect
aura db connection --new-password는 어디에나 붙여넣을 수 있는 문자열을 인쇄합니다.
postgresql://proj_ef13db60:<password>@my-app-ab12cd34.db.example.com:5432/project_694efb7f_...?sslmode=require
Studio › 설정 › 연결 › 데이터베이스(비밀번호 생성/비밀번호 재설정)에 동일한 카드가 존재합니다.
- TLS가 필요합니다. 엔드포인트는 일반 텍스트 연결(
sslmode=require)을 거부합니다. 로컬 k3d 스택에서는 인증서가 자체 서명되어 있으므로(*.db.localhost)sslmode=verify-full는 설계상 실패합니다. 프로덕션에서는*.db.<your-domain>에 대해 발급된 인증서를 사용합니다. - 프로젝트에 국한됩니다. 라우터는 역할 이름에서 데이터베이스를 선택하고 강제합니다. 다른 데이터베이스 이름을 묻는 것은 여전히 귀하의 이름이며 다른 프로젝트의 호스트에서 귀하의 역할 제시는 거부됩니다. 귀하의 역할은 수퍼유저가 아니며 RLS를 우회하지 않습니다. 테이블 소유자로 마이그레이션을 실행하려면
BEGIN; SET LOCAL ROLE tenant_<project-uuid>_admin; …; COMMIT;를 사용하세요. - 여기에서 생성하는 테이블은 플랫폼 전용입니다. 행 수준 보안은 이 연결을 통해 생성된 테이블(관리 프로젝트가 절대 노출하지 않는 PostgreSQL 수퍼유저가 필요함)에 대해 자동으로 켜질 수 없으므로 공개 키는 이에 대한 권한을 얻지 못합니다. REST API는 anon 키와 로그인한 사용자에게
permission denied에 응답하는 반면service_role키, Studio 및 자신의 역할은 이를 읽고 씁니다. 이를 SDK에 노출하려면 RLS를 활성화하고 권한을 부여한 다음 정책을 추가합니다( 행 수준 보안참조):ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT ON posts TO aura_anon; CREATE POLICY …. PostgREST는NOTIFY pgrst, 'reload schema'을 실행할 때 새 테이블에 대해 학습합니다. 이 규칙이 존재하기 전에 이 연결을 통해 생성된 테이블은 이미 RLS가 활성화되어 있지 않은 한 다음에 암호(aura db connection --new-password)를 발행할 때 닫힙니다. - 트랜잭션 풀러. 연결은 트랜잭션 모드에서 PgBouncer를 통해 진행됩니다. 세션 상태는 한 트랜잭션에서 다음 트랜잭션으로 이어지지 않습니다. 트랜잭션 내에서
SET LOCAL을 사용하고 명명된 준비된 문,LISTEN및 세션 수준 권고 잠금이 신뢰할 수 없을 것으로 예상합니다(Prisma: URL에pgbouncer=true추가). - 클라이언트 버전.
pg_dump는 자신보다 새로운 서버를 거부합니다. PostgreSQL 18 클라이언트(pg_dump --version)를 사용하세요.
직접 액세스는 PostgreSQL 포트를 게시하는 배포에 따라 달라집니다. 로컬 k3d 스택 및 Helm 값이 이를 활성화하는 배포(ingress-nginx 뒤의ingress.tcp.enabled 또는 pgproxy.nodePort)에 대해 켜져 있습니다. 그렇지 않은 경우 Studio와 aura db connection에서 알려드립니다.