連線至 MySQL 適用的 Google Cloud SQL

您可以使用 MySQL 適用的 Cloud SQL 連接器，將 MySQL 適用的 Cloud SQL 資料庫連線至數據分析。使用資料庫表格或自訂查詢，建構互動式報表和資訊主頁。接著，您可以與沒有資料庫直接存取權的利害關係人或團隊成員分享這些洞察資訊。

支援的版本

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

  • 5.6
  • 5.7
  • 8.0

如果在使用支援版本時遇到問題，請前往數據分析社群告訴我們。您也可以在 Issue Tracker 中新增及票選功能要求。

如何連線至 MySQL 適用的 Cloud SQL

數據分析資料來源可以連線至單一 MySQL 適用的 Cloud SQL 資料庫表格，或您提供的自訂查詢。

如要連線至 MySQL 適用的 Cloud SQL 資料庫，請按照下列步驟操作：

  1. 登入數據分析。
  2. 在數據分析首頁，按一下 建立，然後選取資料來源。
  3. 選取「MySQL 適用的 Cloud SQL」連線器。
  4. 使用其中一種連線選項，設定資料庫的存取權。
  5. 按一下「驗證」AUTHENTICATE。畫面上會顯示該資料庫中的資料表清單。
  6. 從清單中選取表格，或輸入自訂查詢。
  7. 點選「連結」。

現在，您可以在報表中將表格中的所有欄存取為欄位。

連線選項

使用主機名稱或 IP 位址連線

在連線面板中，選取「基本」。輸入連線詳細資料：

  • 執行個體連線名稱
  • 資料庫
  • 使用者名稱
  • 密碼

使用 JDBC 網址連線

在連線面板中，選取「JDBC URL」。輸入連線詳細資料：

  • JDBC 網址

    • 範例 jdbc:google:mysql://INSTANCE_CONNECTION_NAME/DATABASE

  • 使用者名稱
  • 密碼

如要使用 IPv6 實體位址連線，請將位址放在方括號中。例如：jdbc:google:mysql://[2001:db8:1:1:1:1:1:1]/your_db

自訂查詢

選取「自訂查詢」選項，提供 SQL 查詢，而非連結至單一資料表。對於每個產生的資料庫查詢，數據分析會使用這個自訂 SQL 做為內部的選取陳述式。

自訂 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;

數據分析中的查詢可能會在三到五分鐘後逾時。如果自訂查詢逾時，請嘗試下列方法解決問題：

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

附註

請參閱下列各節，瞭解如何找出執行個體連線名稱、設定必要權限，以及設定網路連線。

找出執行個體連線名稱

執行個體連線名稱會在 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 連線。

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

支援的資料類型

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

防火牆和資料庫存取權

如要允許數據分析連線至防火牆後方的資料庫並查詢資料，您必須開放下列其中一個 IP 位址的存取權。您可能也需要設定資料庫，接受來自這些地址的流量。如需操作說明，請參閱特定資料庫的說明文件。

IP 位址

下列地址保留供數據分析的全球基礎架構使用：

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (選用，適用於支援 IPv6 的平台)

如果已為數據分析 Pro 訂閱方案啟用資料落地，請改用下列地址：

  • 142.251.56.0/24

  • 2001:4860:4815::/48 (選用，適用於支援 IPv6 的平台)

MySQL 適用的 Cloud SQL 連接器限制

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

疑難排解

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