커넥터 (Connectors) 개요
커넥터(Connectors) 는 외부 데이터베이스·그래프 DB·REST API·오브젝트 스토리지 같은 외부 시스템에 접속하기 위한 연결 설정입니다. 접속 주소·인증 정보 등을 커넥터로 한 번 등록해 두면, 파이프라인이나 에이전트 도구 등 여러 기능이 같은 접속 정보를 재사용할 수 있습니다.
화면은 사이드바 애플리케이션 (Applications) 그룹의 데이터 연결 메뉴(/connectors)에서 진입합니다. 페이지 제목도 데이터 연결로 표시됩니다.
화면 구성
- 상단 영역: 페이지 제목(데이터 연결)·설명과 커넥터 생성 버튼. 생성 권한이 없으면 버튼이 비활성화되고 안내 툴팁이 표시됩니다.
- 검색: 이름·설명 기준 부분 일치 검색.
- 요약 표시:
N개 중 M개 표시와 함께 전체 / 내장 / 커스텀 개수 태그가 표시됩니다. - 유형 필터 버튼: 전체 / 데이터베이스 / 그래프 / REST API / S3 스토리지 버튼으로 좁히며, 각 버튼에는 해당 유형의 개수가 함께 표시됩니다.
- 카드 목록: 커넥터는 내장 커넥터와 커스텀 커넥터 두 섹션으로 나뉘어 카드 그리드로 나열됩니다. 각 카드는 아이콘·이름·유형·대상 주소·설명·상태 정보와 액션 메뉴를 제공합니다.
커넥터 유형
| 유형 | 용도 |
|---|---|
| 데이터베이스 (DB) | PostgreSQL, DataHub 등 관계형/분석용 데이터베이스 연결 |
| 그래프 (Graph) | Neo4j 등 그래프 데이터베이스 연결 |
| REST API | HTTP/HTTPS REST API 엔드포인트 호출 |
| S3 스토리지 | S3 호환 오브젝트 스토리지 (AWS S3, MinIO 등) |
각 유형은 고유 색상과 아이콘으로 구분됩니다(데이터베이스=파랑, 그래프=보라, REST API=에메랄드, S3=앰버).
내장 vs 커스텀 커넥터
목록은 두 종류로 나뉩니다.
- 내장 (Built-in) 커넥터: 시스템이 제공하는 커넥터 템플릿입니다(예: 데이터 허브, 온톨로지 저장소, 그래프 저장소 — D.Hub 내부 저장소 연결). 접속 정보만 채우면 바로 사용할 수 있으며, 화면에서는 설정을 열어 확인만 할 수 있고 편집·삭제는 제한됩니다.
- 커스텀 (Custom) 커넥터: 팀 환경에 맞게 직접 작성한 커넥터입니다. 연결 옵션과 함께 커넥터 스크립트(Python) 를 포함할 수 있으며, 생성·수정·삭제가 가능합니다.
카드에는 내장 여부(내장 배지/자물쇠 아이콘), 편집 가능 / 읽기 전용 여부, 마지막 수정일이 표시됩니다. 커스텀 커넥터에는 이름·설명에서 자동 추정된 환경 태그(운영 / 테스트 / 스테이징 / 개발)가 함께 표시될 수 있습니다.
권한
권한은 로그인 사용자의 유형(admin / manager 등) 을 기준으로 합니다.
- 보기: 모든 사용자가 커넥터 목록을 조회하고, 카드를 열어 설정을 읽기 전용으로 확인할 수 있습니다.
- 생성·수정·삭제(커스텀): 관리자(admin) 또는 매니저(manager) 만 가능합니다. 권한이 없으면 생성 버튼이 비활성화되고, 편집/삭제 메뉴 항목도 비활성화됩니다.
- 내장 커넥터: 시스템이 관리하므로 편집·삭제할 수 없습니다.
카드 액션
카드 오른쪽 위의 메뉴(⋮)에서 다음을 제공합니다.
- 상세 보기: 편집 화면을 열어 설정을 확인합니다(권한이 없으면 읽기 전용).
- 편집: 설정을 수정합니다(커스텀 + 관리자/매니저만 활성화).
- 삭제: 커넥터를 제거합니다(커스텀 + 관리자/매니저만 표시). 파이프라인·에이전트 도구 등에서 참조 중이면 삭제 전 확인이 표시됩니다.
연결 테스트는 편집 화면에서
연결 상태를 확인하는 연결 테스트는 카드 메뉴가 아니라 편집 화면 하단에서 수행합니다. 커넥터 설정을 참고하세요.