Copiare dati da SAP Business Warehouse usando Azure Data FactoryCopy data from SAP Business Warehouse using Azure Data Factory

Questo articolo illustra come usare l'attività di copia in Azure Data Factory per copiare dati da un database SAP Business Warehouse (BW).This article outlines how to use the Copy Activity in Azure Data Factory to copy data from an SAP Business Warehouse (BW). 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 connettore SAP Business Warehouse è supportato per le attività seguenti:This SAP Business Warehouse connector is supported for the following activities:

È possibile copiare dati da SAP Business Warehouse in qualsiasi archivio dati di sink supportato.You can copy data from SAP Business Warehouse 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.

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

  • SAP Business Warehouse versione 7.x.SAP Business Warehouse version 7.x.
  • La copia di dati da InfoCube e QueryCube (incluse query BEx) tramite query MDX.Copying data from InfoCubes and QueryCubes (including BEx queries) using MDX queries.
  • La copia di dati usando l'autenticazione di base.Copying data using basic authentication.

PrerequisitiPrerequisites

Per usare il connettore SAP Business Warehouse, è necessario:To use this SAP Business Warehouse connector, you need to:

  • Configurare un runtime di integrazione self-hosted.Set up a Self-hosted Integration Runtime. Per i dettagli, vedere l'articolo Runtime di integrazione self-hosted.See Self-hosted Integration Runtime article for details.
  • Installare la libreria SAP NetWeaver nel computer del runtime di integrazione.Install the SAP NetWeaver library on the Integration Runtime machine. È possibile ottenere la libreria SAP Netweaver dal proprio amministratore SAP o direttamente dall'area per il download di software SAP.You can get the SAP Netweaver library from your SAP administrator, or directly from the SAP Software Download Center. Per ottenere il percorso di download della versione più recente, cercare SAP Note #1025361.Search for the SAP Note #1025361 to get the download location for the most recent version. Assicurarsi di selezionare la libreria SAP NetWeaver a 64 bit, che corrisponde all'installazione del runtime di integrazione in uso.Make sure that you pick the 64-bit SAP NetWeaver library which matches your Integration Runtime installation. Installare quindi tutti i file inclusi in SAP NetWeaver RFC SDK in base alla nota SAP.Then install all files included in the SAP NetWeaver RFC SDK according to the SAP Note. La libreria SAP NetWeaver è inclusa anche nell'installazione degli strumenti client SAP.The SAP NetWeaver library is also included in the SAP Client Tools installation.

Suggerimento

Per risolvere un problema di connettività a SAP BW, assicurarsi che:To troubleshoot connectivity issue to SAP BW, make sure:

  • Tutte le librerie di dipendenza estratte da NetWeaver RFC SDK siano disponibili nella cartella %windir%\system32.All dependency libraries extracted from the NetWeaver RFC SDK are in place in the %windir%\system32 folder. In genere la cartella contiene icudt34.dll, icuin34.dll, icuuc34.dll, libicudecnumber.dll, librfc32.dll, libsapucum.dll, sapcrypto.dll, sapcryto_old.dll, sapnwrfc.dll.Usually it has icudt34.dll, icuin34.dll, icuuc34.dll, libicudecnumber.dll, librfc32.dll, libsapucum.dll, sapcrypto.dll, sapcryto_old.dll, sapnwrfc.dll.
  • Le porte necessarie per la connessione al server SAP siano abilitate nel computer del runtime di integrazione self-hosted. In genere sono le porte 3300 e 3201.The needed ports used to connect to SAP Server are enabled on the Self-hosted IR machine, which usually are port 3300 and 3201.

IntroduzioneGetting 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 entità di Data Factory specifiche per il connettore SAP Business Warehouse.The following sections provide details about properties that are used to define Data Factory entities specific to SAP Business Warehouse connector.

Proprietà del servizio collegatoLinked service properties

Per il servizio collegato di SAP Business Warehouse (BW) sono supportate le proprietà seguenti:The following properties are supported for SAP Business Warehouse (BW) linked service:

ProprietàProperty DescrizioneDescription ObbligatoriaRequired
typetype La proprietà type deve essere impostata su: SapBwThe type property must be set to: SapBw Yes
serverserver Nome del server in cui si trova l'istanza di SAP BW.Name of the server on which the SAP BW instance resides. Yes
systemNumbersystemNumber Numero del sistema SAP BW.System number of the SAP BW system.
Valore consentito: numero decimale a due cifre rappresentato come stringa.Allowed value: two-digit decimal number represented as a string.
Yes
clientIdclientId ID del client nel sistema SAP BW.Client ID of the client in the SAP W system.
Valore consentito: numero decimale a tre cifre rappresentato come stringa.Allowed value: three-digit decimal number represented as a string.
Yes
userNameuserName Nome dell'utente che ha accesso al server SAP.Name of the user who has access to the SAP server. Yes
passwordpassword Password per l'utente.Password for the user. 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. È necessario un runtime di integrazione self-hosted come indicato in Prerequisiti.A Self-hosted Integration Runtime is required as mentioned in Prerequisites. Yes

Esempio:Example:

{
    "name": "SapBwLinkedService",
    "properties": {
        "type": "SapBw",
        "typeProperties": {
            "server": "<server name>",
            "systemNumber": "<system number>",
            "clientId": "<client id>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            }
        },
        "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 BW.This section provides a list of properties supported by SAP BW dataset.

Per copiare dati da SAP BW, impostare la proprietà Type del set di dati su SapBwCube.To copy data from SAP BW, set the type property of the dataset to SapBwCube. Il set di dati SAP BW di tipo RelationalTable non supporta alcuna proprietà specifica del tipo.While there are no type-specific properties supported for the SAP BW dataset of type RelationalTable.

Esempio:Example:

{
    "name": "SAPBWDataset",
    "properties": {
        "type": "SapBwCube",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP BW linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Se si usa RelationalTable un set di dati tipizzato, è ancora supportato così com'è, mentre si consiglia di usare quello nuovo in futuro.If you were using RelationalTable typed dataset, it is still supported as-is, while you are suggested to use the new one going forward.

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 BW.This section provides a list of properties supported by SAP BW source.

SAP BW come origineSAP BW as source

Per copiare dati da SAP BW, nella sezione origine dell'attività di copia sono supportate le proprietà seguenti:To copy data from SAP BW, the following properties are supported in the copy activity source section:

ProprietàProperty DescrizioneDescription ObbligatoriaRequired
typetype La proprietà type dell'origine di attività di copia deve essere impostata su: SapBwSourceThe type property of the copy activity source must be set to: SapBwSource YesYes
queryquery Specifica la query MDX che consente di leggere i dati dall'istanza di SAP BW.Specifies the MDX query to read data from the SAP BW instance. Yes

Esempio:Example:

"activities":[
    {
        "name": "CopyFromSAPBW",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP BW input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapBwSource",
                "query": "<MDX query for SAP BW>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Se si usa RelationalSource l'origine tipizzata, questo è ancora supportato così com'è, mentre si consiglia di usare quello nuovo in futuro.If you were using RelationalSource typed source, it is still supported as-is, while you are suggested to use the new one going forward.

Mapping dei tipi di dati per SAP BWData type mapping for SAP BW

Quando si copiano dati da SAP BW, vengono usati i mapping seguenti tra i tipi di dati di SAP BW e i tipi di dati provvisori di Azure Data Factory.When copying data from SAP BW, the following mappings are used from SAP BW 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 BWSAP BW data type Tipo di dati provvisori di Data FactoryData factory interim data type
ACCPACCP IntInt
CHARCHAR StringString
CLNTCLNT StringString
CURRCURR DecimalDecimal
CUKYCUKY StringString
DECDEC DecimalDecimal
FLTPFLTP DoubleDouble
INT1INT1 ByteByte
INT2INT2 Int16Int16
INT4INT4 IntInt
LANGLANG StringString
LCHRLCHR StringString
LRAWLRAW Byte[]Byte[]
PRECPREC Int16Int16
QUANQUAN DecimalDecimal
RAWRAW Byte[]Byte[]
RAWSTRINGRAWSTRING Byte[]Byte[]
STRINGSTRING StringString
UNITUNIT StringString
DATSDATS StringString
NUMCNUMC StringString
TIMSTIMS StringString

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.