MySQL 连接器 - 功能和设置
可以使用 MySQL 连接器连接到 MySQL 数据库并访问其中的数据。在此页面上,可以了解相关功能、可用设置以及处理与 MySQL 的数据连接时的注意事项。
页面内容
连接器功能
当您使用 MySQL 连接器访问数据时,可以使用以下功能。
功能 | 支持? |
---|---|
加载方法 |
|
自定义查询 | 是 |
预存程序 | 是(SingleStore 除外) |
自定义连接属性 | 否 |
使用身份提供程序进行单点登录 | 否 |
在 Web 客户端中编写 | 否 |
包含在 Linux 上的 Spotfire 发行版中 | 是 |
数据源属性
以下是在使用 MySQL 连接器创建数据连接时可以配置的受支持的数据源属性。
选项 | 说明 |
---|---|
服务器 |
您的数据所在的服务器名称。若要包含端口号,请将其直接添加在名称的后面,前面带有冒号。 端口号的示例:MyDatabaseServer:1234 |
数据库系统 |
选择要连接至的服务器的数据库系统类型:
如果在运行 Spotfire 的计算机上安装了多个受支持的驱动程序,您的选择还会决定连接器将使用哪个 ODBC 驱动程序。 提示: 有关不同选项对应哪个驱动程序以及在哪里可以找到驱动程序的详细信息,请参见 Spotfire 中的驱动程序和数据源。
如果未安装所选数据库系统的驱动程序,但安装了另一个受支持的驱动程序,则连接器将尝试将该驱动程序用于连接。如果安装了多个其他受支持的驱动程序,Spotfire 会按以下顺序选择要使用的驱动程序:
|
Use SSL |
确定是否为数据库连接启用安全套接层 (SSL)。 重要: 在连接 MemSQL 和 MongoDB Connector for BI 时不支持“使用 SSL”和配置 SSL 的选项。
|
嵌入证书文件 |
[仅当选择“使用 SSL”时可用。] 选择 SSL 模式 VERIFY_CA 或 VERIFY_IDENTITY 时要用于验证数据库服务器的证书文件。 要嵌入证书,请单击“浏览”并选择计算机上的证书文件。证书文件将嵌入并存储在 Spotfire 数据源中。 提示: 由于嵌入了证书文件,因此其他用户不必将证书文件保存在其计算机上。
我应该使用什么证书文件? 注: 如果您是 TIBCO Cloud™ Spotfire® 用户,则只能使用包含公钥的证书文件。
证书文件必须与数据库服务器上的 CA 证书匹配。 建议仅使用包含公钥的证书文件。 使用包含私钥的证书文件会带来安全风险,因为证书文件嵌入在 Spotfire 数据源中,可能还会嵌入在分析文件中。 要嵌入包含私钥的证书文件,您必须是已启用偏好设置 提示: 为保持高效重用和可维护性,建议在库中共享连接数据源。
|
浏览 | 打开一个对话框,您可以在其中浏览并选择计算机上的证书文件。 |
视图 |
在 Windows 中打开“证书”对话框,您可以在其中查看有关嵌入的证书文件的信息。 |
删除 | 删除嵌入的证书文件。 |
SSL 模式 |
[仅当选择“使用 SSL”时可用。] 决定要在与数据源的连接中使用的 SSL 模式。包括以下选项: PREFERRED 如果可能,则在连接中使用加密。 REQUIRED 连接必须加密。 VERIFY_CA [要使用此选项,必须嵌入证书文件。] 连接必须加密。客户端将验证数据库服务器的 CA 证书。 VERIFY_IDENTITY [要使用此选项,必须嵌入证书文件。] 连接必须加密。客户端将验证数据库服务器的 CA 证书,包括验证主机名是否与证书匹配。 单向 TLS [仅适用于与 MariaDB 的连接。] 在“数据库系统”下拉菜单中选择“MariaDB”时,“单向 TLS”是唯一可用的 SSL 模式。 |
身份验证方法 |
当登录到数据库时要使用的身份验证方法。从“Windows 身份验证”和“数据库身份验证”中选择。 Windows 身份验证 [只适用于与 MySQL 数据库的连接。] 若使用 Windows 身份验证,Spotfire 会使用当前登录的 Windows 用户 ( 数据库身份验证 使用数据库身份验证,身份验证由数据库用户完成。通过使用“数据源设置”对话框中的设置,可将数据库凭据作为分析文件的一部分加以存储和解密。如果在分析文件中找到凭据,则会使用这些凭据对数据库进行自动身份验证。 如果在分析文件中未找到凭据或凭据配置文件,则打开该文件的所有用户都将被提示输入数据库凭据。 请注意,如果嵌入到分析文件中的凭据失败,则不会提示输入凭据。 |
转换零日期时间 |
确定如何在连接中处理无效的日期时间值(例如“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 |