Copiare dati da SAP ECC tramite Azure Data Factory o Synapse Analytics

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Suggerimento

Provare Data Factory in Microsoft Fabric, una soluzione di analisi all-in-one per le aziende. Microsoft Fabric copre tutto, dallo spostamento dati al data science, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Vedere le informazioni su come iniziare una nuova prova gratuita!

Questo articolo illustra come usare l'attività di copia in Azure Data Factory per copiare dati da SAP Enterprise Central Component (ECC). Per altre informazioni, vedere Panoramica dell'attività di copia.

Suggerimento

Per informazioni sul supporto generale sullo scenario di integrazione dei dati SAP, vedere il white paper sull'integrazione dei dati SAP con Azure Data Factory con sezioni di introduzione, confronto e istruzioni dettagliate su ogni connettore SAP.

Funzionalità supportate

Questo connettore SAP ECC è supportato per le attività seguenti:

Funzionalità supportate IR
Attività Copy (origine/-) ① ②
Attività Lookup ① ②

① Azure Integration Runtime ② Runtime di integrazione self-hosted

Per un elenco degli archivi dati supportati come origini o sink, vedere la tabella Archivi dati supportati.

In particolare, il connettore SAP ECC supporta:

  • La copia di dati da SAP ECC su SAP NetWeaver versione 7.0 e successive.

  • La copia di dati da oggetti esposti dai servizi OData di SAP ECC, ad esempio:

    • Viste o tabelle SAP.
    • Oggetti Business Application Programming Interface [BAPI].
    • Estrattori di dati.
    • Dati o Intermediate Document (IDOC) inviati all'integrazione del processo (PI) SAP che possono essere ricevuti come OData tramite i relativi adattatori.
  • La copia di dati usando l'autenticazione di base.

La versione 7.0 o versione successiva fa riferimento alla versione SAP NetWeaver invece della versione SAP ECC. Ad esempio, SAP ECC 6.0 EHP 7 in generale ha una versione NetWeaver >=7.4. In caso di dubbi in merito all'ambiente, segue una procedura per confermare la versione dal sistema SAP:

  1. Usare l'interfaccia utente grafica SAP per connettersi al sistema SAP.
  2. Passare a Sistema ->Stato.
  3. Controllare la versione di SAP_BASIS, verificare che sia uguale o maggiore di 701.
    Controllare SAP_BASIS

Suggerimento

Per copiare dati da SAP ECC tramite una tabella o una vista SAP, usare il connettore tabella SAP, che è più veloce e più scalabile.

Prerequisiti

Per usare questo connettore SAP ECC, è necessario esporre le entità SAP ECC tramite servizi OData attraverso il gateway SAP. In particolare:

  • Configurare il gateway SAP. Per i server con SAP NetWeaver versioni successive alla 7.4, il gateway SAP è già installato. Per le versioni precedenti, è necessario installare il gateway SAP incorporato o il sistema per l'hub del gateway SAP prima di esporre i dati SAP ECC tramite i servizi OData. Per configurare il gateway SAP, vedere la guida all'installazione.

  • Attivare e configurare il servizio OData di SAP. È possibile attivare il servizio OData tramite TCODE SICF in pochi secondi. È anche possibile configurare gli oggetti da esporre. Per altre informazioni, vedere la guida dettagliata.

Se l'archivio dati si trova all'interno di una rete locale, una rete virtuale di Azure o un cloud privato virtuale di Amazon, è necessario configurare un runtime di integrazione self-hosted per connettersi.

Se l'archivio dati è un servizio dati del cloud gestito, è possibile usare Azure Integration Runtime. Se l'accesso è limitato solo agli indirizzi IP approvati nelle regole del firewall, è possibile aggiungere IP di Azure Integration Runtime nell'elenco Consentiti.

È anche possibile usare la funzionalitàruntime di integrazione della rete virtuale gestita in Azure Data Factory per accedere alla rete locale senza installare e configurare un runtime di integrazione self-hosted.

Per altre informazioni sui meccanismi di sicurezza di rete e sulle opzioni supportate da Data Factory, vedere strategie di accesso ai dati.

Operazioni preliminari

Per eseguire l'attività di copia con una pipeline, è possibile usare uno degli strumenti o SDK seguenti:

Creare un servizio collegato a SAP ECC usando l'interfaccia utente

Usare la procedura seguente per creare un servizio collegato a SAP ECC nell'interfaccia utente del portale di Azure.

  1. Passare alla scheda Gestisci nell'area di lavoro di Azure Data Factory o Synapse e selezionare Servizi collegati, quindi fare clic su Nuovo:

  2. Cercare SAP e selezionare il connettore SAP ECC.

    Screenshot del connettore SAP ECC.

  3. Configurare i dettagli del servizio, testare la connessione e creare il nuovo servizio collegato.

    Screenshot della configurazione del servizio collegato di SAP ECC.

Dettagli di configurazione del connettore

Le sezioni seguenti riportano informazioni dettagliate sulle proprietà che vengono usate per definire entità specifiche per il connettore SAP ECC.

Proprietà del servizio collegato

Per il servizio collegato di SAP ECC sono supportate le proprietà seguenti:

Proprietà Descrizione Richiesto
type Per poter utilizzare questa proprietà, typela proprietà deve essere impostata su SapEcc
url URL del servizio OData di SAP ECC.
username Nome utente usato per la connessione a SAP ECC. No
password Password di testo non crittografato usata per la connessione a SAP ECC. No
connectVia Runtime di integrazione da usare per la connessione all'archivio dati. Per altre informazioni, vedere la sezione Prerequisiti. Se non viene specificato un runtime, come valore predefinito viene usato Azure Integration Runtime. No

Esempio

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

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione dei set di dati, vedere Set di dati. La sezione seguente presenta un elenco delle proprietà supportate dal set di dati SAP ECC.

Per copiare dati da SAP ECC, impostare la proprietà type del set di dati su SapEccResource.

Sono supportate le proprietà seguenti:

Proprietà Descrizione Richiesto
path Percorso dell'entità SAP ECC OData.

Esempio

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

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere Pipeline. La sezione seguente presenta un elenco delle proprietà supportate dall'origine SAP ECC.

SAP ECC come origine

Per copiare dati da SAP ECC, impostare la proprietà type nella sezione source dell'attività di copia su SapEccSource.

Nella sezione source dell'attività di copia sono supportate le proprietà seguenti:

Proprietà Descrizione Richiesto
type La proprietà type della sezione source dell'attività di copia deve essere impostata su SapEccSource.
query Opzioni di query OData per filtrare i dati. Ad esempio:

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

il connettore SAP ECC copia dati dall'URL combinato:

<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).
No
sapDataColumnDelimiter Carattere singolo che viene usato come delimitatore passato a SAP RFC per suddividere i dati di output. No
httpRequestTimeout Timeout (valore di TimeSpan) durante il quale la richiesta HTTP attende una risposta. Si tratta del timeout per ottenere una risposta, non per leggere i dati della risposta. Se non è specificato, il valore predefinito è 00:30:00 (30 minuti). No

Esempio

"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 ECC

Quando si copiano dati da SAP ECC, vengono usati i mapping seguenti tra i tipi di dati di OData per i dati di SAP ECC e i tipi di dati provvisori che il servizio usa internamente. 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.

Tipo di dati di OData Tipo di dati del servizio provvisorio
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.

Proprietà dell'attività Lookup

Per altre informazioni sulle proprietà, vedere Attività Lookup.

Per un elenco degli archivi dati supportati come origini e sink dall'attività Copy, vedere Archivi dati supportati.