Menyalin data dari Dynamics AX menggunakan Azure Data Factory atau Synapse Analytics

BERLAKU UNTUK:Azure Data Factory Azure Synapse Analytics

Tip

Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!

Artikel ini menguraikan cara menggunakan Aktivitas Salin di alur Azure Data Factory atau Synapse Analytics untuk menyalin data dari sumber Dynamics AX. Artikel ini dibuat berdasarkan Aktivitas Salin, yang menyajikan ikhtisar umum tentang Aktivitas Salin.

Kemampuan yang didukung

Konektor Dynamics AX ini didukung untuk kemampuan berikut:

Kemampuan yang didukung	IR
Aktivitas penyalinan (sumber/-)	① ②
Aktivitas pencarian	① ②

① Runtime integrasi Azure ② Runtime integrasi yang dihost sendiri

Untuk daftar penyimpanan data yang didukung sebagai sumber dan sink, lihat Penyimpanan data yang didukung.

Secara khusus, konektor Dynamics AX ini mendukung penyalinan data dari Dynamics AX menggunakan protokol OData dengan autentikasi Perwakilan Layanan.

Tip

Anda juga dapat menggunakan konektor ini untuk menyalin data dari Dynamics 365 Finance and Operations. Lihat dukungan OData Dynamics 365 dan Metode autentikasi.

Mulai

Untuk melakukan aktivitas Salin dengan alur, Anda dapat menggunakan salah satu alat atau SDK berikut:

• Alat Penyalinan Data
• Portal Microsoft Azure
• SDK .NET
• SDK Python
• Azure PowerShell
• REST API
• Templat Azure Resource Manager

Membuat layanan tertaut ke Dynamics AX menggunakan Antarmuka Pengguna

Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke Dynamics AX di antarmuka pengguna portal Microsoft Azure.

1. Telusuri ke tab Kelola di ruang kerja Azure Data Factory atau Synapse Anda dan pilih Layanan Tertaut, lalu klik Baru:

   Azure Data Factory

   

   Azure Synapse

   

2. Cari Dynamics dan pilih konektor Dynamics AX.

   

3. Konfigurasikan detail layanan, uji koneksi, dan buat layanan tertaut baru.

   

Detail konfigurasi konektor

Bagian berikut ini memberikan detail tentang properti yang dapat Anda gunakan untuk menentukan entitas Data Factory khusus untuk konektor Dynamics AX.

Prasyarat

Untuk menggunakan autentikasi perwakilan layanan, ikuti langkah-langkah berikut ini:

1. Daftarkan aplikasi dengan platform Identitas Microsoft. Untuk mempelajari caranya, lihat Mulai Cepat: Mendaftarkan aplikasi dengan platform identitas Microsoft. Catat nilai berikut, yang Anda gunakan untuk menentukan layanan tertaut:

   • ID Aplikasi
   • Kunci Aplikasi
   • ID Penyewa

2. Buka Dynamics AX, dan beri perwakilan layanan ini izin yang tepat untuk mengakses Dynamics AX Anda.

Properti layanan tertaut

Properti berikut ini didukung untuk layanan tertaut Dynamics AX:

Properti	Deskripsi	Wajib
jenis	Properti jenis harus diatur keDynamicsAX.	Ya
url	Titik akhir OData instans Dynamics AX (atau Dynamics 365 Finance and Operations).	Ya
servicePrincipalId	Menentukan ID klien aplikasi.	Ya
servicePrincipalKey	Tentukan kunci aplikasi. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau referensikan rahasia yang disimpan di Azure Key Vault.	Ya
penyewa	Tentukan informasi penyewa (nama domain atau ID penyewa) tempat aplikasi Anda berada. Anda dapat mengambilnya dengan mengarahkan mouse ke sudut kanan atas portal Microsoft Azure.	Ya
aadResourceId	Tentukan sumber daya AAD yang Anda minta untuk otorisasi. Misalnya, jika URL Dynamics Anda adalah https://sampledynamics.sandbox.operations.dynamics.com/data/, sumber daya Azure Active Directory yang sesuai biasanya https://sampledynamics.sandbox.operations.dynamics.com.	Ya
connectVia	Integration Runtime digunakan untuk menyambungkan ke penyimpanan data. Anda dapat memilih Integration Runtime Azure atau IR yang dihost sendiri (jika penyimpanan data Anda berada di jaringan privat). Jika tidak ditentukan, Integration Runtime Azure default digunakan.	Tidak

Contoh

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

Properti himpunan data

Bagian ini menyediakan daftar properti yang didukung himpunan data Dynamics AX.

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan himpunan data, lihat Himpunan data dan layanan tertaut.

Untuk menyalin data dari Dynamics AX, atur properti jenis himpunan data ke DynamicsAXResource. Berikut adalah properti yang didukung:

Properti	Deskripsi	Wajib
jenis	Properti jenis himpunan data harus diatur ke DynamicsAXResource.	Ya
jalan	Jalur ke entitas OData Dynamics AX.	Ya

Contoh

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

Properti Aktivitas Salin

Bagian ini menyediakan daftar properti yang didukung himpunan data Dynamics AX.

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan aktivitas, lihat Alur.

Dynamics AX sebagai sumber

Untuk menyalin data dari Dynamics AX, atur jenis sumber di Aktivitas Salin ke DynamicsAXSource. Properti berikut ini didukung di bagian sumber Aktivitas Penyalinan:

Properti	Deskripsi	Wajib
jenis	Properti jenis sumber Aktivitas Salin harus diatur ke DynamicsAXSource.	Ya
pertanyaan	Opsi kueri OData untuk memfilter data. Contoh: "?$select=Name,Description&$top=5". Catatan: Konektor menyalin data dari URL gabungan: [URL specified in linked service]/[path specified in dataset][query specified in copy activity source]. Selengkapnya, lihat komponen URL OData.	Tidak
httpRequestTimeout	Waktu habis (nilai TimeSpan) untuk permintaan HTTP untuk mendapatkan respons. Nilai ini adalah batas waktu untuk mendapatkan respons, bukan batas waktu untuk membaca data respons. Jika tidak ditentukan, nilai defaultnya adalah 00:05:00 (5 menit).	Tidak

Contoh

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

Properti aktivitas pencarian

Untuk mempelajari detail tentang properti, lihat Aktivitas pencarian.

Konten terkait

Untuk daftar penyimpanan data yang didukung Aktivitas Salin sebagai sumber dan sink, lihat Penyimpanan dan format data yang didukung.