Kopiowanie danych z tabeli SAP przy użyciu usługi Azure Data Factory lub Azure Synapse Analytics

DOTYCZY: Azure Data Factory Azure Synapse Analytics

W tym artykule opisano sposób używania działania kopiowania w potokach usługi Azure Data Factory i Usługi Azure Synapse Analytics do kopiowania danych z tabeli SAP. Aby uzyskać więcej informacji, zobacz działanie Kopiuj omówienie.

Obsługiwane możliwości

Ten łącznik tabel SAP jest obsługiwany w następujących możliwościach:

(1) Środowisko Azure Integration Runtime (2) Self-hosted Integration Runtime

Aby uzyskać listę magazynów danych obsługiwanych jako źródła lub ujścia działania kopiowania, zobacz tabelę Obsługiwane magazyny danych.

W szczególności ten łącznik tabel SAP obsługuje następujące elementy:

• Kopiowanie danych z tabeli SAP w:

  • SAP ERP Central Component (SAP ECC) w wersji 7.01 lub nowszej (w ostatnim stosie pakietów pomocy technicznej SAP wydanym po 2015 r.).
  • SAP Business Warehouse (SAP BW) w wersji 7.01 lub nowszej (w ostatnim stosie pakietów pomocy technicznej SAP wydanym po 2015 r.).
  • SAP S/4HANA.
  • Inne produkty w pakiecie SAP Business Suite w wersji 7.01 lub nowszej (w ostatnim stosie pakietów pomocy technicznej SAP wydanym po 2015 r.).

• Kopiowanie danych z przezroczystej tabeli SAP, tabeli w puli, tabeli klastrowanej i widoku.

• Kopiowanie danych przy użyciu uwierzytelniania podstawowego lub protokołu Secure Network Communications (SNC), jeśli skonfigurowano usługę SNC.

• Połączenie do serwera aplikacji SAP lub serwera komunikatów SAP.

• Pobieranie danych za pomocą domyślnego lub niestandardowego specyfikacji RFC.

Wersja 7.01 lub nowsza odwołuje się do wersji SAP NetWeaver zamiast wersji sap ECC. Na przykład system SAP ECC 6.0 EHP 7 ogólnie ma wersję >NetWeaver =7.4. Jeśli nie masz pewności co do środowiska, poniżej przedstawiono procedurę potwierdzania wersji z systemu SAP:

1. Użyj graficznego interfejsu użytkownika sap, aby nawiązać połączenie z systemem SAP.
2. Przejdź do pozycji System ->Status.
3. Sprawdź wydanie SAP_BASIS, upewnij się, że jest on równy lub większy niż 701.
   

Wymagania wstępne

Aby użyć tego łącznika tabel SAP, należy wykonać następujące czynności:

• Skonfiguruj własne środowisko Integration Runtime (wersja 3.17 lub nowsza). Aby uzyskać więcej informacji, zobacz Tworzenie i konfigurowanie własnego środowiska Integration Runtime.

• Pobierz 64-bitowy program SAP Połączenie or dla platformy Microsoft .NET 3.0 z witryny internetowej SAP i zainstaluj go na maszynie własnego środowiska Integration Runtime. Podczas instalacji upewnij się, że w oknie Opcjonalne kroki konfiguracji wybrano opcję Zainstaluj zestawy do GAC.

  

• Użytkownik SAP, który jest używany w łączniku tabel SAP, musi mieć następujące uprawnienia:

  • Autoryzacja do korzystania z miejsc docelowych wywołania funkcji zdalnej (RFC).
  • Uprawnienia do działania Execute obiektu autoryzacji S_SDSAUTH. W przypadku większości obiektów autoryzacji można odwoływać się do 460089 SAP Note. Niektóre rfCs są wymagane przez podstawowy łącznik NCo, na przykład RFC_FUNCTION_SEARCH.

Rozpocznij

Aby wykonać działanie Kopiuj za pomocą potoku, możesz użyć jednego z następujących narzędzi lub zestawów SDK:

• Narzędzie do kopiowania danych
• Witryna Azure Portal
• Zestaw SDK platformy .NET
• Zestaw SDK języka Python
• Azure PowerShell
• Interfejs API REST
• Szablon usługi Azure Resource Manager

Tworzenie połączonej usługi z tabelą SAP przy użyciu interfejsu użytkownika

Wykonaj poniższe kroki, aby utworzyć połączoną usługę z tabelą SAP w interfejsie użytkownika witryny Azure Portal.

1. Przejdź do karty Zarządzanie w obszarze roboczym usługi Azure Data Factory lub Synapse i wybierz pozycję Połączone usługi, a następnie kliknij pozycję Nowy:

   • Azure Data Factory
   • Azure Synapse

   

2. Wyszukaj pozycję SAP i wybierz łącznik tabeli SAP.

   

3. Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.

   

szczegóły konfiguracji Połączenie or

Poniższe sekcje zawierają szczegółowe informacje o właściwościach używanych do definiowania jednostek specyficznych dla łącznika tabeli SAP.

Właściwości połączonej usługi

Następujące właściwości są obsługiwane dla połączonej usługi SAP BW Open Hub:

Przykład 1: Połączenie do serwera aplikacji SAP

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

Przykład 2: Połączenie do serwera komunikatów SAP

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

Przykład 3: Połączenie przy użyciu 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"
        }
    }
}

Właściwości zestawu danych

Aby uzyskać pełną listę sekcji i właściwości definiowania zestawów danych, zobacz Zestawy danych. Poniższa sekcja zawiera listę właściwości obsługiwanych przez zestaw danych tabeli SAP.

Aby skopiować dane z i do połączonej usługi SAP BW Open Hub, obsługiwane są następujące właściwości:

Przykład

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

Właściwości działania kopiowania

Aby uzyskać pełną listę sekcji i właściwości definiowania działań, zobacz Pipelines (Potoki). Poniższa sekcja zawiera listę właściwości obsługiwanych przez źródło tabeli SAP.

Tabela SAP jako źródło

Aby skopiować dane z tabeli SAP, obsługiwane są następujące właściwości:

W rfcTableOptionsprogramie można użyć następujących typowych operatorów zapytań SAP do filtrowania wierszy:

Przykład

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

Łączenie tabel SAP

Obecnie łącznik SAP Table Connector obsługuje tylko jedną tabelę z domyślnym modułem funkcji. Aby uzyskać dane sprzężone wielu tabel, możesz użyć właściwości customRfcReadTableFunctionModule w łączniku tabel SAP, wykonując poniższe kroki:

• Napisz moduł funkcji niestandardowej, który może przyjąć zapytanie jako OPCJE i zastosować własną logikę w celu pobrania danych.
• W polu "Moduł funkcji niestandardowej" wprowadź nazwę modułu funkcji niestandardowej.
• W przypadku opcji "opcje tabeli RFC" określ instrukcję sprzężenia tabeli, która ma być zawarta w module funkcji, na przykład "<TABLE1> INNER JOIN <TABLE2> ON COLUMN0".

Poniżej przedstawiono przykład:

Tworzenie modułu funkcji niestandardowej

W przypadku tabeli SAP obecnie obsługujemy właściwość customRfcReadTableFunctionModule w źródle kopiowania, która umożliwia wykorzystanie własnej logiki i przetwarzania danych.

Poniżej przedstawiono kilka wskazówek, które należy spełnić, aby rozpocząć pracę z modułem "Funkcja niestandardowa":

• Definicja:

  

• Eksportuj dane do jednej z poniższych tabel:

  

  

Poniżej przedstawiono ilustracje dotyczące sposobu działania łącznika tabel SAP z modułem funkcji niestandardowej:

1. Skompiluj połączenie z serwerem SAP za pośrednictwem rozwiązania SAP NCO.

2. Wywołaj "Moduł funkcji niestandardowej" przy użyciu parametrów ustawionych poniżej:

   • QUERY_TABLE: nazwa tabeli ustawiona w zestawie danych tabeli SAP;
   • Ogranicznik: ogranicznik ustawiony w źródle tabeli SAP;
   • ROWCOUNT/Option/Fields: pole Rowcount/Aggregated Option/Fields ustawione w źródle tabeli.

3. Pobierz wynik i przeanalizuj dane w następujący sposób:

   1. Przeanalizuj wartość w tabeli Pola, aby pobrać schematy.

      

   2. Pobierz wartości tabeli wyjściowej, aby zobaczyć, która tabela zawiera te wartości.

      

   3. Pobierz wartości w OUT_TABLE, przeanalizuj dane, a następnie zapisz je w ujściu.

Mapowania typów danych dla tabeli SAP

Podczas kopiowania danych z tabeli SAP następujące mapowania są używane z typów danych tabeli SAP do tymczasowych typów danych używanych w usłudze. Aby dowiedzieć się, jak działanie kopiowania mapuje schemat źródłowy i typ danych na ujście, zobacz Mapowania schematu i typu danych.

Właściwości działania wyszukiwania

Aby dowiedzieć się więcej o właściwościach, sprawdź działanie Wyszukiwania.

Powiązana zawartość

Aby uzyskać listę magazynów danych obsługiwanych jako źródła i ujścia działania kopiowania, zobacz Obsługiwane magazyny danych.