Menyalin data dari Salesforce Marketing Cloud menggunakan Azure Data Factory atau Azure 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 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/-) | (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.
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:
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. | 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: 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. Misalnya: "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.
Konten terkait
Untuk daftar penyimpanan data yang didukung sebagai sumber dan sink oleh aktivitas salin, lihat penyimpanan data yang didukung.