DatabaseRecordLookupService

文档中心 › 组件索引 › DatabaseRecordLookupService

DatabaseRecordLookupService Controller Service

类型全限定名:cn.org.acal.lynxus.lookup.db.DatabaseRecordLookupService

所属 Bundle:cn.org.acal.lynxus:lynxus-lookup-services-nar:2.11.8

描述

基于关系数据库的查找服务。当在数据库中找到查找键时,指定的列将作为记录中的字段返回。

标签

lookupcacheenrichjoinrdbmsdatabasereloadablekeyvaluerecord

属性

下表中,加粗的属性为必填项;其余为可选项。表格同时标注默认值、是否支持表达式语言,以及是否为敏感属性(值会被加密)。

名称默认值可选值描述
Database Connection Pooling Service控制器服务 API:
DBCPService
cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8
用于获取数据库连接的Controller Service
Table Name需要查询的数据库表名。 请注意,这可能区分大小写,具体取决于数据库。
支持表达式语言:是(使用 FlowFile 属性与环境/系统变量求值)
Lookup Key Column表中将用作查找键的列。这将是与查找处理器中指定的属性匹配的列。请注意,根据数据库的不同,这可能是大小写敏感的。
支持表达式语言:是(仅使用环境/系统变量求值)
Lookup Value Columns当查找键匹配时将返回表中以逗号分隔的列列表。 请注意,这可能区分大小写,具体取决于数据库。
支持表达式语言:是(使用 FlowFile 属性与环境/系统变量求值)
Cache Size0指定要缓存多少查找值/记录。缓存由所有表共享,并维护查找值到记录的映射。将此属性设置为零表示不进行缓存,每条记录中的每个查找值都将查询表。如果查找表经常变化或必须获取最新数据,请不要使用缓存。
支持表达式语言:是(仅使用环境/系统变量求值)
Clear Cache on Enabledtrue
  • true
  • false
启用此服务时是否清除缓存。如果缓存大小为零,则忽略此属性。启用时清除缓存可确保服务首先访问数据库获取最新数据。
Cache Expiration清除所有缓存条目的时间间隔。 如果缓存大小为零,则忽略此属性。
支持表达式语言:是(仅使用环境/系统变量求值)
Default Decimal Precision10当 DECIMAL/NUMBER 值作为 'decimal' Avro 逻辑类型写入时,需要特定的 'precision'(表示可用数字的位数)。通常,精度由列数据类型定义或数据库引擎默认值决定。但是,某些数据库引擎可能返回未定义的精度(0)。'默认小数精度' 用于写入这些未定义精度的数字。
支持表达式语言:是(使用 FlowFile 属性与环境/系统变量求值)
Default Decimal Scale0当 DECIMAL/NUMBER 值作为 'decimal' Avro 逻辑类型写入时,需要特定的 'scale'(表示可用小数位数)。通常,小数位数由列数据类型定义或数据库引擎默认值决定。但是,当返回未定义的精度(0)时,某些数据库引擎的小数位数也可能不确定。'默认小数位数' 用于写入这些未定义的数字。如果值的小数位超过指定的小数位数,则值将被四舍五入,例如,小数位数为 0 时 1.53 变为 2,小数位数为 1 时 1.5 保持不变。
支持表达式语言:是(使用 FlowFile 属性与环境/系统变量求值)

状态管理

该组件不存储状态。

受限 (Restricted)

该组件不受限。

提供的 Service API

  • LookupService (cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8)
  • RecordLookupService (cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8)