tSAPDSOInputの標準プロパティ - Cloud - 8.0

SAP

Version
Cloud
8.0
Language
日本語
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > ビジネスアプリケーション > SAP
データガバナンス > サードパーティーシステム > ビジネスアプリケーション > SAP
データクオリティとプレパレーション > サードパーティーシステム > ビジネスアプリケーション > SAP
Last publication date
2024-03-07

これらのプロパティは、標準ジョブのフレームワークで実行されているtSAPDSOInputを設定するために使われます。

標準tSAPDSOInputコンポーネントは、ビジネスファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのサブスクリプションベースのTalend製品で使用できます。

注: 「このコンポーネントにはsapjco.jarが必要です」と表示されたら、モジュールをダウンロードし、SAP Java Connectorの手順をご覧ください。

基本設定

[Property Type] (プロパティタイプ)

接続の詳細を設定する方法を選択します。

  • [Built-In] (組み込み): このコンポーネントの接続の詳細がローカルに設定されます。関連するすべての接続のプロパティ値を手動で指定する必要があります。

  • [Repository] (リポジトリー): [Repository] (リポジトリー) > [Metadata] (メタデータ)で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。

    このチェックボックスの横にある [...] ボタンをクリックし、表示された [Repository Content] (リポジトリーのコンテンツ)ダイアログボックスで、再使用する接続の詳細を選択すると、関連するすべての接続のプロパティに値が自動的に入力されます。

[Use an existing connection] (既存の接続を使用)

このチェックボックスをオンにし、表示された[Connection configuration] (接続設定)ドロップダウンリストから、再利用する該当するデータベース接続が設定されているコンポーネントを選択します。

ジョブに親ジョブと子ジョブが含まれている場合、リストには同じジョブレベルの接続コンポーネントだけが表示されます。

[Server Type] (サーバータイプ)

接続するSAPサーバーのタイプ([Application Server] (アプリケーションサーバー)または[Message Server] (メッセージサーバー))を選択します。

[Client] (クライアント)

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

[UserId] (ユーザーID)[Password] (パスワード)

ユーザーの接続IDとパスワード。

パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。

[Language] (言語)

SAPシステムの言語。

[Host name] (ホスト名)

SAPサーバーが実行されているホストの名前またはIPアドレス。

[System number] (システム番号)

SAPのシステム番号。

これらのプロパティは、[Server Type] (サーバータイプ)ドロップダウンリストから、[Application Server] (アプリケーションサーバー)が選択されている場合のみ利用できます。

[System ID] (システムID)

SAPのシステムID。

これらのプロパティは、[Server Type] (サーバータイプ)ドロップダウンリストから、[Message Server] (メッセージサーバー)が選択されている場合のみ利用できます。

[Group Name] (グループ名)

SAPのグループ名。

これらのプロパティは、[Server Type] (サーバータイプ)ドロップダウンリストから、[Message Server] (メッセージサーバー)が選択されている場合のみ利用できます。

[Schema] (スキーマ)[Edit schema] (スキーマを編集)

スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

  • [Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。

  • [Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。変更を加えると、スキーマは自動的に組み込みになります。

  • [View schema] (スキーマを表示): スキーマのみを表示する場合は、このオプションを選択します。

  • [Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。

  • [Update repository connection] (リポジトリー接続をアップデート): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。

    変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、ダイナミックスキーマをご覧ください。

ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。

[Name] (名前)

データを取得するデータストアオブジェクトの名前を入力します。

[Max row number] (最大行数)

取得する行の最大数を指定します。デフォルトでは、値は-1に設定されています。これは、すべての行が取得されることを意味します。

[Filter Group] (フィルターグループ)

取得するデータのフィルタリングに使う検索条件を指定します。[ + ]ボタンをクリックして必要な行数を追加します。各行が検索条件となります。各条件に以下の属性値を設定するために使われます。

  • [Column] (カラム): 取得されたデータをフィルタリングする時のベースとなるスキーマカラムの名前を入力します。

  • [Sign] (記号): ドロップダウンリストから、IncludeまたはExcludeを選択します。

    • Include: 条件を満たすデータが取得されます。

    • Exclude: 条件を満たさないデータが取得されます。

  • [Operator] (演算子): ドロップダウンリストから、検索条件の設定に使うデータフィルター演算子を選択します。

  • [Value] (値): 検索条件の構成に使用する検索値を指定します。ワイルドカード文字はサポートされていません。

  • [High value] (高値): Between演算子の検索条件を構成するために使う別の検索値を指定します。

    日付型のカラムを使用してフィルターを指定する時は、[Value] (値)カラムと[High Value] (高値)カラム内の日付と時刻の値は、yyyyMMddおよびHHMMSSの形式にする必要があります。これは、スキーマエディターで定義した形式とは異なる場合があります。ワイルドカード文字はサポートされていません。

パターンを使用して検索値を指定する時は、以下のワイルドカード文字が使用できます。

  • *: マッチングする文字数に制限はありません。

  • +: 1文字にマッチングします。

  • #: エスケープ文字(*, #など)に、および大文字小文字が区別される完全一致の比較に使用されます。

注: [Operator] (オペレーター)カラムのドロップダウンリストにある[Contains pattern] (パターンを含む)演算子は、将来の拡張のためのものです。

[Specify a shared destination] (共有デスティネーションを指定)

このチェックボックスをオンにして、表示された[Shared destination name] (共有デスティネーションの名前)フィールドに共有デスティネーションを指定します。共有デスティネーションにより、SAPのコンポーネントは、 Talend RuntimeコンテナーOSGi環境内でESBルートまたはESBデータサービスの一部として実行された時に、 Talend Runtimeの共有デスティネーションを使えます。

コンポーネントで共有デスティネーションの名前を指定するだけでなく、 Talend RuntimeのSAP DataSourceを設定する必要もあります。SAP DataSourceを定義するうえで必要なことと、それを設定する方法は、Talend ESBパッケージの/add-ons/datasource/sapフォルダーに含まれているreadme.txtに記載されています。

コンポーネント自体の接続設定を使う場合、SAP接続はコンポーネントの末尾で閉じることになります。これを防ぐには、共有デスティネーションを名前を指定した状態で使ってください。

[Use FTP-Batch Options] (FTPバッチオプションを使用)

取得するデータのサイズが[Fetch size] (フェッチサイズ)フィールドで指定したサイズを上回る場合は、このチェックボックスを選択します。このチェックボックスがオンの場合、SAPシステムは必要な数のファイルを生成し、取得したデータをそれらのファイルに書き込みます。続いて、こコンポーネントがFTP接続を使ってファイルを読み取ってデータを取得し、取得したデータを出力コンポーネントに転送します。

このチェックボックスをオンにする時は、以下のプロパティを指定する必要があります。

  • [File Protocol] (ファイルプロトコル): FTPまたはセキュリティで保護された代替SFTPを選択します。
  • [Host] (ホスト): FTPサーバーのIPアドレスまたはホスト名。

  • [Port] (ポート): FTPサーバーのリスニングポート番号。

  • [User] (ユーザー)[Password] (パスワード): FTPサーバーへのアクセスに必要なユーザー認証データ。

  • [Directory] (ディレクトリー): SAPシステムによって生成されたファイルが保存されるディレクトリー。

  • [Data filename prefix] (データファイル名プレフィックス): SAPシステムによって生成されたファイルのプレフィックス。

詳細設定

[Fetch size] (フェッチサイズ)

BAPI コールやリクエストに応答してSAP BWデータベースから返される結果セットの最大サイズ(行数)を入力します。

デフォルトの値である-1を指定すると、デフォルトのフェッチサイズが使われます。このフェッチサイズはSAP側のJavaコードやBAPIによって決定されます。

ジョブに割り当てられたメモリスペースと、要求されたフィールドの数に応じてこのフィールドを設定することをお勧めします。与えられたメモリスペースにより、要求されたフィールドの数が多ければ多いほどフェッチサイズは小さくなります。

[SAP Properties] (SAPプロパティ)

使用中のSAPシステムでカスタム設定を使用する必要がある場合は、カスタマイズするプロパティをこのテーブルで設定します。例:
  • SAPシステムとTalend Studioの間にUnicode接続を確立するには、jco.server.unicodeプロパティを追加してその値を1に設定する必要があります。これらのプロパティは、SAP Java Connector 2.xを使用している場合に機能します。SAP Java Connector 3.0以降のバージョンでは不要です。

  • セキュリティで保護されたネットワーク通信(SNC)を使用してSAP接続を設定するには、このフィールドに以下のプロパティを追加し、設定する必要があります。

    • jco.client.snc_mode
    • jco.client.snc_myname
    • jco.client.snc_lib=.../sapcrypto/sapcrypto.dll
    • jco.client.snc_partnername
    • jco.client.snc_qop
    注: 上記プロパティの値はシステム環境によって異なります。プロパティの設定方法が不明な場合は、SAPシステムの管理者にお問い合わせください。

    SNCパラメータの設定については、SNC の設定をご覧ください: SNCをサポートするRFC通信パスを使用したAS ABAPへの外部プログラム

これらのプロパティは、[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合は表示されません。

[SAP function extraction path] (SAP関数抽出パス)

このオプションを選択すると、抽出されたデータを保持するファイルを生成するSAP関数のディレクトリーを指定できます。右側のテキストフィールドにディレクトリーへのパスを入力します。

このオプションが選択されていない場合、ファイルは[Basic settings] (基本設定)ビューの[FTP directory] (FTPディレクトリー)フィールドで指定されたディレクトリーに生成されます。

このオプションは、[Basic settings] (基本設定)ビューで[Use FTP-Batch Options] (FTPバッチオプションを使用する)オプションを選択した場合に利用できます。[Basic settings] (基本設定)ビューで[Use the SAP Application Server logical path] (SAP Application Serverの論理パスを使用)チェックボックスを選択した場合、このオプションは利用できません。

Talend Studio[SAP function extraction path] (SAP関数抽出パス)フィールドと[FTP directory] (FTPディレクトリー)フィールドで指定されたディレクトリーを同期しないので、これら2つのフィールドが同じリソースを指していることをご確認ください。

[tStatCatcher Statistics] (tStatCatcher統計)

このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。

グローバル変数

ERROR_MESSAGE

エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。

使用方法

使用ルール

このコンポーネントは、通常、ジョブまたはサブジョブの開始コンポーネントとして使い、常に出力リンクが必要です。

制限事項

Talend StudioおよびTalend Studioをホストしているワークステーションに、SAPから提供された特定のJARファイルとDLLファイルを追加する必要があります。正確な手順は、32ビットまたは64ビットのWindowsやLinuxなど、使用しているプラットフォームで異なります。

現在、DSO自体のフィールドのみを抽出できます。ナビゲーション属性の抽出はサポートされていません。