tSAPTableInputの標準プロパティ

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

[Use existing dynamic schema] (既存のダイナミックスキーマを使用)オプションを選択した場合、このオプションは利用できません。

SAP CDSビューのパラメーターは、[CDS View parameters] (CDSビューのパラメーター)テーブルで設定します。CDSビューのパラメーターを設定するためには、テーブルの下部にあるプラスボタンをクリックしてテーブルに行を追加し、その行の[Parameter] (パラメーター)カラムにそのパラメーター名を、[Value] (値)カラムにパラメーター値をそれぞれ入力します。

このオプションは、[Basic settings] (基本設定)ビューで[Use existing dynamic schema] (既存のダイナミックスキーマを使用)が、または[Advanced settings] (詳細設定)ビューで[Use RFC server] (RFCサーバーを使用)が選択されている場合は利用できません。

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

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

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

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

10000を超える値(たとえば12000)を指定した場合、Studio Talendは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接続を使ってファイルを読み取ってデータを取得し、取得したデータを出力コンポーネントに転送します。

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

• [File Protocol] (ファイルプロトコル): FTPまたはセキュリティで保護された代替SFTPを選択します。

• [Host] (ホスト): FTPサーバーのIPアドレスまたはホスト名。

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

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

• [Use the SAP Application Server logical path] (SAP Application Serverの論理パスを使用): SAP Application Serverで設定された論理パスで、フラットファイルを作成するディレクトリーを指定します。

  このオプションは、Talendが提供するR2023-02以降のStudio Talendマンスリーアップデートをインストール済みである場合のみ利用できます。

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

  [Use the SAP Application Server logical path] (SAP Application Serverの論理パスを使用)チェックボックスを選択した場合、このオプションは利用できません。

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

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

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

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

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

このオプションは、STRING型またはRAW型のデータのみに適用されます。それ以外のデータ型では、型変換の前にスペースがトリミングされます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[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以降のStudio Talendマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。

このオプションは、[CDS View] (CDSビュー)を選択した時に標準抽出でのみ利用できます。このオプションは、[Use FTP-Batch Options] (FTPバッチオプションを使用)か[Use the RFC server] (RFCサーバーを使用)を選択した場合は利用できません。

このオプションは、Talendが提供する8.0.1-R2024-03以降のStudio Talendマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。

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

グローバル変数

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] (コンポーネントがエラーの場合)

接続の詳細は、ジョブにおける接続の使い方をご覧ください。

制限事項/前提条件