您可以使用 MySQL 连接器将 MySQL 数据库连接到数据洞察。使用数据库表或自定义查询来构建交互式报告和信息中心。然后，您可以与没有直接数据库访问权限的利益相关者或团队成员分享这些数据洞见。
支持的版本
我们已在以下 MySQL 版本中测试过 数据洞察：
- 5.6
- 5.7
- 8.0
如果您在使用受支持的版本时遇到问题，请在数据洞察社区中告知我们。您还可以在问题跟踪器中添加功能请求并对其进行投票。
如何连接到 MySQL
数据洞察数据源可以连接到单个 MySQL 数据库表，也可以连接到您提供的自定义查询。
如需连接到 MySQL 数据库，请按以下步骤操作：
- 登录数据洞察。
- 在数据洞察首页上，点击 创建，然后选择数据源。
- 选择 MySQL 连接器。
- 使用连接选项之一配置对数据库的访问权限。
- 点击AUTHENTICATE。您会看到相应数据库中的表格列表。
- 从列表中选择一个表，或输入自定义查询。
- 点击连接。
现在，您可以将表格中的所有列作为报告中的字段进行访问。
连接选项
使用主机名或 IP 地址进行连接
在连接中，选择基本。输入连接详细信息：
- 主机名或 IP 地址
- 端口（可选）
- 数据库
- 用户名
- 密码
使用 JDBC 网址进行连接
在连接中，选择 JDBC 网址。输入连接详细信息：
- JDBC 网址
示例
jdbc:mysql://HOSTNAME[:PORT];databaseName=DATABASE
- 用户名
- 密码
如需使用 IPv6 字面地址进行连接，请将该地址放在方括号中。例如：jdbc:mysql://[2001:db8:1:1:1:1:1:1]/your_db。
使用 SSL 进行连接
数据洞察支持使用 TLS（传输层安全协议）(TLS 1.2) 与服务器建立安全（加密）连接。TLS 也称为 SSL（安全套接字层）。
如需启用安全连接，请选择 Enable SSL，然后提供 SSL 配置文件。
数据洞察不要求使用 SSL，但您的数据库配置可能要求使用 SSL。如需了解详情，请咨询您的数据库供应商。
使用客户端身份验证进行连接
选中启用客户端身份验证框后，您可以上传客户端私钥和客户端证书（如果需要访问数据库）。
数据洞察不需要使用客户端身份验证，但您的数据库配置可能需要。如需了解详情，请咨询您的数据库供应商。
自定义查询
选择自定义查询选项，以提供 SQL 查询，而不是连接到单个表。Data Studio 会将此自定义 SQL 用作所生成的每个数据库查询的内部 select 语句。
自定义 SQL 查询只能包含一条语句。例如，以下代码将无法正常运行，因为它包含多个 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;
数据洞察中的查询可能会在 3 到 5 分钟后超时。如果自定义查询超时，请尝试以下方法来解决问题：
- 简化查询，以便更快地运行。
- 在数据库中运行查询，并将结果存储在单独的表中。连接数据源中的新表。
支持的数据类型
数据洞察会将数据库的内置数据类型映射到一组统一的数据类型。如果数据洞察在您的表格或查询中遇到不受支持类型的列，则不会为该列创建字段。防火墙和数据库访问
如需允许数据洞察连接到防火墙后面的数据库并查询这些数据库，您需要开放对以下某个 IP 地址的访问权限。 您可能还需要配置数据库以接受来自这些地址的流量。如需了解相关说明，请参阅您使用的特定数据库的文档。
IP 地址
以下地址预留给数据工作室的全球基础架构：
142.251.74.0/232001:4860:4807::/48（可选，用于支持 IPv6 的平台）
如果您已为数据洞察 Pro 订阅启用数据驻留，请改用以下地址：
142.251.56.0/242001:4860:4815::/48（可选，用于支持 IPv6 的平台）
MySQL 连接器的限制
- 数据洞察数据源可以连接到单个 MySQL 数据库表。
- 数据洞察 MySQL 连接器基于 Google Cloud SQL for MySQL，因此在版本和支持的功能方面受到相同的限制。详细了解 Google Cloud SQL for MySQL。
- 数据洞察不支持 MySQL 空间数据扩展。
- 使用此连接器时，每个查询最多可以查询 15 万行。如果超出此限制，数据将被截断。
- 列标题（字段名称）只能使用 ASCII 字符。不支持非 ASCII 字符。
问题排查
如需查看常见出错提示的列表以及解决这些问题的步骤，请参阅 数据洞察问题排查指南。