Copiare dati da SAP Cloud for Customer (C4C) usando Azure Data FactoryCopy data from SAP Cloud for Customer (C4C) using Azure Data Factory

Questo articolo illustra come usare l'attività di copia in Azure Data Factory per copiare dati da/in SAP Cloud for Customer (C4C).This article outlines how to use the Copy Activity in Azure Data Factory to copy data from/to SAP Cloud for Customer (C4C). 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.

Suggerimento

Per informazioni sul supporto generale di ADF sullo scenario di integrazione dei dati SAP, vedere l'articolo relativo all' integrazione dei dati SAP con Azure Data Factory whitepaper con informazioni dettagliate introduttive, comparsing e linee guida.To learn ADF's overall support on SAP data integration scenario, see SAP data integration using Azure Data Factory whitepaper with detailed introduction, comparsion and guidance.

Funzionalità supportateSupported capabilities

Questo SAP Cloud for Customer Connector è supportato per le attività seguenti:This SAP Cloud for Customer connector is supported for the following activities:

È possibile copiare dati da SAP Cloud for Customer in qualsiasi archivio dati sink supportato o da qualsiasi archivio dati di origine supportato in SAP Cloud for Customer.You can copy data from SAP Cloud for Customer to any supported sink data store, or copy data from any supported source data store to SAP Cloud for Customer. 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.

In particolare, questo connettore consente ad Azure Data Factory di copiare dati da/in SAP Cloud for Customer incluse le soluzioni SAP Cloud for Sales, SAP Cloud for Service e SAP Cloud for Social Engagement.Specifically, this connector enables Azure Data Factory to copy data from/to SAP Cloud for Customer including the SAP Cloud for Sales, SAP Cloud for Service, and SAP Cloud for Social Engagement solutions.

Inizia oraGetting started

È possibile usare l'attività di copia con una pipeline tramite uno degli strumenti o degli SDK seguenti.You can use one of the following tools or SDKs to use the copy activity with a pipeline. Per istruzioni dettagliate, selezionare un collegamento:Select a link for step-by-step instructions:

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

Proprietà del servizio collegatoLinked service properties

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

ProprietàProperty DescriptionDescription ObbligatoriaRequired
typetype La proprietà type deve essere impostata su: SapCloudForCustomer.The type property must be set to: SapCloudForCustomer. Yes
urlurl URL del servizio SAP C4C OData.The URL of the SAP C4C OData service. Yes
Nome utenteusername Specificare il nome utente per la connessione a SAP C4C.Specify the user name to connect to the SAP C4C. Yes
passwordpassword Specificare la password dell'account utente specificato per il nome utente.Specify the password for the user account you specified for the username. Contrassegnare questo campo come SecureString per archiviarlo in modo sicuro in Azure Data Factory oppure fare riferimento a un segreto archiviato in Azure Key Vault.Mark this field as a SecureString to store it securely in Data Factory, or reference a secret stored in Azure Key Vault. Yes
connectViaconnectVia Il runtime di integrazione da usare per la connessione all'archivio dati.The Integration Runtime to be used to connect to the data store. Se non diversamente specificato, viene usato il runtime di integrazione di Azure predefinito.If not specified, it uses the default Azure Integration Runtime. No per l'origine, Sì per il sinkNo for source, Yes for sink

Importante

Per copiare i dati in SAP Cloud for Customer, creare un runtime di integrazione di Azure in modo esplicito con una posizione prossima a SAP Cloud for Customer e associarlo al servizio collegato come illustrato nell'esempio seguente.To copy data into SAP Cloud for Customer, explicitly create an Azure IR with a location near your SAP Cloud for Customer, and associate in the linked service as the following example:

Esempio:Example:

{
    "name": "SAPC4CLinkedService",
    "properties": {
        "type": "SapCloudForCustomer",
        "typeProperties": {
            "url": "https://<tenantname>.crm.ondemand.com/sap/c4c/odata/v1/c4codata/" ,
            "username": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

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 SAP Cloud for Customer.This section provides a list of properties supported by SAP Cloud for Customer dataset.

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

ProprietàProperty DescriptionDescription ObbligatoriaRequired
typetype La proprietà type del set di dati deve essere impostata su: SapCloudForCustomerResource.The type property of the dataset must be set to: SapCloudForCustomerResource Yes
pathpath Specificare il percorso dell'entità SAP C4C OData.Specify path of the SAP C4C OData entity. Yes

Esempio:Example:

{
    "name": "SAPC4CDataset",
    "properties": {
        "type": "SapCloudForCustomerResource",
        "typeProperties": {
            "path": "<path e.g. LeadCollection>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP C4C linked service>",
            "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 SAP Cloud for Customer.This section provides a list of properties supported by SAP Cloud for Customer source.

SAP C4C come origineSAP C4C as source

Per copiare dati da SAP Cloud for Customer, impostare il tipo di origine nell'attività di copia su SapCloudForCustomerSource.To copy data from SAP Cloud for Customer, set the source type in the copy activity to SapCloudForCustomerSource. 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 DescriptionDescription ObbligatoriaRequired
typetype La proprietà type deve essere impostata su: SapCloudForCustomerSource.The type property must be set to: SapCloudForCustomerSource Yes
queryquery Specificare la query OData personalizzata per leggere i dati.Specify the custom OData query to read data. NoNo

Query di esempio per ottenere dati relativi a un giorno specifico:"query": "$filter=CreatedOn ge datetimeoffset'2017-07-31T10:02:06.4202620Z' and CreatedOn le datetimeoffset'2017-08-01T10:02:06.4202620Z'"Sample query to get data for a specific day: "query": "$filter=CreatedOn ge datetimeoffset'2017-07-31T10:02:06.4202620Z' and CreatedOn le datetimeoffset'2017-08-01T10:02:06.4202620Z'"

Esempio:Example:

"activities":[
    {
        "name": "CopyFromSAPC4C",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP C4C input dataset>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapCloudForCustomerSource",
                "query": "<custom query e.g. $top=10>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

SAP C4C come sinkSAP C4C as sink

Per copiare dati in SAP Cloud for Customer, impostare il tipo di sink nell'attività di copia su SapCloudForCustomerSink.To copy data to SAP Cloud for Customer, set the sink type in the copy activity to SapCloudForCustomerSink. Nella sezione sink dell'attività di copia sono supportate le proprietà seguenti:The following properties are supported in the copy activity sink section:

ProprietàProperty DescriptionDescription ObbligatoriaRequired
typetype La proprietà type deve essere impostata su: SapCloudForCustomerSink.The type property must be set to: SapCloudForCustomerSink Yes
writeBehaviorwriteBehavior Comportamento dell'azione di scrittura dell'operazione.The write behavior of the operation. Può essere "Insert", "Update".Could be “Insert”, “Update”.  No.No. Il valore predefinito è "Insert".Default “Insert”.
writeBatchSizewriteBatchSize Dimensioni batch dell'operazione di scrittura.The batch size of write operation. Le dimensioni batch per ottenere prestazioni ottimali possono essere diverse per tabelle o server differenti.The batch size to get best performance may be different for different table or server. No.No. Il valore predefinito è 10.Default 10. 

Esempio:Example:

"activities":[
    {
        "name": "CopyToSapC4c",
        "type": "Copy",
        "inputs": [{
            "type": "DatasetReference",
            "referenceName": "<dataset type>"
        }],
        "outputs": [{
            "type": "DatasetReference",
            "referenceName": "SapC4cDataset"
        }],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "SapCloudForCustomerSink",
                "writeBehavior": "Insert",
                "writeBatchSize": 30
            },
            "parallelCopies": 10,
            "dataIntegrationUnits": 4,
            "enableSkipIncompatibleRow": true,
            "redirectIncompatibleRowSettings": {
                "linkedServiceName": {
                    "referenceName": "ErrorLogBlobLinkedService",
                    "type": "LinkedServiceReference"
                },
                "path": "incompatiblerows"
            }
        }
    }
]

Mapping del tipo di dati per SAP Cloud for CustomerData type mapping for SAP Cloud for Customer

Quando si copiano dati da SAP Cloud for Customer, vengono usati i mapping seguenti tra i tipi di dati di SAP Cloud for Customer e i tipi di dati provvisori di Azure Data Factory.When copying data from SAP Cloud for Customer, the following mappings are used from SAP Cloud for Customer data types to Azure Data Factory interim data types. Vedere Mapping dello schema e del tipo di dati per informazioni su come l'attività di copia esegue il mapping dello schema di origine e del tipo di dati al sink.See Schema and data type mappings to learn about how copy activity maps the source schema and data type to the sink.

Tipo di dati di SAP C4C ODataSAP C4C OData Data Type Tipo di dati provvisori di Data FactoryData factory interim data type
Edm.BinaryEdm.Binary Byte[]Byte[] 
Edm.BooleanEdm.Boolean BooleanoBool
Edm.ByteEdm.Byte Byte[]Byte[] 
Edm.DateTimeEdm.DateTime Data e oraDateTime
Edm.DecimalEdm.Decimal DECIMALDecimal
Edm.DoubleEdm.Double DOUBLEDouble
Edm.SingleEdm.Single SingoloSingle
Edm.GuidEdm.Guid GUIDGuid 
Edm.Int16Edm.Int16 Int16Int16
Edm.Int32Edm.Int32 Int32Int32
Edm.Int64Edm.Int64 Int64Int64
Edm.SByteEdm.SByte Int16Int16
Edm.StringEdm.String StringaString
Edm.TimeEdm.Time Intervallo di tempoTimeSpan
Edm.DateTimeOffsetEdm.DateTimeOffset DateTimeOffsetDateTimeOffset

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.