Copiare dati da Salesforce Marketing Cloud usando Azure Data FactoryCopy data from Salesforce Marketing Cloud using Azure Data Factory

Questo articolo illustra come usare l'attività di copia in Azure Data Factory per copiare dati da Salesforce Marketing Cloud.This article outlines how to use the Copy Activity in Azure Data Factory to copy data from Salesforce Marketing Cloud. Si basa sull'articolo di panoramica dell'attività di copia che presenta una panoramica generale sull'attività di copia.It builds on the copy activity overview article that presents a general overview of copy activity.

Funzionalità supportateSupported capabilities

Questo connettore di Salesforce Marketing Cloud è supportato per le attività seguenti:This Salesforce Marketing Cloud connector is supported for the following activities:

È possibile copiare dati da Salesforce Marketing Cloud in qualsiasi archivio dati di sink supportato.You can copy data from Salesforce Marketing Cloud to any supported sink data store. Per un elenco degli archivi dati supportati come origini/sink dall'attività di copia, vedere la tabella relativa agli archivi dati supportati.For a list of data stores that are supported as sources/sinks by the copy activity, see the Supported data stores table.

Salesforce Marketing Cloud Connector supporta l'autenticazione OAuth 2.The Salesforce Marketing Cloud connector supports OAuth 2 authentication. Si basa sull' API REST di Salesforce Marketing Cloud.It is built on top of the Salesforce Marketing Cloud REST API.

Nota

Questo connettore non supporta il recupero di oggetti personalizzati o le estensioni per dati personalizzati.This connector doesn't support retrieving custom objects or custom data extensions.

IntroduzioneGetting started

È possibile creare una pipeline con l'attività di copia usando .NET SDK, Python SDK, Azure PowerShell, l'API REST o il modello di Azure Resource Manager.You can create a pipeline with copy activity using .NET SDK, Python SDK, Azure PowerShell, REST API, or Azure Resource Manager template. Vedere l'esercitazione sull'attività di copia per le istruzioni dettagliate sulla creazione di una pipeline con un'attività di copia.See Copy activity tutorial for step-by-step instructions to create a pipeline with a copy activity.

Le sezioni seguenti riportano informazioni dettagliate sulle proprietà che vengono usate per definire entità di Data Factory specifiche per il connettore Salesforce Marketing Cloud.The following sections provide details about properties that are used to define Data Factory entities specific to Salesforce Marketing Cloud connector.

Proprietà del servizio collegatoLinked service properties

Per il servizio collegato di Salesforce Marketing Cloud sono supportate le proprietà seguenti:The following properties are supported for Salesforce Marketing Cloud linked service:

ProprietàProperty DescrizioneDescription ObbligatorioRequired
typetype La proprietà type deve essere impostata su SalesforceMarketingCloudThe type property must be set to: SalesforceMarketingCloud Yes
clientIdclientId L'ID client associato all'applicazione Salesforce Marketing Cloud.The client ID associated with the Salesforce Marketing Cloud application. Yes
clientSecretclientSecret Il segreto client associato all'applicazione Salesforce Marketing Cloud.The client secret associated with the Salesforce Marketing Cloud application. È possibile scegliere di contrassegnare questo campo come SecureString per archiviarlo in modo sicuro in Azure Data Factory o archiviare la password in Azure Key Vault e consentire all'attività di copia di ADF di eseguire il pull da tale posizione durante l'esecuzione della copia dei dati. Per altre informazioni, consultare Archiviare le credenziali in Azure Key Vault.You can choose to mark this field as a SecureString to store it securely in ADF, or store password in Azure Key Vault and let ADF copy activity pull from there when performing data copy - learn more from Store credentials in Key Vault. Yes
useEncryptedEndpointsuseEncryptedEndpoints Specifica se gli endpoint dell'origine dati vengono crittografati tramite HTTPS.Specifies whether the data source endpoints are encrypted using HTTPS. Il valore predefinito è true.The default value is true. NoNo
useHostVerificationuseHostVerification Specifica se è necessario che il nome host nel certificato del server corrisponda al nome host del server per la connessione tramite SSL.Specifies whether to require the host name in the server's certificate to match the host name of the server when connecting over SSL. Il valore predefinito è true.The default value is true. NoNo
usePeerVerificationusePeerVerification Specifica se verificare l'identità del server durante la connessione tramite SSL.Specifies whether to verify the identity of the server when connecting over SSL. Il valore predefinito è true.The default value is true. NoNo

Esempio:Example:

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

Proprietà del set di datiDataset properties

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione di set di dati, vedere l'articolo sui set di dati.For a full list of sections and properties available for defining datasets, see the datasets article. Questa sezione presenta un elenco delle proprietà supportate dal set di dati Salesforce Marketing Cloud.This section provides a list of properties supported by Salesforce Marketing Cloud dataset.

Per copiare dati da Salesforce Marketing Cloud, impostare la proprietà type del set di dati su SalesforceMarketingCloudObject.To copy data from Salesforce Marketing Cloud, set the type property of the dataset to SalesforceMarketingCloudObject. Sono supportate le proprietà seguenti:The following properties are supported:

ProprietàProperty DescrizioneDescription ObbligatorioRequired
typetype La proprietà Type del set di dati deve essere impostata su: SalesforceMarketingCloudObjectThe type property of the dataset must be set to: SalesforceMarketingCloudObject Yes
tableNametableName Nome della tabella.Name of the table. No (se nell'origine dell'attività è specificato "query")No (if "query" in activity source is specified)

EsempioExample

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

Proprietà dell'attività di copiaCopy activity properties

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere l'articolo sulle pipeline.For a full list of sections and properties available for defining activities, see the Pipelines article. Questa sezione presenta un elenco delle proprietà supportate dall'origine Salesforce Marketing Cloud.This section provides a list of properties supported by Salesforce Marketing Cloud source.

Salesforce Marketing Cloud come origineSalesforce Marketing Cloud as source

Per copiare dati da Salesforce Marketing Cloud, impostare il tipo di origine nell'attività di copia su SalesforceMarketingCloudSource.To copy data from Salesforce Marketing Cloud, set the source type in the copy activity to SalesforceMarketingCloudSource. Nella sezione origine dell'attività di copia sono supportate le proprietà seguenti:The following properties are supported in the copy activity source section:

ProprietàProperty DescrizioneDescription ObbligatorioRequired
typetype La proprietà type dell'origine dell'attività di copia deve essere impostata su: SalesforceMarketingCloudSourceThe type property of the copy activity source must be set to: SalesforceMarketingCloudSource Yes
queryquery Usare la query SQL personalizzata per leggere i dati.Use the custom SQL query to read data. Ad esempio: "SELECT * FROM MyTable".For example: "SELECT * FROM MyTable". No (se nel set di dati è specificato "tableName")No (if "tableName" in dataset is specified)

Esempio:Example:

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

Proprietà attività di ricercaLookup activity properties

Per informazioni dettagliate sulle proprietà, controllare l' attività di ricerca.To learn details about the properties, check Lookup activity.

Passaggi successiviNext steps

Per un elenco degli archivi dati supportati come origini o sink dall'attività di copia in Azure Data Factory, vedere gli archivi dati supportati.For a list of data stores supported as sources and sinks by the copy activity in Azure Data Factory, see supported data stores.