Kopírování dat z marketingového cloudu Salesforce pomocí Azure Data Factory nebo Synapse Analytics

  • Článek

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

Tento článek popisuje, jak pomocí aktivity kopírování v kanálech Azure Data Factory nebo Synapse Analytics kopírovat data z marketingového cloudu Salesforce. Vychází z článku s přehledem aktivity kopírování, který představuje obecný přehled aktivity kopírování.

Podporované funkce

Tento konektor Salesforce Marketing Cloud je podporovaný pro následující funkce:

Podporované funkce IR
aktivita Copy (zdroj/-) ① ②
Aktivita Lookup ① ②

(1) Prostředí Azure Integration Runtime (2) Místní prostředí Integration Runtime

Seznam úložišť dat podporovaných jako zdroje nebo jímky najdete v tabulce Podporované úložiště dat.

Konektor Salesforce Marketing Cloud podporuje ověřování OAuth 2 a podporuje starší i rozšířené typy balíčků. Konektor je založený na rozhraní REST API marketingového cloudu Salesforce.

Poznámka:

Tento konektor nepodporuje načítání zobrazení, vlastních objektů ani vlastních datových rozšíření.

Začínáme

Kanál s aktivitou kopírování můžete vytvořit pomocí sady .NET SDK, Python SDK, Azure PowerShellu, rozhraní REST API nebo šablony Azure Resource Manageru. Podrobné pokyny k vytvoření kanálu s aktivitou kopírování najdete v aktivita Copy kurzu.

Vytvoření propojené služby pro Salesforce Marketing Cloud pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu s cloudem Salesforce Marketing Cloud v uživatelském rozhraní webu Azure Portal.

  1. Přejděte na kartu Správa v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a pak klikněte na Nový:

  2. Vyhledejte Salesforce a vyberte konektor Salesforce Marketing Cloud.

    Select the Salesforce Marketing Cloud connector.

  3. Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.

    Configure a linked service to Salesforce Marketing Cloud.

Poznámka:

Obor integrace rozhraní API v marketingovém cloudu Salesforce musí být nastavený na Centrum | Kampaň | Čtení za účelem úspěšného úspěšného načtení konektoru

podrobnosti o konfiguraci Připojení oru

Následující části obsahují podrobnosti o vlastnostech, které se používají k definování entit služby Data Factory specifických pro konektor Salesforce Marketing Cloud.

Vlastnosti propojené služby

Pro propojenou službu Salesforce Marketing Cloud jsou podporovány následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu musí být nastavená na: SalesforceMarketingCloud. Ano
connectionProperties Skupina vlastností, která definuje, jak se připojit k Salesforce Marketing Cloudu. Ano
V části connectionProperties:
authenticationType Určuje metodu ověřování, která se má použít. Povolené hodnoty jsou Enhanced sts OAuth 2.0 nebo OAuth_2.0.

Salesforce Marketing Cloud starší verze balíčku podporuje OAuth_2.0pouze , zatímco rozšířené potřeby Enhanced sts OAuth 2.0balíčků .
Od 1. srpna 2019 služba Salesforce Marketing Cloud odebrala možnost vytvářet starší balíčky. Všechny nové balíčky jsou vylepšené balíčky.		 Ano
host U rozšířeného balíčku by měl být hostitelem vaše subdoména , která je reprezentována řetězcem 28 znaků začínajícím písmeny "mc", například mc563885gzs27c5t9-63k636ttgm.
Pro starší verzi balíčku zadejte www.exacttargetapis.com.		 Ano
clientId ID klienta přidružené k aplikaci Salesforce Marketing Cloud. Ano
clientSecret Tajný klíč klienta přidružený k aplikaci Salesforce Marketing Cloud. Toto pole můžete označit jako securestring, abyste ho mohli bezpečně uložit ve službě, nebo uložit tajný kód ve službě Azure Key Vault a nechat aktivitu kopírování služby odtud při kopírování dat – přečtěte si další informace o přihlašovacích údajích k úložišti ve službě Key Vault. Ano
useEncryptedEndpoints Určuje, jestli jsou koncové body zdroje dat šifrované pomocí protokolu HTTPS. Výchozí hodnota je true. No
useHostVerification Určuje, jestli se má při připojování přes protokol TLS vyžadovat název hostitele v certifikátu serveru. Výchozí hodnota je true. No
usePeerVerification Určuje, jestli se má při připojování přes protokol TLS ověřit identita serveru. Výchozí hodnota je true. No

Příklad: Použití rozšířeného ověřování STS OAuth 2 pro vylepšený balíček

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

Příklad: Použití ověřování OAuth 2 pro starší verze balíčku

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

Pokud jste používali propojenou službu Salesforce Marketing Cloud s následující datovou částí, je stále podporovaná tak, jak je, zatímco se navrhuje používat novou službu, která dále přidává rozšířenou podporu balíčků.

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

Vlastnosti datové sady

Úplný seznam oddílů a vlastností dostupných pro definování datových sad najdete v článku o datových sadách . Tato část obsahuje seznam vlastností podporovaných datovou sadou Salesforce Marketing Cloud.

Pokud chcete kopírovat data ze Salesforce Marketing Cloudu, nastavte vlastnost typu datové sady na SalesforceMarketingCloudObject. Podporují se následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu datové sady musí být nastavená na: SalesforceMarketingCloudObject. Ano
tableName Název tabulky. Ne (pokud je zadán dotaz ve zdroji aktivity)

Příklad

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

Vlastnosti aktivity kopírování

Úplný seznam oddílů a vlastností dostupných pro definování aktivit najdete v článku Pipelines . Tato část obsahuje seznam vlastností podporovaných zdrojem Salesforce Marketing Cloud.

Salesforce Marketing Cloud jako zdroj

Pokud chcete kopírovat data ze Salesforce Marketing Cloudu, nastavte typ zdroje v aktivitě kopírování na SalesforceMarketingCloudSource. Ve zdrojové části aktivity kopírování jsou podporovány následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu zdroje aktivity kopírování musí být nastavena na: SalesforceMarketingCloudSource. Ano
query Ke čtení dat použijte vlastní dotaz SQL. Například: "SELECT * FROM MyTable". Ne (pokud je v datové sadě zadán název tabulky)

Příklad:

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

Poznámka:

Tabulka kontaktů není podporovaná.

Vlastnosti aktivity vyhledávání

Podrobnosti o vlastnostech najdete v aktivitě Vyhledávání.

Související obsah

Seznam úložišť dat podporovaných jako zdroje a jímky aktivitou kopírování najdete v podporovaných úložištích dat.