Menyalin data dari Salesforce Marketing Cloud menggunakan Azure Data Factory atau Azure Synapse Analytics

Artikel
11/16/2023

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 Azure Synapse Analytics untuk menyalin data dari Salesforce Marketing Cloud. Artikel tersebut dibuat berdasarkan artikel gambaran umum aktivitas salin yang menyajikan gambaran umum aktivitas salin.

Kemampuan yang didukung

Konektor Cloud Pemasaran Salesforce 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/sink, lihat tabel Penyimpanan data yang didukung.

Konektor Salesforce Marketing Cloud mendukung autentikasi OAuth 2, dan mendukung jenis paket warisan dan yang disempurnakan. Konektor ini dibangun di atas Salesforce Marketing Cloud REST API.

Catatan

Konektor ini tidak mendukung pengambilan tampilan, objek kustom, atau ekstensi data kustom.

Memulai

Anda dapat membuat alur dengan aktivitas salin menggunakan .NET SDK, Python SDK, Azure PowerShell, REST API, atau templat Azure Resource Manager. Lihat Tutorial aktivitas salin untuk instruksi langkah demi langkah guna membuat alur dengan aktivitas salin.

Membuat layanan tertaut ke Salesforce Marketing Cloud menggunakan UI

Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke Salesforce Marketing Cloud di UI portal Azure.

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
Cari Salesforce dan pilih konektor Salesforce Marketing Cloud.
Konfigurasikan detail layanan, uji koneksi, dan buat layanan tertaut baru.

Catatan

Cakupan integrasi API pada Salesforce Marketing Cloud harus diatur ke Hub | Kampanye | Baca agar konektor berhasil.

Detail konfigurasi konektor

Bagian berikut ini menyediakan detail tentang properti yang digunakan untuk menentukan entitas Data Factory tertentu untuk konektor Salesforce Marketing Cloud.

Properti layanan tertaut

Properti berikut ini didukung untuk layanan tertaut Salesforce Marketing Cloud:

Properti	Deskripsi	Wajib
jenis	Properti jenis harus diatur ke: SalesforceMarketingCloud	Ya
connectionProperties	Sekelompok properti yang menentukan cara terhubung ke Salesforce Marketing Cloud.	Ya
Di bawah `connectionProperties`:
authenticationType	Menentukan metode autentikasi yang akan digunakan. Nilai yang diizinkan adalah: `Enhanced sts OAuth 2.0` atau `OAuth_2.0`. Paket warisan Salesforce Marketing Cloud hanya mendukung `OAuth_2.0`, sementara kebutuhan paket yang ditingkatkan `Enhanced sts OAuth 2.0`. Sejak 1 Agustus 2019, Salesforce Marketing Cloud telah menghapus kemampuan untuk membuat paket warisan. Semua paket baru adalah paket yang disempurnakan.	Ya
tuan rumah	Untuk paket yang ditingkatkan, host harus subdomain Anda yang diwakili oleh string 28 karakter yang dimulai dengan huruf "mc", misalnya `mc563885gzs27c5t9-63k636ttgm`. Untuk paket warisan, tentukan `www.exacttargetapis.com`.	Ya
clientId	ID klien yang terkait dengan aplikasi Salesforce Marketing Cloud.	Ya
clientSecret	Rahasia klien yang terkait dengan aplikasi Salesforce Marketing Cloud. Anda dapat memilih untuk menandai bidang ini sebagai SecureString untuk menyimpannya dengan aman di layanan, atau menyimpan rahasia di Azure Key Vault dan membiarkan layanan aktivitas salin menarik dari sana ketika melakukan penyalinan data - pelajari selengkapnya dari Menyimpan kredensial di Key Vault.	Ya
useEncryptedEndpoints	Menentukan apakah titik akhir sumber data dienkripsi menggunakan HTTPS. Nilai defaultnya adalah true.	Tidak
useHostVerification	Menentukan apakah mewajibkan nama host di sertifikat server agar sesuai dengan nama host server saat menyambungkan melalui TLS. Nilai defaultnya adalah true.	Tidak
usePeerVerification	Menentukan apakah akan memverifikasi identitas server ketika menyambungkan melalui TLS. Nilai defaultnya adalah true.	Tidak

Contoh: menggunakan autentikasi STS OAuth 2 yang disempurnakan untuk paket yang disempurnakan

{
    "name": "SalesforceMarketingCloudLinkedService",
    "properties": {
        "type": "SalesforceMarketingCloud",
        "typeProperties": {
            "connectionProperties": {
                "host": "<subdomain e.g. mc563885gzs27c5t9-63k636ttgm>",
                "authenticationType": "Enhanced sts OAuth 2.0",
                "clientId": "<clientId>",
                "clientSecret": {
                     "type": "SecureString",
                     "value": "<clientSecret>"
            	},
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
}

Contoh: menggunakan autentikasi OAuth 2 untuk paket warisan

{
    "name": "SalesforceMarketingCloudLinkedService",
    "properties": {
        "type": "SalesforceMarketingCloud",
        "typeProperties": {
            "connectionProperties": {
                "host": "www.exacttargetapis.com",
                "authenticationType": "OAuth_2.0",
                "clientId": "<clientId>",
                "clientSecret": {
                     "type": "SecureString",
                     "value": "<clientSecret>"
            	},
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
}

Jika Anda menggunakan layanan Salesforce Marketing Cloud yang ditautkan dengan payload berikut, layanan ini masih didukung apa adanya, sementara Anda disarankan untuk menggunakan yang baru ke depan yang menambahkan dukungan paket yang ditingkatkan.

{
    "name": "SalesforceMarketingCloudLinkedService",
    "properties": {
        "type": "SalesforceMarketingCloud",
        "typeProperties": {
            "clientId": "<clientId>",
            "clientSecret": {
                 "type": "SecureString",
                 "value": "<clientSecret>"
            },
            "useEncryptedEndpoints": true,
            "useHostVerification": true,
            "usePeerVerification": true
        }
    }
}

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 kumpulan data Salesforce Marketing Cloud.

Untuk menyalin data dari Salesforce Marketing Cloud, atur properti jenis himpunan data ke SalesforceMarketingCloudObject. Berikut adalah properti yang didukung:

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

Contoh

{
    "name": "SalesforceMarketingCloudDataset",
    "properties": {
        "type": "SalesforceMarketingCloudObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SalesforceMarketingCloud 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 Salesforce Marketing Cloud.

Salesforce Marketing Cloud sebagai sumber

Untuk menyalin data dari Salesforce Marketing Cloud, atur jenis sumber dalam aktivitas penyalinan ke SalesforceMarketingCloudSource. Berikut ini properti yang didukung di bagian sumber aktivitas salin:

Properti	Deskripsi	Wajib
jenis	Properti jenis sumber aktivitas penyalinan harus diatur ke: SalesforceMarketingCloudSource	Ya
pertanyaan	Gunakan kueri SQL kustom untuk membaca data. Sebagai contoh: `"SELECT * FROM MyTable"`.	Tidak (jika "tableName" di himpunan data ditentukan)

Contoh:

"activities":[
    {
        "name": "CopyFromSalesforceMarketingCloud",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SalesforceMarketingCloud input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SalesforceMarketingCloudSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Catatan

Tabel kontak tidak didukung.

Properti aktivitas pencarian

Untuk mempelajari detail tentang properti, lihat Aktivitas pencarian.

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

Menyalin data dari Salesforce Marketing Cloud menggunakan Azure Data Factory atau Azure Synapse Analytics

Kemampuan yang didukung

Memulai

Membuat layanan tertaut ke Salesforce Marketing Cloud menggunakan UI

Detail konfigurasi konektor

Properti layanan tertaut

Properti himpunan data

Properti aktivitas salin

Salesforce Marketing Cloud sebagai sumber

Properti aktivitas pencarian

Konten terkait

Sumber Daya Tambahan: