tVerticaOutputの標準プロパティ - 7.3

Vertica

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 Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > DBコンポーネント > Vertica
データガバナンス > サードパーティーシステム > DBコンポーネント > Vertica
データクオリティとプレパレーション > サードパーティーシステム > DBコンポーネント > Vertica
Last publication date
2024-02-22

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

標準tVerticaOutputコンポーネントは、データベースファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

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

基本設定

[Database] (データベース)

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

[Property Type] (プロパティタイプ)

接続の詳細を設定する方法を選択します。

  • [Built-In] (組み込み): このコンポーネントの接続の詳細がローカルに設定されます。関連するすべての接続のプロパティ値を手動で指定する必要があります。

  • [Repository] (リポジトリー): [Repository] (リポジトリー) > [Metadata] (メタデータ)で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。このチェックボックスの横にある [...] ボタンをクリックし、表示された [Repository Content] (リポジトリーのコンテンツ)ダイアログボックスで、再使用する接続の詳細を選択すると、関連するすべての接続のプロパティに値が自動的に入力されます。

アイコンをクリックしてデータベース接続ウィザードを開き、コンポーネントに設定したデータベース接続パラメーターを保存します。

データベース接続パラメーターの設定と保管の詳細は、Talend Studioユーザーガイドをご覧ください。

[DB Version] (データベースバージョン)

データベースのバージョンを選択します。

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

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

ジョブに親ジョブと子ジョブが含まれている時は、2つのレベルの間の既存の接続を共有する必要がな場合(たとえば、親ジョブで作成した接続を子ジョブと共有するなど)には、以下を実行する必要があります。

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

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

ジョブレベル全体でデータベース接続を共有する方法の例は、Talend Studioユーザーガイドをご覧ください。

[Host] (ホスト)

データベースのIPアドレスまたはホスト名。

[Port] (ポート)

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

[Database] (データベース)

データベースの名前。

[Schema] (スキーマ)

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

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

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

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

[Table] (テーブル)

データが書き込まれるテーブルの名前。

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

定義されたテーブルに対して実行する操作を選択します。

  • [Default] (デフォルト): 操作は行われません。

  • [Drop and create table] (ドロップしてテーブルを作成): テーブルが削除され、再作成されます。

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

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

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

  • [Clear table] (テーブルをクリア): テーブルのコンテンツが削除されます。この操作はロールバックできます。

これらのプロパティは、[Advanced settings] (詳細設定)ビューの[Enable parallel execution] (並列実行を有効化)チェックボックスがオンになっている場合は利用できません。

[Use "drop cascade"] ("ドロップカスケード"の使用)

ドロップされるテーブルに関連するすべてのオブジェクトを削除するには、このチェックボックスをオンにします。

これらのプロパティは、[Action on table] (テーブルのアクション)リストからテーブルドロップ関連のオプションが選択されている場合にのみ使用できます。

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

定義されたテーブルのデータに対して実行する操作を選択します。

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

  • [Update] (アップデート): 既存のエントリーが変更されます。
    注: スキーマカラムがすべてキーとして設定されている場合は、このアクションによってエラーが発生し、ジョブが失敗します。
  • [Insert or update] (挿入またはアップデート): 新しいレコードを挿入します。指定された参照を持つレコードが既に存在する場合は、アップデートされます。
    注: スキーマカラムがすべてキーとして設定されている場合は、このアクションによって警告メッセージが発生し、ジョブが続行されます。
  • [Update or insert] (アップデートまたは挿入): 指定された参照を使用してレコードをアップデートします。レコードが存在しない場合は、新しいレコードが挿入されます。
    注: スキーマカラムがすべてキーとして設定されている場合は、このアクションによって警告メッセージが発生し、ジョブが続行されます。
  • [Delete] (削除): 入力フローに対応するエントリーを削除します。

  • [Copy] (コピー): テキストファイルからデータを読み取り、エントリーのタプルをWOS(Write Optimized Store)または直接ROS(Read Optimized Store)に挿入します。このオプションは、一括ロードに最適です。詳細は、VerticaSQLリファレンスマニュアルをご覧ください。

[Update] (アップデート)操作と[Delete] (削除)操作のベースとなるプライマリキーとして、少なくとも1つのカラムを指定する必要があります。この場合、[Edit Schema] (スキーマを編集)をクリックし、プライマリキーとして設定するカラムの横にあるチェックボックスをオンにします。高度な設定を行う場合は、[Advanced settings] (詳細設定)ビューをクリックして、[Update] (アップデート)操作と[Delete] (削除)操作のプライマリキーを同時に定義できます。この場合、[Use field options] (フィールドオプションを使用)チェックボックスをオンにし、[Update Key] (アップデートキー)カラムで、[Update] (アップデート)操作のベースとして使用するカラム名の横にあるチェックボックスをオンにします。[Delete] (削除)操作の[Key in delete column] (削除カラムのキー)でも同じようにします。

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

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

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

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

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

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

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。
注: 変更を加えると、スキーマは自動的に組み込みになります。
  • [View schema] (スキーマを表示): スキーマのみを表示する場合は、このオプションを選択します。

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

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

このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、Talend Studioユーザーガイドをご覧ください。

このダイナミックスキーマ機能は、テーブルの不明なカラムを取得する目的で設計されており、この目的に限り使用をお勧めします。テーブルの作成で使用することは勧められていません。

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

このチェックボックスをオンにすると、エラー発生時にジョブの実行が停止されます。

エラーの発生した行をスキップし、エラーが発生していない行の処理を完了するには、このチェックボックスをオフにします。

エラーがスキップされる際、Row > Reject接続を使って、エラー行を収集できます。

詳細設定

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

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

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

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

作成するデータベース接続に追加のJDBCパラメーターを指定します。

これらのプロパティは、[Basic settings] (基本設定)[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合は利用できません。

[Abort on error] (エラーで中止)

いずれかの行がリジェクトされた場合に[Copy] (コピー) 操作を停止し、操作をロールバックするには、このチェックボックスをオンにします。したがって、データはロードされません。

これらのプロパティは、[Action on data] (データでのアクション)ドロップダウンリストから、[COPY] (コピー)が選択されている場合のみ利用できます。

[Maximum rejects] (最大リジェクト)

数値を入力して、Verticaが使用するREJECTMAXコマンドを設定するために使われます。これは、ロードが失敗する前にリジェクトされる論理レコードの数の上限を示します。指定されない場合、または値が0の場合、リジェクトは無制限に許可されます。

これらのプロパティは、[Action on data] (データでのアクション)ドロップダウンリストから、[COPY] (コピー)が選択されている場合のみ利用できます。

[No commit] (コミットなし)

現在のトランザクションが自動的にコミットされないようにするには、このチェックボックスをオンにします。

これらのプロパティは、[Action on data] (データでのアクション)ドロップダウンリストから、[COPY] (コピー)が選択されている場合のみ利用できます。

[Exception file] (例外ファイル)

入力行番号と各リジェクトされたデータレコードの理由を示すメッセージが書き込まれているファイルへのパスを入力するか、ファイルを参照します。

これらのプロパティは、[Action on data] (データでのアクション)ドロップダウンリストから、[COPY] (コピー)が選択されている場合のみ利用できます。

[Exception file node] (例外ファイルノード)

例外ファイルのノードを入力します。指定しない場合、操作はデフォルトでクエリーのイニシエーターノードになります。

これらのプロパティは、[Action on data] (データでのアクション)ドロップダウンリストから、[COPY] (コピー)が選択されている場合のみ利用できます。

[Rejected data file] (リジェクトされたデータファイル)

リジェクトされた行を書き込むファイルへのパスを入力するか、ファイルを参照します。その後、このファイルを編集して問題を解決し、リロードできます。

これらのプロパティは、[Action on data] (データでのアクション)ドロップダウンリストから、[COPY] (コピー)が選択されている場合のみ利用できます。

[Rejected data file node] (リジェクトされたデータファイルノード)

リジェクトされたデータファイルのノードを入力します。指定しない場合、操作はデフォルトでクエリーのイニシエーターノードになります。

これらのプロパティは、[Action on data] (データでのアクション)ドロップダウンリストから、[COPY] (コピー)が選択されている場合のみ利用できます。

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

ノードのバッチがデータベースにコミットされるまでに処理されているべき行数を指定します。

このオプションにより、トランザクションの質(ただしロールバックは含まない)、特に実行時のパフォーマンスの向上が保証されます。

[Use batch mode] (バッチモードを使用)

このチェックボックスをオンにしてデータ処理のバッチモードを有効に設定し、[Batch size] (バッチサイズ)フィールドが表示されたら、各バッチで処理するレコード数を指定します。

これらのプロパティは、[Action on data] (データでのアクション)ドロップダウンリストから、[Insert] (挿入)[Update] (アップデート)[Delete] (削除)[Copy] (コピー)のいずれかが選択されている場合のみ利用できます。

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

このオプションにより、SQLファンクションを呼び出してカラムにアクションを実行できます。ただし、挿入、アップデート、削除のアクションでないこと、特定の事前処理を必要とするアクションでないことが条件です。ドロップの有無を問わず、データベーステーブルを作成する場合はこのオプションは提供されません。

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

  • DataType: 新しいカラムのデータ型を入力します。

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

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

  • [Reference column] (参照カラム): 新規または変更されたカラムを配置または置換するためにコンポーネントが使える参照のカラムを選択します。

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

対応するカラムのリクエストをカスタマイズする場合、特に、データに対して複数のアクションが実行される場合に、このチェックボックスをオンにします。

  • [Update Key] (キーのアップデート): データのアップデートに基づいて対応するカラムのチェックボックスをオンにします。
  • [Deletion Key] (削除キー): データ削除の基準とする対応するカラムのチェックボックスをオンにします。
  • [Updatable] (アップデート可能): 対応するカラムのデータをアップデートできる場合は、チェックボックスをオンにします。

  • [Insertable] (挿入可能): 対応する列のデータを挿入できる場合は、チェックボックスをオンにします。

[Debug query mode] (デバッグクエリーモード)

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

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

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

[Create projection when create table] (テーブルを作成するときにプロジェクションを作成する)

このチェックボックスをオンにすると、プロジェクションが作成されます。

このチェックボックスは、[Action on table] (テーブルのアクション)ドロップダウンリストからテーブル作成関連オプションが選択されている場合にのみ使用できます。

[tStatCatcher Statistics] (tStatCatcher統計)

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

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

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

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

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

グローバル変数

NB_LINE

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

NB_LINE_COPIED

コピーされた行数。これはAfter変数で、整数を返します。

NB_LINE_DELETED

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

NB_LINE_INSERTED

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

NB_LINE_REJECTED

リジェクトされた行数。これはAfter変数で、整数を返します。

NB_LINE_UPDATED

アップデートされた行数。これはAfter変数で、整数を返します。

ERROR_MESSAGE

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

使用方法

使用ルール

このコンポーネントは、出力コンポーネントとして使われます。このコンポーネントを使って、データベース内のテーブルまたはテーブルのデータにアクションを実行できます。また、[Row] (行) > [Rejects] (リジェクト)リンクを使って、エラーのあるデータをフィルタリングするリジェクトフローを作成することもできます。tMysqlOutputの使い方の例は、リジェクトリンクを使用してエラーデータを取得するをご覧ください。

Talend StudioとVerticaデータベースは、非常に高速で手頃なデータウェアハウスとデータマートアプリケーションを作成します。Verticaに接続するようにTalend Studioを構成する方法は、TalendおよびHPVerticaのヒントとテクニックをご覧ください。

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

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

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

ダイナミックパラメーターの定義法を示すユースケースについては、コンテキストベースのダイナミック接続によってデータベースからデータを読み取りと、ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取りをご覧ください。[Dynamic settings] (ダイナミック設定)とコンテキスト変数については、Talend Studioユーザーガイドをご覧ください。