커넥터 문제 해결
커넥터 연결 또는 쿼리 실행 중 발생할 수 있는 일반적인 문제와 해결 방법을 안내합니다.
일반적인 오류
연결 실패 (Connection Refused)
- 원인: 데이터 소스 서버에 접근할 수 없습니다
- 확인 사항: 호스트/포트 정보가 정확한지, 방화벽이 해당 포트를 허용하는지, K8s 네트워크 정책을 확인합니다
- 해결:
connector_id/testAPI로 연결 테스트를 재실행하여 상세 오류 메시지를 확인합니다
인증 오류 (Authentication Failed)
- 원인: 사용자명 또는 비밀번호가 올바르지 않습니다
- 확인 사항: 데이터 소스의 인증 정보가 변경되지 않았는지 확인합니다
- 해결: 커넥터 설정에서 인증 정보를 업데이트합니다
메타데이터 조회 실패
- 원인: 연결은 성공했으나 카탈로그/스키마 정보를 가져올 수 없습니다
- 확인 사항: 해당 사용자가 메타데이터 읽기 권한을 보유하고 있는지 확인합니다
쿼리 타임아웃
- 원인: 대용량 데이터 소스에 대한 쿼리가 시간 초과됩니다
- 확인 사항: 쿼리에 적절한 필터 조건이 있는지, Trino의 쿼리 타임아웃 설정을 확인합니다
진단 방법
- 커넥터 상세 페이지에서 연결 테스트를 실행합니다
- 테스트 결과의 상세 메시지를 확인합니다
- 필요 시 감사 로그에서 관련 API 호출 이력을 검색합니다
API 엔드포인트
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/connectors/{connector_id}/test | 연결 테스트 |
| PUT | /api/v1/connectors/{connector_id} | 커넥터 설정 수정 |
| DELETE | /api/v1/connectors/{connector_id} | 커넥터 삭제 |