Kopieren von Daten aus Salesforce Marketing Cloud mithilfe von Azure Data Factory oder Synapse Analytics

  • Artikel

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

In diesem Artikel wird beschrieben, wie Sie die Copy-Aktivität in Azure Data Factory- oder Synapse Analytics-Pipelines verwenden, um Daten aus Salesforce Marketing Cloud zu kopieren. Er baut auf dem Artikel zur Übersicht über die Kopieraktivität auf, der eine allgemeine Übersicht über die Kopieraktivität enthält.

Unterstützte Funktionen

Für den Salesforce Marketing Cloud-Connector werden die folgenden Funktionen unterstützt:

Unterstützte Funktionen IR
Kopieraktivität (Quelle/-) 1.6
Lookup-Aktivität 1.6

① Azure Integration Runtime ② Selbstgehostete Integration Runtime

Eine Liste der Datenspeicher, die als Quellen/Senken unterstützt werden, finden Sie in der Tabelle Unterstützte Datenspeicher.

Der Salesforce Marketing Cloud-Connector unterstützt die OAuth 2-Authentifizierung und sowohl ältere als auch erweiterte Pakettypen. Der Connector basiert auf der Salesforce Marketing Cloud-REST-API.

Hinweis

Das Abrufen von Ansichten, benutzerdefinierten Objekten oder benutzerdefinierten Datenerweiterungen wird von diesem Connector nicht unterstützt.

Erste Schritte

Sie können mit dem .NET SDK, Python SDK, Azure PowerShell, der REST-API oder der Azure Resource Manager-Vorlage eine Pipeline mit einer Kopieraktivität erstellen. Im Tutorial zur Kopieraktivität finden Sie detaillierte Anweisungen, wie Sie eine Pipeline mit einer Kopieraktivität erstellen können.

Erstellen eines verknüpften Diensts mit Salesforce Marketing Cloud über die Benutzeroberfläche

Verwenden Sie die folgenden Schritte, um einen verknüpften Dienst mit Salesforce Marketing Cloud auf der Azure-Portal Benutzeroberfläche zu erstellen.

  1. Navigieren Sie in Ihrem Azure Data Factory- oder Synapse-Arbeitsbereich zu der Registerkarte „Verwalten“, wählen Sie „Verknüpfte Dienste“ aus und klicken Sie dann auf „Neu“:

  2. Suchen Sie nach „Salesforce“, und wählen Sie den Salesforce Marketing Cloud-Connector aus.

    Select the Salesforce Marketing Cloud connector.

  3. Konfigurieren Sie die Dienstdetails, testen Sie die Verbindung, und erstellen Sie den neuen verknüpften Dienst.

    Configure a linked service to Salesforce Marketing Cloud.

Hinweis

Der API-Integrationsbereich in der Salesforce Marketing Cloud muss auf Hub | Kampagne | Lesen festgelegt sein, damit der Connector erfolgreich ist.

Details zur Connector-Konfiguration

Die folgenden Abschnitte enthalten Details zu Eigenschaften, die zum Definieren von Data Factory-Entitäten speziell für den Salesforce Marketing Cloud-Connector verwendet werden.

Eigenschaften des verknüpften Diensts

Folgende Eigenschaften werden für den mit Salesforce Marketing Cloud verknüpften Dienst unterstützt:

Eigenschaft Beschreibung Erforderlich
type Die type-Eigenschaft muss auf Folgendes festgelegt werden: SalesforceMarketingCloud Ja
connectionProperties Eine Gruppe von Eigenschaften, die definieren, wie eine Verbindung mit Salesforce Marketing Cloud hergestellt werden soll. Ja
Unter connectionProperties:
authenticationType Gibt die zu verwendende Authentifizierungsmethode an. Zulässige Werte: Enhanced sts OAuth 2.0 und OAuth_2.0.

Das ältere Salesforce Marketing Cloud-Paket unterstützt nur OAuth_2.0, während das erweiterte Paket Enhanced sts OAuth 2.0 erfordert.
Seit dem 1. August 2019 wird die Möglichkeit zum Erstellen älterer Pakete von Salesforce Marketing Cloud nicht mehr unterstützt. Alle neuen Pakete sind erweiterte Pakete.		 Ja
host Bei einem erweiterten Paket sollte der Host Ihrer Unterdomäne entsprechen, die durch eine 28-stellige Zeichenfolge dargestellt wird und mit den Buchstaben „mc“ beginnt, beispielsweise mc563885gzs27c5t9-63k636ttgm.
Geben Sie für ein älteres Paket www.exacttargetapis.com an.		 Ja
clientId Die Client-ID, die der Salesforce Marketing Cloud-Anwendung zugeordnet ist. Ja
clientSecret Der geheime Clientschlüssel, der der Salesforce Marketing Cloud-Anwendung zugeordnet ist. Sie können dieses Feld optional als SecureString markieren, um es sicher im Dienst zu speichern, oder das Geheimnis in Azure Key Vault speichern und von dort von der Copy-Aktivität des Diensts abrufen lassen, wenn Datenkopiervorgänge durchgeführt werden. Weitere Informationen finden Sie unter Speichern von Anmeldeinformationen in Key Vault. Ja
useEncryptedEndpoints Gibt an, ob die Endpunkte der Datenquelle mit HTTPS verschlüsselt sind. Der Standardwert lautet „true“. Nein
useHostVerification Gibt an, ob der Hostname im Zertifikat des Servers mit dem Hostnamen des Servers übereinstimmen muss, wenn eine Verbindung über TLS hergestellt wird. Der Standardwert lautet „true“. Nein
usePeerVerification Gibt an, ob die Identität des Servers überprüft werden soll, wenn eine Verbindung über TLS hergestellt wird. Der Standardwert lautet „true“. Nein

Beispiel: Verwendung der erweiterten STS OAuth 2-Authentifizierung für das erweiterte Paket

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

Beispiel: Verwendung der OAuth 2-Authentifizierung für das ältere Paket

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

Wenn Sie den verknüpften Salesforce Marketing Cloud-Dienst mit der folgenden Nutzlast verwendet haben, wird er weiterhin unverändert unterstützt. Es wird jedoch empfohlen, zukünftig die neue Version zu verwenden, wodurch die Paketunterstützung erweitert wird.

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

Dataset-Eigenschaften

Eine vollständige Liste mit den Abschnitten und Eigenschaften, die zum Definieren von Datasets zur Verfügung stehen, finden Sie im Artikel zu Datasets. Dieser Abschnitt enthält eine Liste der Eigenschaften, die vom Salesforce Marketing Cloud-Dataset unterstützt werden.

Legen Sie zum Kopieren von Daten aus Salesforce Marketing Cloud die type-Eigenschaft des Datasets auf SalesforceMarketingCloudObject fest. Folgende Eigenschaften werden unterstützt:

Eigenschaft Beschreibung Erforderlich
type Die type-Eigenschaft des Datasets muss auf folgenden Wert festgelegt werden: SalesforceMarketingCloudObject Ja
tableName Der Name der Tabelle. Nein (wenn „query“ in der Aktivitätsquelle angegeben ist)

Beispiel

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

Eigenschaften der Kopieraktivität

Eine vollständige Liste mit den Abschnitten und Eigenschaften zum Definieren von Aktivitäten finden Sie im Artikel Pipelines. Dieser Abschnitt enthält eine Liste der Eigenschaften, die von der Salesforce Marketing Cloud-Quelle unterstützt werden.

Salesforce Marketing Cloud als Quelle

Legen Sie zum Kopieren von Daten aus Salesforce Marketing Cloud den Quelltyp in der Kopieraktivität auf SalesforceMarketingCloudSource fest. Folgende Eigenschaften werden im Abschnitt source der Kopieraktivität unterstützt:

Eigenschaft Beschreibung Erforderlich
type Die type-Eigenschaft der Quelle der Kopieraktivität muss auf Folgendes festgelegt werden: SalesforceMarketingCloudSource Ja
Abfrage Verwendet die benutzerdefinierte SQL-Abfrage zum Lesen von Daten. Beispiel: "SELECT * FROM MyTable". Nein (wenn „tableName“ im Dataset angegeben ist)

Beispiel:

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

Hinweis

Die Kontakttabelle wird nicht unterstützt.

Eigenschaften der Lookup-Aktivität

Ausführliche Informationen zu den Eigenschaften finden Sie unter Lookup-Aktivität.

Zugehöriger Inhalt

Eine Liste der Datenspeicher, die als Quelles und Senken für die Kopieraktivität unterstützt werden, finden Sie in der Dokumentation für Unterstützte Datenspeicher.