Bagikan melalui

Menyalin data dari Marketo menggunakan Azure Data Factory (Pratinjau)

  • Artikel

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!

Penting

Konektor ini berada di tahap Akhir Dukungan. Anda disarankan untuk bermigrasi ke konektor ODBC dengan menginstal driver.

Artikel ini menguraikan cara menggunakan Aktivitas Salin di alur Azure Data Factory atau Synapse Analytics untuk menyalin data dari Marketo. Artikel tersebut dibuat berdasarkan artikel gambaran umum aktivitas salin yang menyajikan gambaran umum aktivitas salin.

Kemampuan yang didukung

Konektor Marketo ini didukung untuk kemampuan berikut:

Kemampuan yang didukung IR
Aktivitas penyalinan (sumber/-) (1) (2)
Aktivitas pencarian (1) (2)

① Runtime integrasi Azure ② Runtime integrasi yang dihost sendiri

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

Saat ini, instans Marketo yang terintegrasi dengan CRM eksternal tidak didukung.

Catatan

Konektor Marketo ini dibangun dengan REST API Marketo. Ketahuilah bahwa Marketo memiliki batas permintaan bersamaan di sisi layanan. Jika Anda mengalami kesalahan yang mengatakan "Kesalahan saat mencoba menggunakan REST API: Batas tingkat maksimum '100' terlampaui dalam '20' detik (606)" atau "Kesalahan saat mencoba menggunakan REST API: Batas akses bersamaan '10' tercapai (615)", pertimbangkan untuk mengurangi aktivitas salin bersamaan yang dijalankan untuk mengurangi jumlah permintaan ke layanan.

Memulai

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

Membuat layanan tertaut ke Marketo menggunakan UI

Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke Marketo di UI portal Azure.

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

  2. Cari Marketo dan pilih konektor Marketo.

    Tangkapan layar konektor Marketo.

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

    Tangkapan layar konfigurasi layanan tertaut untuk Marketo.

Detail konfigurasi konektor

Bagian berikut memberikan detail tentang properti yang digunakan untuk menentukan entitas Data Factory khusus untuk konektor Marketo.

Properti layanan tertaut

Properti berikut ini didukung untuk layanan tertaut Marketo:

Properti Deskripsi Wajib
jenis Properti type harus diatur ke: Marketo Ya
titik akhir Titik akhir server Marketo. (yaitu 123-ABC-321.mktorest.com) Ya
clientId ID klien layanan Marketo Anda. Ya
clientSecret Rahasia klien layanan Marketo Anda. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault. Ya
useEncryptedEndpoints Menentukan apakah titik akhir sumber data dienkripsi menggunakan HTTPS. Nilai defaultnya adalah true. No
useHostVerification Menentukan apakah mewajibkan nama host di sertifikat server agar sesuai dengan nama host server saat menyambungkan melalui TLS. Nilai defaultnya adalah true. No
usePeerVerification Menentukan apakah akan memverifikasi identitas server ketika menyambungkan melalui TLS. Nilai defaultnya adalah true. No

Contoh:

{
    "name": "MarketoLinkedService",
    "properties": {
        "type": "Marketo",
        "typeProperties": {
            "endpoint" : "123-ABC-321.mktorest.com",
            "clientId" : "<clientId>",
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            }
        }
    }
}

Properti himpunan data

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan himpunan data, lihat artikel himpunan data. Bagian ini menyediakan daftar properti yang didukung oleh himpunan data Marketo.

Untuk menyalin data dari Marketo, atur properti type himpunan data ke MarketoObject. Berikut adalah properti yang didukung:

Properti Deskripsi Wajib
jenis Properti type himpunan data harus diatur ke: MarketoObject Ya
tableName Nama tabel. Tidak (jika "kueri" di sumber aktivitas ditentukan)

Contoh

{
    "name": "MarketoDataset",
    "properties": {
        "type": "MarketoObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Marketo linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Properti aktivitas salin

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan aktivitas, lihat artikel Alur. Bagian ini menyediakan daftar properti yang didukung oleh sumber Marketo.

Marketo sebagai sumber

Untuk menyalin data dari Marketo, atur jenis sumber dalam aktivitas salin ke MarketoSource. Berikut ini properti yang didukung di bagian sumber aktivitas salin:

Properti Deskripsi Wajib
jenis Properti type dari sumber aktivitas salin harus diatur ke: MarketoSource Ya
pertanyaan Gunakan kueri SQL kustom untuk membaca data. Misalnya: "SELECT * FROM Activity_Types". Tidak (jika "tableName" di himpunan data ditentukan)

Contoh:

"activities":[
    {
        "name": "CopyFromMarketo",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Marketo input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "MarketoSource",
                "query": "SELECT top 1000 * FROM Activity_Types"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Properti aktivitas pencarian

Untuk mempelajari detail tentang properti, lihat Aktivitas pencarian.

Konten terkait

Untuk daftar penyimpanan data yang didukung sebagai sumber dan sink oleh aktivitas salin, lihat penyimpanan data yang didukung.