Udostępnij za pośrednictwem

Kopiowanie danych z usługi Salesforce Marketing Cloud przy użyciu usługi Azure Data Factory lub Synapse Analytics

  • Artykuł

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

W tym artykule opisano sposób używania działania kopiowania w potokach usługi Azure Data Factory lub Synapse Analytics do kopiowania danych z usługi Salesforce Marketing Cloud. Jest on oparty na artykule omówienie działania kopiowania, który przedstawia ogólne omówienie działania kopiowania.

Obsługiwane możliwości

Ten łącznik usługi Salesforce Marketing Cloud jest obsługiwany dla następujących możliwości:

Obsługiwane możliwości IR
działanie Kopiuj (źródło/-) (1) (2)
Działanie Lookup (1) (2)

(1) Środowisko Azure Integration Runtime (2) Self-hosted Integration Runtime

Aby uzyskać listę magazynów danych obsługiwanych jako źródła/ujścia, zobacz tabelę Obsługiwane magazyny danych.

Łącznik Salesforce Marketing Cloud obsługuje uwierzytelnianie OAuth 2 i obsługuje zarówno starsze, jak i ulepszone typy pakietów. Łącznik jest oparty na interfejsie API REST usługi Salesforce Marketing Cloud.

Uwaga

Ten łącznik nie obsługuje pobierania widoków, obiektów niestandardowych ani niestandardowych rozszerzeń danych.

Wprowadzenie

Potok można utworzyć z działaniem kopiowania przy użyciu zestawu .NET SDK, zestawu PYTHON SDK, programu Azure PowerShell, interfejsu API REST lub szablonu usługi Azure Resource Manager. Zobacz samouczek działanie Kopiuj, aby uzyskać instrukcje krok po kroku dotyczące tworzenia potoku z działaniem kopiowania.

Tworzenie połączonej usługi z usługą Salesforce Marketing Cloud przy użyciu interfejsu użytkownika

Wykonaj poniższe kroki, aby utworzyć połączoną usługę z usługą Salesforce Marketing Cloud w interfejsie użytkownika witryny Azure Portal.

  1. Przejdź do karty Zarządzanie w obszarze roboczym usługi Azure Data Factory lub Synapse i wybierz pozycję Połączone usługi, a następnie kliknij pozycję Nowy:

  2. Wyszukaj pozycję Salesforce i wybierz łącznik Salesforce Marketing Cloud.

    Wybierz łącznik Salesforce Marketing Cloud.

  3. Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.

    Konfigurowanie połączonej usługi z usługą Salesforce Marketing Cloud.

Uwaga

Zakres integracji interfejsu API w chmurze Salesforce Marketing Musi być ustawiony na Hub | Kampania | Przeczytaj, aby łącznik zakończył się pomyślnie.

Szczegóły konfiguracji łącznika

Poniższe sekcje zawierają szczegółowe informacje o właściwościach używanych do definiowania jednostek usługi Data Factory specyficznych dla łącznika usługi Salesforce Marketing Cloud.

Właściwości połączonej usługi

Następujące właściwości są obsługiwane w przypadku połączonej usługi Salesforce Marketing Cloud:

Właściwości Opis Wymagania
type Właściwość type musi być ustawiona na: SalesforceMarketingCloud Tak
connectionProperties Grupa właściwości definiujących sposób nawiązywania połączenia z usługą Salesforce Marketing Cloud. Tak
W obszarze connectionProperties:
authenticationType Określa metodę uwierzytelniania do użycia. Dozwolone wartości to Enhanced sts OAuth 2.0 lub OAuth_2.0.

Starszy pakiet Salesforce Marketing Cloud obsługuje tylko pakiet OAuth_2.0, natomiast rozszerzone wymagania dotyczące pakietu .Enhanced sts OAuth 2.0
Od 1 sierpnia 2019 r. usługa Salesforce Marketing Cloud usunęła możliwość tworzenia starszych pakietów. Wszystkie nowe pakiety to pakiety rozszerzone.		 Tak
host W przypadku pakietu rozszerzonego host powinien być poddomeną reprezentowaną przez 28-znakowy ciąg rozpoczynający się od liter "mc", np. mc563885gzs27c5t9-63k636ttgm.
W przypadku starszego pakietu określ wartość www.exacttargetapis.com.		 Tak
clientId Identyfikator klienta skojarzony z aplikacją Salesforce Marketing Cloud. Tak
clientSecret Wpis tajny klienta skojarzony z aplikacją Salesforce Marketing Cloud. Możesz oznaczyć to pole jako funkcję SecureString, aby bezpiecznie przechowywać je w usłudze lub przechowywać wpis tajny w usłudze Azure Key Vault i umożliwić ściąganie działania kopiowania usługi podczas wykonywania kopiowania danych — dowiedz się więcej na temat przechowywania poświadczeń w usłudze Key Vault. Tak
useEncryptedEndpoints Określa, czy punkty końcowe źródła danych są szyfrowane przy użyciu protokołu HTTPS. Wartość domyślna to true. Nie.
useHostVerification Określa, czy nazwa hosta w certyfikacie serwera ma być zgodna z nazwą hosta serwera podczas nawiązywania połączenia za pośrednictwem protokołu TLS. Wartość domyślna to true. Nie.
usePeerVerification Określa, czy należy zweryfikować tożsamość serwera podczas nawiązywania połączenia za pośrednictwem protokołu TLS. Wartość domyślna to true. Nie.

Przykład: używanie rozszerzonego uwierzytelniania STS OAuth 2 dla pakietu rozszerzonego

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

Przykład: używanie uwierzytelniania OAuth 2 dla starszego pakietu

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

Jeśli używasz połączonej usługi Salesforce Marketing Cloud z następującym ładunkiem, nadal jest obsługiwana w miarę możliwości, podczas gdy zaleca się użycie nowej usługi, która dodaje rozszerzoną obsługę pakietów.

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

Właściwości zestawu danych

Pełna lista sekcji i właściwości dostępnych do definiowania zestawów danych znajduje się w artykule dotyczącym zestawów danych. Ta sekcja zawiera listę właściwości obsługiwanych przez zestaw danych salesforce Marketing Cloud.

Aby skopiować dane z usługi Salesforce Marketing Cloud, ustaw właściwość type zestawu danych na SalesforceMarketingCloudObject. Obsługiwane są następujące właściwości:

Właściwości Opis Wymagania
type Właściwość type zestawu danych musi być ustawiona na: SalesforceMarketingCloudObject Tak
tableName Nazwa tabeli. Nie (jeśli określono "zapytanie" w źródle działania)

Przykład

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

Właściwości działania kopiowania

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania działań, zobacz artykuł Pipelines (Potoki ). Ta sekcja zawiera listę właściwości obsługiwanych przez źródło usługi Salesforce Marketing Cloud.

Salesforce Marketing Cloud jako źródło

Aby skopiować dane z usługi Salesforce Marketing Cloud, ustaw typ źródłowy w działaniu kopiowania na SalesforceMarketingCloudSource. Następujące właściwości są obsługiwane w sekcji źródło działania kopiowania:

Właściwości Opis Wymagania
type Właściwość type źródła działania kopiowania musi być ustawiona na: SalesforceMarketingCloudSource Tak
zapytanie Użyj niestandardowego zapytania SQL, aby odczytać dane. Na przykład: "SELECT * FROM MyTable". Nie (jeśli określono "tableName" w zestawie danych)

Przykład:

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

Uwaga

Tabela Kontaktów nie jest obsługiwana.

Właściwości działania wyszukiwania

Aby dowiedzieć się więcej o właściwościach, sprawdź działanie Wyszukiwania.

Powiązana zawartość

Aby uzyskać listę magazynów danych obsługiwanych jako źródła i ujścia działania kopiowania, zobacz obsługiwane magazyny danych.