借助 MySQL 连接器，您可以在数据洞察中访问 MySQL 数据库的数据。
如何连接到 MySQL
数据洞察数据源可以连接到单个 MySQL 数据库表。
数据洞察 MySQL 连接器基于 Google Cloud SQL for MySQL，并且受版本和支持的功能方面的相同限制。详细了解 Google Cloud SQL for MySQL。
支持的版本
我们已在以下 MySQL 版本上测试了数据洞察：
- 5.6
- 5.7
- 8.0
如果您在使用受支持的版本时遇到问题，请在数据洞察社区中告知我们。您还可以在问题跟踪器中添加功能请求并对其进行投票。在问题跟踪器上。
若要连接，请执行以下操作：
第 1 步
第 2 步
在数据洞察首页的左上角，依次点击 创建 ，然后选择数据源。
第 3 步
选择 MySQL 连接器。
第 4 步
使用主机名或 IP 地址或 JDBC 网址设置与数据库的连接。
使用主机名或 IP 地址连接
在连接中，选择 基本 。输入连接详细信息：
- 主机名或 IP 地址
- 端口（可选）
- 数据库
- 用户名
- 密码
使用 JDBC 网址连接
在连接中，选择 JDBC 网址 。输入连接详细信息：
- JDBC 网址
示例 ：
jdbc:mysql://HOSTNAME[:PORT];databaseName=DATABASE
- 用户名
- 密码
如果您使用 JDBC 主机名选项，则可以使用 Whois 等公共 DNS 查找工具确保该选项可访问。
若要使用 IPv6 字面量地址进行连接，请将该地址括在方括号内。例如： jdbc: mysql ://[2001:db8:1:1:1:1:1:1]/your_db
第 5 步
启用 SSL
数据洞察支持使用 TLS（传输层安全协议）与服务器建立安全（加密）连接。TLS 也称为 SSL（安全套接字层）。如需启用安全连接，请选中启用 SSL，然后提供 SSL 配置文件。
数据洞察不需要此设置，但数据库配置可能需要此设置。如需了解详情，请与数据库供应商联系。
第 6 步
启用客户端身份验证
选中此复选框后，您可以上传客户端私钥和客户端证书（如果需要访问数据库）。
数据洞察不需要此设置，但数据库配置可能需要此设置。如需了解详情，请与数据库供应商联系。
第 7 步
点击身份验证 。
第 8 步
从列表中选择一个表，或输入自定义查询。
选择自定义查询 选项，以提供 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;
数据洞察中的查询可能会在三到五分钟后超时。如果您的自定义查询超时，请尝试以下方法来解决此问题：
- 简化查询，使其运行速度更快。
- 在数据库中运行查询，并将结果存储在单独的表中。在数据源中连接新表。
第 9 步
点击连接 。
片刻之后，系统会显示数据源字段列表页面。点击创建报告 ，开始将数据可视化。
备注
数据类型
数据洞察会将数据库的内置数据类型映射到一组统一的数据类型。如果数据洞察在表或查询中遇到不受支持类型的列，则不会为该列创建字段。
注意 ：数据洞察不支持 MySQL 的空间数据扩展。
防火墙和数据库访问
如需允许数据洞察连接到防火墙后面的数据库并查询这些数据库，您需要开放对以下某个 IP 地址的访问权限。 您可能还需要将数据库配置为接受来自这些地址的流量。如需了解具体操作说明，请参阅特定数据库的文档。
IP 地址
以下地址是为数据洞察的全球基础架构预留的：
142.251.74.0/232001:4860:4807::/48（可选，用于支持 IPv6 的平台）
如果您已为 数据洞察 Pro 订阅启用数据驻留，请改用以下地址：
142.251.56.0/242001:4860:4815::/48（可选，用于支持 IPv6 的平台）
MySQL 连接器的限制
- 使用此连接器时，每个查询最多可以查询 15 万行。如果超出此限制，数据将被截断。
- 列标题（字段名称）只能使用 ASCII 字符。不支持非 ASCII 字符。
问题排查
如需查看常见错误消息列表及其解决方法，请参阅数据洞察问题排查指南。