连接到 Microsoft SQL Server

借助 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/23

  • 2001:4860:4807::/48(可选,用于支持 IPv6 的平台)

Microsoft SQL Server 连接器的限制

  • 使用此连接器时,每个查询最多可以查询 15 万行。如果超出此限制,数据将被截断。
  • 列标题(字段名称)只能使用 ASCII 字符。不支持非 ASCII 字符。

问题排查

如需查看常见错误消息列表及其解决方法,请参阅数据洞察问题排查指南

许可

Microsoft SQL Server 连接器是使用 Microsoft JDBC Driver for SQL Server 开发的,该驱动程序根据 MIT 许可分发。

创建数据源