IMPORT SAP コマンド

Direct Link を使用して、SAP システムからデータをインポートし、Analytics テーブルを作成します。

構文

IMPORT SAP PASSWORD 番号 TO テーブル名 SAP SOURCE "SAP AGENT" インポートの詳細

パラメーター

名前 説明
PASSWORD 番号

使用するパスワード定義。

実際のパスワードを入力することを求めたり指定したりするのには、PASSWORD 番号の構文は使用しません。 パスワード定義とは、以前に PASSWORD コマンドか SET PASSWORD コマンドを使用して入力または設定されたパスワードのことです。

番号はパスワード定義の番号です。 たとえば、以前に 2 つのパスワードをスクリプトで設定したり入力したりしている場合には、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>

備考

IMPORT SAP コマンドは、Direct Link がインストールおよび設定されている場合にのみサポートされます。

Direct Link クエリ タグに記載されているテーブルには、import_details パラメーターに指定できるタグの一覧が示されています。 必須列では、以下の値を使用して、各タグの指定がどのような場合に必須であるかが示されています。

  • Y 必須
  • N オプション
  • M 複数テーブルのクエリの場合のみ必須
  • B 必須。ただし、値を渡すことはできません
  • W フィルターを利用する場合のオプション
  • S スケジュール モードが指定されるときに必須

Direct Link クエリ タグ

名前

タグ

必須

説明

テーブル別名

<a>

M

クエリ内で一意にテーブルを識別する別名。 これにより、同じテーブルを 2 回以上使用できるようになります。

6 文字を上限とします。

すべての行

<ar>

Y

すべての一致する行がクエリの結果セットの一部として返されることを示します。

有効な値は次のとおりです。

1 <r> タグで指定されたレコード数を上書きします（最大行）

0 <r> タグで指定されたレコード数を返します（最大行）

このタグは、常に <r></r> タグの後に指定します。

クライアント

<c>

N

SAP システム内のクライアント。

子テーブル別名

<ca>

M

子テーブルの別名。

子テーブル フィールド

<cf>

M

結合条件に基づく子テーブル内のフィールド。

クライアント ファイル名

<cf>

Y

クエリの結果が格納されるクライアント システム上のターゲット ファイルを識別します。

子テーブル

<ct>

M

結合条件の子テーブル。

宛先

<d>

N

SAP システムを特定するために使用する、SAP RFC ライブラリ ファイル（saprfc.ini）内の宛先を指定します。

データ長

<dl>

B

各行内の文字の数。これには、レコードの終わりを示すキャリッジ リターン文字とライン フィード文字（CR+LF、つまり 16 進数の文字 0D+0A）が含まれます。
日付 <dt> S

スケジュール モードを使用するときに必須です。 SAP ジョブを実行する時間を指定します。

YYYYMMDD の形式である必要があります。 たとえば、2014 年 12 月 31 日は、20140131 と指定する必要があります。

予想される行数

<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 pm は 143000 と指定する必要があります。

テーブル

<ts>

Y

クエリがデータを抽出するテーブルの一覧。
テーブル タイプ <tt> Y

SAP テーブルのタイプ。

有効な値は次のとおりです。

0 クラスター

1 透明

2 プール

3 ビュー

ユーザー名

<u>

N

ユーザーのログオン名。

フィルター

<w>

W

テーブルのデータに適用されるフィルター。

フィルター

<wc>

W

テーブル内に含まれるデータに適用されるフィルターの一覧。
フィルター切り替え <ws> N

フィルター切り替え列挙型に等価な数値。

有効な値は次のとおりです。

0 (Or) および (Or)

1 (And) または (And)