본문으로 건너뛰기
아우라베이스 로고
아우라베이스

데이터베이스

PostgreSQL 18, 조직 클러스터의 프로젝트별 전용 데이터베이스, 격리된 스키마, 자동 생성된 TypeScript 유형, 기본 RLS. 포크도 없고 프록시 재작성도 없습니다. 확장, 트리거, PL/pgSQL은 그대로 작동합니다.

설명8분 읽기레벨 중급2026. 4. 15.에 개정됨

이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

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를 통해 풀링된 연결을 엽니다.

내부 흐름text
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를 열고 자동 완성 기능이 열, 조인 및 반환에 대해 작동합니다.

queries.tstypescript
// 최근 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> 형식의 호스트가 있습니다. 비밀번호는 요청 시 발급되며 한 번 표시됩니다. 플랫폼은 비밀번호를 명확하게 유지하지 않으므로 분실한 비밀번호는 교체되고 복구되지 않습니다.

connect.shbash
# 연결된 프로젝트의 호스트, 포트, 데이터베이스 및 역할(비밀번호 없음)
aura db connection

# 비밀번호를 발급하고 전체 연결 문자열을 인쇄합니다(이전 비밀번호 취소).
aura db connection --new-password

# psql을 엽니다(psql이 비밀번호를 묻습니다).
aura connect

aura db connection --new-password는 어디에나 붙여넣을 수 있는 문자열을 인쇄합니다.

연결 문자열text
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에서 알려드립니다.

더 나아가려면#