Azure Synapse 연결
Azure Synapse 소스는 Foundry에서 제공하는 JDBC 드라이버로 외부 시스템의 데이터를 테이블로 탐색하고 수집합니다. Data Connection에서 소스의 연결과 인증을 구성한 뒤, 동기화가 실행할 SQL 질의와 출력 데이터셋을 지정합니다.
지원 기능
| 기능 | 제공 단계 |
|---|---|
| 원천 데이터 탐색 | 일반 제공(GA) |
| 배치 동기화 | 일반 제공(GA) |
| 증분 수집 | 일반 제공(GA) |
| OAuth 2.0 인증 | 일반 제공(GA) |
| 테이블 내보내기 | 일반 제공(GA) |
소스 설정
- Data Connection의 +New Source에서 Azure Synapse 소스를 선택합니다.
- 신규 연결에는 권장 실행 방식인 Foundry 워커를 선택하고 JDBC URL을 구성합니다. 에이전트 워커는 기존 기능 유지 단계(Legacy)이며 고객 관리 호스트의 자원을 사용하고 OAuth 2.0 인증 코드 흐름을 지원하지 않습니다. 사설망 접근이 필요하면 Foundry 워커에 에이전트 프록시를 연결할 수 있습니다.
- 필수 속성을 모두 입력합니다. 권장 속성은 사용하는 인증 방식과 데이터 범위에 맞게 설정합니다.
- 외부 통신 대상을 허용한 뒤 소스를 저장하고 테이블을 탐색합니다.
속성 이름과 값의 대소문자를 유지합니다. 기본값의 미지정은 설정값이 제시되지 않았다는 뜻이며 인증에 필요하지 않다는 뜻은 아닙니다.
| 속성 | 요구 수준 | 의미와 조건 | 기본값 |
|---|---|---|---|
AuthScheme | 필수 | 인증 방식입니다. Password, AzureAD, AzureServicePrincipal, AzureServicePrincipalCert, AzureMSI, AzurePassword를 사용할 수 있습니다. | Password |
Database | 필수 | Synapse 데이터베이스 이름입니다. | 미지정 |
Encrypt | 필수 | SSL 활성화 여부와 Strict 암호화 유형 사용 여부를 지정합니다. | TRUE |
Server | 필수 | Synapse를 실행하는 서버 이름입니다. | {serverAddress} |
InitiateOAuth | 권장 | OAuth 액세스 토큰을 발급하거나 갱신하는 절차를 지정합니다. 인증과 승인을 마친 사용자의 접근을 유지하는 데 사용합니다. | REFRESH |
OAuthClientId | 권장 | 사용자 정의 OAuth 애플리케이션에 발급한 client ID, 즉 consumer key입니다. 인증 과정에서 OAuth 인증 서버에 애플리케이션을 식별하는 데 필요합니다. | 미지정 |
OAuthClientSecret | 권장 | 사용자 정의 OAuth 애플리케이션에 발급한 client secret입니다. OAuth 인증 서버에 애플리케이션을 인증하는 기밀 값입니다. | 미지정 |
Password | 권장 | 인증할 사용자 계정의 비밀번호입니다. | 미지정 |
Port | 권장 | Synapse 연결 포트입니다. | 1433 |
User | 권장 | 인증할 Azure Synapse 계정의 사용자 ID입니다. | 미지정 |
데이터 수집
동기화 하나에서 테이블을 반환하는 SQL 질의 하나를 실행하고 결과를 Foundry 데이터셋에 저장합니다. 원천 탐색에서 보이는 테이블과 열을 사용해 필요한 범위를 선택합니다. CData 드라이버는 실제 질의 전까지 연결을 지연할 수 있으므로 정적 메타데이터가 보인다는 사실만으로 인증이나 네트워크 연결 성공을 판단하지 않습니다.
외부 통신
연결에 필요한 각 대상에 외부 통신 정책(Egress policy)을 추가합니다. 온프레미스 등 Foundry에서 직접 도달할 수 없는 원천이면 에이전트 프록시 정책을 사용하고, 에이전트 호스트에서도 대상에 도달할 수 있어야 합니다. 조건부 대상은 선택한 인증 방식, 리전과 구성값에 맞게 허용합니다.
| 대상 도메인 또는 주소 | 필요 조건 |
|---|---|
| <Server>:<Port> | 항상 필요하며 Server, Port 연결 속성으로 정합니다. |
| <StorageAccountLocation> | COPY 모드에서 데이터를 임시 적재하는 데 사용합니다. |
| login.microsoftonline.com | AuthScheme이 AzureAD, AzureServicePrincipal, AzureServicePrincipalCert, AzurePassword 중 하나이고 AzureEnvironment=GLOBAL(기본값)이면 필요합니다. |
| login.chinacloudapi.cn | AuthScheme이 AzureAD, AzureServicePrincipal, AzureServicePrincipalCert, AzurePassword 중 하나이고 AzureEnvironment=CHINA이면 필요합니다. |
| login.microsoftonline.us | AuthScheme이 AzureAD, AzureServicePrincipal, AzureServicePrincipalCert, AzurePassword 중 하나이고 AzureEnvironment가 USGOVT 또는 USGOVTDOD이면 필요합니다. |
OAuth 2.0 승인
OAuth 2.0 인증 코드 흐름은 Foundry 워커에서만 지원합니다. 소스에 CallbackUrl을 추가하고 자동으로 표시되는 콜백 URL을 외부 애플리케이션에 등록합니다. 발급한 OAuthClientId와 OAuthClientSecret을 설정한 뒤 소스를 저장하고, 소스 개요의 Authorize로 승인합니다. 갱신과 철회는 소스 개요의 오른쪽 패널에서 수행합니다.
기본적으로 승인 시작, 갱신과 철회에는 소스의 Owner 역할이 필요합니다. Viewer 또는 Editor만 있으면 권한 거부 오류가 발생합니다. ConnectOnOpen=true는 이 인증 방식과 함께 사용할 수 없습니다.
테이블 내보내기
기존 외부 테이블에 Foundry 데이터셋의 행을 추가하는 테이블 내보내기를 지원합니다. CData 드라이버의 내보내기는 대상 테이블을 비우지 않는 모드만 지원하며, 키 기준 갱신, 삭제나 upsert는 지원하지 않습니다. 비운영 대상에 한 행을 먼저 시험하고 소스의 내보내기 설정과 대상 쓰기 권한을 확인합니다.