連線至 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 說明中心社群回報。您可以在問題追蹤工具中新增及投票給功能要求。

如何連線至 MySQL 適用的 Cloud SQL

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

如要連線，請按照下列步驟操作：

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

  5. 設定資料庫連線：

    • 如要透過主機名稱或 IP 位址連線
      1. 選取左側的「BASIC」 。
      2. 輸入連線詳細資料：
        1. 執行個體連線名稱 (請參閱下文，瞭解如何列出執行個體連線)。
        2. 資料庫
        3. 使用者名稱
        4. 密碼
    • 如要使用 JDBC 網址連線，請按照下列步驟操作：
      1. 選取左側的「JDBC URL」 。
      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. 從清單中選取表格，或輸入自訂查詢。 <0

選取「自訂查詢」選項，提供 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 中，查詢可能會在三到五分鐘後逾時。如果自訂查詢逾時，請嘗試下列方法解決問題：

  • 簡化查詢，加快執行速度。
  • 在資料庫中執行查詢，並將結果儲存在另一個資料表中。連結資料來源中的新表格。
  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

權限

您必須在 MySQL 適用的 Cloud SQL 專案中具備至少 cloudsql.client 權限，才能建立連線。如果沒有 (或無法取得) 這項存取權，可以改用 MySQL 連接器。

網路連線

MySQL 適用的 Cloud SQL 連接器支援連線至具備公開 IP 連線能力和私人 IP 連線能力的 MySQL 適用的 Cloud SQL 執行個體。

使用 MySQL 適用的 Cloud SQL 連接器前，請先為 MySQL 適用的 Cloud SQL 執行個體設定公開 IP 連線或私人 IP 連線。

如要允許 Looker Studio 存取 Cloud SQL 中的資料，並透過私人連線對這些資料發出查詢，請在 MySQL 適用的 Cloud SQL 執行個體設定中，選取「Google Cloud 服務的私人路徑」選項。

資料類型

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

注意：Looker Studio 不支援 MySQL Spatial Data Extensions。

MySQL 適用的 Cloud SQL 連接器限制

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

疑難排解

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