Microsoft Dataverse 연결
Microsoft Dataverse 소스는 Foundry에서 제공하는 JDBC 드라이버로 외부 시스템의 데이터를 테이블로 탐색하고 수집합니다. Data Connection에서 소스의 연결과 인증을 구성한 뒤, 동기화가 실행할 SQL 질의와 출력 데이터셋을 지정합니다.
지원 기능
| 기능 | 제공 단계 |
|---|---|
| 원천 데이터 탐색 | 일반 제공(GA) |
| 배치 동기화 | 일반 제공(GA) |
| 증분 수집 | 일반 제공(GA) |
| 테이블 내보내기 | 일반 제공(GA) |
소스 설정
- Data Connection의 +New Source에서 Microsoft Dataverse 소스를 선택합니다.
- 신규 연결에는 권장 실행 방식인 Foundry 워커를 선택하고 JDBC URL을 구성합니다. 에이전트 워커는 기존 기능 유지 단계(Legacy)이며 고객 관리 호스트의 자원을 사용하고 OAuth 2.0 인증 코드 흐름을 지원하지 않습니다. 사설망 접근이 필요하면 Foundry 워커에 에이전트 프록시를 연결할 수 있습니다.
- 필수 속성을 모두 입력합니다. 권장 속성은 사용하는 인증 방식과 데이터 범위에 맞게 설정합니다.
- 외부 통신 대상을 허용한 뒤 소스를 저장하고 테이블을 탐색합니다.
속성 이름과 값의 대소문자를 유지합니다. 기본값의 미지정은 설정값이 제시되지 않았다는 뜻이며 인증에 필요하지 않다는 뜻은 아닙니다.
| 속성 | 요구 수준 | 의미와 조건 | 기본값 |
|---|---|---|---|
AuthScheme | 필수 | Microsoft Dataverse 연결에 사용할 인증 방식입니다. 비워 두면 기본 인증을 사용합니다. | AzureAD |
OrganizationURL | 필수 | Dynamics 365 조직 URL이며 resource라고도 합니다. Microsoft Dataverse 인스턴스의 올바른 URL은 Web Services 페이지에서 확인합니다. | 미지정 |
Schema | 필수 | Microsoft Dataverse 메타데이터를 나열할 때 사용할 스키마입니다. | Entities |
AzureTenant | 권장 | Microsoft Dataverse 데이터 접근에 사용할 테넌트를 이름(예: contoso.onmicrosoft.com) 또는 ID로 지정합니다. 조건부 항목입니다. | 미지정 |
InitiateOAuth | 권장 | OAuth 액세스 토큰을 발급하거나 갱신하는 절차를 지정합니다. 인증과 승인을 마친 사용자의 접근을 유지하는 데 사용합니다. | GETANDREFRESH |
OAuthClientId | 권장 | 사용자 정의 OAuth 애플리케이션을 만들 때 발급한 client ID입니다. consumer key라고도 하며 OAuth 인증 서버에 애플리케이션을 식별합니다. | 미지정 |
OAuthClientSecret | 권장 | 사용자 정의 OAuth 애플리케이션을 만들 때 발급한 client secret입니다. consumer secret이라고도 하며 OAuth 인증 서버에 애플리케이션을 인증합니다. | 미지정 |
OAuthGrantType | 권장 | 선택한 OAuth 흐름의 부여 유형입니다. 사용자 정의 OAuth 애플리케이션을 만들 때 설정한 grant_type과 같아야 합니다. | CLIENT |
데이터 수집
동기화 하나에서 테이블을 반환하는 SQL 질의 하나를 실행하고 결과를 Foundry 데이터셋에 저장합니다. 원천 탐색에서 보이는 테이블과 열을 사용해 필요한 범위를 선택합니다. CData 드라이버는 실제 질의 전까지 연결을 지연할 수 있으므로 정적 메타데이터가 보인다는 사실만으로 인증이나 네트워크 연결 성공을 판단하지 않습니다.
테이블 내보내기
기존 외부 테이블에 Foundry 데이터셋의 행을 추가하는 테이블 내보내기를 지원합니다. CData 드라이버의 내보내기는 대상 테이블을 비우지 않는 모드만 지원하며, 키 기준 갱신, 삭제나 upsert는 지원하지 않습니다. 비운영 대상에 한 행을 먼저 시험하고 소스의 내보내기 설정과 대상 쓰기 권한을 확인합니다.