DatabaseParameterProvider

从数据库提供参数

DatabaseParameterProvider 的核心是把数据库行映射为参数，由 Parameter Name Column 和 Parameter Value Column 指定。还需要确定参数组（Parameter Group）的名称，可以通过 Parameter Grouping Strategy 以不同方式指定。

在讨论具体配置之前，请注意：在某些数据库中，'PARAMETER'、'PARAMETERS'、'GROUP' 甚至 'VALUE' 都是保留字。如果所选的列名在你使用的数据库中是保留字，请按照数据库文档对其进行加引号处理。

另外还应注意，表名和列名要使用你的数据库所偏好大小写形式。例如，Postgres 偏好小写的表名和列名， 而 Oracle 偏好首字母大写的形式。选择合适的大小写可以避免在配置 DatabaseParameterProvider 时 出现意外问题。

默认配置采用完全的基于列的方式，参数组名也由同一张表中的列指定。使用这种配置的表示例如下：

PARAMETER_CONTEXTS

表 1：Grouping Strategy = Column 时的数据库表示例

要使用该表中的数据，请设置以下属性：

• Parameter Grouping Strategy - Column
• Table Name - PARAMETER_CONTEXTS
• Parameter Name Column - PARAMETER_NAME
• Parameter Value Column - PARAMETER_VALUE
• Parameter Group Name Column - PARAMETER_GROUP

获取完成后，本示例中的参数如下：

参数组 group_1：

• param.foo - value-foo
• param.bar - value-bar

参数组 group_2：

• param.one - value-one
• param.two - value-two

分组策略（Grouping Strategy）

默认的分组策略是按列（Column），它允许在 Parameter Group Column 中显式指定参数组名。注意， 如果该列的值为 NULL，会抛出异常。

另一种分组策略是按表（Table），它把每张表映射为一个参数组，并将参数组名设为表名。使用这种 分组策略时不会用到 Parameter Group Column。使用此策略的配置示例如下：

• Parameter Grouping Strategy - Table
• Table Names - KAFKA, S3
• Parameter Name Column - PARAMETER_NAME
• Parameter Value Column - PARAMETER_VALUE

可以配合该策略使用的表示例：

KAFKA

表 2：Grouping Strategy = Table 时的 'KAFKA' 数据库表示例

S3

表 3：Grouping Strategy = Table 时的 'S3' 数据库表示例

获取完成后，本示例中的参数如下：

参数组 KAFKA：

• brokers - http://localhost:9092
• topic - my-topic
• password - my-password

参数组 S3：

• bucket - my-bucket
• secret.access.key - my-key

过滤行

如果只需要把表中的部分行作为参数引入，可以使用 'SQL WHERE clause' 属性。示例如下：

• Parameter Grouping Strategy - Table
• Table Names - KAFKA, S3
• Parameter Name Column - PARAMETER_NAME
• Parameter Value Column - PARAMETER_VALUE
• SQL WHERE clause - OTHER_COLUMN = 'my-parameters'

这里假设 KAFKA 和 S3 两张表中都有另一个列 'OTHER_COLUMN'。那么只有 'OTHER_COLUMN' 值为 'my-parameters' 的行才会从这些表中被获取。