跳转至

Extractors(提取器(Extractors))

The Palantir Foundry Connector 2.0 for SAP Applications ("Connector") supports data ingestion via multiple extraction interfaces called SAP extractors. They were originally designed to extract data from the SAP operational system to SAP Business Warehouse (BW).

There are 3 types of extractors:

  • Business content extractors are standard and pre-delivered by SAP for various application components such as FI, CO, LO Cockpit, and more. They are not activated by default in the source system and need to be activated via the RSA5 transaction code before use.
  • Customer generated extractors are typically generated based on customer implementation and configuration settings.
  • Generic extractors are highly customizable. Each customer can generate its own extraction logic based on database tables/views, info sets and function modules. These extractors are highly customizable and extraction logic is controlled by the customer.

:::callout{theme="neutral"} The Connector can only use ODP-enabled extractors. The complete "ODP Data Replication API 2.0" is available with the following Support Packages (SP) for the applicable component (PI_BASIS, SAP_BW, or DW4CORE) in reference to SAP Note 1931427 - ODP Data Replication API 2.0. Ensure the following prerequisites are met:

  • PI_BASIS 730 SP 14 (part of SAP NetWeaver 7.30 SP 14)+
  • PI_BASIS 731 SP 16 (part of SAP NetWeaver 7.03 SP 16 and 7.31 SP 16)+
  • PI_BASIS 740 SP 11 (part of SAP NetWeaver 7.40 SP 11)+
  • SAP_BW 750 SP 0 (incl. former PI_BASIS packages)+
  • DW4CORE 100 SP 0 (incl. former PI_BASIS packages)+
  • DW4CORE 200 SP 0 (incl. former PI_BASIS packages)+ :::

:::callout{theme="neutral"} For authorizations in the source system where ODP enabled extractors reside, refer to SAP Note 2855052 - Authorizations required for ODP Data Replication API 2.0. The Connector also has a separate role for extractors: assign the /PALANTIR/CONTENT_EXT_ALL authorization role to the Foundry technical user. :::

Configuration of extractors

From a single source system (Connector releases older than v2.20.0 (< SP20))

  • Create an RFC Connection from the Connector to the SAP Source system where the extractors reside.
  • Use the /n/palantir/param transaction to maintain the following parameters:
  • RFC parameters
    • Param ID: EXTRACTOR
    • Param Name: RFC_CONFIGURATION
    • Param Value: <RFC connection name>
  • Context configuration
    • Param ID: EXTRACTOR
    • Param Name: CONTEXT_CONFIGURATION
    • Param Value: SAPI

From multiple source systems (Connector releases v2.20.0 or newer (>= SP20))

As of SP20 of the Connector, it is possible to extract data from multiple source systems, also known as "contexts".

To configure multiple contexts, follow these steps:

  • Run the /PALANTIR/PARAM_E1 transaction and define each context:
  • Extractor ID: <Source System ID>
  • Description: <Description of Source System>
  • Run the /PALANTIR/PARAM_E2 transaction and define each context parameter:
  • Extractor ID: <Context ID>
  • Param ID: <Connector parameter ID>
  • Param Name: <Connector parameter name>
  • Param Value: <Parameter Value>

:::callout{theme="neutral"} RFC and SOURCE parameters are multi-context specific; other extractor parameters are standard Connector parameters. :::

  • One of the contexts can be set as a default. In such a case, the Connector will use the default context if the context information is not specified from Foundry. To define a default context, run the /PALANTIR/PARAM transaction using the following parameter values:
  • Param ID: EXTRACTOR
  • Param Name: DEFAULT_CONFIGURATION
  • Param Value: <EXTRACTOR ID>

Using extractors


中文翻译


提取器(Extractors)

Palantir Foundry SAP应用连接器2.0(以下简称"连接器")支持通过多种称为SAP提取器(SAP extractors)的提取接口进行数据摄取。这些提取器最初设计用于从SAP运营系统向SAP业务仓库(BW)提取数据。

提取器分为3种类型:

  • 业务内容提取器(Business content extractors):由SAP针对各类应用组件(如FI、CO、LO Cockpit等)提供的标准预置提取器。这些提取器在源系统中默认未激活,需通过RSA5事务代码激活后方可使用。
  • 客户生成提取器(Customer generated extractors):通常根据客户实施和配置设置生成。
  • 通用提取器(Generic extractors):高度可定制。每位客户均可基于数据库表/视图、信息集和功能模块生成自己的提取逻辑。这些提取器具有高度可定制性,提取逻辑由客户控制。

:::callout{theme="neutral"} 连接器仅能使用支持ODP的提取器。完整的"ODP数据复制API 2.0"需在适用组件(PI_BASIS、SAP_BW或DW4CORE)的以下支持包(SP)中可用,具体参考SAP注释1931427 - ODP数据复制API 2.0。请确保满足以下前提条件:

  • PI_BASIS 730 SP 14(SAP NetWeaver 7.30 SP 14的一部分)及以上版本
  • PI_BASIS 731 SP 16(SAP NetWeaver 7.03 SP 16和7.31 SP 16的一部分)及以上版本
  • PI_BASIS 740 SP 11(SAP NetWeaver 7.40 SP 11的一部分)及以上版本
  • SAP_BW 750 SP 0(包含之前的PI_BASIS包)及以上版本
  • DW4CORE 100 SP 0(包含之前的PI_BASIS包)及以上版本
  • DW4CORE 200 SP 0(包含之前的PI_BASIS包)及以上版本 :::

:::callout{theme="neutral"} 关于ODP启用提取器所在源系统的授权,请参考SAP注释2855052 - ODP数据复制API 2.0所需的授权。 连接器还为提取器设有独立角色:请将/PALANTIR/CONTENT_EXT_ALL授权角色分配给Foundry技术用户。 :::

提取器配置

从单一源系统(连接器版本低于v2.20.0(< SP20))

  • 从连接器到提取器所在的SAP源系统创建RFC连接。
  • 使用/n/palantir/param事务维护以下参数:
  • RFC参数
    • 参数ID: EXTRACTOR
    • 参数名称: RFC_CONFIGURATION
    • 参数值: <RFC连接名称>
  • 上下文配置
    • 参数ID: EXTRACTOR
    • 参数名称: CONTEXT_CONFIGURATION
    • 参数值: SAPI

从多个源系统(连接器版本v2.20.0或更新版本(>= SP20))

自连接器SP20版本起,可从多个源系统(也称为"上下文")提取数据。

要配置多个上下文,请按以下步骤操作:

  • 运行/PALANTIR/PARAM_E1事务并定义每个上下文:
  • 提取器ID: <源系统ID>
  • 描述: <源系统描述>
  • 运行/PALANTIR/PARAM_E2事务并定义每个上下文参数:
  • 提取器ID: <上下文ID>
  • 参数ID: <连接器参数ID>
  • 参数名称: <连接器参数名称>
  • 参数值: <参数值>

:::callout{theme="neutral"} RFC和SOURCE参数为多上下文专用参数;其他提取器参数为标准连接器参数。 :::

  • 可将其中一个上下文设置为默认上下文。在这种情况下,如果未从Foundry指定上下文信息,连接器将使用默认上下文。要定义默认上下文,请使用以下参数值运行/PALANTIR/PARAM事务:
  • 参数ID: EXTRACTOR
  • 参数名称: DEFAULT_CONFIGURATION
  • 参数值: <提取器ID>

使用提取器