Schema Graph
스키마 메타데이터를 그래프 형태로 조회하는 API입니다. 테이블 간 관계, 컬럼 정보를 시각화 가능한 그래프 구조로 반환합니다.
엔드포인트
GET /api/v1/ai/schema/graph
설명: 스키마 그래프를 조회합니다. 테이블을 노드로, 외래키/조인 관계를 엣지로 표현합니다.
쿼리 파라미터:
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| catalog | string | N | 대상 카탈로그 |
| schema | string | N | 대상 스키마 |
응답:
{
"nodes": [
{"id": "table_name", "columns": ["col1", "col2"]}
],
"edges": [
{"source": "table_a", "target": "table_b", "type": "fk"}
]
}
인증
JWT Bearer 토큰이 필요합니다.
참고
- Schema Sync가 실행된 후에 그래프 데이터가 생성됩니다.
- UI의 카탈로그 탐색기에서 시각화에 사용됩니다.
에러 코드
| 코드 | 설명 |
|---|---|
| 400 | 잘못된 카탈로그/스키마 이름 |
| 500 | 그래프 데이터 조회 실패 |