借助 Microsoft SQL Server 连接器,您可以基于 Microsoft SQL Server 创建数据源。然后,您可以在数据洞察报告和探索中直观呈现这些数据。
支持的版本
Microsoft SQL Server 连接器使用 V7.2 JDBC 驱动程序。该连接器已在 MS SQL Server 上经过测试,并且与以下早期版本兼容:
- 2017
- 2016
- 2014
- 2012
请查看 MS SQL Server 版本兼容性文档,了解您的数据库版本是否与 V7.2 JDBC 驱动程序兼容。
如何连接到 Microsoft SQL Server
数据洞察数据源可以连接到单个 Microsoft SQL Server 数据库表,也可以连接到您提供的自定义查询。
第 1 步
第 2 步
在数据洞察首页的左上角,依次点击 创建 和数据源 。
第 3 步
选择 Microsoft SQL Server 连接器。
第 4 步
使用主机名或 IP 地址,或者 JDBC 网址设置与数据库的连接。
使用主机名或 IP 地址连接
在连接中,选择 基本 。输入连接详细信息:
- 主机名或 IP 地址
- 端口(可选)
- 数据库
- 用户名
- 密码
使用 JDBC 网址连接
在连接中,选择 JDBC 网址 。输入连接详细信息:
- JDBC 网址
示例 :
jdbc:sqlserver://HOSTNAME[:PORT];databaseName=DATABASE
- 用户名
- 密码
如果您使用 JDBC 主机名选项,可以确保可以使用 Whois 等公共 DNS 查找工具访问该选项。
如需使用 IPv6 字面量地址进行连接,请将该地址括在方括号内。例如: jdbc: sqlserver ://[2001:db8:1:1:1:1:1:1]/your_db
第 5 步
启用 SSL
数据洞察支持使用 TLS(传输层安全协议)与服务器建立安全(加密)连接。TLS 也称为 SSL(安全套接字层)。如需启用安全连接,请选中启用 SSL,然后提供 SSL 配置文件。
数据洞察不需要此设置,但数据库配置可能需要此设置。如需了解详情,请与数据库供应商联系。
第 6 步
点击身份验证 。
第 7 步
从列表中选择一个表,或输入自定义查询。
选择自定义查询 选项,以提供 SQL 查询,而不是连接到单个表。对于生成的每个数据库查询,数据洞察都会将此自定义 SQL 用作内部 select 语句。
例如,以下查询将无法 正常运行,因为它包含多个 SQL 语句:
DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;
SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;
数据洞察中的查询可能会在三到五分钟后超时。如果您的自定义查询超时,请尝试以下方法来解决此问题:
- 简化查询,使其运行速度更快。
- 在数据库中运行查询,并将结果存储在单独的表中。在数据源中连接新表。
第 8 步
点击连接 。
片刻之后,系统会显示数据源字段列表页面。点击创建报告 ,开始直观呈现数据。
备注
数据类型
数据洞察会将数据库的内置数据类型映射到一组统一的数据类型。如果数据洞察在表或查询中遇到不受支持类型的列,则不会为该列创建字段。
防火墙和数据库访问权限
如需允许数据洞察连接到防火墙后面的数据库并查询这些数据库,您需要开放对以下某个 IP 地址的访问权限。您可能还需要将数据库配置为接受来自这些地址的流量。如需了解具体操作说明,请参阅特定数据库的文档。
IP 地址
142.251.74.0/232001:4860:4807::/48(可选,用于支持 IPv6 的平台)
Microsoft SQL Server 连接器的限制
- 使用此连接器时,每个查询最多可以查询 15 万行。如果超出此限制,数据将被截断。
- 列标题(字段名称)只能使用 ASCII 字符。不支持非 ASCII 字符。
问题排查
如需查看常见错误消息列表及其解决方法,请参阅数据洞察问题排查指南。
许可
Microsoft SQL Server 连接器是使用 Microsoft JDBC Driver for SQL Server 开发的,该驱动程序根据 MIT 许可分发。