Kopiera data från SAP Business Warehouse med Hjälp av Azure Data Factory eller Synapse Analytics

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Dricks

Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!

Den här artikeln beskriver hur du använder kopieringsaktiviteten i Azure Data Factory- och Synapse Analytics-pipelines för att kopiera data från ett SAP Business Warehouse (BW). Den bygger på översiktsartikeln för kopieringsaktivitet som visar en allmän översikt över kopieringsaktiviteten.

Dricks

Information om tjänstens övergripande stöd för SAP-dataintegreringsscenario finns i SAP-dataintegrering med hjälp av Azure Data Factory white paper med detaljerad introduktion till varje SAP-anslutningsapp, jämförelse och vägledning.

Funktioner som stöds

Den här SAP Business Warehouse-anslutningsappen stöds för följande funktioner:

Funktioner som stöds IR
aktiviteten Kopiera (källa/-)
Sökningsaktivitet

(1) Azure Integration Runtime (2) Lokalt installerad integrationskörning

En lista över datalager som stöds som källor/mottagare av kopieringsaktiviteten finns i tabellen Datalager som stöds.

Mer specifikt stöder den här SAP Business Warehouse-anslutningsappen:

  • SAP Business Warehouse version 7.x.
  • Kopiera data från InfoCubes och QueryCubes (inklusive BEx-frågor) med MDX-frågor.
  • Kopiera data med grundläggande autentisering.

Kommentar

SAP Business Warehouse-anslutningsappen stöder för närvarande inte parametrar med MDX. Om filtrering med MDX-parametrar krävs kan du överväga att använda den alternativa SAP Open Hub-anslutningsappen i stället.

Förutsättningar

Om du vill använda den här anslutningsappen för SAP Business Warehouse måste du:

  • Konfigurera en lokalt installerad integrationskörning. Mer information finns i artikeln Om lokalt installerad integrationskörning .
  • Installera SAP NetWeaver-biblioteket på Integration Runtime-datorn. Du kan hämta SAP Netweaver-biblioteket från SAP-administratören eller direkt från SAP Software Download Center. Sök efter SAP Note #1025361 för att hämta nedladdningsplatsen för den senaste versionen. Se till att du väljer det 64-bitars SAP NetWeaver-bibliotek som matchar installationen av Integration Runtime. Installera sedan alla filer som ingår i SAP NetWeaver RFC SDK enligt SAP Note. SAP NetWeaver-biblioteket ingår också i installationen av SAP-klientverktyg.

Dricks

Om du vill felsöka anslutningsproblem till SAP BW kontrollerar du att:

  • Alla beroendebibliotek som extraheras från NetWeaver RFC SDK finns i mappen %windir%\system32. Vanligtvis har den icudt34.dll, icuin34.dll, icuuc34.dll, libicudecnumber.dll, librfc32.dll, libsapucum.dll, sapcrypto.dll, sapcryto_old.dll, sapnwrfc.dll.
  • De portar som behövs för att ansluta till SAP Server är aktiverade på den lokalt installerade IR-datorn, som vanligtvis är port 3300 och 3201.

Komma igång

Om du vill utföra aktiviteten Kopiera med en pipeline kan du använda något av följande verktyg eller SDK:er:

Skapa en länkad tjänst till SAP BW med hjälp av användargränssnittet

Använd följande steg för att skapa en länkad tjänst till SAP BW i Användargränssnittet för Azure-portalen.

  1. Bläddra till fliken Hantera i Din Azure Data Factory- eller Synapse-arbetsyta och välj Länkade tjänster och klicka sedan på Ny:

  2. Sök efter SAP och välj SAP BW via MDX-anslutningsappen.

    Select the SAP BW via MDX connector.

  3. Konfigurera tjänstinformationen, testa anslutningen och skapa den nya länkade tjänsten.

    Configure a linked service to SAP BW.

Anslut eller konfigurationsinformation

Följande avsnitt innehåller information om egenskaper som används för att definiera Data Factory-entiteter som är specifika för SAP Business Warehouse-anslutningsappen.

Länkade tjänstegenskaper

Följande egenskaper stöds för den länkade tjänsten SAP Business Warehouse (BW):

Property Beskrivning Obligatoriskt
type Typegenskapen måste anges till: SapBw Ja
server Namnet på servern där SAP BW-instansen finns. Ja
systemNumber Systemnummer för SAP BW-systemet.
Tillåtet värde: tvåsiffrigt decimaltal representerat som en sträng.
Ja
clientId Klient-ID för klienten i SAP W-systemet.
Tillåtet värde: tresiffrigt decimaltal representerat som en sträng.
Ja
userName Namnet på den användare som har åtkomst till SAP-servern. Ja
password Lösenordet för användaren. Markera det här fältet som en SecureString för att lagra det på ett säkert sätt eller referera till en hemlighet som lagras i Azure Key Vault. Ja
connectVia Integration Runtime som ska användas för att ansluta till datalagret. En lokalt installerad integrationskörning krävs enligt vad som anges i Krav. Ja

Exempel:

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

Egenskaper för datauppsättning

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera datauppsättningar finns i artikeln datauppsättningar . Det här avsnittet innehåller en lista över egenskaper som stöds av SAP BW-datauppsättningen.

Om du vill kopiera data från SAP BW anger du datauppsättningens typegenskap till SapBwCube. Det finns inga typspecifika egenskaper som stöds för SAP BW-datauppsättningen av typen RelationalTable.

Exempel:

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

Om du använder RelationalTable en typ av datauppsättning stöds den fortfarande i sin form, medan du rekommenderas att använda den nya framöver.

Kopiera egenskaper för aktivitet

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera aktiviteter finns i artikeln Pipelines . Det här avsnittet innehåller en lista över egenskaper som stöds av SAP BW-källan.

SAP BW som källa

Om du vill kopiera data från SAP BW stöds följande egenskaper i avsnittet kopieringsaktivitetskälla:

Property Beskrivning Obligatoriskt
type Typegenskapen för kopieringsaktivitetskällan måste anges till: SapBwSource Ja
query Anger MDX-frågan för att läsa data från SAP BW-instansen. Ja

Exempel:

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

Om du använde RelationalSource en typbaserad källa stöds den fortfarande som den är, medan du rekommenderas att använda den nya framöver.

Datatypsmappning för SAP BW

När du kopierar data från SAP BW används följande mappningar från SAP BW-datatyper till mellanliggande datatyper som används internt i tjänsten. Se Schema- och datatypmappningar för att lära dig mer om hur kopieringsaktivitet mappar källschemat och datatypen till mottagaren.

SAP BW-datatyp Datatyp för interimstjänst
ACCP Int
CHAR String
CLNT String
CURR Decimal
CUKY String
DECEMBER Decimal
FLTP Dubbel
INT1 Byte
INT2 Int16
INT4 Int
LANG String
LCHR String
LRAW Byte[]
PREC Int16
QUAN Decimal
RAW Byte[]
RAWSTRING Byte[]
STRÄNG String
ENHET String
DATS String
NUMC String
TIMS String

Egenskaper för uppslagsaktivitet

Mer information om egenskaperna finns i Sökningsaktivitet.

En lista över datalager som stöds som källor och mottagare av kopieringsaktiviteten finns i datalager som stöds.