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

The Standard tSAPHanaOutputコンポーネントはデータベースファミリーのコンポーネントです。

このフレームワーク内のコンポーネントは、ビッグデータ対応のTalend 製品すべて、およびTalend Data Fabricで使用できます。

注: このコンポーネントは、動的データベースコネクターの特定のバージョンです。データベース設定に関連するプロパティは、データベースタイプの選択に応じて異なります。動的データベースコネクターについては、動的データベースコンポーネントを参照してください。

基本設定

データベース

データベースのタイプをリストから選択し、[Apply] (適用)をクリックします。

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

定義済みの接続の詳細を再利用するには、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)ドロップダウンリストで目的の接続コンポーネントを選択します。

注: ジョブに親ジョブと子ジョブが含まれている時は、2つのレベルの間の既存の接続を共有する必要がな場合(たとえば、親ジョブで作成した接続を子ジョブと共有するなど)には、以下を実行する必要があります。
  1. 親レベルで、共有するデータベース接続を、そのデータベース接続そのものを作成する接続コンポーネントの[Basic settings] (基本設定)ビューに登録します。

  2. 子レベルで、登録済みのそのデータベース接続を読み取るために専用の接続コンポーネントを使用します。

ジョブレベルをまたがってデータベース接続を共有する方法の例は、『 Talend Studio ユーザーガイド』を参照してください。

[Host] (ホスト)

データベースサーバーのIPアドレス。

[Port] (ポート)

データベースサーバーのリスニングポート番号。

スキーマ

データベーススキーマの名前。

[Username] (ユーザー名)[Password] (パスワード)

データベース認証データ。

パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、[OK] をクリックして設定を保存します。

[Table] (テーブル)

書き込まれるテーブルの名前。一度に書き込みができるテーブルは1つだけです。

[Action on table] (テーブルへのアクション)

定義済みのテーブルで、次のオペレーションの1つを実行できます。

[None] (なし): 操作は行われません。

[Drop and create table] (テーブルの削除と作成): テーブルが削除され、再作成されます。

[Create table] (テーブルの作成): テーブルが存在しないため、作成します。

[Create table if not exists] (存在しない場合はテーブルを作成): テーブルが存在しない場合は作成されます。

[Drop table if exists and create] (テーブルがある場合はテーブルをドロップして作成します): テーブルが既に存在する場合は削除され、再び作成されます。

[Clear table] (テーブルのクリア): テーブルの内容が削除されます。

[Type of table storage] (テーブルストレージのタイプ)

このオプションは、データベーステーブルを作成する場合(ドロップありまたはドロップなし)にのみ利用できます。このオプションを使うと、データをテーブルに保管する方法を定義できます。次のタイプのテーブルストレージ組織が使えます。

  • [Row] (行): データは行に保管されます。すべての属性が選択された状態で、テーブルアクセスの大部分が少数のレコードの選択を伴う場合は、このテーブルタイプを使うことをお勧めします。

  • [Column] (カラム): データはカラムに保管されます。テーブルアクセスの大部分が、少数の属性が選択された状態で多数のタプルを介する場合は、このテーブルタイプを使うことをお勧めします。

  • [History column] (履歴カラム): HISTORYと呼ばれる特定のトランザクションセッションタイプでテーブルを作成します。セッションタイプHISTORYのテーブルは、タイムトラベルクエリーをサポートします。HISTORYとタイムトラベルクエリーの詳細は、HISTORY COLUMN Option (Time Travel)を参照してください。

  • [Global temporary]: テーブルの定義とデータは、現在のセッション中にすべてのユーザーと接続から見ることができます。テーブルはセッションの最後に切り詰められます。

  • [Global temporary]: テーブルの定義とデータは、現在のセッション中にテーブルを作成したユーザーのみが表示できます。テーブルはセッションの最後に切り詰められます。

[Action on data] (データへのアクション)

定義されたテーブルのデータでは、以下の操作を実行できます:

[Insert] (挿入): テーブルに新しいエントリを追加します。重複が見つかると、ジョブは停止します。

[Update] (更新): 既存のエントリーが変更されます。

[Insert or update] (挿入または更新): 新しいレコードを挿入します。指定された参照を持つレコードが既に存在する場合は、更新されます。

[Update or insert] (更新または挿入): 指定された参照を使用してレコードを更新します。レコードが存在しない場合は、新しいレコードが挿入されます。

[Delete] (削除): 入力フローに対応するエントリーを削除します。

[Update] (更新)および[Delete] (削除)操作のベースとなる主キーとして、少なくとも1つのカラムを指定する必要があります。それには、[Edit Schema] (スキーマを編集)をクリックし、主キーに指定するカラムの横にあるチェックボックスをオンにします。高度な使い方については、[Advanced settings] (詳細設定)ビューのUse filed optionsを参照してください。

[Schema] (スキーマ)[Edit schema] (スキーマを編集)

スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

 

[Built-in] (組み込み): そのコンポーネントのみのスキーマを作成して、ローカルに保存します。

 

[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。

再使用するスキーマに整数またはファンクションのデフォルト値が指定されている場合は、これらのデフォルト値を引用符で囲まないようにご注意ください。引用符で囲まれている場合は手動で削除します。

詳細は、Talend Studioユーザーガイドでテーブルスキーマに関連する説明を参照してください。

 

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

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

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

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

[Die on error] (エラー発生時に強制終了)

このチェックボックスは、デフォルトでオフになっています。これは、エラーが発生し、行の処理がエラーなしに終了した場合に、[Die on error] (エラー発生時に強制終了)が行をスキップすることを意味します。

詳細設定

[Use alternate schema] (代替スキーマを使用)

データベース接続を確立するコンポーネント(つまり、[Basic settings] (基本設定)ビューの[Component list] (コンポーネントリスト)ドロップダウンリストから選択されたコンポーネント)によって指定されたスキーマ以外のスキーマを使うには、このオプションを選択します。このオプションを選択した後、[Schema] (スキーマ)フィールドに目的のスキーマの名前を入力します。

このオプションは、[Basic settings] (基本設定)ビューで[Use an existing connection] (既存の接続を使用)がオンの場合に利用できます。

[Additional JDBC Parameters] (追加のJDBCパラメーター)

作成するデータベース接続に追加の接続プロパティを指定します。このオプションは、[Basic settings] (基本設定)[Use an existing connection] (既存の接続を使う)チェックボックスをオンにしている場合は使えません。

[Commit every] (コミットする間隔)

ノードのバッチがデータベースにコミットされるまでに完了しているべき行数を入力します。このオプションにより、トランザクションの質(ただしロールバックは含まない)、特に実行時のパフォーマンスの向上が保証されます。

[Additional Columns] (追加のカラム)

このオプションは、データベーステーブルを作成する場合(ドロップありまたはドロップなし)には利用できません。このオプションにより、SQL関数を呼び出してカラムにアクションを実行できます。ただし、[insert] (挿入)[update] (更新)[delete] (削除)のアクションでないこと、特定の事前処理を必要とするその他のアクションでないことが条件です。

 

[Name:] (名前:)変更するか、または新しいカラムとして挿入するスキーマカラムの名前を入力します。

 

[SQL expression:] (SQL式:)関連するカラムデータを変更または挿入するために実行するSQLステートメントを入力します。

 

[Position:] (位置:)参照カラムに対して実行されるアクションに従って、[Before] (実行前)[Replace] (置換)または[After] (実行後)を選択します。

 

[Reference column:] (参照カラム:)新しいカラム、または変更するカラムを探すか、または置換するためにtSAPHanaOutputが使える参照のカラムを入力します。

[Use field options] (フィールドオプションの使用)

特にデータに二重のアクションがある場合、リクエストをカスタマイズするには、このチェックボックスをオンにします。そのテーブルでは、次のことを定義できます。

[Key in update] (更新のキー): 更新操作で使う主キーを定義します。

[Key in delete] (削除のキー): 削除操作で使う主キーを定義します。

[Updatable] (更新可能): 更新するカラムを定義します。

[Insertable] (挿入可能): 挿入するカラムを定義します。

[Enable debug mode] (デバッグモードを有効にする)

このチェックボックスをオンにすると、データベースのエントリの処理中に各ステップが表示されます。

[Support null in "SQL WHERE" statement] ("SQL WHERE"ステートメントでnullをサポート)

"SQL WHERE"ステートメントでnullを検証するには、このチェックボックスをオンにします。

[Use Batch Size] (バッチサイズを使用)

選択すると、処理される各バッチの行数を定義できます。

このオプションは、[Basic settings] (基本設定)[Use an existing connection] (既存の接続を使用)を選択していない場合にのみ利用できます。

[tStatCatcher Statistics] (tStatCatcher統計)

このチェックボックスをオンにすると、コンポーネントレベルでログデータを収集できます。

[Enable parallel execution] (並列実行の有効化)

このチェックボックスをオンにすると、複数のデータフローを同時に処理することにより、高速データ処理を実行できます。このフィーチャーは、データベースまたは複数の挿入を並行して処理するアプリケーションの機能と、関係するCPUの数に依存していることにご注意ください。[Number of parallel executions] (並列実行の数)フィールドで次のいずれかの操作を行います:
  • 実行する並列実行の数を入力する。
  • [Ctrl] + [Space]を押して、リストから適切なコンテキスト変数を選択する。詳細は、『 Talend Studioユーザーガイド』を参照してください。

並列実行を有効にすると、グローバル変数を使ってサブジョブで戻り値を取得することはできないことにご注意ください。

  • [Action on table] (テーブルのアクション)フィールドは、並列化ファンクションでは使用できません。したがって、テーブルを作成する場合は、tCreateTableコンポーネントを使用する必要があります。
  • 並列実行が有効になっている場合、グローバル変数を使用してサブジョブの戻り値を取得することはできません。

グローバル変数

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

NB_LINE: 処理された行の数。これはAfter変数で、整数を返します。

NB_LINE_UPDATED: 更新された行の数。これはAfter変数で、整数を返します。

NB_LINE_INSERTED: 挿入された行の数。これはAfter変数で、整数を返します。

NB_LINE_DELETED: 削除された行の数。これはAfter変数で、整数を返します。

NB_LINE_REJECTED: 拒否された行の数。これはAfter変数で、整数を返します。

QUERY: 処理されたクエリーステートメント。これはAfter変数で、文字列を返します。

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

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

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

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

使用方法

使用ルール

このコンポーネントは、入力コンポーネントに接続する必要があります。このコンポーネントを使って、SAP HANAデータベース内のテーブルまたはテーブルのデータにアクションを実行できます。また、[Row] (行) > [Reject] (リジェクト)リンクを使って、エラーのあるデータをフィルタリングするリジェクトフローを作成することもできます。

サポート

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

[Dynamic settings] (ダイナミック設定)

[+]ボタンをクリックしてテーブルに行を追加し、[Code] (コード)フィールドにコンテキスト変数を入力して、ジョブ内で計画した複数の接続からデータベース接続をダイナミックに選択します。この機能は、データ構造が同じでデータベースが異なるデータベーステーブルにアクセスする必要がある場合、特に、Talend Studioを介さずにジョブをデプロイおよび実行する必要がある時など、ジョブの設定を変更できない環境で作業している場合に役立ちます。

[Dynamic settings] (動的設定)テーブルは、[Basic settings] (基本設定)ビューで[Use an existing connection] (既存の接続を使用)チェックボックスが選択されている場合にのみ使用できます。ダイナミックパラメーターを定義すると、[Basic settings] (基本設定)ビューの[Component List] (コンポーネントリスト)ボックスは使用できなくなります。

動的パラメーターの使用サンプルは、../reuse/../standard/reading-data-from-databases-through-context-based-dynamic-connect_c.htmlおよび../reuse/../standard/tcontextload_tlogrow-tfileinputdelimited-tmysqlinput_reading-data-from-different-mysql-databases-using-dynamically-loa_standard_component_the-job-in_c.htmlを参照してください。[Dynamic settings] (動的設定)とコンテキスト変数については、『Talend Studioユーザーガイド』を参照してください。