连接到 Google Cloud SQL for MySQL

Cloud SQL for MySQL 是一项全代管式数据库服务，可让您在 Google Cloud上快速设置、维护、管理和控制关系型 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 数据洞察首页的左上角，点击 “创建”图标。 创建，然后选择数据源。
  3. 选择 Cloud SQL for MySQL 连接器。
  4. 如果系统要求，请授权 Looker Studio 访问您的数据。

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

    • 使用主机名或 IP 地址进行连接
      1. 在左侧，选择 BASIC 。
      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. 从列表中选择一个表，或输入自定义查询。 <0x0A

选择自定义查询选项，以提供 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 中的查询可能会在 3 到 5 分钟后超时。如果自定义查询超时，请尝试以下方法来解决问题：

  • 简化查询，以便更快地运行。
  • 在数据库中运行查询，并将结果存储在单独的表中。连接数据源中的新表。
  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 Spatial Data Extensions。

Cloud SQL for MySQL 连接器的限制

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

问题排查

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