Kopiowanie danych z Dynamics AX przy użyciu Azure Data Factory lub usługi Synapse Analytics

DOTYCZY: Azure Data Factory Azure Synapse Analytics

W tym artykule opisano sposób używania działania kopiowania w potokach Azure Data Factory i Synapse Analytics w celu kopiowania danych ze źródła Dynamics AX. Artykuł opiera się na działaniu kopiowania, które przedstawia ogólne omówienie działania kopiowania.

Obsługiwane możliwości

Ten łącznik Dynamics AX jest zgodny z następującymi funkcjami:

(1) Środowisko uruchomieniowe Azure (2) Środowisko uruchomieniowe lokalnie hostowane

Aby uzyskać listę magazynów danych, które mogą działać jako źródła i ujścia, zobacz Obsługiwane magazyny danych.

W szczególności ten łącznik Dynamics AX obsługuje kopiowanie danych z Dynamics AX przy użyciu protokołu OData z uwierzytelnianiem jednostki usługi Service.

Wprowadzenie

Aby wykonać działanie kopiowania za pomocą potoku, możesz użyć jednego z następujących narzędzi lub zestawów SDK:

• Narzędzie do kopiowania danych
• Portal Azure
• SDK platformy .NET
• SDK Python
• Azure PowerShell
• API REST
• Szablon menedżera zasobów Azure

Utwórz połączoną usługę dla Dynamics AX przy użyciu interfejsu użytkownika

Wykonaj poniższe kroki, aby utworzyć połączoną usługę z Dynamics AX w interfejsie użytkownika portalu Azure.

1. Przejdź do karty Zarządzanie w obszarze roboczym usługi Azure Data Factory lub Synapse i wybierz pozycję Połączone usługi, a następnie wybierz pozycję Nowe:

   • Azure Data Factory
   • Azure Synapse

   

2. Wyszukaj Dynamics i wybierz łącznik Dynamics AX.

   

3. Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.

   

Szczegóły konfiguracji łącznika

Poniższe sekcje zawierają szczegółowe informacje o właściwościach, których można użyć do definiowania jednostek usługi Data Factory specyficznych dla łącznika Dynamics AX.

Wymagania wstępne

Aby użyć uwierzytelniania jednostki usługi, wykonaj następujące kroki:

1. Zarejestruj aplikację za pomocą platformy Microsoft Identity. Aby dowiedzieć się, jak to zrobić, zobacz Quickstart: Rejestrowanie aplikacji przy użyciu Platforma tożsamości Microsoft. Zanotuj te wartości, których użyjesz do zdefiniowania połączonej usługi:

   • Identyfikator aplikacji
   • Klucz aplikacji
   • Identyfikator dzierżawy

2. Przejdź do Dynamics AX i przyznaj temu pryncypałowi usługi odpowiednie uprawnienia dostępu do Dynamics AX.

Właściwości połączonej usługi

Następujące właściwości są obsługiwane w przypadku usługi połączeniowej Dynamics AX:

Przykład

{
    "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"
    }
}

Właściwości zestawu danych

Ta sekcja zawiera listę właściwości, które obsługuje zestaw danych Dynamics AX.

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania zestawów danych, zobacz Zestawy danych i połączone usługi.

Aby skopiować dane z Dynamics AX, ustaw właściwość type zestawu danych na DynamicsAXResource. Obsługiwane są następujące właściwości:

Przykład

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

Właściwości działania kopiowania

Ta sekcja zawiera listę właściwości, które obsługuje źródło Dynamics AX.

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania działań, zobacz Potoki.

Dynamics AX jako źródło

Aby skopiować dane z Dynamics AX, ustaw typ source w działaniu kopiującym na DynamicsAXSource. Następujące właściwości są obsługiwane w sekcji Źródło działania kopiowania:

Przykład

"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>"
            }
        }
    }
]

Właściwości czynności wyszukiwania

Aby dowiedzieć się więcej o właściwościach, sprawdź działanie wyszukiwania.

Powiązana zawartość

Aby uzyskać listę magazynów danych obsługiwanych przez działanie kopiowania jako źródła i ujścia, zobacz Obsługiwane magazyny danych i formaty.