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

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Wskazówka

Data Factory w usłudze Microsoft Fabric jest następną generacją Azure Data Factory z prostszą architekturą, wbudowaną sztuczną inteligencją i nowymi funkcjami. Jeśli dopiero zaczynasz integrować dane, zacznij od Fabric Data Factory. Istniejące obciążenia ADF można zaktualizować do Fabric, aby uzyskać dostęp do nowych możliwości w zakresie nauki o danych, analiz w czasie rzeczywistym oraz raportowania.

W tym artykule opisano sposób używania działania kopiowania w Azure Data Factory do kopiowania danych ze składnika SAP Enterprise Central Component (ECC). Aby uzyskać więcej informacji, zobacz Copy activity overview.

Wskazówka

Aby poznać ogólną obsługę scenariusza integracji danych SAP, zobacz informator o integracji danych SAP przy użyciu Azure Data Factory ze szczegółowym wprowadzeniem do każdego łącznika SAP, porównaniem i wskazówkami.

Obsługiwane możliwości

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

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

(1) Środowisko uruchomieniowe Azure (2) Środowisko uruchomieniowe lokalnie hostowane

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

W szczególności ten łącznik SAP ECC obsługuje:

  • Kopiowanie danych z programu SAP ECC w oprogramowaniu SAP NetWeaver w wersji 7.0 lub nowszej.

  • Kopiowanie danych z dowolnych obiektów uwidocznionych przez usługi SAP ECC OData, takie jak:

    • Tabele lub widoki SAP.
    • Obiekty interfejsu programowania aplikacji biznesowych [BAPI].
    • Wyodrębniacze danych.
    • Dane lub dokumenty pośrednie (IDoc), wysyłane do SAP Process Integration (SAP PI), które mogą być odbierane jako OData za pośrednictwem adapterów względnych.
  • Kopiowanie danych przy użyciu uwierzytelniania podstawowego.

Wersja 7.0 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.
    Sprawdzanie SAP_BASIS

Wskazówka

Aby skopiować dane z usługi SAP ECC za pośrednictwem tabeli lub widoku SAP, użyj łącznika tabel SAP, który jest szybszy i bardziej skalowalny.

Wymagania wstępne

Aby użyć tego łącznika SAP ECC, należy udostępnić jednostki SAP ECC za pośrednictwem usług OData poprzez SAP Gateway. W szczególności:

  • Konfigurowanie bramy SAP Gateway. W przypadku serwerów z oprogramowaniem SAP NetWeaver w wersji nowszej niż 7.4 brama SAP Gateway jest już zainstalowana. W przypadku wcześniejszych wersji należy zainstalować wbudowaną bramę SAP Gateway lub system komunikacyjny bramy SAP, przed ujawnieniem danych SAP ECC za pośrednictwem usług OData. Aby skonfigurować usługę SAP Gateway, zobacz przewodnik instalacji.

  • Aktywuj i skonfiguruj usługę SAP OData. Usługę OData można aktywować za pomocą interfejsu SICF TCODE w sekundach. Można również skonfigurować, które obiekty muszą być uwidocznione. Aby uzyskać więcej informacji, zobacz wskazówki krok po kroku.

Jeśli magazyn danych znajduje się wewnątrz sieci lokalnej, sieci wirtualnej Azure lub chmury prywatnej Amazon Virtual, musisz skonfigurować self-hosted Integration Runtime aby nawiązać z nim połączenie.

Jeśli magazyn danych jest zarządzaną usługą danych w chmurze, możesz użyć Azure Integration Runtime. Jeśli dostęp jest ograniczony do adresów IP zatwierdzonych w regułach zapory, możesz dodać adresy IP Azure Integration Runtime do listy dozwolonych.

Możesz również użyć funkcji zarządzanego środowiska wykonawczego zintegrowanej sieci wirtualnej w Azure Data Factory, aby uzyskać dostęp do sieci lokalnej bez instalowania i konfigurowania lokalnego środowiska Integration Runtime.

Aby uzyskać więcej informacji na temat mechanizmów zabezpieczeń sieci i opcji obsługiwanych przez usługę Data Factory, zobacz Strategie dostępu do danych.

Wprowadzenie

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

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

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

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

  2. Wyszukaj SAP i wybierz łącznik SAP ECC.

    Zrzut ekranu przedstawiający łącznik SAP ECC.

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

    Zrzut ekranu konfiguracji połączonej usługi dla SAP ECC.

Szczegóły konfiguracji łącznika

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

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

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

Właściwości Opis Wymagane
type Właściwość type musi być ustawiona na SapEcc. Tak
url Adres URL usługi SAP ECC OData. Tak
username Nazwa użytkownika używana do nawiązywania połączenia z usługą SAP ECC. Nie.
password Hasło w postaci zwykłego tekstu używane do nawiązywania połączenia z usługą SAP ECC. Nie.
connectVia Środowisko Integration Runtime do nawiązania połączenia z magazynem danych. Dowiedz się więcej w sekcji Wymagania wstępne . Jeśli nie określisz środowiska uruchomieniowego, zostanie użyte domyślne środowisko Integration Runtime Azure. Nie.

Przykład

{
    "name": "SapECCLinkedService",
    "properties": {
        "type": "SapEcc",
        "typeProperties": {
            "url": "<SAP ECC OData URL, e.g., http://eccsvrname:8000/sap/opu/odata/sap/zgw100_dd02l_so_srv/>",
            "username": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    },
    "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 dostępnych do definiowania zestawów danych, zobacz Zestawy danych. Poniższa sekcja zawiera listę właściwości obsługiwanych przez zestaw danych SAP ECC.

Aby skopiować dane z SAP ECC, ustaw właściwość type zestawu danych na SapEccResource.

Obsługiwane są następujące właściwości:

Właściwości Opis Wymagane
path Ścieżka encji SAP ECC OData. Tak

Przykład

{
    "name": "SapEccDataset",
    "properties": {
        "type": "SapEccResource",
        "typeProperties": {
            "path": "<entity path, e.g., dd04tentitySet>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP ECC linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Właściwości aktywności kopiowania

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania działań, zobacz Pipelines. Poniższa sekcja zawiera listę właściwości obsługiwanych przez źródło usługi SAP ECC.

SAP ECC jako źródło

pl-PL: Aby skopiować dane z usługi SAP ECC, ustaw type właściwość w source sekcji aktywności kopiowania na SapEccSource.

Następujące właściwości są obsługiwane w sekcji działania kopiowania source :

Właściwości Opis Wymagane
type Właściwość type sekcji działania kopiowania musi być ustawiona source na SapEccSourcewartość . Tak
query Opcje zapytania OData do filtrowania danych. Na przykład:

"$select=Name,Description&$top=10"

Łącznik SAP ECC kopiuje dane z połączonego adresu URL:

<URL specified in the linked service>/<path specified in the dataset>?<query specified in the copy activity's source section>

Aby uzyskać więcej informacji, zobacz Składniki adresu URL OData.
Nie.
sapDataColumnDelimiter Pojedynczy znak, który jest używany jako ogranicznik przekazywany do oprogramowania SAP RFC w celu podzielenia danych wyjściowych. Nie.
httpRequestTimeout Limit czasu ( wartość TimeSpan ) żądania HTTP w celu uzyskania odpowiedzi. Ta wartość to limit czasu pobierania odpowiedzi, a nie limit czasu odczytu danych odpowiedzi. Jeśli nie zostanie określona, wartość domyślna to 00:30:00 (30 minut). Nie.

Przykład

"activities":[
    {
        "name": "CopyFromSAPECC",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP ECC input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapEccSource",
                "query": "$top=10"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Mapowania typów danych dla usługi SAP ECC

Podczas kopiowania danych z usługi SAP ECC następujące mapowania są używane z typów danych OData dla danych SAP ECC do tymczasowych typów danych używanych wewnętrznie przez usługę. Aby dowiedzieć się, jak operacja kopiowania mapuje schemat źródłowy i typ danych na miejsce docelowe, zobacz Mapowanie schematu i typu danych.

Typ danych OData Typ danych usługi tymczasowej
Edm.Binary String
Edm.Boolean Bool
Edm.Byte String
Edm.DateTime DateTime
Edm.Decimal Decimal
Edm.Double Double
Edm.Single Single
Edm.Guid String
Edm.Int16 Int16
Edm.Int32 Int32
Edm.Int64 Int64
Edm.SByte Int16
Edm.String String
Edm.Time TimeSpan
Edm.DateTimeOffset DateTimeOffset

Uwaga

Złożone typy danych nie są obecnie obsługiwane.

Właściwości czynności 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.