# tSAPADSOInput

SAP HANAデータベース上またはSAP Java Connector経由で、SAP BWシステムからアクティブなADSO (Advanced Data Store Object)のデータを取得します。

## tSAPADSOInputの標準プロパティ

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

標準のtSAPADSOInputコンポーネントは、ビジネスファミリーに属しています。

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

情報メモ注: 「このコンポーネントにはsapjco.jarが必要です」と表示されたら、モジュールをダウンロードし、[SAP Java Connector](https://support.sap.com/ja/product/connectors/jco.html)の手順をご覧ください。

## 基本設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| プロパティタイプ | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。<br><br><ul> <li> <p> <span>[Built-In] (組み込み)</span>: 一元的に保存されるプロパティデータはありません。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: プロパティが保存されているリポジトリーファイルを選択します。</p> </li> </ul> |
| [Connection type] (接続タイプ) | ADSOデータを取得する方法([Hana JDBC]か[SAP JCO 3])を選択します。<br><br><ul> <li> <span>[Hana JDBC]</span>: SAP HANAデータベースへのJDBC接続を通じて、ADSOデータを取得します。</li> <li> <span>[SAP JCO 3]</span>: SAP Java Connectorを通じて、ADSOデータを取得します。</li> </ul><br><br>情報メモ注: このオプションは、Talendが提供するR2021-12以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。 |
| [Host] (ホスト) | データベースのIPアドレスまたはホスト名を入力します。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[Hana JDBC]が選択済みである場合に利用できます。 |
| [Port] (ポート) | データベースのリスニングポート番号を入力します。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[Hana JDBC]が選択済みである場合に利用できます。 |
| [Table Schema] (テーブルスキーマ) | テーブルスキーマ名を入力します。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[Hana JDBC]が選択済みである場合に利用できます。 |
| [Username] (ユーザー名)と[Password] (パスワード) | データベースユーザー認証データを入力します。<br><br>パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、OKをクリックして設定を保存します。<br><br>これらの2つのオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[Hana JDBC]が選択済みである場合に利用できます。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。<br><br><ul> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul><br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。変更を加えると、スキーマは自動的に組み込みになります。<br><br><ul> <li> <p> <span>[View schema] (スキーマを表示)</span>: スキーマのみを表示する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Change to built-in property] (組み込みのプロパティに変更)</span>: ローカルで変更を行うためにスキーマを<span>組み込み</span>に変更する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Update repository connection] (リポジトリー接続をアップデート)</span>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。</p> <p>変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul> |
| [Name] (名前) | データを取得するアクティブな詳細データストアオブジェクトの名前を入力します。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[Hana JDBC]が選択済みである場合に利用できます。 |
| [Use an existing connection] (既存の接続を使用) | このチェックボックスをオンにし、表示された[Connection configuration] (接続設定)ドロップダウンリストから、再利用する該当するデータベース接続が設定されているコンポーネントを選択します。<br><br>ジョブに親ジョブと子ジョブが含まれている場合、リストには同じジョブレベルの接続コンポーネントだけが表示されます。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [Server Type] (サーバータイプ) | 接続するSAPサーバーのタイプ([Application Server] (アプリケーションサーバー)または[Message Server] (メッセージサーバー))を選択します。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [Client] (クライアント) | SAPシステムクライアントIDを入力します。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [UserId] (ユーザーID)と[Password] (パスワード) | ユーザーの接続IDとパスワードを入力します。<br><br>パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、[OK] をクリックして設定を保存します。<br><br>これらの2つのオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| Language | SAPシステムの言語を入力します。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [Host name] (ホスト名) | SAPサーバーが稼働しているホストの名前またはIPアドレスを入力します。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [System number] (システム番号) | SAPシステム番号を入力します。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みで、[Application Server] (アプリケーションサーバー)ドロップダウンリストから[Message Server] (メッセージサーバー)が選択済みである場合に利用できます。 |
| [System ID] (システムID) | SAPシステムIDを入力します。<br><br>このフィールドは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択され、[Server Type] (サーバータイプ)ドロップダウンリストから[Message Server] (メッセージサーバー)が選択されている場合に利用できます。 |
| [Group Name] (グループ名) | SAPグループ名を入力します。<br><br>このフィールドは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択され、[Server Type] (サーバータイプ)ドロップダウンリストから[Message Server] (メッセージサーバー)が選択されている場合に利用できます。 |
| [Service name] (サービス名) | オペレーショナルデルタキューの名前を入力します。<br><br>詳細は、[Introduction to Operational Delta Queues](https://wiki.scn.sap.com/wiki/display/BI/Introduction+to+Operational+Delta+Queues#IntroductiontoOperationalDeltaQueues-TheOperationalDeltaQueue%28ODQ%29)をご覧ください。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [Subscriber name] (サブスクライバー名) | SAPからのデータを消費するサブスクライバーの名前を入力します。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [Subscriber process name] (サブスクライバープロセス名) | サブスクライバープロセスの名前を入力します。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [Execute a full extraction] (フル抽出を実行) | フル抽出を実行してSAPシステムからすべてのデータを取得する場合は、このチェックボックスをオンにします。デフォルトでは、このチェックボックスはオフになっており、デルタ抽出が実行されて、変更されたデータのみが取得されます。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [Reset subscriber] (サブスクライバーをリセット) | サブスクライバーをリセットして最初のロードを実行するには、このチェックボックスをオンにします。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [Selection Group] (選択グループ) | 取得するデータのフィルタリングに使う検索条件を指定します。[ + ]ボタンをクリックして必要な行数を追加します。各行が検索条件となります。各条件に以下の属性値を設定するために使われます。<br><br>情報メモ注: このコンポーネントは、このフィールドに設定されたすべての条件を満たすデータレコードを取得します。<br><br><ul> <li> <p> <span>[Column] (カラム)</span>: 取得されたデータをフィルタリングする時のベースとなるスキーマカラムの名前を入力します。</p> </li> <li> <p> <span>[Sign] (記号)</span>: ドロップダウンリストから、<kbd>Include</kbd>または<kbd>Exclude</kbd>を選択します。</p> <ul> <li> <p> <kbd>Include</kbd>: 条件を満たすデータが取得されます。</p> </li> <li> <p> <kbd>Exclude</kbd>: 条件を満たさないデータが取得されます。</p> </li> </ul> </li> <li> <p> <span>[Operator] (演算子)</span>: ドロップダウンリストから、検索条件の設定に使うデータフィルター演算子を選択します。</p> </li> <li> <p> <span>[Value] (値)</span>: 検索条件の構成に使用する検索値を指定します。ワイルドカード文字はサポートされていません。</p> </li> <li> <p> <span>[High value] (高値)</span>: <span>Between</span>演算子の検索条件を構成するために使う別の検索値を指定します。</p> <p>日付型のカラムを使用してフィルターを指定する時は、<span>[Value] (値)</span>カラムと<span>[High Value] (高値)</span>カラム内の日付と時刻の値は、<kbd>yyyyMMdd</kbd>および<kbd>HHMMSS</kbd>の形式にする必要があります。これは、スキーマエディターで定義した形式とは異なる場合があります。ワイルドカード文字はサポートされていません。</p> </li> </ul><br><br>このテーブルは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [Specify a shared destination] (共有デスティネーションを指定) | このチェックボックスをオンにし、表示された[Shared destination name] (共有デスティネーションの名前)フィールドに共有デスティネーションを指定します。共有デスティネーションにより、SAPのコンポーネントは、 Talend RuntimeコンテナーOSGi環境内でESBルートまたはESBデータサービスの一部として実行された時に、 Talend Runtimeの共有デスティネーションを使えます。<br><br>コンポーネントで共有デスティネーションの名前を指定するだけでなく、 Talend RuntimeのSAP DataSourceを設定する必要もあります。SAP DataSourceを定義するうえで必要なことと、それを設定する方法は、Talend ESBパッケージの/add-ons/datasource/sapフォルダーに含まれているreadme.txtに記載されています。<br><br>コンポーネント自体の接続設定を使う場合、SAP接続はコンポーネントの末尾で閉じることになります。これを防ぐには、共有の宛先を名前を指定した状態で使ってください。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |

## 詳細設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Additional JDBC Parameters] (追加のJDBCパラメーター) | parameterName1=value1&parameterName2=value2&...という形式で追加のJDBCパラメーターを入力します。このフィールドでは、高度なDataStoreオブジェクト用のメタデータを提供できます。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[Hana JDBC]を選択する場合に利用できます。 |
| [Fetch size] (フェッチサイズ) | BAPIコールやリクエストに応答してSAP BWデータベースから返される結果セットの最大サイズ(行数)を入力します。<br><br>デフォルトの値である-1を指定すると、デフォルトのフェッチサイズが使われます。このフェッチサイズはSAP側のJavaコードやBAPIによって決定されます。<br><br>ジョブに割り当てられたメモリスペースと、要求されたフィールドの数に応じてこのフィールドを設定することをお勧めします。与えられたメモリスペースにより、要求されたフィールドの数が多ければ多いほどフェッチサイズは小さくなります。<br><br>このオプションは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みである場合に利用できます。 |
| [SAP Properties] (SAPプロパティ) | 使用中のSAPシステムでカスタム設定を使用する必要がある場合は、カスタマイズするプロパティをこのテーブルで設定します。例:<br><br><ul> <li> <p>SAPシステムと<span>Talend Studio</span>の間にUnicode接続を確立するには、<kbd>jco.server.unicode</kbd>プロパティを追加してその値を<kbd>1</kbd>に設定する必要があります。このプロパティはSAP Java Connector 2.xを使用している場合に機能します。SAP Java Connector 3.0以降のバージョンでは不要です。 </p> </li> <li> <p>セキュリティで保護されたネットワーク通信(SNC)を使用してSAP接続を設定するには、このフィールドに以下のプロパティを追加し、設定する必要があります。</p> <ul> <li> <span>jco.client.snc_mode</span> </li> <li> <span>jco.client.snc_myname</span> </li> <li> <span>jco.client.snc_lib=.../sapcrypto/sapcrypto.dll</span> </li> <li> <span>jco.client.snc_partnername</span> </li> <li> <span>jco.client.snc_qop</span> </li> </ul> <div><span>情報メモ</span><span>注:</span>  上記プロパティの値はシステム環境によって異なります。プロパティの設定方法が不明な場合は、SAPシステムの管理者にお問い合わせください。</div> <p>SNCパラメータの設定については、<a href="https://help.sap.com/viewer/10977ac76c531014a966b3f130d4f853/7.0.36/en-US/d9e8a740bbaa4d8f8bee6f7b173bd99f.html" target="_blank">SNC の設定をご覧ください: SNCをサポートするRFC</a>と<a href="https://help.sap.com/viewer/10977ac76c531014a966b3f130d4f853/7.0.36/en-US/76128150317a47b6a326e63a17017729.html" target="_blank">通信パスを使用したAS ABAPへの外部プログラム</a>。</p> </li> </ul><br><br>このテーブルは、[Connection type] (接続タイプ)ドロップダウンリストから[SAP JCO 3]が選択済みで、[Basic settings] (基本設定)ビューで[Using an existing connection] (既存の接続を使用)チェックボックスが選択されていない場合に利用できます。 |
| [Convert NULL numeric values to zero] (Nullの数値を0に変換) | このチェックボックスをオンにすると、データ抽出時に数値フィールドのNULL値が自動的に0に変換されます。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

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

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

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| 使用ルール | このコンポーネントは通常、ジョブまたはサブジョブの開始コンポーネントとして使い、常に出力リンクが必要です。 |

**関連概念**

* [SAP BWからADSOデータを取得する](https://help.qlik.com/talend/ja-JP/components/8.0/sap/tsapadsoinput-tfileoutputdelimited-retrieving-adso-data-from-sap-bw-standard-component-enterprise "このサンプルシナリオでは、Talendコンポーネントを使ってSAP HANAデータベース上のSAP BWシステムからアクティブなADSO (詳細データストアオブジェクト) のデータを取得する方法を示します。")