온톨로지 변경하고 전달하기
실제로 지원되는 모델 변경 범위를 확인하고 분석가에게 Cypher를, 엔지니어에게 파이프라인 출력 계약을 전달합니다.
운영 데이터가 바뀌면 엔티티와 관계의 정의, 적재 파이프라인, 이를 사용하는 Cypher를 함께 확인해야 합니다. 마지막 레슨에서는 포털에서 직접 수정할 수 있는 범위와 삭제 후 다시 만들어야 하는 범위를 구분하고, 결과를 재현할 수 있는 정보를 전달합니다.
생성 후 수정 가능한 항목 이해하기
저장된 엔티티나 관계를 선택하면 개요, 속성, 데이터, 히스토리 탭이 표시됩니다. 모든 항목을 자유롭게 바꿀 수 있는 것은 아닙니다.
| 변경 | 현재 포털 | 영향 |
|---|---|---|
| 별칭·설명·태그 | 개요에서 저장 가능 | 캔버스 표시와 검색 문맥 |
| Nullable 새 속성 추가 | 기존 스키마에 추가 가능 | Code 출력, 데이터가 없는 기존 행의 NULL 처리 |
| Display Column 변경 | 생성 후 읽기 전용 | 그래프 노드 이름표 |
| 이름 변경 | 생성 후 읽기 전용 | 새 리소스로 다시 만들어야 함 |
| 속성 삭제·이름 변경 | 기존 항목에서 지원하지 않음 | 삭제 후 다시 만들기 전에 데이터·파이프라인 이전 필요 |
| 타입·NULL 허용 여부 변경 | 기존 항목에서 지원하지 않음 | 변환 및 데이터 마이그레이션 필요 |
| Identity Keys 변경 | 기존 항목에서 지원하지 않음 | Upsert 키와 중복 데이터 영향 |
| 관계의 소스·대상 변경 | 생성 후 읽기 전용 | 올바른 방향의 새 관계 필요 |
지원되지 않는 스키마 변경을 저장하려 하면 “컬럼 삭제·이름 변경, 타입·NULL 허용 여부 변경, 식별 키 변경은 지원되지 않습니다”라는 안내가 표시됩니다. 빈 리소스라도 같은 제한이 적용되므로 이름·키·타입을 생성 전에 확인하세요.
모델 확장 연습하기
새 maintenance_events 데이터셋이 들어왔다고 가정하고 기존 모델을 확장합니다.
- 모델링에서 이름
iot_maintenance_event, 별칭정비 이벤트인 엔티티를 만듭니다. id를 Text, NOT NULL 속성으로 만들고 Identity Keys와 Display Column으로 지정합니다.- Batch 파이프라인에
maintenance_events입력과 변환 또는 Code 노드를 추가합니다. iot_maintenance_event를 Entity 출력으로 연결하고 쓰기 방식을 병합으로 설정합니다.iot_machine을 소스로,iot_maintenance_event를 대상으로 하는iot_triggers관계를 만듭니다.- 관계 파이프라인에서 다음 구조 컬럼을 출력합니다.
| 컬럼 | 의미 |
|---|---|
id | 관계 행의 안정적인 고유 ID |
iot_machine_id | 소스 iot_machine의 식별 키 id |
iot_maintenance_event_id | 대상 iot_maintenance_event의 식별 키 id |
- Entity와 Relation 파이프라인의 준비됨, 최근 실행 성공을 확인합니다.
- 각 리소스의 데이터 탭과 그래프 탐색기에서 결과를 확인합니다.
분석가에게 탐색 전달하기
그래프 탐색기에서 선택한 컬렉션과 쿼리는 다음처럼 한 묶음으로 전달합니다.
컬렉션: test1
확인 대상: 센서와 기계 관계 조회
예상 결과: 노드 2개, 관계 1개
쿼리:
MATCH (s:`iot_sensor`)-[r:`iot_reads_from`]->(m:`iot_machine`)
RETURN s, r, m
LIMIT 50
분석가는 같은 컬렉션을 선택하고 쿼리 콘솔에 Cypher를 붙여 넣어 결과를 재현할 수 있습니다.
엔지니어에게 출력 전달하기
컬렉션 설명에는 목적과 담당 팀을 남기고, 상세 내용은 팀 문서나 코드 저장소에서 관리하세요.
| 파이프라인 | 입력 키 | 출력 키·리소스 | 필수 컬럼 | 쓰기 방식 |
|---|---|---|---|---|
load_iot_machines | machines | iot_machine Entity | id와 엔티티 속성 | Upsert |
load_iot_reads_from | sensor_machine_links | iot_reads_from Relation | id, iot_sensor_id, iot_machine_id, installed_at | Upsert |
| 정비 이벤트 적재 | maintenance_events | iot_maintenance_event Entity | id와 엔티티 속성 | Upsert |
| 기계·정비 연결 적재 | 팀에서 정한 입력 키 | iot_triggers Relation | id, iot_machine_id, iot_maintenance_event_id | Upsert |
각 필드의 타입과 NULL 허용 여부, Code의 run 인자, 반환 키도 함께 기록하세요. 파이프라인 변경 후에는 실행 성공과 함께 대상 리소스의 데이터 탭까지 확인합니다.
권한 지정하기
- 모델러 — 수정할 온톨로지와 적재 파이프라인의 편집자
- 엔지니어 — 입력 데이터셋과 적재 파이프라인의 편집자, 확인할 온톨로지의 뷰어
- 분석가 — 그래프에서 조회할 컬렉션과 자원의 뷰어
- 권한 관리자 — 멤버와 권한을 관리할 컬렉션의 소유자
변경 기록 남기기
엔티티와 관계의 히스토리 탭에서 해당 리소스의 변경 이력을 확인할 수 있습니다. 변경 목적, 영향을 받는 파이프라인, 검증 Cypher, 이전 상태로 되돌리는 방법은 팀의 이력 관리 도구에 기록하세요. 사이드바의 최근 항목은 보안 감사 로그가 아닙니다.
코스 완료 점검
- 엔티티와 관계를 만들었다.
- Identity Keys와 Display Column을 설정했다.
- 실제 Batch 파이프라인으로 Entity와 Relation 행을 Upsert했다.
- 데이터 탭과 그래프 탐색기에서 결과를 확인했다.
- 분석가와 엔지니어에게 재현 가능한 정보를 전달할 수 있습니다.
이제 모델 정의, 데이터 적재, 그래프 검증을 하나의 흐름으로 수행할 수 있습니다.