Foundry 제공 JDBC 드라이버

Foundry 제공 소스는 JDBC 드라이버를 감싼 연결 구성입니다. Data Connection에서 필수 속성과 권장 속성을 설정하고 외부 시스템의 데이터를 테이블로 수집합니다. 직접 JDBC 드라이버를 업로드하는 사용자 정의 연결과 달리, 제공되는 드라이버를 선택해 사용합니다.

소스 생성

1. Data Connection 오른쪽 위의 +New Source를 선택합니다.
2. 사용할 외부 시스템의 소스를 찾습니다.
3. 신규 연결에는 권장 실행 방식인 Foundry 워커를 선택합니다. 에이전트 워커는 고객 관리 호스트에서 실행하는 기존 기능 유지 단계(Legacy)이며 OAuth 2.0 인증 코드 흐름을 지원하지 않습니다. 사설망 연결은 Foundry 워커에 에이전트 프록시를 연결하는 방식으로 구성할 수 있습니다.
4. Documentation에서 해당 드라이버의 연결 조건과 인증 정보 생성 절차를 확인합니다.
5. JDBC URL과 필수 속성을 설정하고 저장합니다.

필수 속성은 기본적으로 목록에 나타나며 값을 지정해야 소스를 저장할 수 있습니다. 권장 속성은 +Add property의 Recommended에서 찾습니다. Required 또는 Recommended 속성 이름에 포인터를 올리면 드라이버의 해당 속성 설명으로 이동할 수 있습니다.

동기화 질의

동기화 하나에서 SQL 질의 하나를 실행합니다. 질의는 테이블을 결과로 반환해야 하며, 그 결과를 Foundry 출력 데이터셋에 저장합니다. 데이터를 결과로 반환하는 저장 프로시저를 호출하는 방식도 가능합니다.

CData 드라이버의 내보내기

Foundry 제공 드라이버 중 상당수는 CData에서 개발합니다. 일부 CData 커넥터는 Foundry 데이터셋의 행을 기존 외부 테이블에 추가하는 테이블 내보내기를 지원합니다. 지원 여부는 개별 커넥터에서 확인해야 합니다.

CData 테이블 내보내기는 기존 테이블을 비우지 않는 모드만 지원합니다. 키 기준 갱신, 삭제나 upsert는 지원하지 않습니다. 운영 데이터를 보내기 전에 비운영 대상에 한 행을 시험하고 테이블 내보내기의 요구 조건을 확인합니다.

Foundry 워커 소스에서 더 복잡한 작업이 필요하면 해당 커넥터에 대해 확인된 코드 기반 연결 방식을 사용합니다. 임의 JDBC 작업을 모든 CData 커넥터에서 실행할 수 있다고 가정하지 말고 지원 연산과 인증 조건을 확인합니다.

탐색 시 실제 연결 검사

CData 드라이버는 기본적으로 실제 질의를 수행할 때까지 연결을 늦춥니다. 소스 탐색에서 드라이버에 내장된 정적 메타데이터 테이블이 보이더라도 원천에 정상 연결되었다는 의미는 아닙니다. 인증 정보나 외부 통신 정책이 누락되어도 메타데이터가 보일 수 있습니다.

ConnectOnOpen JDBC 속성을 true로 설정하면 탐색할 때에도 no-op 연결 검사를 수행하도록 할 수 있습니다. 다만 OAuth 2.0 인증과 함께 사용할 수 없습니다. 원천 계정의 권한이 매우 좁아서 이 검사 명령을 실행할 수 없으면 오히려 연결이 실패할 수 있습니다.

인증서 인증

여러 CData 드라이버, 특히 Azure 기반 시스템에서는 인증서를 사용할 수 있습니다. 연결별 속성에 더해 다음 값을 설정합니다.

Windows에서 파일을 Base64로 변환하는 형식은 다음과 같습니다. 파일 경로는 예시입니다.

[Convert]::ToBase64String([IO.File]::ReadAllBytes("\path\to\file.pfx"))

파일 수집용 저장 프로시저

Amazon Marketplace나 Microsoft OneDrive 같은 파일 기반 시스템의 일부 CData 드라이버는 저장 프로시저로 파일을 수집합니다. 반환 테이블의 파일 내용은 Base64 문자열로 들어옵니다. 하위 변환에서 디코딩해야 원래 파일 내용을 사용할 수 있습니다. Pipeline Builder의 Base64 decode 보드를 사용할 수 있습니다.

OAuth 2.0 인증 코드 흐름

지원되는 CData 드라이버에서는 OAuth 2.0 인증 코드 부여 방식으로 사용자가 자신의 외부 계정에 인증하고 그 사용자를 대신해 작업하도록 할 수 있습니다. 이 방식은 Foundry 워커에서만 지원하며 에이전트 워커에서는 지원하지 않습니다.

1. JDBC 속성에 CallbackUrl을 추가합니다. https://<YOUR_FOUNDRY_URL>/workspace/oauth2-clients/callback 형식의 값이 자동 입력됩니다.
2. 외부 시스템에서 사용자 정의 OAuth 애플리케이션을 등록하고 이 콜백 URL을 입력합니다. 예를 들어 GitHub에서는 Settings의 Developer Settings, OAuth Apps에서 New OAuth App을 선택합니다.
3. 발급한 OAuth client id와 OAuth client secret을 소스의 JDBC 속성에 넣고 저장합니다.

4. 소스 개요의 Authorization required to start using this source 배너에서 Authorize를 선택해 인증 절차를 시작합니다.

인증 갱신과 철회는 소스 개요의 오른쪽 패널에서 수행합니다.

인증 흐름을 시작하거나 갱신하거나 철회하려면 기본적으로 소스의 Owner 역할이 필요합니다. Viewer 또는 Editor만 있는 사용자는 Authorize에서 권한 거부 오류가 발생합니다. 전체 Owner 권한 없이 허용하려면 소스 관리 연산을 포함한 사용자 정의 역할을 구성합니다.

드라이버별 OAuth 2.0 지원

다음 지원 여부는 위에서 설명한 Foundry 제공 드라이버의 OAuth 2.0 인증 코드 흐름을 가리킵니다. 외부 제품 자체가 제공하는 모든 OAuth 기능의 지원 여부와는 구분합니다.