tSAPDSOInput標準プロパティ - 7.3

SAP

Version
7.3
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 Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > ビジネスアプリケーション > SAP
データガバナンス > サードパーティーシステム > ビジネスアプリケーション > SAP
データクオリティとプレパレーション > サードパーティーシステム > ビジネスアプリケーション > SAP

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

Standard tSAPDSOInputコンポーネントはビジネスファミリーのコンポーネントです。

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

注: このコンポーネントにはsapjco.jarが必要であるという指示が表示されたら、それに従ってモジュールをダウンロードしてインストールします。

基本設定

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

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

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

  • [Repository] (リポジトリー): [Repository] (リポジトリー) > [Metadata] (メタデータ)で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。このチェックボックスのとなりにある [...] ボタンをクリックし、表示された [Repository Content] (リポジトリーの内容)ダイアログボックスで、再使用する接続の詳細を選択すると、関連するすべての接続のプロパティに値が自動的に入力されます。

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

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

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

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

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

クライアント

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] (リポジトリーのコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

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

このダイナミックスキーマ機能は、テーブルの不明なカラムを取得する目的で設計されており、この目的に限り使用をお勧めします。テーブルの作成で使用することは勧められていません。

[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] (フェッチサイズ)

SAP BWデータベースとの1回の通信ステップで送信されるresultsetデータの量を指定するフェッチサイズ(KB単位)を入力します。

[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バッチオプションを使用する)オプションを選択した場合に使用できます。

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

注: このオプションは、TalendのR2021-01以降のStudio月次アップデートをインストールした場合のみ利用できます。詳細は管理者にお問い合わせください。

[tStatCatcher Statistics] (tStatCatcher統計)

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

グローバル変数

ERROR_MESSAGE

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

使用方法

使用ルール

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

制限事項

SAPから提供された特定のjarファイルとdllファイルを、StudioおよびStudioをホストしているワークステーションに追加する必要があります。正確な手順は、32ビットまたは64ビットのWindowsやLinuxなど、使用しているプラットフォームで異なります。
  • 詳細は、『Talend Studioユーザーガイド』の「SAP Java Connectorのインストール方法」と「SAPメタデータの一元管理」を参照してください。

  • SAP Javaコネクターのインストール方法の例は、Talend Help Center (https://help.talend.com)および、『Talend Studioユーザーガイド』の「SAPメタデータの一元管理」を参照してください。

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