Apache Hive 연결
Apache Hive 소스는 Foundry에서 제공하는 JDBC 드라이버로 외부 시스템의 데이터를 테이블로 탐색하고 수집합니다. Data Connection에서 소스의 연결과 인증을 구성한 뒤, 동기화가 실행할 SQL 질의와 출력 데이터셋을 지정합니다.
이 커넥터는 Beta 단계입니다. 플랫폼 인스턴스에서 제공되지 않을 수 있고 개발 중 기능이 변경될 수 있습니다.
지원 기능
| 기능 | 제공 단계 |
|---|---|
| 원천 데이터 탐색 | Beta |
| 배치 동기화 | Beta |
| 증분 수집 | Beta |
| 테이블 내보내기 | Beta |
소스 설정
- Data Connection의 +New Source에서 Apache Hive 소스를 선택합니다.
- 신규 연결에는 권장 실행 방식인 Foundry 워커를 선택하고 JDBC URL을 구성합니다. 에이전트 워커는 기존 기능 유지 단계(Legacy)이며 고객 관리 호스트의 자원을 사용하고 OAuth 2.0 인증 코드 흐름을 지원하지 않습니다. 사설망 접근이 필요하면 Foundry 워커에 에이전트 프록시를 연결할 수 있습니다.
- 필수 속성을 모두 입력합니다. 권장 속성은 사용하는 인증 방식과 데이터 범위에 맞게 설정합니다.
- 외부 통신 대상을 허용한 뒤 소스를 저장하고 테이블을 탐색합니다.
속성 이름과 값의 대소문자를 유지합니다. 기본값의 미지정은 설정값이 제시되지 않았다는 뜻이며 인증에 필요하지 않다는 뜻은 아닙니다.
| 속성 | 요구 수준 | 의미와 조건 | 기본값 |
|---|---|---|---|
AuthScheme | 필수 | 인증 방식입니다. Anonymous, Plain, LDAP, NoSasl, Kerberos를 사용할 수 있습니다. | Anonymous |
Server | 필수 | HiveServer2를 호스팅하는 서버의 호스트 이름 또는 IP 주소입니다. | {serverAddress} |
UseSSL | 필수 | Hive 연결에서 SSL 암호화를 사용할지 지정합니다. | TRUE |
Database | 권장 | 기본으로 사용할 Hive 데이터베이스 이름입니다. | 미지정 |
Password | 권장 | Hive 인증 비밀번호입니다. | 미지정 |
Port | 권장 | HiveServer2 인스턴스 연결 포트입니다. | 10000 |
SSLServerCert | 권장 | TLS/SSL 연결에서 허용할 서버 인증서를 지정합니다. | 미지정 |
TransportMode | 권장 | Hive 서버와 통신할 전송 방식입니다. BINARY 또는 HTTP를 사용할 수 있습니다. | BINARY |
User | 권장 | Hive 인증 사용자 이름입니다. | 미지정 |
데이터 수집
동기화 하나에서 테이블을 반환하는 SQL 질의 하나를 실행하고 결과를 Foundry 데이터셋에 저장합니다. 원천 탐색에서 보이는 테이블과 열을 사용해 필요한 범위를 선택합니다. CData 드라이버는 실제 질의 전까지 연결을 지연할 수 있으므로 정적 메타데이터가 보인다는 사실만으로 인증이나 네트워크 연결 성공을 판단하지 않습니다.
외부 통신
연결에 필요한 각 대상에 외부 통신 정책(Egress policy)을 추가합니다. 온프레미스 등 Foundry에서 직접 도달할 수 없는 원천이면 에이전트 프록시 정책을 사용하고, 에이전트 호스트에서도 대상에 도달할 수 있어야 합니다. 조건부 대상은 선택한 인증 방식, 리전과 구성값에 맞게 허용합니다.
| 대상 도메인 또는 주소 | 필요 조건 |
|---|---|
| <Server>:<Port> | 항상 필요합니다. |
| <KerberosKDC>:88 | AuthScheme=Negotiate일 때 필요합니다. |
| <KerberosServiceKDC>:88 | AuthScheme=Negotiate이고 Kerberos 구성이 여러 realm을 사용하면 필요합니다. |
테이블 내보내기
기존 외부 테이블에 Foundry 데이터셋의 행을 추가하는 테이블 내보내기를 지원합니다. CData 드라이버의 내보내기는 대상 테이블을 비우지 않는 모드만 지원하며, 키 기준 갱신, 삭제나 upsert는 지원하지 않습니다. 비운영 대상에 한 행을 먼저 시험하고 소스의 내보내기 설정과 대상 쓰기 권한을 확인합니다.