엔티티 관리
엔티티(Entity)는 온톨로지의 핵심 구성 요소입니다. 엔티티를 생성하고, 스키마와 식별 메타데이터를 정의하며, 인스턴스 데이터를 미리 보는 방법을 설명합니다.
엔티티 속성 정의
엔티티 생성 또는 편집 시 다음 항목들을 설정합니다.
기본 정보
엔티티 인스펙터의 스키마 영역. Identity Keys 체크박스와 Display Column 선택 드롭다운, 속성 목록이 한 화면에 보여야 합니다.
- Name: 엔티티 이름 (필수, 영문 대문자 권장)
- Alias: 사용자에게 보여줄 별칭 (목록·검색·인스펙터 1차 라벨)
- Description: 엔티티에 대한 설명 (AI 자동 생성 지원)
- Collection: 엔티티가 속할 컬렉션 (필수 — 누락 시 API 422)
- Owner: 소유자 (호버 시 사용자/그룹 미리보기)
스키마 (Schema)
엔티티가 가질 속성(Property)들을 정의합니다. 이는 backing dataset의 컬럼 구조와 일치해야 합니다.
- Name: 속성 이름
- Type: 데이터 타입 (Text, Integer, Float, Boolean, Date, Timestamp 등)
- Identity Key: 인스턴스를 고유하게 식별하는 키 컬럼 여부 (복수 컬럼 허용)
- Display Column: UI 1차 라벨로 사용할 컬럼 (스키마 전체에서 하나만)
- Nullable: 값이 비어있어도 되는지 여부
Identity Keys 필수: 파이프라인의 Entity I/O가 동작하려면 Identity Keys가 비어 있지 않아야 합니다. 비어 있으면 빌더에 경고가 표시되고, Entity 노드를 사용하는 파이프라인은 실행 시 페이로드 검증에 실패합니다.
데이터셋 매핑 (backing dataset)
엔티티를 정의한 후, 실제 데이터가 담긴 Dataset과 매핑합니다. 매핑된 데이터셋은 backing dataset 역할을 하며, 데이터셋의 References 탭에 이 엔티티가 자동 등록됩니다.
- 엔티티 상세 패널에서 Mapping 탭을 선택합니다.
- 연결할 데이터셋을 선택합니다 (동일 컬렉션의 데이터셋만 노출).
- 엔티티 속성과 데이터셋 컬럼을 1:1로 매핑합니다.
- Identity Keys 매핑을 명시하면 인스턴스 단위 조회가 가능해집니다.
인스턴스 Data 탭 (행 단위 조회)
엔티티 상세 패널의 Data 탭에서 backing dataset의 인스턴스를 페이지 단위로 조회할 수 있습니다.
엔티티 Data 탭 — 행 페이지네이션, Identity Keys 표시, Display Column 우선 정렬이 보여야 합니다.
- Identity Keys 기반 fetch: PK 컬럼을 기준으로 한 행 단위 조회. 행 클릭 시 인스턴스 상세 패널이 열립니다.
- Display Column 우선 정렬: 표시명이 1차 컬럼으로, 시스템 이름은 보조 컬럼으로.
- 컬럼 필터·정렬: 다른 데이터셋 데이터 탭과 동일한 UX.
- 인스턴스 직접 편집은 지원하지 않습니다 — 편집은 backing dataset 또는 파이프라인을 통해 수행합니다.
사라진 UI: EntitySink
이전 버전에 있던 Sink 탭/버튼은 제거되었습니다(refactor(ontology): remove EntitySink/RelationSink UI and API surface). 데이터 동기화는 백엔드 인프라가 자동으로 처리합니다.