Adatok másolása a Dynamics AX-ből az Azure Data Factory vagy a Synapse Analytics használatával

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk azt ismerteti, hogyan másolhat adatokat a Dynamics AX-forrásból az Azure Data Factory és a Synapse Analytics-folyamatok másolási tevékenységeivel. A cikk a másolási tevékenységre épül, amely a másolási tevékenység általános áttekintését mutatja be.

Támogatott képességek

Ez a Dynamics AX-összekötő a következő képességeket támogatja:

Támogatott képességek IR
Copy tevékenység (forrás/-) ① ②
Keresési tevékenység ① ②

(1) Azure-integrációs modul (2) Saját üzemeltetésű integrációs modul

A forrásként és fogadóként támogatott adattárak listáját a Támogatott adattárak című témakörben találja.

Ez a Dynamics AX-összekötő kifejezetten támogatja az adatok Dynamics AX-ből való másolását az OData protokollal, szolgáltatásnév-hitelesítéssel.

Tipp.

Ezzel az összekötővel adatokat másolhat a Dynamics 365 Finance and Operations szolgáltatásból. Tekintse meg a Dynamics 365 OData támogatási és hitelesítési módszerét.

Első lépések

A Copy tevékenység folyamattal való végrehajtásához használja az alábbi eszközök vagy SDK-k egyikét:

Társított szolgáltatás létrehozása a Dynamics AX-hez felhasználói felületen

Az alábbi lépésekkel létrehozhat egy társított szolgáltatást a Dynamics AX-hez az Azure Portal felhasználói felületén.

  1. Keresse meg az Azure Data Factory vagy a Synapse-munkaterület Kezelés lapját, és válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:

  2. Keresse meg a Dynamics-t, és válassza ki a Dynamics AX-összekötőt.

    Select the Dynamics AX connector.

  3. Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

    Configure a linked service to Dynamics AX.

Csatlakozás or konfigurációjának részletei

Az alábbi szakaszok a Dynamics AX-összekötőre jellemző Data Factory-entitások meghatározásához használható tulajdonságok részleteit ismertetik.

Előfeltételek

A szolgáltatásnév-hitelesítés használatához kövesse az alábbi lépéseket:

  1. Alkalmazás regisztrálása a Microsoft Identity platformon. Ennek módjáról a rövid útmutatóban olvashat: Alkalmazás regisztrálása a Microsoft Identitásplatform. Jegyezze fel ezeket az értékeket, amelyeket a társított szolgáltatás definiálásához használ:

    • Pályázat azonosítója
    • Alkalmazáskulcs
    • Tenant ID
  2. Nyissa meg a Dynamics AX-et, és adjon megfelelő engedélyt a szolgáltatásnévnek a Dynamics AX eléréséhez.

Társított szolgáltatás tulajdonságai

A Dynamics AX társított szolgáltatás esetében a következő tulajdonságok támogatottak:

Property Leírás Required
típus A típustulajdonságot DynamicsAX értékre kell állítani. Igen
url A Dynamics AX (vagy Dynamics 365 Finance and Operations) OData-példányának OData-végpontja. Igen
servicePrincipalId Adja meg az alkalmazás ügyfél-azonosítóját. Igen
servicePrincipalKey Adja meg az alkalmazás kulcsát. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra. Igen
bérlő Adja meg azt a bérlői információt (tartománynevet vagy bérlőazonosítót), amely alatt az alkalmazás található. A lekéréshez vigye az egérmutatót az Azure Portal jobb felső sarkában. Igen
aadResourceId Adja meg az engedélyezéshez kért AAD-erőforrást. Ha például a Dynamics URL-címe, https://sampledynamics.sandbox.operations.dynamics.com/data/akkor a megfelelő AAD-erőforrás általában https://sampledynamics.sandbox.operations.dynamics.com. Igen
connectVia Az adattárhoz való csatlakozáshoz használható integrációs modul . Kiválaszthatja az Azure Integration Runtime-t vagy egy saját üzemeltetésű integrációs modult (ha az adattár egy magánhálózaton található). Ha nincs megadva, a rendszer az alapértelmezett Azure Integration Runtime-t használja. Nem

Példa

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

Adathalmaz tulajdonságai

Ez a szakasz a Dynamics AX-adatkészlet által támogatott tulajdonságok listáját tartalmazza.

Az adathalmazok meghatározásához elérhető szakaszok és tulajdonságok teljes listáját az Adathalmazok és a csatolt szolgáltatások című témakörben találja.

Ha adatokat szeretne másolni a Dynamics AX-ből, állítsa az adathalmaz típustulajdonságát a DynamicsAXResource-ra. A következő tulajdonságok támogatottak:

Property Leírás Required
típus Az adathalmaz típustulajdonságának DynamicsAXResource értékre kell állítania. Igen
ösvény A Dynamics AX OData entitás elérési útja. Igen

Példa

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

Másolási tevékenység tulajdonságai

Ez a szakasz a Dynamics AX-forrás által támogatott tulajdonságok listáját tartalmazza.

A tevékenységek meghatározásához elérhető szakaszok és tulajdonságok teljes listáját a Folyamatok című témakörben találja.

Dynamics AX mint forrás

Ha adatokat szeretne másolni a Dynamics AX-ből, állítsa be a forrástípust a Másolási tevékenységben a DynamicsAXSource-ba. A Másolási tevékenység forrás szakasza a következő tulajdonságokat támogatja:

Property Leírás Required
típus A Másolási tevékenység forrás típustulajdonságának DynamicsAXSource-ra kell állítania. Igen
Lekérdezés OData-lekérdezési beállítások az adatok szűréséhez. Example: "?$select=Name,Description&$top=5".

Megjegyzés: Az összekötő adatokat másol a kombinált URL-címről: [URL specified in linked service]/[path specified in dataset][query specified in copy activity source]. További információ: OData URL-összetevők.
Nem
httpRequestTimeout A HTTP-kérés időtúllépése (a TimeSpan értéke) a válasz lekéréséhez. Ez az érték a válasz lekéréséhez szükséges időtúllépés, nem pedig a válaszadatok olvasásának időtúllépése. Ha nincs megadva, az alapértelmezett érték 00:05:00 (5 perc). Nem

Példa

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

Keresési tevékenység tulajdonságai

A tulajdonságok részleteinek megismeréséhez tekintse meg a keresési tevékenységet.

Azoknak az adattáraknak a listáját, amelyeket a Másolási tevékenység forrásként és fogadóként támogat, tekintse meg a támogatott adattárakat és formátumokat.