스키마

스키마는 인터랙션 데이터의 구조를 정의합니다. 데이터를 저장하기 전에 엣지가 어떻게 구조화되어 있는지, 어떤 프로퍼티를 가지는지, 그리고 어떻게 쿼리할 수 있는지 정의해야 합니다.

자세한 내용은 핵심 개념을 참조하세요.

스키마 계층 구조

Service (v3: Database)
├── Label (v3: Table)
│   ├── Schema (src, tgt, fields)
│   └── Indices (v3: Indexes)
└── Alias

레이블과 별칭을 포함하는 네임스페이스입니다.

Example: an e-commerce service might contain labels for likes, recent_views, and purchases.

엣지의 스키마—src, tgt, 필드, 인덱스를 정의합니다.

프로퍼티	설명
name	형식: `service.label`
desc	설명 (v3: 코멘트)
type	레이블 타입 (INDEXED, HASH, MULTI_EDGE)
schema	엣지 구조 (src, tgt, fields)
dirType	방향 타입 (v3: direction)
storage	스토리지 URI (예: `datastore://<namespace>/<table>`)
indices	쿼리용 인덱스 (v3: indexes)
active	활성화 여부

Example: Recent Views

src: user_id (LONG)
tgt: product_id (LONG)
fields:
  - created_at (LONG)
dirType: BOTH

Example: Reactions

src: user_id (LONG)
tgt: product_id (LONG)
fields:
  - created_at (LONG)
  - reaction_type (STRING)
dirType: BOTH

인덱스는 효율적인 쿼리를 가능하게 합니다. 각 인덱스는 이름과 정렬 순서를 갖는 필드 목록을 가집니다.

indices:
  - name: by_created_at
    fields: [created_at DESC]
  - name: by_type_and_time
    fields: [reaction_type ASC, created_at DESC]

인덱스는 쓰기 시점에 미리 계산됩니다. 자세한 내용은 쿼리를 참고하세요.

레이블의 대체 이름입니다.

점진적 마이그레이션이나 도메인별 네이밍에 유용합니다.

v2와 v3는 거의 1:1로 매핑됩니다.

(이 문서는 Kanana-2로 번역되었습니다. 번역 기여를 환영합니다!)