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

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

W tym artykule opisano sposób używania działania kopiowania w potokach usługi Azure Data Factory i usługi Synapse Analytics do kopiowania danych z magazynu SAP Business Warehouse (BW). Jest on oparty na artykule omówienie działania kopiowania, który przedstawia ogólne omówienie działania kopiowania.

Napiwek

Aby poznać ogólną obsługę scenariusza integracji danych SAP z usługą SAP, zobacz oficjalny dokument dotyczący integracji danych SAP przy użyciu usługi Azure Data Factory ze szczegółowym wprowadzeniem do każdego łącznika SAP, porównania i wskazówek.

Obsługiwane możliwości

Ten łącznik SAP Business Warehouse jest obsługiwany w następujących funkcjach:

Obsługiwane możliwości IR
działanie Kopiuj (źródło/-)
Działanie Lookup

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

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

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

  • SAP Business Warehouse w wersji 7.x.
  • Kopiowanie danych z zapytań InfoCubes i QueryCubes (w tym zapytań BEx) przy użyciu zapytań MDX.
  • Kopiowanie danych przy użyciu uwierzytelniania podstawowego.

Uwaga

Łącznik SAP Business Warehouse nie obsługuje obecnie parametrów z rozwiązaniem MDX. Jeśli wymagane jest filtrowanie przy użyciu parametrów MDX, możesz zamiast tego rozważyć użycie alternatywnego łącznika SAP Open Hub.

Wymagania wstępne

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

  • Skonfiguruj własne środowisko Integration Runtime. Aby uzyskać szczegółowe informacje, zobacz artykuł Self-hosted Integration Runtime (Self-hosted Integration Runtime ).
  • Zainstaluj bibliotekę SAP NetWeaver na maszynie Integration Runtime. Bibliotekę SAP Netweaver można pobrać z poziomu administratora sap lub bezpośrednio z Centrum pobierania oprogramowania SAP. Wyszukaj plik SAP Note #1025361, aby uzyskać lokalizację pobierania najnowszej wersji. Upewnij się, że wybrano 64-bitową bibliotekę SAP NetWeaver zgodną z instalacją środowiska Integration Runtime. Następnie zainstaluj wszystkie pliki zawarte w zestawie SAP NetWeaver RFC SDK zgodnie z notatką SAP. Biblioteka SAP NetWeaver jest również zawarta w instalacji narzędzi klienckich SAP.

Napiwek

Aby rozwiązać problem z łącznością z oprogramowaniem SAP BW, upewnij się, że:

  • Wszystkie biblioteki zależności wyodrębnione z zestawu NETWeaver RFC SDK znajdują się w folderze %windir%\system32. Zwykle ma icudt34.dll, icuin34.dll, icuuc34.dll, libicudecnumber.dll, librfc32.dll, libsapucum.dll, sapcrypto.dll, sapcryto_old.dll, sapnwrfc.dll.
  • Wymagane porty używane do nawiązywania połączenia z programem SAP Server są włączone na maszynie własnego środowiska IR, która zazwyczaj jest portem 3300 i 3201.

Wprowadzenie

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

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

Wykonaj poniższe kroki, aby utworzyć połączoną usługę z oprogramowaniem SAP BW 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:

  2. Wyszukaj pozycję SAP i wybierz łącznik SAP BW za pośrednictwem łącznika MDX.

    Select the SAP BW via MDX connector.

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

    Configure a linked service to SAP BW.

szczegóły konfiguracji Połączenie or

Poniższe sekcje zawierają szczegółowe informacje o właściwościach używanych do definiowania jednostek usługi Data Factory specyficznych dla łącznika SAP Business Warehouse.

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

Następujące właściwości są obsługiwane dla połączonej usługi SAP Business Warehouse (BW):

Właściwości Opis Wymagania
type Właściwość type musi być ustawiona na: SapBw Tak
serwer Nazwa serwera, na którym znajduje się wystąpienie sap BW. Tak
systemNumber Numer systemu SAP BW.
Dozwolona wartość: dwucyfrowa liczba dziesiętna reprezentowana jako ciąg.
Tak
clientId Identyfikator klienta klienta w systemie SAP W.
Dozwolona wartość: trzycyfrowa liczba dziesiętna reprezentowana jako ciąg.
Tak
userName Nazwa użytkownika, który ma dostęp do serwera SAP. Tak
hasło Hasło użytkownika. Oznacz to pole jako element SecureString w celu bezpiecznego przechowywania go lub odwołuj się do wpisu tajnego przechowywanego w usłudze Azure Key Vault. Tak
connectVia Środowisko Integration Runtime do nawiązania połączenia z magazynem danych. Środowisko Integration Runtime (Self-hosted) jest wymagane zgodnie z wymaganiami wstępnymi. Tak

Przykład:

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

Właściwości zestawu danych

Pełna lista sekcji i właściwości dostępnych do definiowania zestawów danych znajduje się w artykule dotyczącym zestawów danych. Ta sekcja zawiera listę właściwości obsługiwanych przez zestaw danych SAP BW.

Aby skopiować dane z systemu SAP BW, ustaw właściwość type zestawu danych na SapBwCube. Chociaż nie są obsługiwane żadne właściwości specyficzne dla typu dla zestawu danych SAP BW typu RelationalTable.

Przykład:

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

Jeśli używasz RelationalTable wpisanego zestawu danych, nadal jest on obsługiwany w stanie rzeczywistym, podczas gdy zaleca się korzystanie z nowego zestawu danych w przyszłości.

Właściwości działania kopiowania

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania działań, zobacz artykuł Pipelines (Potoki ). Ta sekcja zawiera listę właściwości obsługiwanych przez źródło sap BW.

SAP BW jako źródło

Aby skopiować dane z oprogramowania SAP BW, w sekcji źródła działania kopiowania są obsługiwane następujące właściwości:

Właściwości Opis Wymagania
type Właściwość type źródła działania kopiowania musi być ustawiona na: SapBwSource Tak
zapytanie Określa zapytanie MDX do odczytywania danych z wystąpienia systemu SAP BW. Tak

Przykład:

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

Jeśli używasz RelationalSource wpisanego źródła, nadal jest obsługiwana w taki sposób, jak jest, podczas gdy sugerowane jest użycie nowego źródła w przyszłości.

Mapowanie typów danych dla systemu SAP BW

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

Typ danych SAP BW Typ danych usługi tymczasowej
ACCP Int
CHAR String
CLNT String
CURR Dziesiętne
CUKY String
DEC Dziesiętne
FLTP Liczba rzeczywista
INT1 Byte
INT2 Int16
INT4 Int
LANG String
LCHR String
LRAW Bajt[]
PREC Int16
QUAN Dziesiętne
RAW Bajt[]
NIEPRZETWORZONE ŚCIĄGNIE Bajt[]
CIĄG String
JEDNOSTKA String
DATS String
NUMC String
TIMS String

Właściwości działania wyszukiwania

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

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