使用 Azure Data Factory 或 Azure Synapse Analytics 從 SAP 資料表複製資料

適用於：Azure Data Factory Azure Synapse Analytics

本文概述如何使用 Azure Data Factory 和 Azure Synapse Analytics 管線中的複製活動，從 SAP 資料庫複製資料。 如需詳細資訊，請參閱複製活動概觀。

支援的功能

此 SAP 資料表連接器支援下列功能：

① Azure 整合執行階段 ② 自我裝載整合執行階段

如需複製活動所支援做為來源或接收器的資料存放區清單，請參閱支援的資料存放區資料表。

具體而言，此 SAP 資料表連接器支援：

• 在下列位置從 SAP 資料表複製資料：

  • SAP ERP Central Component (SAP ECC) 7.01 版或更新版本 (在 2015 年之後發行的 SAP 支援套件堆疊)。
  • SAP Business Warehouse (SAP BW) 7.01 版或更新版本 (位於 2015 年之後發行的最新 SAP 支援套件堆疊中)。
  • SAP S/4HANA。
  • SAP Business Suite 7.01 版或更新版本中的其他產品 (位於 2015 年之後發行的最新 SAP 支援套件堆疊中)。

• 從 SAP 透明資料表、集區資料表、叢集資料表和檢視複製資料。

• 如果已設定 SNC，請使用基本驗證或安全網路通訊 (SNC) 來複製資料。

• 連線至 SAP 應用程式伺服器或 SAP 訊息伺服器。

• 透過預設或自訂 RFC 擷取資料。

7.01 版或更新版本是指 SAP NetWeaver 版本，而不是 SAP ECC 版本。 例如，SAP ECC 6.0 EHP 7 一般具有 NetWeaver > =7.4 版。 如果您不確定您的環境，以下步驟可供您確認 SAP 系統的版本：

1. 使用 SAP GUI 連線到 SAP 系統。
2. 移至 [系統] ->[狀態]。
3. 請檢查 SAP_BASIS 的版本，確定其等於或大於 701。
   

必要條件

若要使用此 SAP 資料表連接器，您必須：

• 設定自我裝載整合執行階段 (3.17 版或更新版本)。 如需詳細資訊，請參閱建立和設定自我裝載整合執行階段。

• 從 SAP 的網站下載 64 位元 SAP Connector for Microsoft .NET 3.0，並將其安裝在自我裝載整合執行階段機器上。 在安裝期間，請務必在 [選擇性安裝步驟] 視窗中選取 [將組件安裝至 GAC] 選項。

  

• 在 SAP 資料表連接器中使用的 SAP 使用者必須具有下列權限：

  • 使用遠端函式呼叫 (RFC) 目的地的授權。
  • 「執行」S_SDSAUTH 授權物件活動的權限。 您可以在多數授權物件上參考 SAP 附註 460089。 基礎 NCo 連接器需要某些 RFC，例如 RFC_FUNCTION_SEARCH。

開始使用

若要透過管線執行複製活動，您可以使用下列其中一個工具或 SDK：

• 資料複製工具
• Azure 入口網站
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure Resource Manager 範本

使用 UI 建立 SAP 資料表的連結服務

使用下列步驟，在 Azure 入口網站 UI 中建立連結至 SAP 資料表的服務。

1. 前往 Azure Data Factory 或 Synapse 工作區的 [管理] 索引標籤，選取 [連結服務]，然後按一下 [新增]：

   • Azure Data Factory
   • Azure Synapse

   

2. 搜尋 SAP 並選取 SAP 資料表連接器。

   

3. 設定服務詳細資料，測試連線，然後建立新的連結服務。

   

連接器設定詳細資料

下列各節將針對用來定義 SAP 資料表連接器特定實體的屬性提供相關詳細資料。

連結服務屬性

SAP BW Open Hub 連結服務支援下列屬性：

範例 1：連線到 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"
        }
    }
}

範例 2：連線到 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"
        }
    }
}

範例 3：使用 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"
        }
    }
}

資料集屬性

如需用於定義資料集的區段和屬性完整清單，請參閱資料集。 下列小節提供 SAP 資料表資料集所支援的屬性清單。

若要從 SAP BW Open Hub 連結服務複製資料或將資料複製到 SAP BW Open Hub 連結服務，支援下列屬性：

範例

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

複製活動屬性

如需用來定義活動的區段和屬性完整清單，請參閱管線。 下列小節提供 SAP 資料表來源所支援的屬性清單。

SAP 資料表即來源

若要從 SAP 資料表複製資料，以下是支援的屬性：

在 rfcTableOptions 中，您可以使用下列常見的 SAP 查詢運算子來篩選資料列：

範例

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

聯結 SAP 資料表

目前 SAP 資料表連接器僅支援一個具有預設函式模組的單一資料表。 若要取得多個資料表的聯結資料，您可以遵循下列步驟，利用 SAP 資料表連接器中的 customRfcReadTableFunctionModule 屬性：

• 撰寫自訂函式模組，其可將查詢當作 OPTIONS，並套用您自己的邏輯來擷取資料。
• 針對 [自訂函式模組]，輸入自訂函式模組的名稱。
• 針對「RFC 資料表選項」，請指定資料表聯結陳述式，以 OPTIONS 的形式饋送至您的函式模組，例如 "<TABLE1> INNER JOIN <TABLE2> ON COLUMN0"。

範例如下：

建立自訂函式模組

針對 SAP 資料表，我們目前支援複製來源中的 customRfcReadTableFunctionModule 屬性，這可讓您利用自己的邏輯和處理資料。

做為快速指引，以下是開始使用「自訂函式模組」的一些需求：

• 定義：

  

• 將資料匯出至下列其中一個資料表：

  

  

以下是 SAP 資料表連接器與自訂函式模組搭配使用方式的圖例：

1. 透過 SAP NCO 建置與 SAP 伺服器的連線。

2. 使用設定如下的參數叫用「自訂函式模組」：

   • QUERY_TABLE：您在 SAP 資料表資料集中所設定資料表的名稱；
   • 分隔符號：您在 SAP 資料表來源中設定的分隔符號；
   • ROWCOUNT/Option/Fields：您在資料表來源中設定的 Rowcount/Aggregated Option/Fields。

3. 取得結果，並以下列方式剖析資料：

   1. 剖析 Fields 資料表中的值以取得結構描述。

      

   2. 取得輸出資料表的值，以查看哪個資料表包含這些值。

      

   3. 取得 OUT_TABLE 中的值、剖析資料，然後將其寫入接收器。

SAP 資料表的資料類型對應

當您從 SAP 資料表複製資料時，從 SAP 資料表資料類型到服務中使用的過渡資料類型會使用下列對應。 若要了解複製活動如何將來源結構描述和資料類型對應至接收，請參閱結構描述和資料類型對應。

查閱活動屬性

若要了解屬性的詳細資料，請參閱查閱活動。

相關內容

如需複製活動支援做為來源和接收器的資料存放區清單，請參閱支援的資料存放區。