Copiare dati da SAP ECC usando Azure Data FactoryCopy data from SAP ECC by using Azure Data Factory

Questo articolo illustra come usare l'attività di copia in Azure Data Factory per copiare dati da SAP Enterprise Central Component (ECC).This article outlines how to use the copy activity in Azure Data Factory to copy data from SAP Enterprise Central Component (ECC). Per altre informazioni, vedere Cenni preliminari sull'attività di copia.For more information, see Copy activity overview.

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 connettore SAP ECC è supportato per le attività seguenti:This SAP ECC connector is supported for the following activities:

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

In particolare, il connettore SAP ECC supporta:Specifically, this SAP ECC connector supports:

  • Copia di dati da SAP ECC in SAP NetWeaver versione 7,0 e successive.Copying data from SAP ECC on SAP NetWeaver version 7.0 and later.

  • Copia di dati da qualsiasi oggetto esposto da SAP ECC OData Services, ad esempio:Copying data from any objects exposed by SAP ECC OData services, such as:

    • Tabelle o viste SAP.SAP tables or views.
    • Oggetti business Application Programming Interface [Bova].Business Application Programming Interface [BAPI] objects.
    • Estrattori di dati.Data extractors.
    • Dati o documenti intermedi (IDOCs) inviati all'integrazione del processo SAP (PI) che può essere ricevuta come OData tramite adattatori relativi.Data or intermediate documents (IDOCs) sent to SAP Process Integration (PI) that can be received as OData via relative adapters.
  • Copia dei dati tramite l'autenticazione di base.Copying data by using basic authentication.

Suggerimento

Per copiare dati da SAP ECC tramite una tabella o una vista SAP, usare SAP Table Connector, che è più veloce e più scalabile.To copy data from SAP ECC via an SAP table or view, use the SAP table connector, which is faster and more scalable.

PrerequisitiPrerequisites

In genere, SAP ECC espone entità tramite i servizi OData mediante il gateway SAP.Generally, SAP ECC exposes entities via OData services through SAP Gateway. Per usare questo connettore SAP ECC, è necessario:To use this SAP ECC connector, you need to:

  • Configurare il gateway SAP.Set up SAP Gateway. Per i server con versioni di SAP NetWeaver successive alla 7,4, il gateway SAP è già installato.For servers with SAP NetWeaver versions later than 7.4, SAP Gateway is already installed. Per le versioni precedenti, è necessario installare il gateway SAP incorporato o il sistema Hub gateway SAP prima di esporre i dati SAP ECC tramite i servizi OData.For earlier versions, you must install the embedded SAP Gateway or the SAP Gateway hub system before exposing SAP ECC data through OData services. Per configurare il gateway SAP, vedere la Guida all'installazione.To set up SAP Gateway, see the installation guide.

  • Attivare e configurare il servizio SAP OData.Activate and configure the SAP OData service. È possibile attivare il servizio OData tramite TCODE SICF in pochi secondi.You can activate the OData service through TCODE SICF in seconds. È anche possibile configurare quali oggetti devono essere esposti.You can also configure which objects need to be exposed. Per ulteriori informazioni, vedere le istruzioni dettagliate.For more information, see the step-by-step guidance.

PrerequisitiPrerequisites

Se l'archivio dati è configurato in uno dei modi seguenti, è necessario configurare un Integration Runtime self-hosted per connettersi a questo archivio dati:If your data store is configured in one of the following ways, you need to set up a Self-hosted Integration Runtime in order to connect to this data store:

  • L'archivio dati si trova all'interno di una rete locale, all'interno di una rete virtuale di Azure o all'interno di un cloud privato virtuale di Amazon.The data store is located inside an on-premises network, inside Azure Virtual Network, or inside Amazon Virtual Private Cloud.
  • L'archivio dati è un servizio dati cloud gestito in cui l'accesso è limitato agli indirizzi IP consentiti nelle regole del firewall.The data store is a managed cloud data service where the access is restricted to IPs whitelisted in the firewall rules.

Attività inizialiGet 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à che vengono usate per definire le entità Data Factory specifiche del connettore SAP ECC.The following sections provide details about properties that are used to define the Data Factory entities specific to the SAP ECC connector.

Proprietà del servizio collegatoLinked service properties

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

ProprietàProperty DescrizioneDescription ObbligatoriaRequired
type La type proprietà deve essere impostata su SapEcc.The type property must be set to SapEcc. YesYes
url URL del servizio SAP ECC OData.The URL of the SAP ECC OData service. Yes
username Nome utente usato per la connessione a SAP ECC.The username used to connect to SAP ECC. NoNo
password Password in testo non crittografato utilizzata per la connessione a SAP ECC.The plaintext password used to connect to SAP ECC. NoNo
connectVia Runtime di integrazione da usare per la connessione all'archivio dati.The integration runtime to be used to connect to the data store. Ulteriori informazioni sono disponibili nella sezione prerequisiti .Learn more from Prerequisites section. Se non si specifica un runtime, viene usato il runtime di integrazione di Azure predefinito.If you don't specify a runtime, the default Azure integration runtime is used. NoNo

EsempioExample

{
    "name": "SapECCLinkedService",
    "properties": {
        "type": "SapEcc",
        "typeProperties": {
            "url": "<SAP ECC OData URL, e.g., http://eccsvrname:8000/sap/opu/odata/sap/zgw100_dd02l_so_srv/>",
            "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 dei set di impostazioni, vedere Datasets.For a full list of the sections and properties available for defining datasets, see Datasets. Nella sezione seguente viene fornito un elenco delle proprietà supportate dal set di dati SAP ECC.The following section provides a list of the properties supported by the SAP ECC dataset.

Per copiare dati da SAP ecc, impostare la type proprietà del set di dati SapEccResourcesu.To copy data from SAP ECC, set the type property of the dataset to SapEccResource.

Sono supportate le proprietà seguenti:The following properties are supported:

ProprietàProperty DescrizioneDescription ObbligatoriaRequired
path Percorso dell'entità SAP ECC OData.Path of the SAP ECC OData entity. Yes

EsempioExample

{
    "name": "SapEccDataset",
    "properties": {
        "type": "SapEccResource",
        "typeProperties": {
            "path": "<entity path, e.g., dd04tentitySet>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP ECC 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 pipeline.For a full list of the sections and properties available for defining activities, see Pipelines. Nella sezione seguente viene fornito un elenco delle proprietà supportate dall'origine SAP ECC.The following section provides a list of the properties supported by the SAP ECC source.

SAP ECC come origineSAP ECC as a source

Per copiare dati da SAP ecc, impostare la type proprietà source nella sezione dell'attività di copia su SapEccSource.To copy data from SAP ECC, set the type property in the source section of the copy activity to SapEccSource.

Nella sezione dell'attività di source copia sono supportate le proprietà seguenti:The following properties are supported in the copy activity's source section:

ProprietàProperty DescrizioneDescription ObbligatoriaRequired
type La type proprietà della source sezione dell'attività di copia deve essere impostata su SapEccSource.The type property of the copy activity's source section must be set to SapEccSource. Yes
query Opzioni di query OData per filtrare i dati.The OData query options to filter the data. Ad esempio:For example:

"$select=Name,Description&$top=10"

Il connettore SAP ECC copia i dati dall'URL combinato:The SAP ECC connector copies data from the combined URL:

<URL specified in the linked service>/<path specified in the dataset>?<query specified in the copy activity's source section>

Per altre informazioni, vedere OData URL components (Componenti dell'URL di OData).For more information, see OData URL components.
NoNo

EsempioExample

"activities":[
    {
        "name": "CopyFromSAPECC",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP ECC input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapEccSource",
                "query": "$top=10"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Mapping dei tipi di dati per SAP ECCData type mappings for SAP ECC

Quando si copiano dati da SAP ECC, i mapping seguenti vengono usati dai tipi di dati OData per i dati SAP ECC per Azure Data Factory tipi di dati provvisori.When you're copying data from SAP ECC, the following mappings are used from OData data types for SAP ECC data 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.To learn how the copy activity maps the source schema and data type to the sink, see Schema and data type mappings.

Tipo di dati di ODataOData data type Tipo di dati provvisorio di Data FactoryData Factory interim data type
Edm.Binary String
Edm.Boolean Bool
Edm.Byte String
Edm.DateTime DateTime
Edm.Decimal Decimal
Edm.Double Double
Edm.Single Single
Edm.Guid String
Edm.Int16 Int16
Edm.Int32 Int32
Edm.Int64 Int64
Edm.SByte Int16
Edm.String String
Edm.Time TimeSpan
Edm.DateTimeOffset DateTimeOffset

Nota

I tipi di dati complessi non sono attualmente supportati.Complex data types aren't currently supported.

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 e sink dall'attività di copia in Azure Data Factory, vedere archivi dati supportati.For a list of the data stores supported as sources and sinks by the copy activity in Azure Data Factory, see Supported data stores.