복사 작업에서 Dynamics CRM을 구성하는 방법
이 문서에서는 데이터 파이프라인에서 복사 작업을 사용하여 Dynamics CRM에서 데이터를 복사하는 방법에 대해 설명합니다.
필수 조건
이 커넥터를 Entra ID 서비스 주체 인증과 함께 사용하려면 Dynamics CRM에서 서버 간(S2S) 인증을 설정해야 합니다. 먼저 Microsoft Entra에 애플리케이션 사용자(서비스 주체)를 등록합니다. 자세한 내용은 리소스에 액세스할 수 있는 Microsoft Entra 애플리케이션 및 서비스 주체 만들기를 참조하세요.
애플리케이션을 등록하는 동안 Dynamics CRM에서 해당 사용자를 만들고 권한을 부여해야 합니다. 이러한 권한은 Dynamics CRM에서 권한이 부여된 팀에 애플리케이션 사용자를 추가하여 직접 또는 간접적으로 부여할 수 있습니다. 애플리케이션 사용자가 Dynamics CRM으로 인증하도록 설정하는 방법에 대한 자세한 내용은 단일 테넌트 서버 간 인증 사용을 참조하세요.
지원되는 구성
복사 작업 아래의 각 탭을 구성하려면 각각 다음 섹션으로 이동합니다.
일반
일반 탭을 구성하려면 일반 설정으로 이동합니다.
Source
원본 탭으로 이동하여 복사 작업 원본을 구성합니다. 자세한 구성은 다음 내용을 참조하세요.
다음 속성은 필수입니다.
- 데이터 저장소 유형: 외부를 선택합니다.
- 연결: 연결 목록에서 기존 Dynamics CRM 연결을 선택합니다. 연결이 없으면 새로 만들기를 선택하여 새 Dynamics CRM 연결을 만듭니다.
- 연결 유형: Dynamics CRM을 선택합니다.
- 쿼리 사용: 데이터를 읽는 데 사용되는 방식을 지정합니다. 엔터티 이름을 사용하여 데이터를 읽으려면 엔터티 이름을 선택하고 쿼리를 사용하여 데이터를 읽으려면 쿼리를 선택하면 됩니다.
엔터티 이름: 드롭다운 목록에서 엔터티 이름을 선택하거나 편집을 선택하여 수동으로 입력합니다. 검색할 엔터티의의 논리적 이름입니다.
쿼리: FetchXML을 사용하여 Dynamics CRM에서 데이터를 읽습니다. FetchXML은 재산적 가치가 있는 쿼리 언어로, Dynamics 온라인 및 온-프레미스에서 사용됩니다. 다음 예를 참조하세요. 자세한 내용을 알아보려면 FeachXML로 쿼리 작성을 참조하세요.
샘플 FetchXML 쿼리:
<fetch> <entity name="account"> <attribute name="accountid" /> <attribute name="name" /> <attribute name="marketingonly" /> <attribute name="modifiedon" /> <order attribute="modifiedon" descending="false" /> <filter type="and"> <condition attribute ="modifiedon" operator="between"> <value>2017-03-10 18:40:00z</value> <value>2017-03-12 20:40:00z</value> </condition> </filter> </entity> </fetch>
고급에서 다음 필드를 지정할 수 있습니다.
- 추가 열: 데이터 열을 추가하여 원본 파일의 상대 경로 또는 정적 값을 저장하세요. 식은 정적 값에 대해 지원됩니다.
대상
대상 탭으로 이동하여 복사 작업 대상을 구성합니다. 자세한 구성은 다음 내용을 참조하세요.
다음 속성은 필수입니다.
- 데이터 저장소 유형: 외부를 선택합니다.
- 연결: 연결 목록에서 기존 Dynamics CRM 연결을 선택합니다. 연결이 없으면 새로 만들기를 선택하여 새 Dynamics CRM 연결을 만듭니다.
- 연결 유형: Dynamics CRM을 선택합니다.
- 엔터티 이름: 데이터를 쓸 엔터티의 이름을 지정합니다. 드롭다운 목록에서 엔터티 이름을 선택하거나 편집을 선택하여 수동으로 입력합니다. 검색할 엔터티의 논리적 이름입니다.
고급에서 다음 필드를 지정할 수 있습니다.
- 쓰기 동작: 작업의 쓰기 동작입니다. 이 속성은 필수 속성이며 Upsert를 선택해야 합니다. 동적 컨텐츠 추가를 사용하는 경우 Upsert에 값을 지정합니다.
- 대체 키 이름: 엔터티에 정의된 대체 키 이름을 지정하여 레코드를 upsert합니다.
- null 값 무시: 쓰기 작업 중 입력 데이터에서 null 값을 무시할지 여부를 나타냅니다. 기본적으로 선택되지 않습니다.
- 선택한 경우: upsert/update 작업을 수행할 때 대상 개체의 데이터를 변경하지 않고 삽입 작업을 수행할 때 정의된 기본값을 삽입합니다.
- 선택되지 않은 경우: upsert/update 작업을 수행할 때 대상 개체의 데이터를 NULL로 업데이트하고 삽입 작업을 수행할 때 NULL 값을 삽입합니다.
- 쓰기 일괄 처리 크기: 각 일괄 처리에서 Dynamics CRM에 기록된 데이터의 행 수를 지정합니다.
- 최대 동시 연결: 작업 실행 중 데이터 저장소에 설정된 동시 연결의 상한입니다. 동시 연결을 제한하려는 경우에만 값을 지정합니다.
매핑
매핑 탭 구성의 경우 매핑 탭에서 매핑 구성으로 이동합니다.
설정
설정 탭을 구성하려면 설정 탭에서 기타 설정 구성으로 이동합니다.
표 요약
Dynamics CRM 복사 작업에 대한 요약 및 자세한 내용은 다음 표를 참조하세요.
원본 정보
| 이름 | 설명 | 값 | 필수 | JSON 스크립트 속성 |
|---|---|---|---|---|
| 데이터 저장소 유형 | 데이터 저장소 유형입니다. | 외부 | 예 | / |
| 연결 | 원본 데이터 저장소에 대한 연결입니다. | < Dynamics CRM 연결 > | 예 | connection |
| 연결 형식 | 연결 유형입니다. | Dynamics CRM | 예 | 유형(typeProperties ->source ->datasetSettings):DynamicsCrmEntity |
| 쿼리 사용 | Dynamics CRM에서 데이터를 읽는 방법 | * 테이블 * 쿼리 |
예 | / |
| 엔터티 이름 | 검색할 엔터티의의 논리적 이름입니다. | < 엔터티 이름 > | 예 | entityName |
| 쿼리 | FetchXML을 사용하여 Dynamics CRM에서 데이터를 읽습니다. FetchXML은 재산적 가치가 있는 쿼리 언어로, Dynamics 온라인 및 온-프레미스에서 사용됩니다. 자세한 내용을 알아보려면 FeachXML로 쿼리 작성을 참조하세요. | < 쿼리 > | 예 | 쿼리 |
| 추가 열 | 데이터 열을 추가하여 원본 파일의 상대 경로 또는 정적 값을 저장하세요. 식은 정적 값에 대해 지원됩니다. | * 이름 * 값 |
아니요 | additionalColumns: * 이름 * 값 |
대상 정보
| 이름 | 설명 | 값 | 필수 | JSON 스크립트 속성 |
|---|---|---|---|---|
| 데이터 저장소 유형 | 데이터 저장소 유형입니다. | 외부 | 예 | / |
| Connection | 대상 Dynamics CRM에 대한 연결입니다. | < 연결 > | 예 | connection |
| 연결 형식 | 연결 유형입니다. | Dynamics CRM | 예 | 유형(typeProperties ->sink ->datasetSettings):DynamicsCrmEntity |
| 엔터티 이름 | 검색할 엔터티의의 논리적 이름입니다. | < 엔터티 > | 예 | entityName |
| 쓰기 동작 | 작업의 쓰기 동작입니다. 값은 Upsert여야 합니다. | Upsert | 예 | writeBehavior: upsert |
| 대체 키 이름 | 엔터티에 정의된 대체 키 이름으로 레코드를 upsert할 수 있습니다. | < 대체 키 이름 > | 아니요 | alternateKeyName |
| null 값 무시 | 쓰기 작업 중에 입력 데이터에서 null 값을 무시할지를 나타냅니다. - 선택됨(true): upsert/update 작업을 수행할 때 대상 개체의 데이터를 변경하지 않고 삽입 작업을 수행할 때 정의된 기본값을 삽입합니다. - 선택되지 않음(false): upsert/update 작업을 수행할 때 대상 개체의 데이터를 NULL로 업데이트하고 삽입 작업을 수행할 때 NULL 값을 삽입합니다. |
선택되거나 선택되지 않음(기본값) | 아니요 | ignoreNullValues: true 또는 false(기본값) |
| 쓰기 일괄 처리 크기 | 각 일괄 처리에서 Dynamics CRM에 작성된 데이터의 행 수입니다. | < 쓰기 일괄 처리 크기 > 기본값은 10입니다. |
아니요 | writeBatchSize |
| 최대 동시 연결 수 | 작업 실행 중 데이터 저장소에 설정된 동시 연결의 상한입니다. 동시 연결을 제한하려는 경우에만 값을 지정합니다. | < 최대 동시 연결 수 > | 아니요 | maxConcurrentConnections |