본문으로 건너뛰기

Schema Graph

스키마 메타데이터를 그래프 형태로 조회하는 API입니다. 테이블 간 관계, 컬럼 정보를 시각화 가능한 그래프 구조로 반환합니다.

엔드포인트

GET /api/v1/ai/schema/graph

설명: 스키마 그래프를 조회합니다. 테이블을 노드로, 외래키/조인 관계를 엣지로 표현합니다.

쿼리 파라미터:

파라미터타입필수설명
catalogstringN대상 카탈로그
schemastringN대상 스키마

응답:

{
"nodes": [
{"id": "table_name", "columns": ["col1", "col2"]}
],
"edges": [
{"source": "table_a", "target": "table_b", "type": "fk"}
]
}

인증

JWT Bearer 토큰이 필요합니다.

참고

  • Schema Sync가 실행된 후에 그래프 데이터가 생성됩니다.
  • UI의 카탈로그 탐색기에서 시각화에 사용됩니다.

에러 코드

코드설명
400잘못된 카탈로그/스키마 이름
500그래프 데이터 조회 실패