IMPORT SAP 命令

通过使用 Direct Link 从 SAP 系统导入数据来创建 Analytics 表。

说明

IMPORT SAP 命令仅当在您的本地计算机和您组织的 SAP 系统上安装并配置 Direct Link 后才会被支持。

语法

IMPORT SAP PASSWORD 数字 TO 表名称 SAP SOURCE "SAP AGENT" 导入明细

参数

名称 描述
PASSWORD 数字

要使用的密码定义。

您不使用 PASSWORD 数字提示用户提供或者指定实际密码。密码定义是指先前使用 PASSWORD 命令、SET PASSWORD 命令或 PASSWORD 分析标记提供或设置的密码。

数字是密码定义的编号。例如,如果之前已在脚本中或在调度分析脚本时提供或设置了两个密码,则 PASSWORD 2 指定使用密码 #2。

有关提供或设置密码的详细信息,请参阅:

说明

密码被用来访问 SAP 系统。

TO 表名

数据要导入到的 Analytics 表的名称。

说明

表名称被限制为不超过 64 个字母数字字符。该名称可以包括下划线字符 ( _ ),但不能包括其他特殊字符或任何空格。该名称不能以数字开头。

SAP SOURCE "SAP AGENT"

为导入 SAP 数据所必须。“SAP AGENT” 是唯一可用选项。

导入详细信息

该查询的详细信息。必须使用 <q></q> 标记将其引起来,并使用 Direct Link 查询标记 中列出的标记来定义该查询。

该参数的物理大小最大可为 16 KB。

示例

执行多表查询

以下示例使用 IMPORT SAP 命令执行多表查询。

标记具有正确的顺序和嵌套关系是创建有效查询字符串的必要条件。该示例中的标记被正确地排序和嵌套。请使用该示例来确定 IMPORT SAP 查询标记所必须的顺序和嵌套。

说明

为了提高可读性,该示例使用了多行格式。在您的脚本中输入命令和查询字符串时,不得输入任何换行符。

提示

IMPORT SAP 查询字符串的语法通常比较复杂。向您的脚本添加带有查询字符串的 IMPORT SAP 命令的最佳方法是:从 Analytics 中的日志选项卡复制一个现有的 IMPORT SAP 命令,然后根据需要编辑查询标记。

IMPORT SAP PASSWORD 1 TO Purchasing_doc SAP SOURCE "SAP AGENT"
<q version="6.0">
  <s>0</s>
  <d>IDES</d>
  <u>mzunini</u>
  <c>800</c>
  <lg>en</lg>
  <cf>C:\ACL Data\Purchasing_doc.fil</cf>
  <sf>E:\Data\DL_JSMITH111107.DAT</sf>
  <jcount>11110701</jcount>
  <jname>DL_JSMITH111107.DAT</jname>
  <dl>75</dl>
  <m>2</m>
  <dt>20140321</dt>
  <tm>033000</tm>
  <r>500</r>
  <ar>0</ar>
  <e>500</e>
  <ts>
    <t>
      <n>EKKO</n>
      <a>T00001</a>
      <td>采购凭证标题</td>
      <fs>
        <f>EBELN</f>
        <f>BUKRS</f>
        <f>BSTYP</f>
        <f>BSART</f>
        <f>STATU</f>
        <f>WKURS</f>
      </fs>
      <wc>
        <w>
           <f>BUKRS</f>
           <o>0</o>
           <l>1000</l>
           <h></h>
        </w>
      </wc>
    </t>
    <t>
      <n>EKPO</n>
      <a>T00002</a>
      <td>采购凭证条目</td>
      <fs>
        <f>EBELP</f>
        <f>WERKS</f>
        <f>MENGE</f>
        <f>BRTWR</f>
      </fs>
      <wc></wc>
    </t>
  </ts>
  <js>
    <jc>
      <pt>
        <pa>T00001</pa>
        <pf>EBELN</pf>
      </pt>
      <ct>
        <ca>T00002</ca>
        <cf>EBELN</cf>
      </ct>
    </jc>
  </js>
</q>

备注

Direct Link 查询标记 中的表列出了可以包括在导入详细信息参数中的标记。必须列使用以下值指明标记何时必须存在:

  • Y 必须
  • N 可选
  • M 仅对多表查询而言是必须的
  • B 必须,但不应传递值
  • W 在使用过滤器时可选
  • S 在指定调度模式时是必须的

Direct Link 查询标记

名称

标记

必须

描述

表别名

<a>

M

在查询中唯一地标识表的别名。这使得同一个表可以被使用多次。

最大长度为 6 个字符。

所有行

<ar>

Y

指明所有匹配行应作为查询结果集的一部分返回。

有效值是:

1 覆盖在 <r> 标记(最大行数)中指定的记录数

0 返回在 <r> 标记(最大行数)中指定的记录数

该标记始终出现在 <r></r> 标记之后。

客户端

<c>

N

SAP 系统中的客户端。

子表别名

<ca>

M

子表的别名。

子表域

<cf>

M

联接条件所基于的子表中的域。

客户端文件名

<cf>

Y

确定用来存储查询结果的客户端系统上的目标文件。

子表

<ct>

M

联接条件中的子表。

目标

<d>

N

在 SAP RFC 库文件 (sapnwrfc.ini) 中标识用于定位 SAP 系统的目标。

数据长度

<dl>

B

每行的字符数量,包括指示记录结尾的回车符和换行符(CR+LF 或十六进制字符 0D+0A)。

日期 <dt> S

在使用调度模式时是必须的。指定运行 SAP 作业的时间。

必须被格式化为 YYYYMMDD。例如,必须将 2014 年 12 月 31 日指定为 20141231。

预期行数

<e>

B

查询将要返回的预期行数。

域名称

<f>

Y

原始域名称。

过滤器域

<f>

W

过滤器应用于的原始域名称。

<fs>

Y

表中将作为查询结果的一部分返回的域列表。

高值

<h>

W

使用 Between 操作符时包含高值。使用任何其他操作符时省略。

联接条件

<jc>

M

联接条件。

作业计数

<jcount>

B

由 SAP 内部用于确定背景模式查询。

作业名称

<jname>

B

由 SAP 内部用于确定背景模式查询。

联接关系

<js>

Y

查询中关联表的联接条件列表。

联接开关 <jw> N

联接开关枚举类型的等效数值。

有效值是:

0 内部联接

1 左外部联接

低值

<l>

W

包含使用 Between 操作符时的最低值或使用任何其他操作符时的值。

语言

<lg>

Y

用于确定 SAP 数据库中域区域设置的语言标识符。

模式

<m>

Y

提交模式枚举类型的等效数值。

有效值是:

0 立即提取

1  后台

2  调度

表名

<n>

Y

原始表名。

运算符

<o>

W

运算符枚举类型的等效数值。

有效值是:

0 等于 (=)

1 不等于 (<>)

2 小于 (<)

3 小于等于 (<=)

4 大于 (>)

5 大于等于 (>=)

6 介于

7 包含

父表别名

<pa>

M

父表的别名。

父表域

<pf>

M

联接条件所基于的父表中的域。

父表

<pt>

M

联接条件中的父表。

查询

<q>

Y

封闭查询。

最大行数

<r>

Y

查询将要返回的最大行数。

选定

<s>

Y

如果 <s> 标记出现在 <f> 标记下方,则指示该字段是否作为查询结果集的一部分返回。

系统

<s>

Y

如果 <s> 标记出现在 <q> 标记的下方,它标识该查询要应用到的系统类型(目前仅支持 SAP)。

服务器文件名

<sf>

B

确定服务器上用于容纳背景模式查询结果的文件。

服务器组名称 <sg> N 服务器组的名称。最多 20 个字符。
服务器名称 <sn> N 服务器的名称。最多 20 个字符。

<t>

Y

表。

表描述

<td>

Y

来自 SAP 数据词典的表描述。它应该始终出现在 <a> 标记的下方。

时间 <tm> S

在使用调度模式时是必须的。指定运行 SAP 作业的时间。

必须被格式化为 hhmmss。例如,必须将下午 2:30 指定为 143000。

<ts>

Y

查询将从其提取数据的表的列表。

表类型 <tt> Y

SAP 表的类型。

有效值是:

0 群集

1 透明

2 汇集

3  视图

用户名

<u>

N

用户的登录名。

筛选

<w>

W

被应用于表数据的过滤器。

过滤器

<wc>

W

应用于表中所含数据的过滤器的列表。

过滤器开关 <ws> N

过滤器开关枚举类型的等效数值。

有效值是:

0 (或)与(或)

1 (与) 或 (与)