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:
- Nástroj pro kopírování dat
- Azure Portal
- Sada .NET SDK
- Sada Python SDK
- Azure PowerShell
- Rozhraní REST API
- Šablona Azure Resource Manageru
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.
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ý:
Vyhledejte Dynamics a vyberte konektor Dynamics AX.
Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.
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:
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
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í.
Související obsah
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.