Cloud Code 支援執行 Cloud SQL 驗證 Proxy,以便連線至 Cloud SQL 資料庫、查看 Cloud SQL 執行個體,以及建立新的資料來源。
事前準備
如果尚未安裝 Cloud Code,請先安裝。
如要建立新的資料來源,您可以使用下列任一 JetBrains IDE 進階版:
IntelliJ Ultimate 或其他含有 資料庫工具和 SQL 外掛程式的高級 JetBrains IDE (預設為啟用)。
DataGrip:獨立的資料庫管理環境。
您也可以使用其他偏好的資料庫工具 (例如 DBeaver、MySQL Workbench 和 SQL Server Management Studio),透過 Cloud Code 提供的本機連接埠連線至 Cloud SQL 執行個體。
使用 Cloud SQL 驗證 Proxy 連線至 Cloud SQL 資料庫
您可以在 IntelliJ 或其他支援的 JetBrains IDE 中,連線至 Cloud SQL 資料庫並查看 Cloud SQL 執行個體清單,並使用 Cloud Code 進行操作。
如要使用 Cloud Code 連線至 Cloud SQL 資料庫,請執行下列操作:
在 IDE 中,按一下側欄中的「Google Cloud Databases」,或依序點選「View」 >「Tool Windows」 >「Google Cloud Databases」。
如果您尚未選取 Google Cloud 專案,請按一下「選取 Google Cloud 專案」,然後按照提示載入 Google Cloud專案。
Google Cloud 專案中的 Cloud SQL 執行個體會顯示在「Cloud SQL」下方。
如要連線至 Cloud SQL 執行個體,請按一下執行個體,然後選取「Connect using Cloud SQL Proxy」。您也可以選取「使用 Cloud SQL Proxy 連線 (私人 IP)」,使用私人 IP。
如要進一步瞭解如何連線至 SQL 執行個體,請參閱「關於連線選項」。
建立新資料來源
建立 Cloud SQL 驗證 Proxy 連線後,系統會顯示「Cloud SQL 執行個體已連線」對話方塊,讓您為本機可用的資料庫建立新資料來源,或查看現有資料來源。
如要建立新的資料來源,請選取「建立新資料來源」。
或者,您也可以在執行個體上按一下滑鼠右鍵,然後選取「建立新資料來源」。
在「Authentication」欄位中選取驗證方法 (預設為使用者名稱和密碼)。
儲存設定。
Cloud Code 會建立新的資料來源連線,名稱格式如下:
gcp-project:location:db-instance-name
。您可以透過 JetBrains 的資料庫工具和 SQL 外掛程式功能,或 DataGrip 開始使用資料庫執行個體。
(選用) 如要查看 IDE 中的資料來源清單,請按一下側欄中的「資料庫」,或依序點選「View」 >「Tool Windows」 >「Database」。在資料來源上按一下滑鼠右鍵,即可看到選項清單,例如查看結構定義、資料表和其他資料庫作業。
如要進一步瞭解如何在 DataGrip 中使用資料庫,請參閱「DataGrip 快速入門」。
中斷 Cloud SQL 驗證 Proxy
如要停止 Proxy 程序並釋出本機資料庫埠,請在終端機中按下 Ctrl+C
。
已知問題
本節列出所有已知問題及其目前的解決方法。
設定不同的通訊埠來連線至多個資料庫
Cloud SQL 驗證 Proxy 在忙碌時不會自動選取連接埠,且會一律依賴一個連接埠,因此您只能連線到特定類型資料庫的單一執行個體。
Cloud Code 會在終端機中執行 Cloud SQL 驗證 Proxy,如果發生連接埠衝突,您可以使用自訂 --port
旗標在終端機中執行相同指令,藉此設定其他連接埠來連線至資料庫。例如:
--port=PORT_NUMBER
您可以在資料庫連線中使用這個通訊埠。系統會自動產生指令。例如:
path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING