모델링

온톨로지 빌더에서 엔티티와 관계를 만들고 서로 연결합니다. 캔버스에서 전체 구조를 확인하고 각 항목의 스키마와 데이터를 관리합니다.

화면 구성

뷰 모드

상단 헤더에서 화면 모드를 전환합니다.

• 빌더: 엔티티를 노드로, 관계를 연결선으로 표시합니다. 전체 구조를 확인하고 연결을 편집합니다.
• 목록: 엔티티와 관계를 목록으로 표시합니다. 항목을 검색하거나 속성을 확인합니다.

템플릿 패널

왼쪽 패널에서 엔티티를 만들 때 사용할 템플릿을 선택합니다.

• Person, Organization, Product와 같은 템플릿을 캔버스에 끌어다 놓아 엔티티를 만듭니다.

캔버스

엔티티를 배치하고 관계를 연결하는 작업 영역입니다.

• 이동: 노드를 원하는 자리에 끌어다 놓습니다.
• 연결: 노드의 연결점(핸들)을 다른 노드에 끌어다 놓으면 관계 만들기 창이 열립니다.
• 확대/축소: 마우스 휠이나 화면의 조절 버튼을 사용합니다.
• 자동 레이아웃: 상단 메뉴에서 노드를 자동으로 정렬합니다.
• 관계 강조 표시: 관계선에 마우스를 올리거나 누르면 해당 관계와 양 끝 엔티티가 강조됩니다. 같은 엔티티에 연결된 다른 관계는 옅게 표시되고 나머지 항목은 흐리게 표시됩니다.
• 엔티티 그룹 보기: 엔티티에 그룹을 지정하면 캔버스 왼쪽 위에 그룹 선택 메뉴가 나타납니다. 그룹을 선택하면 해당 엔티티와 연결된 관계·상대 엔티티가 함께 표시됩니다. 전체 그룹을 선택하면 모든 항목을 표시합니다. 관계에는 그룹을 지정하지 않습니다.

속성 패널

오른쪽에 있으며, 선택한 엔티티나 관계의 상세 정보를 편집합니다.

• 이름 표기 방식: 속성 패널과 노드에는 별칭을 대표 이름으로 표시하고 시스템 이름을 보조 이름으로 표시합니다. 별칭이 없으면 시스템 이름만 표시합니다.

검색

• 현재 화면 검색: ⌘F(macOS) / Ctrl+F(Windows)로 현재 캔버스의 엔티티와 관계를 찾습니다.
• 전체 검색 열기: 모델링 목록 헤더의 검색 아이콘을 누르면 허브 전역 검색이 열립니다. ⌘K(macOS) / Ctrl+K(Windows)로도 엽니다. 다른 모델의 엔티티·관계, 데이터 자산, 에이전트를 검색합니다. 검색 결과를 누르면 해당 모델링 위치로 이동합니다.

유효성 검사

상단의 모델 품질 진단을 누르면 현재 선택한 컬렉션의 엔티티와 관계 구조를 검사합니다. Error는 중복 엔티티 이름과 같은 소스·대상 사이의 중복 관계, Warning은 관계가 없는 고립 엔티티와 순환 경로, Info는 자기 참조 관계와 별칭이 없는 엔티티를 표시합니다. 항목을 누르면 캔버스의 해당 엔티티 노드나 관계선이 선택됩니다. 이 진단은 모델 구조의 품질 신호이며 데이터 행, 스키마 저장 요청 또는 파이프라인 실행의 유효성을 검사하는 기능은 아닙니다. 컬렉션을 선택하지 않으면 진단할 수 없습니다.

엔티티 생성

1. 템플릿 사용: 왼쪽 패널에서 원하는 템플릿을 캔버스로 끌어다 놓습니다.
2. 직접 만들기: 캔버스의 빈 공간에서 마우스 오른쪽 버튼을 클릭하거나 상단의 엔티티 만들기 버튼을 클릭합니다.
3. 설정: 이름, 설명, 속성(컬럼) 등을 정의하고 저장합니다.

관계 설정

1. 소스 엔티티의 테두리에 있는 연결점에 마우스를 올립니다.
2. 연결점을 대상 엔티티로 끌어다 놓습니다.
3. 관계 만들기 창에서 관계 이름을 입력하고 저장합니다. 예: purchased, works_for

식별 키와 표시 컬럼

엔티티·관계의 속성 패널에는 식별 키와 표시 컬럼 필드가 나타납니다.

• 식별 키: 엔티티의 각 항목을 고유하게 구분하는 컬럼입니다. 엔티티를 만들고 파이프라인 입출력으로 사용하려면 지정합니다. 관계 자체의 스키마와 식별 키는 선택 사항이며 양 끝 엔티티의 식별 키가 관계 생성에 사용됩니다.
• 표시 컬럼: 전역 검색, 트레이스, 속성 패널에서 대표 이름으로 사용할 컬럼입니다. 지정하지 않으면 시스템 이름을 표시합니다.

필드 유형과 제약 조건을 지정하는 방법은 스키마 편집기 사용하기에서 확인합니다.

데이터 적재하기

엔티티·관계의 데이터 탭에서 현재 데이터를 확인합니다. 도구 모음에서 CSV·JSON·Parquet 파일을 직접 올리거나, 파이프라인에서 코드 노드의 출력을 엔티티·관계에 연결해 데이터를 적재합니다.

파이프라인 연결은 스키마를 비교하거나 필드를 자동으로 연결하지 않습니다. 코드 출력의 컬럼 이름과 타입을 대상 엔티티·관계 스키마에 맞춥니다. 연결 방법은 노드 연결하기에서 확인합니다.

개별 테이블과 컬렉션 전체 초기화 구분: 엔티티·관계의 데이터 탭에 있는 테이블 초기화는 해당 타입의 적재 행만 지우고 타입 정의는 남깁니다. 모델링 상단의 온톨로지 데이터 초기화는 선택한 컬렉션의 관계 타입을 먼저, 엔티티 타입을 다음 순서로 모두 삭제합니다.

컬렉션 전체를 초기화하려면 먼저 창에서 관계·엔티티 수와 이름 목록을 확인하고 표시된 컬렉션 이름을 그대로 입력한 뒤 일괄 삭제 시작을 누릅니다. 이 작업은 되돌릴 수 없습니다. 대기 중 또는 실행 중에는 같은 컬렉션의 생성·수정·삭제가 잠기며, 상태 배너에서 전체 처리 수, 관계·엔티티별 완료 수, 현재 항목, 실패·건너뜀과 완료 / 부분 완료 / 실패 / 취소됨 상태를 확인합니다. 다른 세션에서 이미 실행한 작업이 있으면 새로 시작하지 않고 그 상태를 이어서 표시합니다. 끝난 뒤 목록 새로고침으로 남은 항목을 확인합니다.

AI 자동 생성

엔티티나 관계를 선택하고 속성 패널의 AI로 설명 생성을 누르면 이름과 속성을 바탕으로 설명을 생성합니다. 생성된 설명을 검토한 뒤 저장합니다.

현재 컬렉션에 엔티티가 2개 이상 있으면 상단의 AI: 관계 제안으로 가능한 관계를 요청합니다. 요청 중에는 분석한 컬렉션과 엔티티 수, AI 관계 제안 생성 중이 표시되며 관계 제안 중지로 취소합니다. 결과 창에서 소스 엔티티, 관계 이름, 대상 엔티티와 설명을 검토하고 검색하거나 소스별·전체 선택을 사용합니다. 기존과 중복되는 관계는 제안에서 제외되며 N개 관계 생성을 누르면 선택한 항목만 만듭니다. 완료 알림에서 생성 수와 실패 수를 확인하고, 일부 실패해도 성공한 관계는 유지됩니다.

버전과 소속 컬렉션

• 버전 이력: 모든 변경은 버전 이력으로 기록되고 화면에 표시됩니다. 현재 타임라인은 읽기 전용이며 일반 자산처럼 복원하지 않습니다. 자산별 차이는 버전 기록에서 확인합니다.
• 소속 컬렉션 지정 필수: 엔티티나 관계를 새로 만들거나 옮길 때는 소속 컬렉션을 반드시 지정해야 합니다. 컬렉션 트리에서 열고 들어온 빌더는 해당 컬렉션이 자동으로 적용됩니다.

내보내기/가져오기

온톨로지 정의를 파일로 내보내거나 외부 파일에서 가져옵니다.

• 내보내기(JSON): 현재 컬렉션의 엔티티, 관계, 속성(스키마)을 JSON 파일로 저장합니다.
• 가져오기(JSON · TTL/Turtle): JSON 정의 파일과 Turtle(TTL/RDF) 파일을 가져옵니다. TTL의 OWL 클래스는 엔티티로, 데이터 속성은 엔티티 컬럼으로, 객체 속성은 관계로 변환합니다. rdfs:label은 별칭으로, rdfs:comment는 설명으로 가져옵니다.
• 가져올 컬렉션 자동 지정: 가져온 항목은 파일에 적힌 값과 관계없이 지금 선택한 컬렉션으로 들어갑니다. 같은 이름의 엔티티·관계가 이미 있으면 건너뜁니다.
• 진행률 표시: 가져오는 동안 검증 → 엔티티 → 관계 → 새로고침 단계와 함께 처리한 개수 / 전체 개수, 그리고 지금 처리 중인 항목 이름이 실시간으로 표시됩니다.

자기 참조 관계

엔티티는 자기 자신과의 관계도 정의합니다. 예를 들어 Person 엔티티의 manages 관계가 같은 Person 엔티티를 가리키도록 설정합니다.

목록 화면

목록 화면에서는 엔티티와 관계를 표로 관리합니다.

엔티티 테이블

• 검색: 이름·별칭·태그로 검색합니다.
• 정렬: 이름 컬럼 헤더를 클릭해 정렬합니다.
• 편집: 행을 클릭해 편집 창을 열거나 작업 메뉴에서 데이터 조회·편집·삭제를 선택합니다.

관계 테이블

• 검색: 이름·별칭·소스 엔티티·대상 엔티티·태그로 검색합니다.
• 정렬: 이름 컬럼 헤더를 클릭해 정렬합니다.
• 편집: 행을 클릭해 편집 창을 열거나 작업 메뉴에서 데이터 조회·편집·삭제를 선택합니다.

키보드 단축키

단축키	동작
Delete / Backspace	선택한 항목 삭제
⌘Z(macOS) / Ctrl+Z(Windows)	실행 취소
⌘Shift+Z(macOS) / Ctrl+Shift+Z(Windows)	다시 실행
⌘A(macOS) / Ctrl+A(Windows)	전체 선택
Space	팬 모드로 전환
V	선택 모드로 전환

상단의 ? 아이콘을 누르면 전체 단축키 목록이 표시됩니다.

실전 예제

• 코로나19 지역 분석 — 행정구역 인구부터 동선 핫스팟, 지역 온톨로지까지 — 전국 일부 동 단위의 합성 데이터를 통합해 지역 단위 전염병 감시 그래프를 구성하는 90분 워크숍입니다.