개요
온톨로지는 고객, 제품, 주문 같은 엔티티를 정의하고 엔티티 사이의 관계를 연결한 모델입니다. 여러 데이터의 행을 업무에서 사용하는 개념과 이름으로 조회해야 할 때 사용합니다.
주요 개념
| 개념 | 설명 | 예시 |
|---|---|---|
| 엔티티 | 구분하여 관리할 업무 대상입니다. | 고객, 제품, 주문 |
| 관계 | 두 엔티티가 어떻게 연결되는지 정의합니다. | 고객이 주문함, 주문에 제품이 포함됨 |
| 속성 | 엔티티나 관계가 가진 데이터 항목입니다. | 고객 ID, 주문일, 수량 |
| 식별 키 | 각 데이터 행을 다른 행과 구분하는 컬럼입니다. | customer_id, order_id |
| 표시 컬럼 | 목록과 그래프에서 대표 이름으로 표시할 컬럼입니다. | 고객 이름, 제품명 |
| 인스턴스 데이터 | 엔티티·관계의 스키마에 맞춰 적재한 실제 행입니다. | 고객 행, 주문 관계 행 |
컬렉션마다 온톨로지 범위가 하나씩 연결됩니다. 엔티티와 관계는 컬렉션 트리의 말단 항목이 아니라 사이드바의 모델링과 그래프 탐색기에서 관리합니다.
온톨로지 컬렉션 목록에서 여러 행을 선택하면 삭제 권한이 있는 컬렉션만 삭제합니다. 모델링 안의 엔티티·관계 표는 이 목록 일괄 선택과 별도이며 온톨로지 데이터 초기화를 사용합니다. 공통 선택·부분 실패 규칙은 첫 화면의 관리 목록 공통 동작에서 확인합니다.
온톨로지 만들기
- 온톨로지 빌더에서 작업할 컬렉션을 선택합니다.
- 엔티티를 만들고 이름, 속성, 식별 키, 표시 컬럼을 지정합니다.
- 엔티티 사이에 관계를 만들고 방향과 속성을 정합니다.
- 데이터 탭에서 파일을 올리거나 파이프라인으로 데이터를 적재합니다.
- 데이터 탭에서 적재된 행을 확인합니다.
- 그래프 탐색기에서 엔티티나 관계를 선택해 실제 연결을 조회합니다.
엔티티와 관계를 만든 뒤에는 기존 속성의 이름·타입·NULL 허용 여부와 식별 키를 바로 변경할 수 없습니다. 업로드할 파일이나 파이프라인 출력의 컬럼과 식별 키를 대조한 뒤 생성합니다.
데이터 확인하기
모델링 목록에서 엔티티나 관계 행의 데이터를 누르면 적재된 행을 확인합니다. 식별 키를 먼저 표시하고, 표시 컬럼과 나머지 속성이 이어집니다.
파이프라인으로 적재할 때는 코드 출력의 컬럼 이름과 타입을 대상 엔티티·관계 스키마에 맞춥니다.
그래프 탐색기에서는 엔티티나 관계 유형을 선택해 연결된 데이터를 조회합니다. 결과의 노드나 연결선을 선택하면 해당 항목의 속성을 확인합니다.
원본 변경 내용이 온톨로지 화면에 반영되지 않으면 관리자에게 동기화 상태를 확인해 달라고 요청합니다. 관리자는 설정의 온톨로지 미러 유지보수에서 재동기화를 실행할 수 있습니다.
관리자는 시스템 → 설정 → 온톨로지 미러 유지보수에서 동기화됨 / 비동기화 — 재동기화 권장 상태와 비동기화 사유·감지 시각을 확인합니다. 재동기화는 현재 컬렉션만이 아니라 전체 미러를 Postgres 원본 기준으로 다시 맞추는 작업입니다. 원본 부하와 소요 시간 경고를 확인한 뒤 시작하며, 실행 중에는 버튼이 잠깁니다. 이미 다른 관리자가 실행 중이면 새 작업을 만들지 않고 진행 중임을 알립니다. 완료 뒤 설정 카드 상태와 모델링 목록을 새로 확인합니다.
이어서 할 작업
- 온톨로지 빌더 사용하기에서 엔티티와 관계를 만듭니다.
- 스키마 편집하기에서 속성과 식별 키를 정의합니다.
- 그래프 탐색하기에서 적재한 데이터의 연결을 조회합니다.