Gegevens kopiëren uit SAP Business Warehouse met behulp van Azure Data Factory of Synapse Analytics

Artikel
11/16/2023

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel wordt beschreven hoe u de kopieeractiviteit in Azure Data Factory- en Synapse Analytics-pijplijnen gebruikt om gegevens te kopiëren uit een SAP Business Warehouse (BW). Het is gebaseerd op het artikel over het overzicht van kopieeractiviteiten met een algemeen overzicht van de kopieeractiviteit.

Tip

Zie sap-gegevensintegratie met behulp van een technisch document over Azure Data Factory met gedetailleerde inleiding over elke SAP-connector, vergelijking en richtlijnen voor meer informatie over de algehele ondersteuning van de service voor sap-gegevensintegratiescenario's.

Ondersteunde mogelijkheden

Deze SAP Business Warehouse-connector wordt ondersteund voor de volgende mogelijkheden:

Ondersteunde mogelijkheden	IR
Copy-activiteit (bron/-)	②
Activiteit Lookup	②

(1) Azure Integration Runtime (2) Zelf-hostende Integration Runtime

Zie de tabel Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen/sinks door de kopieeractiviteit.

Deze SAP Business Warehouse-connector ondersteunt met name:

SAP Business Warehouse versie 7.x.
Gegevens kopiëren uit InfoCubes en QueryCubes (inclusief BEx-query's) met behulp van MDX-query's.
Gegevens kopiëren met basisverificatie.

Notitie

De SAP Business Warehouse-connector biedt momenteel geen ondersteuning voor parameters met MDX. Als filteren met MDX-parameters is vereist, kunt u overwegen om in plaats daarvan de alternatieve SAP Open Hub-connector te gebruiken.

Vereisten

Als u deze SAP Business Warehouse-connector wilt gebruiken, moet u het volgende doen:

Stel een zelf-hostende Integration Runtime in. Zie het artikel over zelf-hostende Integration Runtime voor meer informatie.
Installeer de SAP NetWeaver-bibliotheek op de Integration Runtime-machine. U kunt de SAP Netweaver-bibliotheek ophalen van uw SAP-beheerder of rechtstreeks vanuit het SAP Software Download Center. Zoek naar de SAP-notitie #1025361 om de downloadlocatie voor de meest recente versie op te halen. Zorg ervoor dat u de 64-bits SAP NetWeaver-bibliotheek kiest die overeenkomt met uw Integration Runtime-installatie. Installeer vervolgens alle bestanden die zijn opgenomen in de SAP NetWeaver RFC SDK volgens de SAP-opmerking. De SAP NetWeaver-bibliotheek is ook opgenomen in de installatie van SAP Client Tools.

Tip

Als u het connectiviteitsprobleem met SAP BW wilt oplossen, moet u het volgende controleren:

Alle afhankelijkheidsbibliotheken die zijn geëxtraheerd uit de NetWeaver RFC SDK, bevinden zich in de map %windir%\system32. Meestal heeft het icudt34.dll, icuin34.dll, icuuc34.dll, libicudecnumber.dll, librfc32.dll, bibliothekenapucum.dll, sapcrypto.dll, sapcryto_old.dll, sapnwrfc.dll.
De benodigde poorten die worden gebruikt om verbinding te maken met SAP Server zijn ingeschakeld op de zelf-hostende IR-computer, meestal poort 3300 en 3201.

Aan de slag

Als u de kopieeractiviteit wilt uitvoeren met een pijplijn, kunt u een van de volgende hulpprogramma's of SDK's gebruiken:

Een gekoppelde service maken in SAP BW met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde service te maken voor SAP BW in de gebruikersinterface van Azure Portal.

Blader naar het tabblad Beheren in uw Azure Data Factory- of Synapse-werkruimte en selecteer Gekoppelde services en klik vervolgens op Nieuw:
- Azure Data Factory
- Azure Synapse
Zoek NAAR SAP en selecteer de SAP BW via MDX-connector.
Configureer de servicedetails, test de verbinding en maak de nieuwe gekoppelde service.

configuratiedetails Verbinding maken or

De volgende secties bevatten details over eigenschappen die worden gebruikt voor het definiëren van Data Factory-entiteiten die specifiek zijn voor SAP Business Warehouse-connector.

Eigenschappen van gekoppelde service

De volgende eigenschappen worden ondersteund voor de gekoppelde SAP Business Warehouse-service (BW):

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap moet worden ingesteld op: SapBw	Ja
server	Naam van de server waarop het SAP BW-exemplaar zich bevindt.	Ja
systemNumber	Systeemnummer van het SAP BW-systeem. Toegestane waarde: een decimaal getal van twee cijfers dat wordt weergegeven als een tekenreeks.	Ja
clientId	Client-id van de client in het SAP W-systeem. Toegestane waarde: een decimaal getal van drie cijfers dat wordt weergegeven als een tekenreeks.	Ja
gebruikersnaam	Naam van de gebruiker die toegang heeft tot de SAP-server.	Ja
password	Het wachtwoord voor de gebruiker. Markeer dit veld als SecureString om het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault.	Ja
connectVia	De Integration Runtime die moet worden gebruikt om verbinding te maken met het gegevensarchief. Een zelf-hostende Integration Runtime is vereist, zoals vermeld in vereisten.	Ja

Voorbeeld:

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

Eigenschappen van gegevensset

Zie het artikel gegevenssets voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van gegevenssets . Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de SAP BW-gegevensset.

Als u gegevens van SAP BW wilt kopiëren, stelt u de typeeigenschap van de gegevensset in op SapBwCube. Hoewel er geen typespecifieke eigenschappen worden ondersteund voor de SAP BW-gegevensset van het type RelationalTable.

Voorbeeld:

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

Als u RelationalTable getypte gegevensset gebruikt, wordt deze nog steeds ondersteund terwijl u wordt aangeraden de nieuwe gegevensset te gebruiken.

Eigenschappen van de kopieeractiviteit

Zie het artikel Pijplijnen voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van activiteiten. Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de SAP BW-bron.

SAP BW als bron

Als u gegevens uit SAP BW wilt kopiëren, worden de volgende eigenschappen ondersteund in de sectie bron van kopieeractiviteit:

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap van de bron van de kopieeractiviteit moet worden ingesteld op: SapBwSource	Ja
query	Hiermee geeft u de MDX-query op voor het lezen van gegevens uit het SAP BW-exemplaar.	Ja

Voorbeeld:

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

Als u RelationalSource getypte bron gebruikt, wordt deze nog steeds ondersteund, terwijl u wordt aangeraden de nieuwe bron te gebruiken.

Toewijzing van gegevenstypen voor SAP BW

Bij het kopiëren van gegevens uit SAP BW worden de volgende toewijzingen gebruikt van SAP BW-gegevenstypen naar tussentijdse gegevenstypen die intern in de service worden gebruikt. Zie Schema- en gegevenstypetoewijzingen voor meer informatie over hoe kopieeractiviteit het bronschema en het gegevenstype toewijst aan de sink.

SAP BW-gegevenstype	Tussentijdse servicegegevenstype
ACCP	Int
CHAR	String
CLNT	String
CURR	Decimal
CUKY	String
DEC	Decimal
FLTP	Dubbel
INT1	Byte
INT2	Int16
INT4	Int
LANG	String
LCHR	String
LRAW	Byte[]
PREC	Int16
QUAN	Decimal
RAW	Byte[]
RAWSTRING	Byte[]
STRING	String
EENHEID	String
DATS	String
NUMC	String
TIMS	String

Eigenschappen van opzoekactiviteit

Als u meer wilt weten over de eigenschappen, controleert u de lookup-activiteit.

Zie ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen en sinks door de kopieeractiviteit.

Gegevens kopiëren uit SAP Business Warehouse met behulp van Azure Data Factory of Synapse Analytics

Ondersteunde mogelijkheden

Vereisten

Aan de slag

Een gekoppelde service maken in SAP BW met behulp van de gebruikersinterface

configuratiedetails Verbinding maken or

Eigenschappen van gekoppelde service

Eigenschappen van gegevensset

Eigenschappen van de kopieeractiviteit

SAP BW als bron

Toewijzing van gegevenstypen voor SAP BW

Eigenschappen van opzoekactiviteit

Gerelateerde inhoud

Aanvullende resources