连接到 Google Cloud SQL for MySQL

Cloud SQL for MySQL 是一项完全托管式数据库服务，可让您快速在 Cloud Platform 上设置、维护、管理和控制关系型 MySQL 数据库。借助 Cloud SQL for MySQL 连接器，您可以在 Looker Studio 中访问 Cloud SQL for MySQL 数据库中的数据。

支持的版本

Cloud SQL for MySQL 连接器已在以下 MySQL 版本上进行了测试：

  • 5.6
  • 5.7
  • 8.0

如果您在使用受支持的版本时遇到问题，请在 Looker Studio 帮助社区中告诉我们。您可以点击此处添加功能请求并对其进行投票。

如何连接到 Cloud SQL for MySQL

Looker Studio 数据源可以连接到单个 Cloud SQL for MySQL 数据库表，也可以连接到您提供的自定义查询。

连接

  1. 登录 Looker 数据洞察。
  2. 在 Looker Studio 首页的左上角，点击 “创建”图标。 Create（创建），然后选择 Data Source（数据源）。
  3. 选择 Cloud SQL for MySQL 连接器。
  4. 如果系统提示，请授权 Looker 数据洞察访问您的数据。

  5. 设置与数据库的连接：

    • 如需使用主机名或 IP 地址进行连接，请执行以下操作
      1. 在左侧，选择 基本 。
      2. 输入连接详情：
        1. 实例连接名称（请参阅下文，了解如何列出实例连接）。
        2. 数据库
        3. 用户名
        4. 密码
    • 如需使用 JDBC 网址进行连接，请执行以下操作：
      1. 在左侧，选择 JDBC 网址 。
      2. 输入连接详情：
        1. JDBC 网址

          示例 jdbc:google:mysql: //<instance connection name>/

        2. 用户名
        3. 密码
      > 如果您使用 JDBC 主机名选项，则可以确保可以使用 Whois 等公共 DNS 查询工具访问该主机名。
    如需使用 IPv6 字面地址进行连接，请将地址括在方括号中。例如： jdbc:google:mysql://\[2001:db8:1:1:1:1:1:1\]/your_db
    • 注意：Looker Studio 无法连接到 localhost。您必须使用公共主机名或 IP 地址。

  6. 点击身份验证。

  7. 从列表中选择一个表，或输入自定义查询。

选择 CUSTOM QUERY 选项以提供 SQL 查询，而不是连接到单个表。Looker Studio 会将此自定义 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;

Looker Studio 中的查询可能会在三到五分钟后超时。如果您的自定义查询超时，请尝试通过以下方法解决此问题：

  • 简化查询，以加快其运行速度。
  • 在数据库中运行查询，并将结果存储在单独的表中。在数据源中连接新表。
  1. 点击连接。

稍等片刻，系统会显示数据源字段列表页面。点击创建报告，开始直观呈现您的数据。

备注

查找实例连接名称

实例连接名称用于标识 Google Cloud上的实例。您可以通过 Google Cloud 控制台或使用命令行获取该证书。

使用控制台

  1. 前往 https://console.cloud.google.com/sql/instances
  2. 点击要连接的实例 ID。
  3. 在左侧的“连接到此实例”部分中，您会看到连接名称。

使用命令行

如需使用 Cloud 命令行界面查找连接名称，请使用以下命令：


gcloud sql instances describe [INSTANCE_NAME] | grep connectionName

权限

您必须至少拥有 Cloud SQL for MySQL 项目的 cloudsql.client 权限，才能创建连接。如果您没有（或无法获得）此访问权限，可以改用 MySQL 连接器。

网络连接

Cloud SQL for MySQL 连接器支持连接到具有公共 IP 连接和专用 IP 连接的 Cloud SQL for MySQL 实例。

您必须先为 Cloud SQL for MySQL 实例配置公共 IP 连接或专用 IP 连接，然后才能使用 Cloud SQL for MySQL 连接器。

如需允许 Looker Studio 访问 Cloud SQL 中的数据，并通过专用连接对此数据进行查询，请在 Cloud SQL for MySQL 实例设置中选择 Google Cloud 服务的专用路径选项。

数据类型

Looker Studio 会将数据库的内置数据类型映射到一组统一的数据类型。如果 Looker Studio 在表格或查询中遇到不受支持的类型的列，则不会为该列创建字段。

注意：Looker 数据洞察不支持 MySQL 空间数据扩展。

Cloud SQL for MySQL 连接器的限制

  • 使用此连接器时，每次查询最多可查询 15 万行。如果超出此限制，系统会截断数据。
  • 列标题（字段名称）只能使用 ASCII 字符。不支持非 ASCII 字符。

问题排查

如需查看常见错误消息的列表以及解决这些错误的步骤，请参阅 Looker Studio 问题排查指南。