Adatok másolása a Salesforce Marketing Cloudból az Azure Data Factory vagy a Synapse Analytics használatával

  • Cikk

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk azt ismerteti, hogyan használhatja a másolási tevékenységet az Azure Data Factoryben vagy a Synapse Analytics-folyamatokban adatok másolására a Salesforce Marketing Cloudból. A másolási tevékenység áttekintési cikkére épül, amely a másolási tevékenység általános áttekintését mutatja be.

Támogatott képességek

Ez a Salesforce Marketing Cloud-összekötő a következő képességeket támogatja:

Támogatott képességek IR
Copy tevékenység (forrás/-) ① ②
Keresési tevékenység ① ②

(1) Azure-integrációs modul (2) Saját üzemeltetésű integrációs modul

A forrásként/fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

A Salesforce Marketing Cloud-összekötő támogatja az OAuth 2 hitelesítést, és támogatja az örökölt és a továbbfejlesztett csomagtípusokat is. Az összekötő a Salesforce Marketing Cloud REST API-ra épül.

Megjegyzés:

Ez az összekötő nem támogatja a nézetek, egyéni objektumok vagy egyéni adatbővítmények lekérését.

Első lépések

A másolási tevékenységgel rendelkező folyamatokat .NET SDK, Python SDK, Azure PowerShell, REST API vagy Azure Resource Manager-sablon használatával hozhatja létre. A másolási tevékenységgel rendelkező folyamat létrehozásához részletes útmutatást Copy tevékenység oktatóanyagban talál.

Társított szolgáltatás létrehozása a Salesforce Marketing Cloudhoz felhasználói felülettel

Az alábbi lépésekkel létrehozhat egy társított szolgáltatást a Salesforce Marketing Cloudhoz az Azure Portal felhasználói felületén.

  1. Keresse meg az Azure Data Factory vagy a Synapse-munkaterület Kezelés lapját, és válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:

  2. Keresse meg a Salesforce-t, és válassza ki a Salesforce Marketing Cloud-összekötőt.

    Select the Salesforce Marketing Cloud connector.

  3. Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

    Configure a linked service to Salesforce Marketing Cloud.

Megjegyzés:

A Salesforce Marketing Cloud API-integrációs hatókörét a Hub | Kampány | Olvassa el az összekötő sikerességét.

Csatlakozás or konfigurációjának részletei

A következő szakaszok a Salesforce Marketing Cloud-összekötőre jellemző Data Factory-entitások meghatározásához használt tulajdonságok részleteit ismertetik.

Társított szolgáltatás tulajdonságai

A Salesforce Marketing Cloud társított szolgáltatása a következő tulajdonságokat támogatja:

Property Leírás Required
típus A típustulajdonságnak a következőnek kell lennie: SalesforceMarketingCloud Igen
connectionProperties A Salesforce Marketing Cloudhoz való csatlakozás módját meghatározó tulajdonságok csoportja. Igen
A következő alatt connectionProperties:
authenticationType Megadja a használni kívánt hitelesítési módszert. Az engedélyezett értékek a következők: Enhanced sts OAuth 2.0 vagy OAuth_2.0.

A Salesforce Marketing Cloud örökölt csomagja csak támogatja OAuth_2.0, míg a továbbfejlesztett csomagra van szükség Enhanced sts OAuth 2.0.
2019. augusztus 1-től a Salesforce Marketing Cloud megszüntette az örökölt csomagok létrehozásának lehetőségét. Minden új csomag továbbfejlesztett csomag.		 Igen
házigazda Továbbfejlesztett csomag esetén a gazdagépnek az altartománynak kell lennie, amelyet egy 28 karakterből álló sztring jelöl, amely az "mc" betűkkel kezdődik, például. mc563885gzs27c5t9-63k636ttgm
Örökölt csomag esetén adja meg a következőt www.exacttargetapis.com: .		 Igen
clientId A Salesforce Marketing Cloud alkalmazáshoz társított ügyfélazonosító. Igen
clientSecret A Salesforce Marketing Cloud alkalmazáshoz társított ügyfélkód. Dönthet úgy, hogy secureStringként jelöli meg ezt a mezőt, hogy biztonságosan tárolja a szolgáltatásban, vagy tárolja a titkos kódot az Azure Key Vaultban, és hagyja, hogy a szolgáltatás másolási tevékenysége onnan lekérje az adatmásolást – további információ a Key Vaultban tárolt hitelesítő adatok tárolásáról. Igen
useEncryptedEndpoints Megadja, hogy az adatforrásvégpontok HTTPS használatával vannak-e titkosítva. Az alapértelmezett érték igaz. Nem
useHostVerification Megadja, hogy a kiszolgáló tanúsítványában szereplő gazdagépnévnek meg kell-e egyeznie a kiszolgáló gazdagépnevével, amikor TLS-en keresztül csatlakozik. Az alapértelmezett érték igaz. Nem
usePeerVerification Megadja, hogy ellenőrizze-e a kiszolgáló identitását, amikor TLS-en keresztül csatlakozik. Az alapértelmezett érték igaz. Nem

Példa: továbbfejlesztett STS OAuth 2-hitelesítés használata továbbfejlesztett csomaghoz

{
    "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élda: OAuth 2-hitelesítés használata örökölt csomaghoz

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

Ha a Salesforce Marketing Cloud társított szolgáltatást használta a következő hasznos adatokkal, az továbbra is támogatott, míg a tovább haladó újat javasoljuk, amely továbbfejlesztett csomagtámogatást ad hozzá.

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

Adathalmaz tulajdonságai

Az adathalmazok meghatározásához elérhető szakaszok és tulajdonságok teljes listáját az adathalmazokról szóló cikkben találja. Ez a szakasz a Salesforce Marketing Cloud-adatkészlet által támogatott tulajdonságok listáját tartalmazza.

Ha adatokat szeretne másolni a Salesforce Marketing Cloudból, állítsa be az adathalmaz típustulajdonságát a SalesforceMarketingCloudObject értékre. A következő tulajdonságok támogatottak:

Property Leírás Required
típus Az adathalmaz típustulajdonságának a következőnek kell lennie: SalesforceMarketingCloudObject Igen
tableName A tábla neve. Nem (ha "lekérdezés" van megadva a tevékenységforrásban)

Példa

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

Másolási tevékenység tulajdonságai

A tevékenységek meghatározásához elérhető szakaszok és tulajdonságok teljes listáját a Folyamatok című cikkben találja. Ez a szakasz a Salesforce Marketing Cloud-forrás által támogatott tulajdonságok listáját tartalmazza.

A Salesforce Marketing Cloud mint forrás

Ha adatokat szeretne másolni a Salesforce Marketing Cloudból, állítsa be a másolási tevékenység forrástípusát a SalesforceMarketingCloudSource-ra. A másolási tevékenység forrás szakaszában a következő tulajdonságok támogatottak:

Property Leírás Required
típus A másolási tevékenység forrásának típustulajdonságának a következőnek kell lennie: SalesforceMarketingCloudSource Igen
Lekérdezés Az adatok olvasásához használja az egyéni SQL-lekérdezést. For example: "SELECT * FROM MyTable". Nem (ha "tableName" van megadva az adathalmazban)

Példa

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

Megjegyzés:

A Névjegyek tábla nem támogatott.

Keresési tevékenység tulajdonságai

A tulajdonságok részleteinek megismeréséhez tekintse meg a keresési tevékenységet.

Kapcsolódó tartalom

A másolási tevékenység által forrásként és fogadóként támogatott adattárak listáját a támogatott adattárakban találja.