借助 Microsoft® SQL Server® 连接器,您可以 使用链式命令 在 Microsoft SQL Server 数据库中执行结构化查询语言 (SQL) 操作,包括 Microsoft Dynamics® Great Plains® (GP) 或 Yardi® Private Cloud 等解决方案。例如,使用此连接器,您可以:
- 执行 SQL 命令,包括
CREATE或UPDATE语句或SELECT查询 - 检索 SQL Server 中表的详细信息
- 将记录插入 SQL Server 数据库
注: 此连接器由 Workiva 构建,并连接到第三方系统。虽然我们的支持团队可以帮助您在工作区内配置此连接器,但我们无法对源自 Workiva 平台之外的任何问题进行故障排除或提供其他帮助。
要求
为了实现与 SQL Server 数据库的连接,连接器使用 Java 数据库连接 (JDBC),并通过基本的用户名和密码身份验证进行保护。要设置连接器,您需要:
- 在 SQL Server 中为连接器创建的指定集成用户
- 集成用户的用户名和密码
- JDBC 连接的 URL,例如
jdbc:sqlserver://localhost:1433;[选项] - 要连接到本地 SQL Server 数据库, 需要连接 GroundRunner
支持的版本
Microsoft® SQL Server® 连接器与 以下数据库版本兼容:
- Azure SQL 数据库
- Azure Synapse|Azure Synapse Analytics
- Azure SQL 托管实例
- SQL Server 2022
- SQL Server 2019
- SQL Server 2017
- SQL Server 2016
- SQL Server 2014
设置 Microsoft SQL Server 连接器
注: 要使连接器可在您组织的链中使用, 组织安全管理员首先需要在配置中启用它。
- 从 链构建器中,单击 连接,然后单击右上角的 创建 。
- 在 连接器连接下,选择 Microsoft SQL Server和要与连接一起使用的运行程序。
- 在 基本信息下,输入一个唯一的名称和描述,以帮助识别连接。
- 在 属性下,输入连接器的详细信息:
摘要信息 详细信息 用户名 输入连接器的 SQL Server 集成用户的用户名。 密码 输入 Username 属性的密码。 连接 URL 输入 JDBC 连接的 URL,例如 jdbc:sqlserver://<server> :<port>。 要为连接添加 可选属性,请将它们附加在分号之后,例如: jdbc:sqlserver://localhost:1433;<options>。例如,要使用 Active Directory® 集成安全性连接到数据库:;databasename=<database> ;integratedSecurity=True;authenticationScheme=NTLM注意:默认端口为
1433;但是,您的环境中的端口可能有所不同。注意: 所有敏感凭证均自动加密并以高级加密标准 (AES)-256 加密方式存储。出于安全考虑,请避免将用户凭据作为可选属性包含在 “连接 URL ”属性中
。 - 选择要与连接一起使用的环境,然后单击 保存。
- 要测试连接, 创建并运行一个链 ,使用 连接器的 获取表定义命令,并验证它是否返回有效输出。
疑难解答
如果与 SQL Server 的连接失败:
- 验证集成用户的身份验证凭据。
- 检查 JDBC 连接的 URL,包括其服务器和端口。
- 如果连接到本地数据库,请检查为连接器选择的 GroundRunner。
如果连接执行命令失败,请验证其输入(例如 SQL 语法或表)是否有效。