커넥터 설정
새 커넥터를 만들거나 기존 커넥터를 편집할 때 사용하는 설정 화면을 안내합니다.
생성 흐름
- 데이터 연결 목록 페이지에서 우상단의 커넥터 생성 버튼을 클릭합니다.
- 편집 페이지(
/connectors/new)로 이동합니다. - 유형과 템플릿을 고르고, 기본 정보와 연결 설정을 채운 뒤 생성합니다.
커넥터 생성은 관리자(admin) 또는 매니저(manager) 권한이 있는 사용자만 가능합니다. 권한이 없으면 화면 상단에 안내 배너가 표시되고 입력이 읽기 전용으로 잠깁니다.
편집 화면 구성
편집 화면은 탭으로 나뉩니다.
| 탭 | 내용 |
|---|---|
| 기본 정보 | 유형/템플릿 선택(생성 시)과 이름·별칭·컬렉션·설명·태그 |
| 구성 | 연결 설정(접속 정보), 커스텀 커넥터의 스크립트와 필수 패키지 |
| 사용 권한 | (편집 시에만) 이 커넥터를 실행할 수 있는 사용자·그룹 관리 |
화면 하단에는 연결 테스트 / 취소 / 저장(또는 생성) 버튼이 있습니다.
기본 정보 탭
유형과 템플릿 선택 (생성 시)
새 커넥터를 만들 때는 먼저 유형을 고른 뒤 템플릿을 선택합니다.
- 커넥터 타입 선택: 데이터베이스 / 그래프 / REST API / S3 스토리지 중 하나.
- 템플릿 선택: 해당 유형의 내장 템플릿(예: 데이터베이스 → 데이터 허브·온톨로지 저장소, 그래프 → 그래프 저장소 — D.Hub 내부 저장소) 또는 커스텀(스크립트를 직접 작성).
내장 템플릿을 고르면 유형에 맞는 입력 폼이 자동으로 준비되고, 커스텀을 고르면 커넥터 스크립트 작성 영역이 함께 나타납니다.
공통 정보
유형/템플릿을 선택하면 다음 메타데이터를 입력합니다.
| 필드 | 설명 |
|---|---|
| 커넥터 이름 | 시스템 식별자. 소문자로 시작하고 소문자·숫자·밑줄(_)만 사용(최대 128자). 생성 후에는 변경할 수 없습니다. |
| 별칭 | 화면에 표시할 이름(선택). 비워 두면 이름과 동일하게 설정됩니다. |
| 컬렉션 | 커넥터를 실행할 컬렉션 맥락(필수). |
| 설명 | 연결 대상·용도·운영 주의사항 등 자유 텍스트. |
| 태그 | 검색·분류용 태그. |
별칭·설명·태그는 입력 필드 오른쪽의 반짝임(✨) 아이콘 버튼으로 AI 자동 생성할 수 있습니다(이름을 먼저 입력해야 활성화됩니다).
구성 탭 — 연결 설정
선택한 유형/템플릿에 맞는 연결 설정 폼이 표시됩니다.
데이터베이스 (온톨로지 저장소 · 데이터 허브)
- 호스트 / 포트: 접속 호스트와 포트(온톨로지 저장소 기본 5432, 데이터 허브 기본 8123)
- 데이터베이스: 데이터베이스 이름
- 사용자 이름 / 비밀번호: 인증 정보
- 보안 연결: (데이터 허브) 보안 연결 사용 여부 스위치
그래프 (그래프 저장소)
- URI: 접속 주소(예:
bolt://graph.example.com:7687) - 사용자 이름 / 비밀번호: 인증 정보
REST API
- 기본 URL: 호출 대상 엔드포인트 URL(필수, URL 형식 검증)
- 타임아웃 (ms): 호출 제한 시간(밀리초)
- SSL 검증: SSL 인증서 검증 사용 여부 스위치
S3 스토리지
- 엔드포인트 URL: S3 엔드포인트(예:
https://s3.amazonaws.com) - 액세스 키 / 시크릿 키: 자격 증명
- 리전 / 기본 버킷: 리전과 기본 버킷(선택)
REST API·S3와 내장 템플릿(데이터 허브·온톨로지 저장소·그래프 저장소)은 위와 같은 입력 폼을 제공합니다. 반면 커스텀 데이터베이스/그래프 커넥터는 정해진 폼이 없어, 연결 옵션을 JSON 에디터로 직접 입력합니다.
비밀번호·키 입력 방식 (Secret)
비밀번호·액세스 키·시크릿 키 같은 민감 정보는 항목별로 두 가지 입력 방식을 선택할 수 있습니다.
- 새 Secret 입력: 값을 직접 입력합니다. 저장하면 값은 안전하게 보관되고, 이후 커넥터에는 참조만 남아 값이 다시 표시되지 않습니다.
- Secret 참조 사용: 이미 저장된 Secret을 참조 경로로 지정합니다(예:
secret://connector/connector.x/password).
구성 탭 — 커스텀 커넥터 스크립트
커스텀 커넥터(또는 기존 커스텀 커넥터 편집 시)에는 연결·동작 로직을 직접 구현하는 영역이 추가됩니다.
- 커넥터 스크립트: Python 스크립트를 코드 에디터에서 작성합니다. 작성해야 하는 필수 함수 목록이 에디터 위에 안내됩니다(필수 함수는 커넥터 타입에 따라 달라집니다).
- 필수 패키지 (접힌 상태로 제공): 스크립트가 사용하는 Python 패키지를 버전과 함께 추가합니다(예:
psycopg2-binary>=3.0). 단, 여기 나열한 패키지는 Docker 이미지 빌드 시 참고용이며 실행 시 자동으로 설치되지 않습니다.
저장과 연결 테스트
- 연결 테스트: 저장하기 전에 현재 입력값으로 실제 접속을 시도해 볼 수 있습니다. 성공/실패와 소요 시간이 결과로 표시됩니다.
- 저장 / 생성: 입력 검증을 통과하면 커넥터가 저장되고 목록으로 돌아갑니다. 검증 오류가 있으면 해당 항목이 있는 탭으로 자동 전환됩니다.
사용 권한 탭 (편집 시)
기존 커넥터를 편집할 때 나타나는 탭으로, 이 커넥터를 실행할 수 있는 사용자·그룹을 관리합니다.
- 사용 권한 부여: 사용자나 그룹을 검색해 실행 권한을 추가합니다.
- 컬렉션 전제 조건: 컬렉션에 속한 커넥터는 대상이 해당 컬렉션의 owner 또는 use 권한을 가져야 실행할 수 있습니다. 권한이 없는 대상에는 권한 부여 시 컬렉션 권한이 자동으로 함께 추가될 수 있습니다.
삭제
커스텀 커넥터는 목록 카드의 메뉴(⋮) → 삭제로 제거합니다(관리자/매니저만 표시). 내장 커넥터는 삭제할 수 없습니다. 파이프라인·에이전트 도구 등에서 참조 중인 커넥터를 삭제하려 하면 확인이 표시됩니다.