連線至 Google Cloud SQL for MySQL

MySQL 適用的 Cloud SQL 是一項全代管資料庫服務，可讓您快速設定、維護及管理 Google Cloud中的 MySQL 關聯資料庫。您可以透過 MySQL 適用的 Cloud SQL 連接器，在 Looker Studio 中存取 MySQL 適用的 Cloud SQL 資料庫資料。

支援的版本

我們已在下列 MySQL 版本上測試 MySQL 適用的 Cloud SQL 連接器：

  • 5.6
  • 5.7
  • 8.0

如果您在使用支援的版本時遇到問題，請前往 Looker Studio 說明社群告訴我們。您可以在Issue Tracker 中新增功能要求並對其投票。

如何連線至 MySQL 適用的 Cloud SQL

Looker Studio 資料來源可連線至單一 Cloud SQL for MySQL 資料庫資料表，或您提供的自訂查詢。

連線方式

  1. 登入 Looker Studio。
  2. 在 Looker Studio 首頁左上方，依序點選 「建立」圖示。「建立」，然後選取「資料來源」。
  3. 選取「Cloud SQL for MySQL」連接器。
  4. 如有提示，請授權 Looker Studio 存取資料。

  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. 從清單中選取資料表，或輸入自訂查詢。

選取「自訂查詢」選項，提供 SQL 查詢，而非連線至單一資料表。Looker Studio 會將這項自訂 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;

Looker Studio 中的查詢可能會在 3 到 5 分鐘後逾時。如果自訂查詢逾時，請嘗試下列方法解決問題：

  • 簡化查詢，加快執行速度。
  • 在資料庫中執行查詢，並將結果儲存在另一個資料表中。在資料來源中連結新表格。
  1. 點選「連結」。

資料來源欄位清單頁面隨即顯示。按一下「建立報表」即可開始以圖表呈現資料。

附註

找出執行個體連線名稱

執行個體連線名稱可識別 Google Cloud上的執行個體。您可以透過 Google Cloud 主控台或指令列取得。

使用控制台

  1. 前往 https://console.cloud.google.com/sql/instances
  2. 按一下要連線的執行個體 ID。
  3. 在畫面左側的「Connect to this instance」部分，您會看到連線名稱。

使用指令列

如要使用 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 中的資料，並透過私人連線對這項資料執行查詢，請在 MySQL 適用的 Cloud SQL 執行個體設定中選取「Google Cloud 服務的私人路徑」選項。

資料類型

Looker Studio 會將資料庫的內建資料類型對應至一組統一的資料類型。如果 Looker Studio 在表格或查詢中遇到不支援的類型資料欄，就不會為該欄建立欄位。

注意：Looker Studio 不支援 MySQL 空間資料擴充功能。

MySQL 適用的 Cloud SQL 連接器限制

  • 使用這個連接器時，每個查詢最多可查詢 150 K 列。如果超過這個限制，資料就會遭到截斷。
  • 欄標題 (欄位名稱) 只能使用 ASCII 字元。不支援非 ASCII 字元。

疑難排解

如需常見錯誤訊息清單和解決步驟，請參閱 Looker Studio 疑難排解指南。