借助 MySQL 连接器，您可以在数据洞察中访问 MySQL 数据库中的数据。
如何连接到 MySQL
数据洞察数据源可以连接到单个 MySQL 数据库表。
Data Studio 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;
数据洞察中的查询可能会在 3 到 5 分钟后超时。如果您的自定义查询超时，请尝试以下方法来解决此问题：
- 简化查询，以便更快地运行。
- 在数据库中运行查询，并将结果存储在单独的表中。连接数据源中的新表。
第 9 步
点击连接。
稍后，系统会显示数据源字段列表页面。点击创建报告，开始直观呈现数据。
备注
数据类型
数据洞察会将数据库的内置数据类型映射到一组统一的数据类型。如果数据洞察在您的表格或查询中遇到不受支持类型的列，则不会为该列创建字段。
注意：数据洞察不支持 MySQL 的空间数据扩展。
防火墙和数据库访问
如需允许 Google 数据洞察连接到防火墙后面的数据库并查询这些数据库，您需要开放对以下某个 IP 地址的访问权限。您可能还需要将数据库配置为接受来自这些地址的流量。如需了解相关说明，请参阅您使用的特定数据库的文档。
IP 地址
142.251.74.0/232001:4860:4807::/48（可选，用于支持 IPv6 的平台）
MySQL 连接器的限制
- 使用此连接器时，每个查询最多可以查询 15 万行。如果超出此限制，数据将被截断。
- 列标题（字段名称）只能使用 ASCII 字符。不支持非 ASCII 字符。
问题排查
如需查看常见出错提示的列表以及解决这些错误的步骤，请参阅 数据洞察问题排查指南。