Kopírování dat z Dynamics AX pomocí Azure Data Factory nebo Synapse Analytics

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

Tento článek popisuje, jak pomocí aktivity kopírování v kanálech Azure Data Factory a Synapse Analytics kopírovat data ze zdroje Dynamics AX. Článek vychází z aktivity kopírování, která představuje obecný přehled aktivity kopírování.

Podporované funkce

Tento konektor Dynamics AX je podporovaný pro následující funkce:

Podporované funkce IR
aktivita Copy (zdroj/-) (1) (2)
Aktivita Lookup (1) (2)

(1) Prostředí Azure Integration Runtime (2) Místní prostředí Integration Runtime

Seznam úložišť dat, která podporují jako zdroje a jímky, najdete v tématu Podporované úložiště dat.

Konkrétně tento konektor Dynamics AX podporuje kopírování dat z Dynamics AX pomocí protokolu OData s ověřováním instančního objektu.

Tip

Tento konektor můžete také použít ke kopírování dat z Dynamics 365 Finance and Operations. Podívejte se na metodu podpory a ověřování Dynamics 365 OData.

Začínáme

K provedení aktivita Copy s kanálem můžete použít jeden z následujících nástrojů nebo sad SDK:

Vytvoření propojené služby s Dynamics AX pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu s Dynamics AX v uživatelském rozhraní webu Azure Portal.

  1. Přejděte na kartu Správa v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a pak klikněte na Nový:

  2. Vyhledejte Dynamics a vyberte konektor Dynamics AX.

    Vyberte konektor Dynamics AX.

  3. Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.

    Nakonfigurujte propojenou službu pro Dynamics AX.

Podrobnosti konfigurace konektoru

Následující části obsahují podrobnosti o vlastnostech, které můžete použít k definování entit služby Data Factory, které jsou specifické pro konektor Dynamics AX.

Požadavky

Pokud chcete použít ověřování instančního objektu, postupujte takto:

  1. Zaregistrujte aplikaci na platformě Microsoft Identity Platform. Postup najdete v tématu Rychlý start: Registrace aplikace na platformě Microsoft Identity Platform. Poznamenejte si tyto hodnoty, které použijete k definování propojené služby:

    • ID aplikace
    • Klíč aplikace
    • ID tenanta
  2. Přejděte do Dynamics AX a udělte tomuto instančnímu objektu správné oprávnění pro přístup k dynamics AX.

Vlastnosti propojené služby

Propojená služba Dynamics AX podporuje následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu musí být nastavena na DynamicsAX. Ano
url Koncový bod OData instance Dynamics AX (nebo Dynamics 365 Finance and Operations). Ano
servicePrincipalId Zadejte ID klienta aplikace. Ano
servicePrincipalKey Zadejte klíč aplikace. Označte toto pole jako securestring , abyste ho mohli bezpečně uložit, nebo odkazovat na tajný klíč uložený ve službě Azure Key Vault. Ano
tenant Zadejte informace o tenantovi (název domény nebo ID tenanta), pod kterým se vaše aplikace nachází. Načtěte ho tak, že nainstalujete myší v pravém horním rohu webu Azure Portal. Ano
aadResourceId Zadejte prostředek AAD, který žádáte o autorizaci. Pokud je https://sampledynamics.sandbox.operations.dynamics.com/data/například adresa URL dynamics , odpovídající prostředek AAD je obvykle https://sampledynamics.sandbox.operations.dynamics.com. Ano
connectVia Prostředí Integration Runtime , které se má použít pro připojení k úložišti dat. Můžete zvolit prostředí Azure Integration Runtime nebo místní prostředí Integration Runtime (pokud se vaše úložiště dat nachází v privátní síti). Pokud není zadaný, použije se výchozí prostředí Azure Integration Runtime. No

Příklad

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

Vlastnosti datové sady

Tato část obsahuje seznam vlastností, které datová sada Dynamics AX podporuje.

Úplný seznam oddílů a vlastností, které jsou k dispozici pro definování datových sad, najdete v tématu Datové sady a propojené služby.

Pokud chcete kopírovat data z Dynamics AX, nastavte vlastnost typu datové sady na DynamicsAXResource. Podporují se následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu datové sady musí být nastavena na DynamicsAXResource. Ano
path Cesta k entitě Dynamics AX OData. Ano

Příklad

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

Vlastnosti aktivity kopírování

Tato část obsahuje seznam vlastností, které zdroj Dynamics AX podporuje.

Úplný seznam oddílů a vlastností, které jsou k dispozici pro definování aktivit, najdete v tématu Kanály.

Dynamics AX jako zdroj

Pokud chcete kopírovat data z Dynamics AX, nastavte typ zdroje v aktivitě kopírování na DynamicsAXSource. Ve zdroji aktivity kopírování jsou podporovány následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu zdroje aktivity kopírování musí být nastavena na DynamicsAXSource. Ano
query Možnosti dotazu OData pro filtrování dat Příklad: "?$select=Name,Description&$top=5".

Poznámka: Konektor kopíruje data z kombinované adresy URL: [URL specified in linked service]/[path specified in dataset][query specified in copy activity source]. Další informace najdete v tématu Komponenty adresy URL OData.
No
httpRequestTimeout Časový limit ( hodnota TimeSpan ) požadavku HTTP pro získání odpovědi. Tato hodnota je časový limit pro získání odpovědi, nikoli časový limit pro čtení dat odpovědi. Pokud není zadána, výchozí hodnota je 00:05:00 (5 minut). No

Příklad

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

Vlastnosti aktivity vyhledávání

Podrobnosti o vlastnostech najdete v aktivitě Vyhledávání.

Seznam úložišť dat, která aktivita kopírování podporuje jako zdroje a jímky, najdete v tématu Podporované úložiště a formáty dat.