커넥터 설정
새 커넥터를 만들거나 기존 커넥터를 편집할 때 사용하는 설정 화면을 안내합니다.
생성 흐름
- 커넥터 목록 페이지 우상단의 + 커넥터 추가 버튼을 클릭합니다.
- 편집 페이지(
/settings/connectors/new)로 이동합니다. - 유형을 선택하고 세부 필드를 채운 뒤 저장합니다.
커스텀 커넥터 생성은 관리자 권한(또는 manager 유형 사용자)에게만 허용됩니다.
공통 필드
모든 유형의 커넥터는 다음 메타데이터를 공유합니다.
| 필드 | 설명 |
|---|---|
| 이름(name) | 커넥터의 시스템 식별자 (중복 불가) |
| 별칭(alias) | 사용자에게 표시되는 별칭 (선택) |
| 설명(description) | 용도·담당자 등 자유 텍스트 |
| 타입 | DB / REST / S3 중 하나 |
내장(Built-in) 커넥터는 이름·타입이 고정되어 있으며, 설명과 일부 옵션만 편집할 수 있습니다.
유형별 옵션
DB
관계형 데이터베이스 연결 설정입니다. 드라이버가 요구하는 접속 정보를 JSON 형태로 입력합니다. 주요 필드 예:
- host / port: 접속 호스트와 포트
- database: 데이터베이스 이름
- user / password: 인증 정보 (비밀 필드는 마스킹되어 저장)
- params: 추가 연결 파라미터 (SSL, 타임아웃 등)
REST
외부 API 엔드포인트 호출 설정입니다.
- base_url: 기본 엔드포인트 URL
- headers: 공통 헤더(인증 키 등)
- auth: 인증 방식(Bearer, API Key, Basic 등)
- timeout: 호출 제한 시간
S3 (S3 호환)
S3 또는 S3 호환 오브젝트 스토리지(MinIO 등) 접속 설정입니다.
- endpoint: S3 엔드포인트
- region: 리전
- access_key / secret_key: 자격 증명
- bucket: 기본 버킷(선택)
커스텀 커넥터 스크립트
커스텀 커넥터는 연결·쿼리 로직을 사용자가 직접 구현하는 커넥터 스크립트를 포함할 수 있습니다.
- 편집 페이지의 Code 섹션에서 Monaco 에디터로 스크립트를 작성합니다.
- 런타임에서 필요한 Python 패키지는 Packages 섹션에서 버전 지정하여 추가합니다.
- 스크립트에는 커넥터 유형에 따라 요구되는 진입점(예:
connect(),execute())이 있어야 합니다.
옵션 JSON
모든 커넥터는 Options 탭에 유형별 세부 옵션을 JSON으로 저장합니다. 편집 화면의 JSON 에디터에서 직접 수정하거나, 제공되는 폼 필드를 통해 편집할 수 있습니다. 저장 시 스키마 검증이 수행됩니다.
저장과 검증
- Save: 전체 폼 유효성 검증을 통과하면 커넥터가 저장됩니다.
- Test Connection (유형별 지원): 저장 전에 현재 입력값으로 연결을 시도해 볼 수 있습니다.
- 저장 후에도 언제든지 편집 페이지에서 옵션을 갱신할 수 있으며, 내장 커넥터는 일부 필드가 잠겨 있습니다.
삭제
커스텀 커넥터는 목록 카드 또는 편집 페이지의 삭제 메뉴로 제거할 수 있습니다. 파이프라인·에이전트 도구 등에서 참조 중일 경우 삭제 전 경고가 표시됩니다.