Oracle 数据库凭据#

您可使用以下凭据对下列节点进行身份验证：

• OracleDB
• Agent

注意

这些节点不支持 SSH 隧道， 要求 Oracle 数据库版本为 19c 或更高。 如需使用透明应用连续性（TAC）和分片等高级功能，还需 Oracle 客户端库版本为 19c 或更高。

前置条件#

在 Oracle 数据库 服务器上创建用户账户。

支持的认证方式#

• 数据库连接

相关资源#

有关该服务的更多信息，请参阅 Oracle 数据库文档。

使用数据库连接#

配置此凭据需准备：

• 用户名称
• 对应用户的密码
• 连接字符串：要连接的 Oracle 数据库实例。可以是简易连接字符串、tnsnames.ora 文件中的 TNS 别名或数据库实例名
• 使用可选 Oracle 客户端库：如需使用 Oracle 数据库高级功能，请启用此选项。该选项内部使用 node-oracledb 厚模式，需额外配置启用厚模式的设置。详见启用厚模式文档。官方 n8n Docker 镜像不支持此选项
• 使用 SSL：若连接字符串使用 SSL，请启用并配置 SSL 认证的详细信息
• 钱包密码：用于解密 PEM 编码私有证书的密码（若已加密）
• 钱包内容：建立与 Oracle 数据库双向 TLS（mTLS）连接所需的安全凭证
• 可识别名称：应与证书 DN 匹配的可识别名称（DN）
• 匹配可识别名称：除常规证书验证外是否额外验证服务器证书 DN
• 允许弱可识别名称匹配：是否执行安全检查同时验证监听器与服务器证书
• 连接池最小值：创建连接池时与数据库建立的初始连接数
• 连接池最大值：连接池可增长的最大连接数
• 连接池增量：当连接请求超过当前打开连接数时每次新增的连接数
• 连接池最大会话生存时间：连接在池中可存活的最高时长（秒）
• 连接池空闲超时：连接关闭前允许保持空闲状态的时长（秒）
• 连接类名称：DRCP/PRCP 连接类。详见启用 DRCP
• 连接超时：建立 Oracle Net 连接的超时时长（秒）
• 传输连接超时：等待建立数据库主机连接的最大秒数
• 保活探测间隔：发送保活探测包的时间间隔（分钟）

设置数据库连接凭据的步骤：

1. 在 n8n 凭据中将数据库用户名填入用户字段

2. 输入对应用户的密码

3. 在 n8n 凭据中将数据库连接字符串填入连接字符串字段

4. 若数据库使用 SSL 且需配置 SSL 连接，请在凭据中启用此选项。启用后，在这些字段中输入 Oracle 数据库 SSL 证书信息：

   1. 输入保留换行符的 PEM 编码钱包文件 ewallet.pem 的内容。命令

node -e "console.log('{{\"' + require('fs').readFileSync('ewallet.pem', 'utf8').split('\n').join('\\\\n') + '\"}}')"

可用于将文件内容转储到钱包内容字段中。

有关处理TLS连接的更多信息，请参阅node-oracledb文档。