N8N中文教程
集成节点/Built in_nodes/Credentials

Microsoft SQL 凭据#

你可以使用这些凭据来认证以下节点:

  • Microsoft SQL

前提条件#

在 Microsoft SQL Server 数据库上创建一个用户账户。

支持的认证方式#

  • SQL 数据库连接

相关资源#

更多关于连接服务的信息,请参考 Microsoft 的连接到 SQL Server 文档。

使用 SQL 数据库连接#

要配置此凭据,你需要提供以下信息:

  • 服务器(Server)名称
  • 数据库(Database)名称
  • 你的 用户(User)账户/ID
  • 你的 密码(Password)
  • 用于连接的 端口(Port)
  • 域名(Domain)名称
  • 是否启用 TLS
  • 是否 忽略 SSL 问题(Ignore SSL Issues)
  • 连接超时时间(Connect Timeout)
  • 请求超时时间(Request Timeout)
  • 连接应使用的 TDS 版本(TDS Version)

要设置数据库连接:

  1. 将 SQL Server 主机名输入为 服务器(Server)。在现有的 SQL Server 连接中,主机名位于实例名之前,格式为 HOSTNAME\INSTANCENAME。可通过以下方式查找主机名:
    • 对象资源管理器(Object Explorer) 窗格中,作为数据库的顶级对象。
    • 在查询窗口的页脚中。
    • 查看当前连接的 属性(Properties),查找 名称(Name)显示名称(Display Name)
    • 参阅 查找 SQL Server 实例名称 | 当你已连接到 SQL Server 获取更多信息。你也可以在 错误日志(Error logs) 中找到相关信息。
  2. 将 SQL Server 实例名输入为 数据库(Database) 名称。可通过上述查找主机名的相同步骤获取此名称。
    • 如果在这些位置均未看到实例名,则你的数据库使用默认的 MSSQLSERVER 实例名。
  3. 输入你的 用户(User) 账户名或 ID。
  4. 输入你的 密码(Password)
  5. 对于 端口(Port)
    • SQL Server 默认使用 1433
    • 如果无法通过端口 1433 连接,请检查 错误日志(Error logs) 中的短语 Server is listening on,以确定应输入的端口号。
  6. 仅当多个域中的用户访问你的数据库时,才需要输入 域(Domain) 名称。运行以下 SQL 查询以获取域名:
1

| ``` SELECT DEFAULT_DOMAIN() [DomainName];


---|---
  7. 选择是否使用 **TLS**。
  8. 选择是否**忽略 SSL 问题**:如果启用,即使 SSL 证书验证失败,凭证仍会尝试连接。
  9. 输入 n8n 在断开连接前尝试完成初始连接的毫秒数,作为**连接超时(Connect Timeout)**。更多信息请参考 SqlConnection.ConnectionTimeout 属性文档。
     * SQL Server 将此超时值以秒为单位存储,而 n8n 使用毫秒。如果你复制的是 SQL Server 的默认值,请将该数值乘以 100 后再输入。
  10. 输入 n8n 在单个请求上等待响应而不超时的毫秒数,作为**请求超时(Request Timeout)**。这基本上等同于查询超时参数。更多信息请参考 排查查询超时错误。
  11. 从 **TDS 版本(TDS Version)** 下拉菜单中选择要使用的 Tabular Data Stream (TDS) 协议版本。如果服务器不支持所选版本,连接将协商使用其他兼容版本。有关 TDS 各版本与不同 SQL Server 版本及 .NET 框架之间的兼容性详细说明,请参阅 附录 A:产品行为(Appendix A: Product Behavior)。可选项包括:
     * **7_4 (SQL Server 2012 ~ 2019)** :TDS 版本 7.4。
     * **7_3_B (SQL Server 2008R2)** :TDS 版本 7.3.B。
     * **7_3_A (SQL Server 2008)** :TDS 版本 7.3.A。
     * **7_2 (SQL Server 2005)** :TDS 版本 7.2。
     * **7_1 (SQL Server 2000)** :TDS 版本 7.1。