Spotfire® 用户指南

MySQL 连接器 - 功能和设置

可以使用 MySQL 连接器连接到 MySQL 数据库并访问其中的数据。在此页面上,可以了解相关功能、可用设置以及处理与 MySQL 的数据连接时的注意事项。

页面内容

连接器功能

当您使用 MySQL 连接器访问数据时,可以使用以下功能。

功能 支持?
加载方法
  • 导入(内存中)
  • 外部(数据库内)
  • 按需
自定义查询
预存程序 是(SingleStore 除外)
自定义连接属性
使用身份提供程序进行单点登录
在 Web 客户端中编写
包含在 Linux 上的 Spotfire 发行版中

数据源属性

以下是在使用 MySQL 连接器创建数据连接时可以配置的受支持的数据源属性。

选项 说明
服务器

您的数据所在的服务器名称。若要包含端口号,请将其直接添加在名称的后面,前面带有冒号。

端口号的示例:MyDatabaseServer:1234

数据库系统

选择要连接至的服务器的数据库系统类型:

  • MySQL
  • MariaDB
  • MongoDB Connector for BI
  • SingleStore

如果在运行 Spotfire 的计算机上安装了多个受支持的驱动程序,您的选择还会决定连接器将使用哪个 ODBC 驱动程序。

提示: 有关不同选项对应哪个驱动程序以及在哪里可以找到驱动程序的详细信息,请参见 Spotfire 中的驱动程序和数据源

如果未安装所选数据库系统的驱动程序,但安装了另一个受支持的驱动程序,则连接器将尝试将该驱动程序用于连接。如果安装了多个其他受支持的驱动程序,Spotfire 会按以下顺序选择要使用的驱动程序:

  1. MySQL Connector/ODBC
  2. MariaDB Connector/ODBC
  3. MongoDB ODBC Driver for BI Connector
注: 如果您选择 SingleStore,Spotfire 会要求您安装特定版本的 MySQL Connector/ODBC 驱动程序。有关受支持的驱动程序版本的详细信息,请参见系统要求
Use SSL

确定是否为数据库连接启用安全套接层 (SSL)。

重要: 在连接 MemSQL 和 MongoDB Connector for BI 时不支持“使用 SSL”和配置 SSL 的选项。
嵌入证书文件

[仅当选择“使用 SSL”时可用。]

选择 SSL 模式 VERIFY_CAVERIFY_IDENTITY 时要用于验证数据库服务器的证书文件。

要嵌入证书,请单击“浏览”并选择计算机上的证书文件。证书文件将嵌入并存储在 Spotfire 数据源中。

提示: 由于嵌入了证书文件,因此其他用户不必将证书文件保存在其计算机上。

我应该使用什么证书文件?

注: 如果您是 TIBCO Cloud™ Spotfire® 用户,则只能使用包含公钥的证书文件。

证书文件必须与数据库服务器上的 CA 证书匹配。

建议仅使用包含公钥的证书文件。

使用包含私钥的证书文件会带来安全风险,因为证书文件嵌入在 Spotfire 数据源中,可能还会嵌入在分析文件中。

要嵌入包含私钥的证书文件,您必须是已启用偏好设置 AllowEmbeddingCertificatesWithPrivateKeys 的用户组的成员。

提示: 为保持高效重用和可维护性,建议在库中共享连接数据源。
浏览 打开一个对话框,您可以在其中浏览并选择计算机上的证书文件。
视图

在 Windows 中打开“证书”对话框,您可以在其中查看有关嵌入的证书文件的信息。

删除 删除嵌入的证书文件。
SSL 模式

[仅当选择“使用 SSL”时可用。]

决定要在与数据源的连接中使用的 SSL 模式。包括以下选项:

PREFERRED

如果可能,则在连接中使用加密。

REQUIRED

连接必须加密。

VERIFY_CA

[要使用此选项,必须嵌入证书文件。]

连接必须加密。客户端将验证数据库服务器的 CA 证书。

VERIFY_IDENTITY

[要使用此选项,必须嵌入证书文件。]

连接必须加密。客户端将验证数据库服务器的 CA 证书,包括验证主机名是否与证书匹配。

单向 TLS

[仅适用于与 MariaDB 的连接。]

在“数据库系统”下拉菜单中选择“MariaDB”时,“单向 TLS”是唯一可用的 SSL 模式。

身份验证方法

当登录到数据库时要使用的身份验证方法。从“Windows 身份验证”“数据库身份验证”中选择。

Windows 身份验证

[只适用于与 MySQL 数据库的连接。]

若使用 Windows 身份验证,Spotfire 会使用当前登录的 Windows 用户 (DOMAIN\Username) 进行身份验证。这要求您在 MySQL 数据库中设置一个格式为 DOMAIN\Username 的相应用户。

数据库身份验证

使用数据库身份验证,身份验证由数据库用户完成。通过使用“数据源设置”对话框中的设置,可将数据库凭据作为分析文件的一部分加以存储和解密。如果在分析文件中找到凭据,则会使用这些凭据对数据库进行自动身份验证。

如果在分析文件中未找到凭据或凭据配置文件,则打开该文件的所有用户都将被提示输入数据库凭据。

请注意,如果嵌入到分析文件中的凭据失败,则不会提示输入凭据。

转换零日期时间

确定如何在连接中处理无效的日期时间值(例如“0000-00-00 00:00:00”)。

选中“转换零日期时间”时,无效的日期时间值会返回为“null”。

清除“转换零日期时间”时,将不接受无效的日期时间值。

默认情况下,会清除“转换零日期时间”

字符集 选择应该用于将查询从驱动程序编码到数据库的字符集。
连接超时(秒)

指定与数据库建立连接时等待的最大秒数。

默认值为 120。

注: 如果将连接超时设为零,则被视为永不超时。这意味着,尝试连接时不设上限。通常不建议采取这种做法。
命令超时 (秒)

指定执行一条命令所允许的最大秒数。

默认值为 1800。

注: 如果将命令超时设为零,则被视为永不超时。这意味着,尝试执行命令时不设上限。通常不建议采取这种做法。
注: 有关高级设置的详细信息,请参阅驱动程序供应商提供的官方文档。

受支持的数据类型

设置到外部数据源的连接时,Spotfire 需要将数据源中的数据类型映射到 Spotfire 中的数据类型。以下是 MySQL 连接器支持的数据类型。

数据库数据类型 Spotfire 数据类型
BINARY Binary
BLOB Binary
LONGBLOB Binary
MEDIUMBLOB Binary
TINYBLOB Binary
BIT Boolean
DATE Date
DATETIME DateTime
TIMESTAMP DateTime
INT Integer
MEDIUMINT Integer
SMALLINT Integer
TINYINT Integer
YEAR Integer
BIGINT LongInteger
DOUBLE Real
FLOAT SingleReal
CHAR String
ENUM String
LONGTEXT String
MEDIUMTEXT String
NCHAR String
NVARCHAR String
SET String
TINYTEXT String
VARBINARY String
VARCHAR String
TIME Time
DECIMAL(p, s)

当 p <= 9 并且 s = 0 时:Integer

当 9 < p <= 18 并且 s = 0 时:LongInteger

其他:Real

支持的函数

支持的函数是指您在处理数据库中的数据表时可以使用的函数,例如在计算的列和自定义表达式中使用。

注: 您的数据库可能无法使用某些受支持的函数。这取决于数据库中可用的函数,不同数据库版本和类型之间通常会有差异。

以下是 MySQL 连接器支持的函数。

函数类型 支持的函数
日期和时间 Year, Quarter, Month, Week, WeekDay, WeekOfYear, Day, DayOfMonth, DayOfYear, DayOfWeek, DayName, Hour, Minute, Second, Microsecond
转换 SN
数学 Abs, ASin, ACos, ATan, Ceiling, Cos, Sin, Tan, Cot, Exp, Floor, Log, Log10, Log2, Ln, Power, Sqrt, Degrees, Pi, Truncate
运算符 +, -, *, /, %
统计 Sum, Avg, Min, Max, Count, UniqueCount, Std, Stddev_Samp, Var_Samp, Var_Pop
文本 Concat, Instr, Length, Lower, LPad, RPad, RTrim, Trim, Upper, LeftString, RightString, Locate, Space, Replace, Substring, Substring_Index, Soundex, Reverse, Format, Insert