为 JDBC 驱动程序版本 2.1 创建初始化(.ini)文件
通过对 Amazon Redshift JDBC 驱动程序 2.1 版本使用初始化(.ini)文件,您可以指定系统级别的配置参数。例如,联合 IdP 身份验证参数可能因每个应用程序而异。.ini 文件为 SQL 客户端提供了获取所需配置参数的常见位置。
您可以创建包含 SQL 客户端配置选项的 JDBC 驱动程序 2.1 版本初始化(.ini)文件。文件的默认名称为 rsjdbc.ini。JDBC 驱动程序 2.1 版本在按优先级顺序列出的以下位置检查 .ini 文件:
IniFile连接 URL 或 SQL 客户端的连接属性对话框中的 参数。请确保IniFile参数包含 .ini 文件的完整路径,其中包括文件名。有关IniFile参数的信息,请参阅 IniFile。如果IniFile参数错误地指定了 .ini 文件的位置,将显示错误。环境变量,例如具有完整路径 AMAZON_REDSHIFT_JDBC_INI_FILE,包括文件名。您可以使用
rsjdbc.ini或指定文件名。如果 AMAZON_REDSHIFT_JDBC_INI_FILE 环境变量错误地指定了 .ini 文件的位置,将显示一个错误。驱动程序 JAR 文件所在的目录。
用户主目录。
系统的临时目录。
您可以将 .ini 文件组织成各个部分,例如 [DRIVER]。每个部分都包含键-值对,这些键-值对将指定各种连接参数。您可以使用 IniSection 参数来指定 .ini 文件中的部分。有关 IniSection 参数的信息,请参阅 IniSection。
以下是 .ini 文件格式的示例,其中包含了 [DRIVER]、[DEV]、[QA] 和 [PROD] 的部分。[DRIVER] 部分可以应用于任何连接。
[DRIVER] key1=val1 key2=val2 [DEV] key1=val1 key2=val2 [QA] key1=val1 key2=val2 [PROD] key1=val1 key2=val2
JDBC 驱动程序 2.1 版本从按优先级顺序列出的以下位置加载配置参数:
-
应用程序代码中的默认配置参数。
-
.ini 文件中的 [DRIVER] 部分属性(如果包含)。
-
自定义部分配置参数,如果
IniSection选项在连接 URL 或 SQL 客户端的连接属性对话框中提供。 -
getConnection调用中指定的连接属性对象的属性。 -
连接 URL 中指定的配置参数。