계약
스키마, 열, RLS 정책, 인증 도우미, 인덱스의 이름 지정. 안정적이고 문서화된 규칙을 통해 팀에서 이름을 지정하는 한 가지 방법을 사용할 수 있습니다.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.
도메인당 접두사 1개#
각 프로젝트는 project_{uuid}접두사가 붙은 4개의 하위 스키마를 받습니다. 비즈니스 테이블은 기본 스키마로 이동합니다. 시스템 스키마에 객체를 생성하지 마십시오.
| 스키마 | 소유자 | 사용 |
|---|---|---|
project_{uuid} | 당신 | 테이블, 뷰 및 비즈니스 기능. 이는 정규화되지 않은 SQL(create table posts …)이 있는 스키마입니다. 이식 가능한 aura db backup download 및 schema/dump를 사용하여 내보낸 SQL에서만 public로 이름이 지정됩니다. |
project_{uuid}_auth | aura-auth | 사용자, 세션 및 MFA. 수정하지 마십시오. |
project_{uuid}_storage | aura-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— 회로도는 이미 절연체입니다.
sql
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, 없는 경우 NULLauth.role()— 텍스트 · 익명 / 인증됨 / 서비스_역할auth.tenant()— 현재 테넌트의 uuid(다중 테넌트 RBAC)auth.has_role(name)— 부울 · 사용자에게 이 애플리케이션 역할이 있는 경우 trueauth.email()— 텍스트 · 사용자 이메일, JWT에서 읽음auth.claim(key)— jsonb · 사용자 정의 클레임에 대한 원시 액세스
예측 가능한 이름, 작업, 역할#
규칙: <table>_<scope>_<operation>. 예: posts_own_read, orders_admin_delete. 항상 to aura_authenticated 또는 to aura_anon를 지정하세요.
sql
-- ✓ 좋음: 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