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

계약

스키마, 열, RLS 정책, 인증 도우미, 인덱스의 이름 지정. 안정적이고 문서화된 규칙을 통해 팀에서 이름을 지정하는 한 가지 방법을 사용할 수 있습니다.

레퍼런스6분 읽기레벨 초보자2026. 4. 15.에 개정됨

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

도메인당 접두사 1개#

각 프로젝트는 project_{uuid}접두사가 붙은 4개의 하위 스키마를 받습니다. 비즈니스 테이블은 기본 스키마로 이동합니다. 시스템 스키마에 객체를 생성하지 마십시오.

스키마소유자사용
project_{uuid}당신테이블, 뷰 및 비즈니스 기능. 이는 정규화되지 않은 SQL(create table posts …)이 있는 스키마입니다. 이식 가능한 aura db backup download 및 schema/dump를 사용하여 내보낸 SQL에서만 public로 이름이 지정됩니다.
project_{uuid}_authaura-auth사용자, 세션 및 MFA. 수정하지 마십시오.
project_{uuid}_storageaura-storage버킷, 객체 및 스토리지 정책
project_{uuid}_platform플랫폼함수, 작업, 크론 및 비밀

snake_case, 복수형, ID uuid#

  • 복수형 테이블: posts, comments, invoices
  • snake_case의 열: created_at, user_id, last_seen_at
  • 기본 키 id uuid primary key default gen_random_uuid() — 아니요 uuid_generate_v4(). ID가 클라이언트에 노출될 때 bigint generated always as identity보다 uuid를 선호합니다(추측할 수 없으며 JavaScript에서 2^53 정밀도 문제가 없음). ID 열도 작동하며 백업 및 복원에서 이를 처리합니다.
  • 타임스탬프 timestamptz, 절대 timestamp 알몸
  • FK 접미사 _id: author_id, tenant_id
  • 부울 접두사 is_ 또는 has_
  • 열 없음 project_id — 회로도는 이미 절연체입니다.
exemplesql
create table posts (
  id            uuid primary key default gen_random_uuid(),
  author_id     uuid not null references users(id) on delete cascade,
  title         text not null,
  is_published  boolean not null default false,
  created_at    timestamptz not null default now()
);
주의

project_id 열을 추가하지 마세요. 격리는 이미 스키마에서 발생하며 이러한 열은 보안을 추가하지 않고 인덱스를 추가합니다.

각 세션에 세 가지 기능이 주입됩니다.#

게이트웨이는 request.jwt.claims가 지정된 Postgres 연결을 엽니다. 아래 세 명의 도우미는 이러한 주장을 읽고 정책의 어느 곳에서나 사용할 수 있습니다.

  • auth.uid() — 현재 사용자의 uuid, 없는 경우 NULL
  • auth.role() — 텍스트 · 익명 / 인증됨 / 서비스_역할
  • auth.tenant() — 현재 테넌트의 uuid(다중 테넌트 RBAC)
  • auth.has_role(name) — 부울 · 사용자에게 이 애플리케이션 역할이 있는 경우 true
  • auth.email() — 텍스트 · 사용자 이메일, JWT에서 읽음
  • auth.claim(key) — jsonb · 사용자 정의 클레임에 대한 원시 액세스

예측 가능한 이름, 작업, 역할#

규칙: <table>_<scope>_<operation>. 예: posts_own_read, orders_admin_delete. 항상 to aura_authenticated 또는 to aura_anon를 지정하세요.

namingsql
-- ✓ 좋음: table_scope_op
create policy "posts_own_read"   on posts for select …
create policy "orders_admin_all" on orders for all …

-- ✗ 피하려면
create policy "allow_stuff"    -- 너무 모호하다
create policy "new_policy_42" -- 설명적이지 않음

이름 지정 및 색인 생성 시기#

  • 이름: idx_<table>_<colonnes> 또는 uq_<table>_<colonnes>(고유)
  • 항상 색인화: FK, 빈번한 filter/order_by 열, RLS 정책의 where
  • 인덱스하지 않음: 낮은 카디널리티가 있는 부울 열(부분 인덱스 사용), 테이블 < 1000개 행
  • pgvector: 100,000개 이상의 벡터인 경우 using hnsw, 그렇지 않은 경우 ivfflat

더 나아가려면#