Kopiera data från en SAP-tabell med Azure Data Factory eller Azure Synapse Analytics

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

Den här artikeln beskriver hur du använder kopieringsaktiviteten i Azure Data Factory- och Azure Synapse Analytics-pipelines för att kopiera data från en SAP-tabell. Mer information finns i Översikt över kopieringsaktivitet.

Funktioner som stöds

Den här SAP-tabellanslutningsappen stöds för följande funktioner:

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

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

Mer specifikt stöder den här SAP-tabellanslutningsappen:

• Kopiera data från en SAP-tabell i:

  • SAP ERP Central Component (SAP ECC) version 7.01 eller senare (i en nyligen publicerad SAP Support Package Stack efter 2015).
  • SAP Business Warehouse (SAP BW) version 7.01 eller senare (i en nyligen publicerad SAP Support Package Stack efter 2015).
  • SAP S/4HANA.
  • Andra produkter i SAP Business Suite version 7.01 eller senare (i en nyligen publicerad SAP Support Package Stack efter 2015).

• Kopiera data från både en TRANSPARENT SAP-tabell, en pooltabell, en klustrad tabell och en vy.

• Kopiera data med grundläggande autentisering eller SNC (Secure Network Communications), om SNC har konfigurerats.

• Ansluta till en SAP-programserver eller SAP-meddelandeserver.

• Hämtar data via standard eller anpassad RFC.

Version 7.01 eller senare refererar till SAP NetWeaver-versionen i stället för SAP ECC-versionen. Till exempel har SAP ECC 6.0 EHP 7 i allmänhet NetWeaver-version >=7.4. Om du är osäker på din miljö följer du stegen för att bekräfta versionen från DITT SAP-system:

1. Använd SAP GUI för att ansluta till SAP-systemet.
2. Gå till System ->Status.
3. Kontrollera versionen av SAP_BASIS, se till att den är lika med eller större än 701.
   

Förutsättningar

Om du vill använda den här SAP-tabellanslutningsappen måste du:

• Konfigurera en lokalt installerad integrationskörning (version 3.17 eller senare). Mer information finns i Skapa och konfigurera en lokalt installerad integrationskörning.

• Ladda ned 64-bitars SAP Connector för Microsoft .NET 3.0 från SAP:s webbplats och installera den på den lokala integrationskörningsdatorn. Under installationen kontrollerar du att du väljer alternativet Installera sammansättningar till GAC i fönstret Valfria installationssteg .

  

• DEN SAP-användare som används i SAP-tabellanslutningen måste ha följande behörigheter:

  • Auktorisering för användning av RFC-mål (Remote Function Call).
  • Behörigheter till körningsaktiviteten för S_SDSAUTH-auktoriseringsobjektet. Du kan läsa SAP Note 460089 för de flesta auktoriseringsobjekt. Vissa RFC:er krävs av den underliggande NCo-anslutningsappen, till exempel RFC_FUNCTION_SEARCH.

Kom igång

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

• Verktyget Kopiera data
• Azure-portalen
• The .NET SDK
• The Python SDK
• Azure PowerShell
• REST-API:et
• Azure Resource Manager-mallen

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

Använd följande steg för att skapa en länkad tjänst till en SAP-tabell 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:

   • Azure Data Factory
   • Azure Synapse

   

2. Sök efter SAP och välj SAP-tabellanslutningen.

   

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

   

Konfigurationsinformation för anslutningsprogram

Följande avsnitt innehåller information om egenskaper som används för att definiera de entiteter som är specifika för SAP-tabellanslutningen.

Länkade tjänstegenskaper

Följande egenskaper stöds för den länkade SAP BW Open Hub-tjänsten:

Exempel 1: Ansluta till en SAP-programserver

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "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"
        }
    }
}

Exempel 2: Ansluta till en SAP-meddelandeserver

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "typeProperties": {
            "messageServer": "<message server name>",
            "messageServerService": "<service name or port>",
            "systemId": "<system ID>",
            "logonGroup": "<logon group>",
            "clientId": "<client ID>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            }
        },
        "connectVia": {
            "referenceName": "<name of integration runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Exempel 3: Anslut med hjälp av SNC

{
    "name": "SapTableLinkedService",
    "properties": {
        "type": "SapTable",
        "typeProperties": {
            "server": "<server name>",
            "systemNumber": "<system number>",
            "clientId": "<client ID>",
            "userName": "<SAP user>",
            "password": {
                "type": "SecureString",
                "value": "<Password for SAP user>"
            },
            "sncMode": 1,
            "sncMyName": "<SNC myname>",
            "sncPartnerName": "<SNC partner name>",
            "sncLibraryPath": "<SNC library path>",
            "sncQop": "8"
        },
        "connectVia": {
            "referenceName": "<name of integration runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Egenskaper för datauppsättning

En fullständig lista över avsnitt och egenskaper för att definiera datauppsättningar finns i Datauppsättningar. Följande avsnitt innehåller en lista över de egenskaper som stöds av SAP-tabelldatauppsättningen.

Följande egenskaper stöds för att kopiera data från och till den länkade SAP BW Open Hub-tjänsten:

Exempel

{
    "name": "SAPTableDataset",
    "properties": {
        "type": "SapTableResource",
        "typeProperties": {
            "tableName": "<SAP table name>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP table linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Kopiera egenskaper för aktivitet

En fullständig lista över avsnitt och egenskaper för att definiera aktiviteter finns i Pipelines. Följande avsnitt innehåller en lista över de egenskaper som stöds av SAP-tabellkällan.

SAP-tabell som källa

Följande egenskaper stöds för att kopiera data från en SAP-tabell:

I rfcTableOptionskan du använda följande vanliga SAP-frågeoperatorer för att filtrera raderna:

Exempel

"activities":[
    {
        "name": "CopyFromSAPTable",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP table input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapTableSource",
                "partitionOption": "PartitionOnInt",
                "partitionSettings": {
                     "partitionColumnName": "<partition column name>",
                     "partitionUpperBound": "2000",
                     "partitionLowerBound": "1",
                     "maxPartitionsNumber": 500
                 }
            },
            "sink": {
                "type": "<sink type>"
            },
            "parallelCopies": 4
        }
    }
]

Ansluta TILL SAP-tabeller

För närvarande stöder SAP Table Connector endast en enskild tabell med standardfunktionsmodulen. Om du vill hämta anslutna data för flera tabeller kan du använda egenskapen customRfcReadTableFunctionModule i SAP Table Connector genom att följa stegen nedan:

• Skriv en anpassad funktionsmodul som kan ta en fråga som ALTERNATIV och använda din egen logik för att hämta data.
• För modulen "Anpassad funktion" anger du namnet på din anpassade funktionsmodul.
• För "RFC-tabellalternativ" anger du tabellkopplingssatsen för att mata in i funktionsmodulen som ALTERNATIV, till exempel "<TABLE1> INRE KOPPLING <TABLE2> PÅ COLUMN0".

Nedan visas ett exempel:

Skapa en anpassad funktionsmodul

För SAP-tabellen stöder vi för närvarande egenskapen customRfcReadTableFunctionModule i kopieringskällan, vilket gör att du kan använda din egen logik och processdata.

Som en snabb vägledning, här är några krav för att komma igång med "Anpassad funktionsmodul":

• Definition:

  

• Exportera data till en av tabellerna nedan:

  

  

Nedan visas illustrationer av hur SAP Table Connector fungerar med modulen anpassad funktion:

1. Skapa anslutning med SAP-servern via SAP NCO.

2. Anropa "Anpassad funktionsmodul" med parametrarna som anges nedan:

   • QUERY_TABLE: tabellnamnet som du angav i SAP Table-datauppsättningen.
   • Avgränsare: avgränsare som du angav i SAP-tabellkällan.
   • ROWCOUNT/Option/Fields: rowcount/aggregated option/fields som du angav i tabellkällan.

3. Hämta resultatet och parsa data på följande sätt:

   1. Parsa värdet i tabellen Fält för att hämta scheman.

      

   2. Hämta värdena för utdatatabellen för att se vilken tabell som innehåller dessa värden.

      

   3. Hämta värdena i OUT_TABLE, parsa data och skriv dem sedan till mottagaren.

Datatypsmappningar för en SAP-tabell

När du kopierar data från en SAP-tabell används följande mappningar från SAP-tabelldatatyperna till mellanliggande datatyper som används i tjänsten. Information om hur kopieringsaktiviteten mappar källschemat och datatypen till mottagaren finns i Schema- och datatypmappningar.

Egenskaper för uppslagsaktivitet

Mer information om egenskaperna finns i Sökningsaktivitet.

Relaterat innehåll

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