Gegevens kopiëren uit Salesforce Marketing Cloud met behulp van Azure Data Factory of Synapse Analytics

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

Belangrijk

Deze connector bevindt zich aan het einde van de ondersteuningsfase. U wordt aangeraden om naar de ODBC-connector te migreren door een stuurprogramma te installeren.

In dit artikel wordt beschreven hoe u de kopieeractiviteit in Azure Data Factory- of Synapse Analytics-pijplijnen gebruikt om gegevens te kopiëren uit Salesforce Marketing Cloud. Het is gebaseerd op het artikel over het overzicht van kopieeractiviteiten met een algemeen overzicht van de kopieeractiviteit.

Ondersteunde mogelijkheden

Deze Salesforce Marketing Cloud-connector wordt ondersteund voor de volgende mogelijkheden:

Ondersteunde mogelijkheden	IR
Copy-activiteit (bron/-)	(1) (2)
Activiteit Lookup	(1) (2)

(1) Azure Integration Runtime (2) Zelf-hostende Integration Runtime

Zie de tabel Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen/sinks.

De Salesforce Marketing Cloud-connector ondersteunt OAuth 2-verificatie en ondersteunt zowel verouderde als verbeterde pakkettypen. De connector is gebouwd op basis van de Salesforce Marketing Cloud REST API.

Notitie

Deze connector biedt geen ondersteuning voor het ophalen van weergaven, aangepaste objecten of aangepaste gegevensextensies.

Aan de slag

U kunt een pijplijn met kopieeractiviteit maken met behulp van .NET SDK, Python SDK, Azure PowerShell, REST API of Azure Resource Manager-sjabloon. Zie Copy-activiteit zelfstudie voor stapsgewijze instructies voor het maken van een pijplijn met een kopieeractiviteit.

Een gekoppelde service maken voor Salesforce Marketing Cloud met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde service te maken voor Salesforce Marketing Cloud in de gebruikersinterface van Azure Portal.

1. Blader naar het tabblad Beheren in uw Azure Data Factory- of Synapse-werkruimte en selecteer Gekoppelde services en klik vervolgens op Nieuw:

   Azure Data Factory

   

   Azure Synapse

   

2. Zoek naar Salesforce en selecteer de Salesforce Marketing Cloud-connector.

   

3. Configureer de servicedetails, test de verbinding en maak de nieuwe gekoppelde service.

   

Notitie

Het API-integratiebereik op de Salesforce Marketing Cloud moet worden ingesteld op Hub | Campagne | Lees om de connector te laten slagen.

Configuratiedetails van connector

De volgende secties bevatten details over eigenschappen die worden gebruikt voor het definiëren van Data Factory-entiteiten die specifiek zijn voor Salesforce Marketing Cloud-connector.

Eigenschappen van gekoppelde service

De volgende eigenschappen worden ondersteund voor de gekoppelde Salesforce Marketing Cloud-service:

Eigenschappen	Beschrijving	Vereist
type	De eigenschap type moet worden ingesteld op: SalesforceMarketingCloud	Ja
connectionProperties	Een groep eigenschappen die definieert hoe u verbinding maakt met Salesforce Marketing Cloud.	Ja
Onder connectionProperties:
authenticationType	Hiermee geeft u de verificatiemethode op die moet worden gebruikt. Toegestane waarden zijn Enhanced sts OAuth 2.0 of OAuth_2.0. Legacy-pakket van Salesforce Marketing Cloud biedt alleen ondersteuning OAuth_2.0voor verbeterde pakketbehoeften Enhanced sts OAuth 2.0. Sinds 1 augustus 2019 heeft Salesforce Marketing Cloud de mogelijkheid om verouderde pakketten te maken verwijderd. Alle nieuwe pakketten zijn verbeterde pakketten.	Ja
host	Voor een uitgebreid pakket moet de host uw subdomein zijn dat wordt vertegenwoordigd door een tekenreeks van 28 tekens die begint met de letters 'mc', bijvoorbeeld mc563885gzs27c5t9-63k636ttgm. Geef voor een verouderd pakket op www.exacttargetapis.com.	Ja
clientId	De client-id die is gekoppeld aan de Salesforce Marketing Cloud-toepassing.	Ja
clientSecret	Het clientgeheim dat is gekoppeld aan de Salesforce Marketing Cloud-toepassing. U kunt ervoor kiezen om dit veld als securestring te markeren om het veilig op te slaan in de service, of het geheim op te slaan in Azure Key Vault en de service-kopieeractiviteit daar te laten ophalen bij het uitvoeren van gegevenskopie- meer informatie over storereferenties in Key Vault.	Ja
useEncryptedEndpoints	Hiermee geeft u op of de eindpunten van de gegevensbron zijn versleuteld met HTTPS. De standaardwaarde is waar.	Nee
useHostVerification	Hiermee geeft u op of de hostnaam in het certificaat van de server moet overeenkomen met de hostnaam van de server wanneer u verbinding maakt via TLS. De standaardwaarde is waar.	Nee
usePeerVerification	Hiermee geeft u op of de identiteit van de server moet worden gecontroleerd bij het maken van verbinding via TLS. De standaardwaarde is waar.	Nee

Voorbeeld: verbeterde STS OAuth 2-verificatie gebruiken voor een uitgebreid pakket

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

Voorbeeld: OAuth 2-verificatie gebruiken voor verouderd pakket

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

Als u een gekoppelde Salesforce Marketing Cloud-service met de volgende nettolading gebruikt, wordt deze nog steeds ondersteund, terwijl u wordt aangeraden om de nieuwe service te gebruiken die in de toekomst verbeterde pakketondersteuning toevoegt.

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

Eigenschappen van gegevensset

Zie het artikel gegevenssets voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van gegevenssets . Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de Salesforce Marketing Cloud-gegevensset.

Als u gegevens uit Salesforce Marketing Cloud wilt kopiëren, stelt u de typeeigenschap van de gegevensset in op SalesforceMarketingCloudObject. De volgende eigenschappen worden ondersteund:

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap van de gegevensset moet zijn ingesteld op: SalesforceMarketingCloudObject	Ja
tableName	Naam van de tabel.	Nee (als 'query' in de activiteitsbron is opgegeven)

Voorbeeld

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

Eigenschappen van de kopieeractiviteit

Zie het artikel Pijplijnen voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van activiteiten. Deze sectie bevat een lijst met eigenschappen die worden ondersteund door salesforce marketingcloudbron.

Salesforce Marketing Cloud als bron

Als u gegevens uit Salesforce Marketing Cloud wilt kopiëren, stelt u het brontype in de kopieeractiviteit in op SalesforceMarketingCloudSource. De volgende eigenschappen worden ondersteund in de sectie bron van kopieeractiviteit:

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap van de bron van de kopieeractiviteit moet worden ingesteld op: SalesforceMarketingCloudSource	Ja
query	Gebruik de aangepaste SQL-query om gegevens te lezen. Voorbeeld: "SELECT * FROM MyTable".	Nee (als 'tableName' in de gegevensset is opgegeven)

Voorbeeld:

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

Notitie

De tabel Contactpersonen wordt niet ondersteund.

Eigenschappen van opzoekactiviteit

Als u meer wilt weten over de eigenschappen, controleert u de lookup-activiteit.

Gerelateerde inhoud

Zie ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen en sinks door de kopieeractiviteit.