Aracılığıyla paylaş


Azure Data Factory veya Synapse Analytics kullanarak Salesforce Marketing Cloud'dan veri kopyalama

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

İpucu

Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!

Bu makalede, Salesforce Marketing Cloud'dan veri kopyalamak için Azure Data Factory veya Synapse Analytics işlem hatlarında Kopyalama Etkinliğinin nasıl kullanılacağı özetlenmiştir. Kopyalama etkinliğine genel bir genel bakış sunan kopyalama etkinliğine genel bakış makalesini oluşturur.

Desteklenen özellikler

Bu Salesforce Marketing Cloud bağlayıcısı aşağıdaki özellikler için desteklenir:

Desteklenen özellikler IR
Kopyalama etkinliği (kaynak/-) (1) (2)
Arama etkinliği (1) (2)

(1) Azure tümleştirme çalışma zamanı (2) Şirket içinde barındırılan tümleştirme çalışma zamanı

Kaynak/havuz olarak desteklenen veri depolarının listesi için Desteklenen veri depoları tablosuna bakın.

Salesforce Marketing Cloud bağlayıcısı OAuth 2 kimlik doğrulamasını destekler ve hem eski hem de gelişmiş paket türlerini destekler. Bağlayıcı, Salesforce Marketing Cloud REST API'sinin üzerine kurulmuştur.

Not

Bu bağlayıcı görünümlerin, özel nesnelerin veya özel veri uzantılarının alınmasını desteklemez.

Başlarken

.NET SDK, Python SDK, Azure PowerShell, REST API veya Azure Resource Manager şablonu kullanarak kopyalama etkinliğiyle işlem hattı oluşturabilirsiniz. Kopyalama etkinliğiyle işlem hattı oluşturmaya yönelik adım adım yönergeler için Kopyalama etkinliği öğreticiye bakın.

Kullanıcı arabirimini kullanarak Salesforce Marketing Cloud'a bağlı hizmet oluşturma

Azure portalı kullanıcı arabiriminde Salesforce Marketing Cloud'a bağlı bir hizmet oluşturmak için aşağıdaki adımları kullanın.

  1. Azure Data Factory veya Synapse çalışma alanınızda Yönet sekmesine göz atın ve Bağlı Hizmetler'i seçin, ardından Yeni'ye tıklayın:

  2. Salesforce için arama yapın ve Salesforce Marketing Cloud bağlayıcısını seçin.

    Salesforce Marketing Cloud bağlayıcısını seçin.

  3. Hizmet ayrıntılarını yapılandırın, bağlantıyı test edin ve yeni bağlı hizmeti oluşturun.

    Bağlı bir hizmeti Salesforce Marketing Cloud'a yapılandırın.

Not

Salesforce Marketing Cloud'da API tümleştirme kapsamı Hub | olarak ayarlanmalıdır Kampanya | Bağlayıcının başarılı olması için okuyun.

Bağlayıcı yapılandırma ayrıntıları

Aşağıdaki bölümlerde Salesforce Marketing Cloud bağlayıcısına özgü Data Factory varlıklarını tanımlamak için kullanılan özelliklerle ilgili ayrıntılar sağlanır.

Bağlı hizmet özellikleri

Salesforce Marketing Cloud bağlı hizmeti için aşağıdaki özellikler desteklenir:

Özellik Açıklama Gerekli
Tür Tür özelliği şu şekilde ayarlanmalıdır: SalesforceMarketingCloud Yes
connectionProperties Salesforce Marketing Cloud'a bağlanmayı tanımlayan bir özellik grubu. Yes
altında connectionProperties:
authenticationType Kullanılacak kimlik doğrulama yöntemini belirtir. İzin verilen değerler veya OAuth_2.0şeklindedirEnhanced sts OAuth 2.0.

Salesforce Marketing Cloud eski paketi yalnızca desteklerken OAuth_2.0, gelişmiş pakete ihtiyaç duyar Enhanced sts OAuth 2.0.
Salesforce Marketing Cloud, 1 Ağustos 2019'dan bu yana eski paketler oluşturma özelliğini kaldırmıştır. Tüm yeni paketler gelişmiş paketlerdir.
Yes
host Gelişmiş paket için konak, "mc" harfleriyle başlayan 28 karakterlik bir dizeyle temsil edilen alt etki alanınız olmalıdır; örneğin. mc563885gzs27c5t9-63k636ttgm.
Eski paket için belirtin www.exacttargetapis.com.
Yes
clientId Salesforce Marketing Cloud uygulamasıyla ilişkili istemci kimliği. Yes
clientSecret Salesforce Marketing Cloud uygulamasıyla ilişkili istemci gizli dizisi. Bu alanı güvenli bir şekilde hizmette depolamak için SecureString olarak işaretlemeyi veya gizli diziyi Azure Key Vault'ta depolamayı ve veri kopyalama gerçekleştirirken hizmet kopyalama etkinliğinin oradan çekmesine izin vermeyi seçebilirsiniz. Key Vault'ta kimlik bilgilerini depolama bölümünden daha fazla bilgi edinebilirsiniz. Yes
useEncryptedEndpoints Veri kaynağı uç noktalarının HTTPS kullanılarak şifrelenip şifrelenmediğini belirtir. Varsayılan değer doğru'dur. Hayır
useHostVerification TLS üzerinden bağlanırken sunucunun sertifikasındaki ana bilgisayar adının sunucunun ana bilgisayar adıyla eşleşip eşleşmeymeyeceğini belirtir. Varsayılan değer doğru'dur. Hayır
usePeerVerification TLS üzerinden bağlanırken sunucunun kimliğinin doğrulanıp doğrulanmayacağını belirtir. Varsayılan değer doğru'dur. Hayır

Örnek: Gelişmiş paket için gelişmiş STS OAuth 2 kimlik doğrulamasını kullanma

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

Örnek: eski paket için OAuth 2 kimlik doğrulamasını kullanma

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

Salesforce Marketing Cloud bağlı hizmetini aşağıdaki yükle birlikte kullanıyorsanız, bu hizmet olduğu gibi desteklenirken, ileriye dönük olarak gelişmiş paket desteği ekleyen yeni hizmeti kullanmanız önerilir.

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

Veri kümesi özellikleri

Veri kümelerini tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için veri kümeleri makalesine bakın. Bu bölümde Salesforce Marketing Cloud veri kümesi tarafından desteklenen özelliklerin listesi sağlanır.

Salesforce Marketing Cloud'dan veri kopyalamak için veri kümesinin tür özelliğini SalesforceMarketingCloudObject olarak ayarlayın. Aşağıdaki özellikler desteklenir:

Özellik Açıklama Gerekli
Tür Veri kümesinin tür özelliği şu şekilde ayarlanmalıdır: SalesforceMarketingCloudObject Yes
tableName Tablonun adı. Hayır (etkinlik kaynağında "sorgu" belirtilirse)

Örnek

{
    "name": "SalesforceMarketingCloudDataset",
    "properties": {
        "type": "SalesforceMarketingCloudObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SalesforceMarketingCloud linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Kopyalama etkinliğinin özellikleri

Etkinlikleri tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için İşlem hatları makalesine bakın. Bu bölümde Salesforce Marketing Cloud kaynağı tarafından desteklenen özelliklerin listesi sağlanır.

Kaynak olarak Salesforce Marketing Cloud

Salesforce Marketing Cloud'dan veri kopyalamak için kopyalama etkinliğindeki kaynak türünü SalesforceMarketingCloudSource olarak ayarlayın. Kopyalama etkinliği kaynağı bölümünde aşağıdaki özellikler desteklenir:

Özellik Açıklama Gerekli
Tür Kopyalama etkinliği kaynağının tür özelliği şu şekilde ayarlanmalıdır: SalesforceMarketingCloudSource Yes
query Verileri okumak için özel SQL sorgusunu kullanın. Örneğin: "SELECT * FROM MyTable". Hayır (veri kümesinde "tableName" belirtilirse)

Örnek:

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

Not

Kişiler tablosu desteklenmiyor.

Arama etkinliği özellikleri

Özellikler hakkında ayrıntılı bilgi edinmek için Arama etkinliği'ne bakın.

Kopyalama etkinliği tarafından kaynak ve havuz olarak desteklenen veri depolarının listesi için bkz . desteklenen veri depoları.