tSAPTableInputの標準プロパティ
これらのプロパティは、標準ジョブのフレームワークで実行されているtSAPTableInputを設定するために使われます。
標準のtSAPTableInputコンポーネントは、ビジネスファミリーに属しています。
このフレームワーク内のコンポーネントは、すべてのサブスクリプションベースのTalend製品で使用できます。
基本設定
| [Property Type] (プロパティタイプ) |
[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つのオプションを利用できます。
|
| Table | データの取得元であるテーブルか SAP CDSビューの名前を入力します。 [Use existing dynamic schema] (既存のダイナミックスキーマを使用)オプションを選択した場合、このオプションは利用できません。 |
| CDSビュー | SAP CDSビューからデータを取得するためには、このオプションを選択します。 SAP CDSビューのパラメーターは、[CDS View parameters] (CDSビューのパラメーター)テーブルで設定します。CDSビューのパラメーターを設定するためには、テーブルの下部にあるプラスボタンをクリックしてテーブルに行を追加し、その行の[Parameter] (パラメーター)カラムにそのパラメーター名を、[Value] (値)カラムにパラメーター値をそれぞれ入力します。 このオプションは、[Basic settings] (基本設定)ビューで[Use existing dynamic schema] (既存のダイナミックスキーマを使用)が、または[Advanced settings] (詳細設定)ビューで[Use RFC server] (RFCサーバーを使用)が選択されている場合は利用できません。 情報メモ注:
|
| [RFC server url] (RFCサーバーのURL) |
表示されたフィールドにRFCサーバーの詳細を入力します。 Talend Studioは、RFCサーバーをストリーミングプロキシとして使い、FTPやSFTPなどのサードパーティの転送プロトコルに情報を保存する必要なく、大量のデータ抽出をサポートします。 このフィールドは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使う)を選択すると表示されます。 |
| [Package size] (パッケージサイズ) |
各パッケージのレコード数を指定します。デフォルトでは、値は10000を表示します。 10000を超える値(たとえば12000)を指定した場合、Talend Studioは2つのパッケージを作成します: その1つには10000レコードが含まれ、もう1つには2000レコードが含まれます。 このフィールドは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使う)を選択すると表示されます。 |
| [Connection id] (接続ID) | SAP接続設定ファイル(拡張子を除く)の名前である、Talend SAP RFC Serverによって確立された接続のIDを入力します。 SAP RFCサーバーは、SAP設定ファイルに基づいて、複数のSAP接続を確立できます。デフォルトでSAP接続設定ファイルは、 $TSAPS_HOMEがTalend SAP RFC Serverのインストールされたディレクトリーである$TSAPS_HOME/conf/named-connectiondに保管されています。デフォルトディレクトリー内に目的のSAP接続設定ファイルが見つからない場合は、tsap-rfc-server.propertiesファイルでnamed.connectionsパラメーターによって指定されているディレクトリーをチェックしてください。 このフィールドは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使用)が選択されている時に利用できます。 |
| [Number of threads to extract the data from SAP] (SAPからデータを抽出するスレッド数) | データ抽出のスレッド数を設定するために使われます。デフォルトは2です。 このオプションは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使用)オプションを選択している場合に利用できます。 |
| [Kafka topic partition count] (Kafkaトピックパーティション数) | Kafkaトピックのパーティション数を設定するために使われます。デフォルトは2です。 このオプションは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使用)オプションを選択している場合に利用できます。 |
| [Max time to wait for more data] (追加データを待機する最大時間) | エラー発生時にクライアントがKafkaトピックの追加データを待機する最大時間(秒)を設定するために使われます。指定した期間が過ぎてもデータの受信がない場合、ストリームはキャンセルされます。デフォルトは60です。 このオプションは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使用)オプションを選択している場合に利用できます。 |
| [From statement] (ステートメントから) | データをクエリーするSQLステートメント(通常はSQL FROM句か単一テーブルの名前)を入力します。 情報メモ注:
|
| [Use existing dynamic schema] (既存のダイナミックスキーマを使用) | tSetDynamicSchemaコンポーネントによって生成されたダイナミックスキーマを使用する場合は、このオプションを選択します。このダイナミックスキーマは、[Dynamic schema] (ダイナミックスキーマ)ドロップダウンリストからtSetDynamicSchemaコンポーネントを選択すれば選択できます。 情報メモ注:
|
| [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 FTP-Batch Options] (FTPバッチオプションを使用) | 取得するデータのサイズが[Fetch size] (フェッチサイズ)フィールドで指定したサイズを上回る場合は、このチェックボックスを選択します。このチェックボックスがオンの場合、SAPシステムは必要な数のファイルを生成し、取得したデータをそれらのファイルに書き込みます。続いて、こコンポーネントがFTP接続を使ってファイルを読み取ってデータを取得し、取得したデータを出力コンポーネントに転送します。 このチェックボックスをオンにする時は、以下のプロパティを指定する必要があります。
このオプションは、[Advanced settings] (詳細設定)ビューで[Use the RFC server] (RFCサーバーを使用)オプションが選択されていない場合のみ利用できます。 情報メモ注: このオプションは、Talendが提供する8.0.1-R2022-04以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。
|
詳細設定
| [Timeout for the generation of the start indicator file (ms)] (開始インジケーターファイル生成のタイムアウト(ミリ秒)) | SAPバッチ抽出で開始ファイルの生成を待機する時間をミリ秒単位で指定します。生成されたこのファイルは、データがFTPディレクトリーに正常に抽出されたことを示しています。デフォルト値は8000ミリ秒です。 |
| [Timeout for the data file polling (ms)] (データファイルポーリングのタイムアウト(ミリ秒)) | FTPサーバーからのデータファイルのポーリングを待つ時間を、ミリ秒単位で指定します。 このフィールドを空のままにするか、0に設定すると、ファイルポーリング中のタイムアウトは発生しなくなります。 |
| [Abort background Job and remove generated files on error] (バックグラウンドジョブを中止し、エラー時に生成されたファイルを削除) | このオプションを選択すると、コンポーネントが例外を検出した場合、FTPバッチ抽出で実行中のバックグラウンドジョブは中断され、FTP側で生成された無駄なファイルはクリーンアップされます。 |
| [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タイプであるデータは整数として扱われます。 |
| [Read DATE data as String in the dynamic column] (ダイナミックカラムでDATEデータを文字列として読み取る) | このオプションを選択すると、ダイナミックカラムにあるDATEタイプのデータが文字列として扱われます。 このオプションが選択されていない場合、ダイナミックカラムにあるDATEタイプのデータは日付として扱われます。 |
| [Trim spaces] (スペースをトリミング) | このオプションを選択すると、SAPサーバーから取得したデータにあるスペースがトリミングされます。データにあるスペースが特定の目的のためのもので、変更されないようにする必要がある場合は、このオプションをオフにできます。 このオプションは、STRING型またはRAW型のデータのみに適用されます。それ以外のデータ型では、型変換の前にスペースがトリミングされます。 情報メモ注: このオプションは、Talendが提供する8.0.1 R2023-07以降のTalend 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 Properties] (SAPプロパティ) |
使用中のSAPシステムでカスタム設定を使用する必要がある場合は、カスタマイズするプロパティをこのテーブルで設定します。例:
このプロパティは、[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合は表示されません。 |
| [Fetch size] (フェッチサイズ) | BAPI コールやリクエストに応答してSAP BWデータベースから返される結果セットの最大サイズ(行数)を入力します。 デフォルトの値である-1を指定すると、デフォルトのフェッチサイズが使われます。このフェッチサイズはSAP側のJavaコードやBAPIによって決定されます。 ジョブに割り当てられたメモリスペースと、要求されたフィールドの数に応じてこのフィールドを設定することをお勧めします。与えられたメモリスペースにより、要求されたフィールドの数が多ければ多いほどフェッチサイズは小さくなります。 情報メモ注: このフィールドは、Talendが提供する8.0.1-R2022-04以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。
|
| [SAP function extraction path] (SAP関数抽出パス) | このオプションを選択すると、抽出されたデータを保持するファイルを生成するSAP関数のディレクトリーを指定できます。右側のテキストフィールドにディレクトリーへのパスを入力します。 このオプションが選択されていない場合、ファイルは[Basic settings] (基本設定)ビューの[FTP directory] (FTPディレクトリー)フィールドで指定されたディレクトリーに生成されます。 [Basic settings] (基本設定)ビューで[Use the SAP Application Server logical path] (SAP Application Serverの論理パスを使用)チェックボックスを選択した場合、このオプションは利用できません。 Talend Studioは[SAP function extraction path] (SAP関数抽出パス)フィールドと[FTP directory] (FTPディレクトリー)フィールドで指定されたディレクトリーを同期しないので、これら2つのフィールドが同じリソースを指していることをご確認ください。 情報メモ注: このオプションは、Talendが提供する8.0.1-R2022-04以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。
|
| [Use space to replace the control characters in data] (スペースを使用してデータの制御文字を置き換える) | データ内の特殊文字をスペースに置き換えるには、このオプションを選択します。データ内の一部の文字(たとえば、\n)は制御文字として扱われるため、データ解析に影響を与える可能性があります。このオプションは、特殊文字をスペースに置き換えることでこれを防ぎます。 このオプションは、[Basic settings] (基本設定)ビューで[Use existing dynamic schema] (既存のダイナミックスキーマを使用)が、または[Advanced settings] (詳細設定)ビューで[Use RFC server] (RFCサーバーを使用)が選択されている場合は利用できません。 このオプションは、Talendが提供する8.0.1 R2023-06以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。 |
| [Fetch all records at once] (すべてのレコードを一度にフェッチ) | このチェックボックスをオンにすると、設定された最大行数に基づいてすべてのレコードが一度に取得されます。このチェックボックスをオフにすると、システムで定義されているフェッチサイズに基づいてレコードがフェッチされます。 このオプションは、[CDS View] (CDSビュー)を選択した時に標準抽出でのみ利用できます。このオプションは、[Use FTP-Batch Options] (FTPバッチオプションを使用)か[Use the RFC server] (RFCサーバーを使用)を選択した場合は利用できません。 このオプションは、Talendが提供する8.0.1-R2024-03以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。 |
| [tStatCatcher Statistics] (tStatCatcher統計) |
このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |
グローバル変数
| グローバル変数 |
ERROR_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。 Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。 フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。 変数の詳細は、コンテキストと変数を使用をご覧ください。 |
使用方法
| 使用ルール | このコンポーネントは、通常、ジョブの開始コンポーネントとして使い、常に出力リンクが必要です。 |
| サポート |
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およびTalend Studioをホストしているワークステーションに、SAPから提供された特定のJARファイルとDLLファイルを追加する必要があります。正確な手順は、32ビットまたは64ビットのWindowsやLinuxなど、使用しているプラットフォームで異なります。
|