관계
관계는 두 엔티티가 업무에서 어떻게 연결되는지 나타냅니다. 관계의 방향과 속성을 정하고 실제 데이터를 확인합니다.
관계 생성
온톨로지 빌더의 캔버스에서 관계를 만듭니다.
- 소스 엔티티의 연결점을 대상 엔티티로 끌어다 놓습니다.
- 관계 만들기 창이 열립니다.
관계를 저장하려면 양 끝 엔티티에 식별 키가 있어야 합니다. 관계 자체의 스키마와 식별 키는 선택 사항입니다. 관계에 스키마를 추가한 뒤에는 기존 속성의 삭제·이름 변경, 타입·NULL 허용 여부 변경, 식별 키 변경을 지원하지 않습니다.
이 항목을 바꾸려면 관계를 삭제하고 다시 만들어야 합니다. 삭제하기 전에 관계를 참조하는 파이프라인을 확인합니다. 재생성한 뒤에는 파일을 다시 올리거나 파이프라인 연결을 확인해 데이터를 다시 적재합니다.
관계 속성
- 소스 엔티티: 관계가 시작되는 주체입니다.
- 대상 엔티티: 관계가 향하는 대상입니다.
- 이름: 관계의 이름입니다. 영문 소문자로 시작하고 소문자·숫자·밑줄만 사용하는
lower_snake_case로 입력합니다. 예:knows,contains. 그래프 조회 언어인 Cypher에서 이 이름을 사용합니다. - 별칭: 화면에 대표로 보여줄 이름입니다.
- 설명: 관계의 용도와 의미를 기록합니다. AI로 설명을 제안받습니다.
- 컬렉션: 관계를 저장할 컬렉션입니다. 반드시 선택합니다.
스키마 — 식별 키 / 표시 컬럼
관계도 엔티티와 마찬가지로 스키마 정보를 함께 가집니다.
- 식별 키: 관계 스키마를 정의한 경우 관계 데이터를 구별할 키 컬럼을 선택합니다. 관계는 자체 스키마나 식별 키 없이도 만들 수 있습니다. 파이프라인 편집기에서는 관계 노드에 키 경고가 표시될 수 있으므로 입출력으로 사용하기 전에 대상 스키마와 실행 결과를 확인합니다.
- 표시 컬럼: 각 관계를 대표하는 이름으로 표시할 컬럼입니다.
데이터 적재
관계의 데이터 탭에서 CSV·JSON·Parquet 파일을 올리거나, 파이프라인의 코드 출력을 관계에 연결해 데이터를 적재합니다. 파이프라인은 필드를 자동으로 연결하지 않으므로 코드 출력의 컬럼 이름과 타입을 관계 스키마에 맞춥니다.
데이터 탭
관계 데이터는 페이지별로 조회합니다. 식별 키, 표시 컬럼, 나머지 속성 순서로 표시하며 새로고침·파일 업로드·다운로드·그래프 탐색기에서 열기·테이블 초기화를 실행합니다. 초기화의 확인 절차를 포함한 자세한 동작은 엔티티 데이터 탭과 같습니다.
관계 편집 및 삭제
- 캔버스에서 연결선을 클릭하면 오른쪽 패널에 상세 정보가 나타납니다.
- 이 패널에서 별칭·설명·태그를 고칩니다. 관계 이름과 소스·대상 엔티티는 이 패널에서 읽기 전용으로 표시됩니다.
- 연결선을 고른 뒤
Delete키를 누르면 관계가 삭제됩니다.
여러 관계를 새로 정의하려면 모델링의 AI 관계 제안에서 현재 컬렉션의 엔티티를 분석하고 소스·관계·대상을 검토해 선택한 제안만 생성합니다. 선택한 컬렉션의 모든 관계·엔티티 타입을 제거하는 작업은 온톨로지 데이터 초기화에서 대상과 진행 상태를 확인한 뒤 실행합니다.