tSAPTableInput標準プロパティ - 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ジョブフレームワークで実行されているtSAPTableInputを設定するために使います。

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

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

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

基本設定

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

[Built-In] (組み込み)または[Repository] (リポジトリー)のいずれか。

  • [Built-In] (組み込み): プロパティデータは一元的に保存されません。

  • [Repository] (リポジトリー): プロパティを保存するリポジトリーファイルを選択します。

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

このチェックボックスをオンにして、表示されたリストから、定義済みの接続詳細を再利用する、該当する接続コンポーネントを選択します。

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

[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を避けます。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを使用できます。

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

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

  • [Update repository connection] (リポジトリー接続を更新): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーのコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

[RFC server url] (RFCサーバーのURL)

表示されたフィールドにRFCサーバーの詳細を入力します。

Studioは、RFCサーバーをストリーミングプロキシとして使い、FTPやSFTPなどのサードパーティの転送プロトコルに情報を保存する必要なく、大量のデータ抽出をサポートします。

このフィールドは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使う)を選択すると表示されます。

[Package size] (パッケージサイズ)

各パッケージのレコード数を指定します。デフォルトでは、値は10000を表示します。

10000より大きい値(12000など)の場合、Studioは2つのパッケージを作成します。1つのパッケージは10000レコードを含み、もう1つのパッケージは2000レコードを含みます。

このフィールドは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使う)を選択すると表示されます。

[Connection id] (接続ID)

SAP接続設定ファイル(拡張子を除く)の名前である、SAP RFCサーバーによって確立された接続のIDを入力します。

SAP RFCサーバーは、SAP設定ファイルに基づいて、複数のSAP接続を確立できます。デフォルトでSAP接続設定ファイルは、 $TSAPS_HOMETalend SAP RFC Serverのインストールされたディレクトリーである$TSAPS_HOME/conf/named-connectiondに保管されています。デフォルトディレクトリー内に目的のSAP接続設定ファイルが見つからない場合は、tsap-rfc-server.propertiesファイルでnamed.connectionsパラメーターによって指定されるディレクトリーをチェックしてください。

このフィールドは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使用)が選択されている時に使用できます。

注:
  • このフィールドは、TalendのR2021-08以降のStudio月次アップデートをインストールした場合のみ利用できます。詳細は管理者にお問い合わせください。
  • $TSAPS_HOME/conf/named-connectiondディレクトリー、named.connectionsパラメーター、SAP接続設定ファイルは、Patch_20210820_TDI-45536_v1-7.3.1を適用した場合のみ有効です。

[Number of threads to extract the data from SAP] (SAPからデータを抽出するスレッド数)

データ抽出のスレッド数を設定します。デフォルトは2です。

このオプションは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使用)オプションを選択している場合に利用できます。

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

[Kafka topic partition count] (Kafkaトピックパーティション数)

Kafkaトピックのパーティション数を設定します。デフォルトは2です。

このオプションは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使用)オプションを選択している場合に利用できます。

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

[Max time to wait for more data] (続きのデータを待機する最大時間)

エラー発生時にクライアントがKafkaトピックの続きのデータを待機する最大時間(秒)を設定します。指定した期間が過ぎてもデータの受信がない場合、ストリームはキャンセルされます。デフォルトは60です。

このオプションは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使用)オプションを選択している場合に利用できます。

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

[Table] (テーブル)

データが取得されるテーブルの名前を入力します。

[Filter] (フィルター)

二重引用符の間にフィルター条件を入力します。コンポーネントは、この条件に基づいてデータを読み取ります。

カラムの値は一重引用符で囲む必要があり、フィルター式の等号(=)の前後には空白スペースが必要です。たとえば、次のとおりです: "MANDT = '800' AND WAERK = 'EUR' OR (FKART = 'F2' AND VBELN = '0090038989')"

[Start row number] (開始行番号)

データの取得を開始する行のシーケンス番号を指定します。SAPテーブルの行のシーケンス番号は0から始まります。

このフィールドのデフォルト値は-1です。これは、指定されたテーブルのすべての行を読み取ることを意味します。

[Max row number] (最大行数)

データを取得する行の最大数を指定します。

このフィールドのデフォルト値は-1です。これは、フィルター条件を満たすすべての行を取得することを意味します。

[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 the RFC server (Technical Preview)] (RFCサーバーを使う(テクニカルプレビュー)) SAPアプリケーションから大量のデータを直接抽出する場合は、このチェックボックスをオンにします。このオプションを選択すると、[接続設定]セクションに[RFC server url] (RFCサーバーのURL)[Package size] (パッケージサイズ)のフィールドが表示されます。詳細については、[Basic settings] (基本設定) ビューでこれらのフィールドの対応する説明を参照してください。

[Read NUMC data as String in the dynamic column] (ダイナミックカラムでNUMCデータを文字列として読み取る)

このオプションを選択して、ダイナミックカラム内のNUMCタイプであるデータを文字列として扱います。

このオプションが選択されていない場合は、ダイナミックカラム内のNUMCタイプであるデータは整数として扱われます。

注: このオプションは、TalendのR2021-08以降のStudio月次アップデートをインストールした時のみ利用できます。詳細は管理者にお問い合わせください。
[Kafka Properties] (Kafkaのプロパティ) [Use the RFC server] (RFCサーバーを使う)オプションを選択すると、ウィンドウにKafkaプロパティテーブルが表示されます。Kafka、またはApache Kafkaは、オープンソースの分散ストリーミングプラットフォームです。Kafkaの詳細については、https://kafka.apache.org/を参照してください。

表示されたフィールドにKafkaの情報を入力します。

[Set max length for variable length type when api.use_z_talend_read_table parameter is true] (api.use_z_talend_read_tableパラメーターがTrueの時に変数長タイプの最大長を設定)

SAPデータディクショナリーで任意の文字列および文字列タイプフィールドの長さが0に設定されている場合は、このチェックボックスを選択して、表示される[Max length] (最大長)フィールドで、文字列フィールドおよび文字列タイプフィールドで取得するデータの最大長を指定する必要があります。次の点にご注意ください。

  • このチェックボックスは、SAP接続プロパティの値api.use_z_talend_read_tabletrueに設定されている場合にのみ利用できます。

  • この最大長は、文字列および文字列タイプのすべてのフィールドに適用されます。データの損失を回避するために、値を慎重に決定してください。

[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] (既存の接続を使用)チェックボックスがオンの場合には表示されません。

[tStatCatcher Statistics] (tStatCatcher統計)

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

グローバル変数

[Global Variables] (グローバル変数)

ERROR_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、Die on error (エラー時強制終了)がオフになっている場合にのみ機能します。

Flow変数はコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。

フィールドまたは式に変数を入れるには、Ctrl + Spaceを押して変数リストにアクセスし、リストから使用する変数を選択します。

変数の詳細は、『 Talend Studio ユーザーガイド』を参照してください。

使用方法

使用ルール

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

サポート

S4/HANAを含め、SAPのERP部分と連携するためにtSAPTableInputを使う必要があります。

[Connections] (接続)

外部リンク(このコンポーネントから別のコンポーネントへのリンク):

[Row] (行): [Main] (メイン)、[Iterate] (反復処理)

[Trigger] (トリガー): [On Subjob Ok] (サブジョブがOKの場合)、[On Subjob Error] (サブジョブがエラーの場合)、[Run if] (条件付き実行)、[On Component Ok] ( コンポーネントがOKの場合)、[On Component Error] (コンポーネントがエラーの場合)

受信リンク(あるコンポーネントからこのコンポーネントへのリンク):

[Trigger] (トリガー): [On Subjob Ok] (サブジョブがOKの場合)、[On Subjob Error] (サブジョブがエラーの場合)、[Run if] (条件付き実行)、[On Component Ok] ( コンポーネントがOKの場合)、[On Component Error] (コンポーネントがエラーの場合)

接続の詳細は、 Talend Studioユーザーガイドを参照してください。

制限事項/前提条件

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メタデータの一元管理」を参照してください。