Dela via


Kopiera data från Salesforce Marketing Cloud med Hjälp av Azure Data Factory eller Synapse Analytics

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Dricks

Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!

Den här artikeln beskriver hur du använder kopieringsaktiviteten i Azure Data Factory- eller Synapse Analytics-pipelines för att kopiera data från Salesforce Marketing Cloud. Den bygger på översiktsartikeln för kopieringsaktivitet som visar en allmän översikt över kopieringsaktiviteten.

Funktioner som stöds

Den här salesforce Marketing Cloud-anslutningsappen stöds för följande funktioner:

Funktioner som stöds IR
Kopieringsaktivitet (källa/-) (1) (2)
Sökningsaktivitet (1) (2)

(1) Azure Integration Runtime (2) Lokalt installerad integrationskörning

En lista över datalager som stöds som källor/mottagare finns i tabellen Datalager som stöds.

Salesforce Marketing Cloud-anslutningsappen stöder OAuth 2-autentisering och stöder både äldre och förbättrade pakettyper. Anslutningsappen bygger på Rest-API:et för Salesforce Marketing Cloud.

Kommentar

Den här anslutningsappen stöder inte hämtning av vyer, anpassade objekt eller anpassade datatillägg.

Komma igång

Du kan skapa en pipeline med kopieringsaktivitet med hjälp av .NET SDK, Python SDK, Azure PowerShell, REST API eller Azure Resource Manager-mall. Stegvisa instruktioner för att skapa en pipeline med en kopieringsaktivitet finns i Självstudie om kopieringsaktivitet.

Skapa en länkad tjänst till Salesforce Marketing Cloud med hjälp av användargränssnittet

Använd följande steg för att skapa en länkad tjänst till Salesforce Marketing Cloud i Azure-portalens användargränssnitt.

  1. Bläddra till fliken Hantera i Din Azure Data Factory- eller Synapse-arbetsyta och välj Länkade tjänster och klicka sedan på Ny:

  2. Sök efter Salesforce och välj anslutningsappen Salesforce Marketing Cloud.

    Välj anslutningsappen Salesforce Marketing Cloud.

  3. Konfigurera tjänstinformationen, testa anslutningen och skapa den nya länkade tjänsten.

    Konfigurera en länkad tjänst till Salesforce Marketing Cloud.

Kommentar

API-integreringsomfånget i Salesforce Marketing Cloud måste anges till Hub | Kampanj | Läs för att anslutningsappen ska lyckas.

Konfigurationsinformation för anslutningsprogram

Följande avsnitt innehåller information om egenskaper som används för att definiera Data Factory-entiteter som är specifika för Salesforce Marketing Cloud Connector.

Länkade tjänstegenskaper

Följande egenskaper stöds för den länkade tjänsten Salesforce Marketing Cloud:

Property Beskrivning Obligatoriskt
type Typegenskapen måste anges till: SalesforceMarketingCloud Ja
connectionProperties En grupp med egenskaper som definierar hur du ansluter till Salesforce Marketing Cloud. Ja
Under connectionProperties:
authenticationType Anger vilken autentiseringsmetod som ska användas. Tillåtna värden är Enhanced sts OAuth 2.0 eller OAuth_2.0.

Salesforce Marketing Cloud-äldre paket stöder OAuth_2.0endast , medan förbättrade paket behöver Enhanced sts OAuth 2.0.
Sedan den 1 augusti 2019 har Salesforce Marketing Cloud tagit bort möjligheten att skapa äldre paket. Alla nya paket är förbättrade paket.
Ja
värd För det förbättrade paketet ska värden vara din underdomän som representeras av en sträng på 28 tecken som börjar med bokstäverna "mc", t.ex. mc563885gzs27c5t9-63k636ttgm.
För äldre paket anger du www.exacttargetapis.com.
Ja
clientId Klient-ID:t som är associerat med Salesforce Marketing Cloud-programmet. Ja
clientSecret Klienthemligheten som är associerad med Salesforce Marketing Cloud-programmet. Du kan välja att markera det här fältet som en SecureString för att lagra det på ett säkert sätt i tjänsten, eller lagra hemligheten i Azure Key Vault och låta aktiviteten för tjänstkopiering hämtas därifrån när du utför datakopiering – läs mer från Store-autentiseringsuppgifter i Key Vault. Ja
useEncryptedEndpoints Anger om datakällans slutpunkter krypteras med HTTPS. Standardvärdet är sant. Nej
useHostVerification Anger om värdnamnet i serverns certifikat ska behövas för att matcha serverns värdnamn vid anslutning via TLS. Standardvärdet är sant. Nej
usePeerVerification Anger om serverns identitet ska verifieras vid anslutning via TLS. Standardvärdet är sant. Nej

Exempel: använda förbättrad STS OAuth 2-autentisering för förbättrat 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
            }
        }
    }
}

Exempel: använda OAuth 2-autentisering för äldre 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
            }
        }
    }
}

Om du använder den länkade tjänsten Salesforce Marketing Cloud med följande nyttolast stöds den fortfarande som den är, medan du rekommenderas att använda den nya framöver som lägger till utökad paketsupport.

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

Egenskaper för datauppsättning

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera datauppsättningar finns i artikeln datauppsättningar . Det här avsnittet innehåller en lista över egenskaper som stöds av Salesforce Marketing Cloud-datauppsättningen.

Om du vill kopiera data från Salesforce Marketing Cloud anger du datamängdens typegenskap till SalesforceMarketingCloudObject. Följande egenskaper stöds:

Property Beskrivning Obligatoriskt
type Typegenskapen för datamängden måste anges till: SalesforceMarketingCloudObject Ja
tableName Tabellens namn. Nej (om "fråga" i aktivitetskällan har angetts)

Exempel

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

Kopiera egenskaper för aktivitet

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera aktiviteter finns i artikeln Pipelines . Det här avsnittet innehåller en lista över egenskaper som stöds av Salesforce Marketing Cloud-källan.

Salesforce Marketing Cloud som källa

Om du vill kopiera data från Salesforce Marketing Cloud anger du källtypen i kopieringsaktiviteten till SalesforceMarketingCloudSource. Följande egenskaper stöds i avsnittet kopieringsaktivitetskälla:

Property Beskrivning Obligatoriskt
type Typegenskapen för kopieringsaktivitetskällan måste anges till: SalesforceMarketingCloudSource Ja
query Använd den anpassade SQL-frågan för att läsa data. Exempel: "SELECT * FROM MyTable". Nej (om "tableName" i datauppsättningen har angetts)

Exempel:

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

Kommentar

Tabellen Kontakter stöds inte.

Egenskaper för uppslagsaktivitet

Mer information om egenskaperna finns i Sökningsaktivitet.

En lista över datalager som stöds som källor och mottagare av kopieringsaktiviteten finns i datalager som stöds.