Azure Data Factory 또는 Synapse Analytics를 사용하여 Dynamics AX에서 데이터 복사

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!

이 문서에서는 Azure Data Factory 및 Synapse Analytics 파이프라인에서 복사 작업을 사용하여 Dynamics AX 원본에서 데이터를 복사하는 방법을 간략하게 설명합니다. 이 문서는 복사 작업에 대한 일반적인 개요를 제공하는 복사 작업을 기준으로 합니다.

지원되는 기능

이 Dynamics AX 커넥터는 다음과 같은 기능에 지원됩니다.

지원되는 기능	IR
복사 작업(원본/-)	3,4
조회 작업	3,4

① Azure 통합 런타임 ② 자체 호스팅 통합 런타임

원본 및 싱크로 지원되는 데이터 저장소 목록은 지원되는 데이터 저장소를 참조하세요.

특히 이 Dynamics AX 커넥터는 서비스 주체 인증에 OData 프로토콜을 사용하여 Dynamics AX에서 데이터 복사를 지원합니다.

팁

또한 이 커넥터를 사용하여 Dynamics 365 Finance and Operations에서 데이터를 복사할 수도 있습니다. Dynamics 365의 OData 지원 및 인증 방법을 참조하세요.

시작하기

파이프라인에 복사 작업을 수행하려면 다음 도구 또는 SDK 중 하나를 사용하면 됩니다.

• 데이터 복사 도구
• Azure Portal
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure Resource Manager 템플릿

UI를 사용하여 Dynamics AX에 연결된 서비스 만들기

다음 단계를 사용하여 Azure Portal UI에서 Dynamics AX에 연결된 서비스를 만듭니다.

1. Azure Data Factory 또는 Synapse 작업 영역에서 관리 탭으로 이동하여 연결된 서비스를 선택하고 새로 만들기를 클릭합니다.

   Azure Data Factory

   

   Azure Synapse

   

2. Dynamics를 검색하고 Dynamics AX 커넥터를 선택합니다.

   

3. 서비스 세부 정보를 구성하고, 연결을 테스트하고, 새로운 연결된 서비스를 만듭니다.

   

커넥터 구성 세부 정보

다음 섹션에서는 Dynamics AX 커넥터에 한정된 Data Factory 엔터티를 정의하는 데 사용되는 속성에 대해 자세히 설명합니다.

필수 조건

서비스 주체 인증을 사용하려면 다음 단계를 수행합니다.

1. Microsoft ID 플랫폼에 애플리케이션을 등록합니다. 자세한 방법은 빠른 시작: Microsoft ID 플랫폼에 애플리케이션 등록을 참조하세요. 연결된 서비스를 정의하는 데 사용되므로 다음 값을 적어둡니다.

   • 애플리케이션 ID
   • 애플리케이션 키
   • 테넌트 ID

2. Dynamics AX로 이동한 다음, 이 서비스 주체에 Dynamics AX에 액세스할 수 있는 적절한 권한을 부여합니다.

연결된 서비스 속성

Dynamics AX 연결된 서비스에 다음 속성이 지원됩니다.

속성	설명	필수
type	형식 속성은 DynamicsAX로 설정해야 합니다.	예
URL	Dynamics AX(또는 Dynamics 365 Finance and Operations) 인스턴스 OData 엔드포인트입니다.	예
servicePrincipalId	애플리케이션의 클라이언트 ID를 지정합니다.	예
servicePrincipalKey	애플리케이션의 키를 지정합니다. 이 필드를 SecureString으로 표시하여 안전하게 저장하거나, Azure Key Vault에 저장된 비밀을 참조합니다.	예
테넌트	애플리케이션이 있는 테넌트 정보(도메인 이름 또는 테넌트 ID)를 지정합니다. Azure Portal의 오른쪽 위 모서리를 마우스로 가리켜 검색합니다.	예
aadResourceId	권한 부여를 요청하는 AAD 리소스를 지정합니다. 예를 들어 동적 URL가 https://sampledynamics.sandbox.operations.dynamics.com/data/이면 그에 해당하는 AAD 리소스는 일반적으로 https://sampledynamics.sandbox.operations.dynamics.com입니다.	예
connectVia	데이터 저장소에 연결하는 데 사용할 통합 런타임입니다. Azure Integration Runtime 또는 데이터 저장소가 프라이빗 네트워크에 있는 경우, 자체 호스팅 통합 런타임을 선택할 수 있습니다. 지정하지 않으면 기본 Azure Integration Runtime이 사용됩니다.	아니요

예제

{
    "name": "DynamicsAXLinkedService",
    "properties": {
        "type": "DynamicsAX",
        "typeProperties": {
            "url": "<Dynamics AX instance OData endpoint>",
            "servicePrincipalId": "<service principal id>",
            "servicePrincipalKey": {
                "type": "SecureString",
                "value": "<service principal key>"
            },
            "tenant": "<tenant info, e.g. microsoft.onmicrosoft.com>",
            "aadResourceId": "<AAD resource, e.g. https://sampledynamics.sandbox.operations.dynamics.com>"
        }
    },
    "connectVia": {
        "referenceName": "<name of Integration Runtime>",
        "type": "IntegrationRuntimeReference"
    }
}

데이터 세트 속성

이 섹션에서는 Dynamics AX 데이터 세트에서 지원하는 속성의 목록을 제공합니다.

데이터 세트 정의에 사용할 수 있는 섹션 및 속성의 전체 목록은 데이터 세트 및 연결된 서비스를 참조하세요.

Dynamics AX에서 데이터를 복사하려면 데이터 세트의 type 속성을 DynamicsAXResource로 설정합니다. 다음과 같은 속성이 지원됩니다.

속성	설명	필수
type	데이터 세트의 type 속성을 DynamicsAXResource로 설정해야 합니다.	예
경로	Dynamics AX OData 엔터티의 경로입니다.	예

예제

{
    "name": "DynamicsAXResourceDataset",
    "properties": {
        "type": "DynamicsAXResource",
        "typeProperties": {
            "path": "<entity path e.g. dd04tentitySet>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Dynamics AX linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

복사 활동 속성

이 섹션에서는 Dynamics AX 원본에서 지원하는 속성의 목록을 제공합니다.

작업 정의에 사용할 수 있는 섹션 및 속성의 전체 목록은 파이프라인을 참조하세요.

원본으로 Dynamics AX

Dynamics AX에서 데이터를 복사하려면 복사 작업의 source 형식을 DynamicsAXSource로 설정합니다. 복사 작업 source 섹션에서 지원되는 속성은 다음과 같습니다.

속성	설명	필수
type	복사 작업 원본의 type 속성을 DynamicsAXSource로 설정해야 합니다.	예
query	데이터 필터링에 대한 OData 쿼리 옵션입니다. 예: "?$select=Name,Description&$top=5" 참고: 커넥터가 결합된 URL([URL specified in linked service]/[path specified in dataset][query specified in copy activity source])에서 데이터를 복사합니다. 자세한 내용은 OData URL 구성 요소를 참조하세요.	아니요
httpRequestTimeout	HTTP 요청이 응답을 받을 시간 제한(TimeSpan 값)입니다. 이 값은 응답 데이터를 읽는 시간 제한이 아니라, 응답을 받을 시간 제한입니다. 지정하지 않으면 기본값은 00:05:00(5분)입니다.	아니요

예제

"activities":[
    {
        "name": "CopyFromDynamicsAX",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Dynamics AX input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "DynamicsAXSource",
                "query": "$top=10"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

조회 작업 속성

속성에 대한 자세한 내용을 보려면 조회 작업을 확인하세요.

관련 콘텐츠

복사 작업에서 원본 및 싱크로 지원되는 데이터 저장소의 목록은 지원되는 데이터 저장소 및 형식을 참조하세요.