DatabaseRecordLookupService

説明

リレーショナル データベースを基にした検索サービス。ルックアップ キーがデータベースで見つかると、指定された列 (Lookup Value Columns が指定されていない場合はすべて) が Record として返されます。1つの行だけがそれぞれの検索に返され、重複したデータベース・エントリは無視されます。

タグ

キャッシュ、データベース、エンリッチ、結合、キー、検索、rdbms、記録、リロード可能、値

プロパティ

以下のリストでは、必要なプロパティをアスタリスク (*) で表示しています。その他のプロパティはオプションと見なされます。この表は、任意のデフォルト値と、そのプロパティが NiFi 式言語に対応しているかどうかも示します。

表示名

API 名前

デフォルト値

許容値

説明

キャッシュの有効期限

キャッシュの有効期限

すべてのキャッシュエントリをクリアする時間間隔。キャッシュ・サイズがゼロの場合、このプロパティは無視されます。

デフォルトの10進数精度 *

dbf-default-precision

10

DECIMAL/NUMBER の値が'10進数'Avro論理タイプとして記述される場合、利用可能な桁数を示す特定の'精度'が要求されます。一般的に、精度は列のデータ型の定義やデータベースエンジンのデフォルトによって定義されます。しかし、データベースエンジンによっては未定義の精度(0)が返されることがあります。デフォルトの10進数」は、未定義の精度の数値を書き込むときに使用されます。

デフォルトの10進数目盛 *

dbf-default-scale

0

DECIMAL/NUMBER の値が'10進数'Avro論理タイプとして記述される場合、利用可能な10進数の桁数を示す特定の'スケール'が必要となります。一般的に、スケールは列のデータ型定義やデータベースエンジンのデフォルトで定義されます。しかし、未定義の精度(0)が返された場合、データベースエンジンによってはスケールが不確定になることもあります。「デフォルトの10進数」は、未定義の数値を書くときに使われます。もし数値が指定のスケールよりも小数点を持つなら、値は切り上げられます。例えば、1.53はスケール0では2になり、スケール1では1.5になります。

キャッシュサイズ *

dbrecord-lookup-cache-size

0

ルックアップ値/記録をキャッシュする数を指定します。キャッシュはすべてのテーブルで共有され、検索値と記録のマッピングを保持します。このプロパティをゼロにセットすると、キャッシュは行われず、各記録のルックアップ値ごとにテーブルがクエリされます。検索テーブルが頻繁に変更される場合や、最新のデータを取得する必要がある場合は、キャッシュを使用しないでください。

有効時のキャッシュクリア *

dbrecord-lookup-clear-cache-on-enabled

true

  • true

  • false

このサービスが有効になっているときにキャッシュをクリアするかどうか。キャッシュ・サイズがゼロの場合、このプロパティは無視されます。サービスを有効にする際にキャッシュをクリアすることで、サービスが最初にデータベースにアクセスして最新のデータを取得するようになります。

データベース接続プーリングサービス *

dbrecord-lookup-dbcp-service

データベースへの接続を取得するために使用するController Service。

検索キー列 *

dbrecord-lookup-key-column

ルックアップ・キーとなるテーブルの列。これは、検索プロセッサーで指定されたプロパティと照合される列です。データベースによっては大文字と小文字が区別されることに注意してください。

テーブル名 *

dbrecord-lookup-table-name

クエリ対象のデータベース・テーブル名。データベースによっては大文字と小文字が区別されることに注意してください。

検索値列

dbrecord-lookup-value-columns

検索キーがマッチしたときに返されるテーブルの列のカンマ区切りリスト。データベースによっては大文字と小文字が区別されることに注意してください。

状態管理

このコンポーネントは状態を保存しません。

制限あり

このコンポーネントには制限はありません。

システムリソースに関する考察

このコンポーネントは、システムリソースを考慮したものではありません。