tMySQLInvalidRowsの標準プロパティ - Cloud - 8.0

MySQL

Version
Cloud
8.0
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コンポーネント > MySQL
データガバナンス > サードパーティーシステム > DBコンポーネント > MySQL
データクオリティとプレパレーション > サードパーティーシステム > DBコンポーネント > MySQL
Last publication date
2024-03-07

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

標準tMySQLInvalidRows コンポーネントは、ファミリーデータクオリティおよびデータベースに属しています。

このコンポーネントは、Talend Data Management PlatformTalend Big Data PlatformTalend Real-Time Big Data PlatformTalend Data Services PlatformTalend MDM PlatformおよびTalend Data Fabricで使用できます。

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

基本設定

データベース

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

[Validation type] (検証タイプ)

[Regex pattern validation] (正規表現パターンの検証)または[DQ rule validation] (DQルールの検証)のいずれか。

[Regex pattern validation] (正規表現パターンの検証): データベース内のデータを正規表現パターンに基づいて検証します。

[DQ rule validation] (DQルールの検証): データベース内のデータをDQルールに基づいて検証します。

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

[Built-in] (組み込み)[Repository] (リポジトリー)のいずれかです。

[Built-in] (組み込み): 一元的に保存されるプロパティデータはありません。

[Repository] (リポジトリー): プロパティが保存されているリポジトリーファイルを選択します。後続するフィールドは、取得されたデータを使用して事前に入力されます。

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

使用するMySQLのバージョンを選択します。

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

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

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

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

[Host] (ホスト)

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

[Port] (ポート)

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

[Database] (データベース)

データベースの名前。

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

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

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

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

スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは[Built-in] (組み込み)か、[Repository] (リポジトリー)にリモートで保存されます。

 

[Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。[Basic settings] (基本設定)タブにあるコンポーネントスキーマの詳細は、[Basic settings] (基本設定)をご覧ください。

 

[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保存されているため、必要な時に再利用できます。[Basic settings] (基本設定)タブにあるコンポーネントスキーマの詳細は、[Basic settings] (基本設定)をご覧ください。

[Table Name] (テーブル名)

読み取るテーブルの名前を入力します。

[Where clause] (Where句)

WHERE句を入力して、テーブル内に行フィルターを定義します。

テーブル内の分析する行をフィルタリングするには、WHERE句を使用します。このWHERE句で、指定した条件にマッチングする有効なデータと無効なデータを取得できます。

[Analyzed column] (分析済みカラム)

このフィールドは、[Validation type] (検証タイプ)として[Regex pattern validation] (正規表現パターンの検証)が選択された時に利用可能となります。
[Custom pattern] (カスタムパターン)

このチェックボックスを選択してカスタムパターンを入力します。

このチェックボックスは、[Validation type] (検証タイプ)として[Regex pattern validation] (正規表現パターンの検証)が選択された時に利用可能となります。
[Patterns list] (パターンリスト) データベース行をチェックするためのパターンを選択します。

このフィールドは、[Validation type] (検証タイプ)として[Regex pattern validation] (正規表現パターンの検証)が選択された時に利用可能となります。

[DQ rule list] (DQルールリスト)

データベース行をチェックするルールをリストから選択します。

このフィールドは、[Validation type] (検証タイプ)として[DQ rule validation] (DQルールの検証)が選択された時に利用可能となります。
[Query type] (クエリータイプ) [Built-in] (組み込み): 手動でクエリーステートメントを入力するか、SQLBuilderを使ってグラフィカルに作成します。

[Repository] (リポジトリー): リポジトリーに保管されている関連クエリーを選択すると、[Query] (クエリー)フィールドはそれに従って入力されます。

このフィールドは、[Validation type] (検証タイプ)として[DQ rule validation] (DQルールの検証)が選択された時に利用可能となります。
[Guess Query] (クエリーを推測)

クリックして、お使いのテーブルスキーマに対応するクエリーを生成します。クエリーは[Query] (クエリー)フィールドで編集できます。

このボタンは、[Validation type] (検証タイプ)として[DQ rule validation] (DQルールの検証)が選択された時に利用可能となります。

[Guess Schema] (推測スキーマ)

クリックして、テーブルからスキーマを取得します。

このボタンは、[Validation type] (検証タイプ)として[DQ rule validation] (DQルールの検証)が選択された時に利用可能となります。

[Query] (クエリー) クエリーを二重引用符で囲んで入力するか、[Guess Query] (クエリーを推測)をクリックします。

このフィールドは、[Validation type] (検証タイプ)として[DQ rule validation] (DQルールの検証)が選択された時に利用可能となります。

詳細設定

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

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

ヒント: 事前定義済みのグローバル変数のリストにアクセスするには、Ctrl + スペースを押します。

[Enable stream] (ストリームを有効化)

ストリーミングオーバーバッファリングを有効にする場合は、このチェックボックスを選択します。それによって大きなテーブルからの読み取りでも大量のメモリを消費せずに済むため、パフォーマンスが最適化されます。

[Trim all the String/Char columns] (すべての文字列/文字カラムをトリミング)

すべてのStringカラム/Charカラムの先頭や末尾の空白を削除する場合は、このチェックボックスを選択します。

[Trim column] (カラムをトリミング)

このチェックボックスを選択すると、先行ホワイトスペースおよび後続ホワイトスペースが定義されたカラムから削除されます。

[Trim all the String/Char columns] (すべての文字列/文字カラムをトリミング)がオンの場合、このチェックボックスは表示されません。[Trim column] (カラムをトリミング)を有効にするためには、[Trim all the String/Char columns] (すべての文字列/文字カラムをトリミング)をオフにします。

[tStatCatcher Statistics] (tStatCatcher統計)

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

グローバル変数

グローバル変数

NB_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。

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

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

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

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

変数の詳細は、コンテキストと変数を使用をご覧ください。

使用方法

使用ルール

このコンポーネントは開始ステップまたは中間ステップとして使用でき、出力フローを必要とします。

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

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

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

ダイナミックパラメーターの定義法を示すユースケースについては、コンテキストベースのダイナミック接続によってデータベースからデータを読み取りと、ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取りをご覧ください。ダイナミック設定とコンテキスト変数の詳細は、ダイナミックスキーマコンテキストグループを作成し、その中でコンテキスト変数を定義をご覧ください。