# tELTSAPMap 1つ以上のtELTSAPInputコンポーネントが提供するテーブルスキーマを使って、SQL SELECTステートメントを作成します。 ## tELTSAPMapの標準プロパティ これらのプロパティは、標準ジョブのフレームワークで実行されているtELTSAPMapを設定するために使われます。 標準のtELTSAPMapコンポーネントは、ELTファミリーに属しています。 このフレームワーク内のコンポーネントは、すべてのサブスクリプションベースのTalend製品で利用できます。 ## 基本設定 | [Properties] (プロパティ) | 説明 | | --- | --- | | プロパティタイプ | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。

| | [Use an existing connection] (既存の接続を使用) | このチェックボックスをオンにして、表示されたリストから、定義済みの接続詳細を再利用する、該当する接続コンポーネントを選択します。

情報メモ注: ジョブに親ジョブと子ジョブが含まれている時は、親ジョブと子ジョブの間の既存の接続を共有したい場合(たとえば、親ジョブで作成した接続を子ジョブと共有するなど)には、次のように実行します。

  1. 親レベルで、共有するデータベース接続を、そのデータベース接続そのものを作成する接続コンポーネントの[Basic settings] (基本設定)ビューに登録します。
  2. 子レベルで、登録済みのそのデータベース接続を読み取るために専用の接続コンポーネントを使用します。


ジョブレベル全体でデータベース接続を共有する方法の例は、[データベース接続を共有](https://help.qlik.com/talend/r/ja-JP/7.3/studio-user-guide/sharing-database-connection)をご覧ください。 | | [SAP Map Editor] (SAPマップエディター) | ELT Mapエディターでは、出力スキーマを定義し、実行するSQLステートメントをグラフィカルにビルドできます。スキーマのカラム名は、SAPシステムのカラム名とは異なる場合があります。

情報メモ注:

| | [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] (メッセージサーバー)が選択されている時のみ利用可能です。 | | [CDS view] (CDSビュー) | SAP CDSビューからデータを取得するためには、このオプションを選択します。

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

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

情報メモ注:

| | [Start row number] (開始行番号) | データの取得を開始する行のシーケンス番号を指定します。SAPテーブルの行のシーケンス番号は*0*から始まります。

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

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

情報メモ注: このオプションは、Talendが提供する8.0.1 R2023-06以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。 | | [Max row number] (最大行数) | データを取得する行の最大数を指定します。

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

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

情報メモ注: このオプションは、Talendが提供する8.0.1 R2023-06以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。 | | [Batch size] (バッチサイズ) | SAPシステムによって生成される各ファイルに書き込むことができるレコードの最大数を指定します。 | | [File protocol] (ファイルプロトコル) | FTPまたはセキュリティで保護された代替SFTPを選択します。 | | [FTP host] (FTPホスト) | FTPサーバーのIPアドレスまたはホスト名を指定します。 | | [FTP port] (FTPポート) | FTPサーバーのリスニングポート番号を指定します。 | | [FTP user] (FTPユーザー)と[FTP password] (FTPパスワード) | FTPサーバーにアクセスするためのユーザー認証データを指定します。

パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。 | | [Use the SAP Application Server logical path] (SAP Application Serverの論理パスを使用) | SAP Application Serverで設定された論理パスを入力し、フラットファイルを作成するディレクトリーを指定する場合はこのチェックボックスをオンにします。

情報メモ注: このオプションは、Talendが提供するR2023-02以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。 | | [FTP Directory] (FTPディレクトリー) | SAPシステムによって生成されたファイルが保存されるディレクトリーを指定します。

[Use the SAP Application Server logical path] (SAP Application Serverの論理パスを使用)チェックボックスをオンにした場合、このオプションは利用できません。 | | [Data filename prefix] (データファイル名プレフィックス) | SAPシステムによって生成されるファイルのプレフィックスを指定します。 | | [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接続はコンポーネントの末尾で閉じることになります。これを防ぐには、共有の宛先を名前を指定した状態で使ってください。 | | [RFC server url] (RFCサーバーのURL) | 表示されたフィールドにRFCサーバーのURLを入力します。

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サーバーを使用)オプションを選択している場合に利用できます。 | ## 詳細設定 | [Properties] (プロパティ) | 説明 | | --- | --- | | [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] (RFCサーバーを使用) | SAPアプリケーションから大量のデータを直接抽出したい場合は、このチェックボックスをオンにします。このオプションをオンにすると、[接続設定]セクションに[RFC server url] (RFCサーバーのURL) と[Package size] (パッケージサイズ)のフィールドが表示されます。詳細については、[Basic settings] (基本設定) ビューでこれらのフィールドの対応する説明をご覧ください。 | | [Kafka Properties] (Kafkaのプロパティ) | [Use the RFC server] (RFCサーバーを使う)オプションをオンにすると、ウィンドウにKafkaプロパティテーブルが表示されます。Kafka、またはApache Kafkaは、オープンソースの分散ストリーミングプラットフォームです。Kafkaの詳細は、https://kafka.apache.org/をご覧ください。

表示されたフィールドにKafkaの情報を入力します。 | | [Use space to replace the control characters in data] (スペースを使用してデータの制御文字を置き換える) | データ内の特殊文字をスペースに置き換えるには、このオプションを選択します。データ内の一部の文字(たとえば、\n)は制御文字として扱われるため、データ解析に影響を与える可能性があります。このオプションは、特殊文字をスペースに置き換えることでこれを防ぎます。

このオプションはデフォルトで選択されています。 | | [SAP Properties] (SAPプロパティ) | 使用中のSAPシステムでカスタム設定を使用する必要がある場合は、カスタマイズするプロパティをこのテーブルで設定します。例:



このプロパティは、[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合は表示されません。 | | [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つのフィールドが同じリソースを指していることをご確認ください。 | | [Trim spaces] (スペースをトリミング) | このオプションをオンにすると、SAPサーバーから取得したデータにあるスペースがトリミングされます。データにあるスペースが特定の目的のためのもので、変更されないようにする必要がある場合は、このオプションをオフにできます。

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

情報メモ注: このオプションは、Talendが提供する8.0.1 R2023-07以降のTalend Studioマンスリーアップデートをインストール済みである時のみ利用可能です。詳細は管理者にお問い合わせください。 | | [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 | ## [Global Variables] (グローバル変数) | 変数 | 説明 | | --- | --- | | ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 | ## 使用方法 | 使用方法のガイダンス | 説明 | | --- | --- | | 使用ルール | tELTSAPMapコンポーネントは、tELTSAPInputコンポーネントと共によく使われます。tELTSAPInputからtELTSAPMapへのリンクの名前は、tELTSAPInputの[Default Table Name] (デフォルトテーブル名)フィールドに指定したテーブル名と同じでなければなりません。 | | **サポート** | S4/HANAを含め、SAPのERP部分と連携するためにtELTSAPMapを使う必要があります。 | **関連概念** * [複数のSAPテーブルのデータを集計およびフィルタリングする](https://help.qlik.com/talend/ja-JP/components/8.0/sap/teltsapmap-teltsapinput-tfileoutputdelimited-teltsapinput-tfileoutputdelimited-aggregating-and-filtering-data-in-multiple-sap-tables "この例では、tELTSAPInputおよびtELTSAPMapコンポーネントを使って2つのSAPテーブルからデータを集計し、データのカラムと行をフィルタリングし、最後にtFileOutputDelimitedコンポーネントを使ってフィルタリングされたデータをローカルCSVファイルに書き込む方法を示します。")