Cloud Code 支援執行 Cloud SQL 驗證 Proxy 連線至 Cloud SQL 資料庫、查看 Cloud SQL 執行個體,以及建立新的資料來源。
事前準備
如果尚未安裝 Cloud Code,請先安裝。
如要建立新的資料來源,可以使用下列其中一個 JetBrains 進階 IDE:
IntelliJ Ultimate 或其他包含 Database Tools and SQL 外掛程式 (預設為啟用) 的 JetBrains 進階 IDE。
DataGrip:獨立的資料庫管理環境。
您也可以使用其他偏好的資料庫工具 (例如 DBeaver、MySQL Workbench 和 SQL Server Management Studio),透過 Cloud Code 提供的本機連接埠連線至 Cloud SQL 執行個體。
使用 Cloud SQL 驗證 Proxy 連線至 Cloud SQL 資料庫
您可以在 IntelliJ 或其他支援的 JetBrains IDE 中,透過 Cloud Code 連線至 Cloud SQL 資料庫,並查看 Cloud SQL 執行個體清單。
如要使用 Cloud Code 連線至 Cloud SQL 資料庫,請執行下列步驟:
在 IDE 中,按一下側欄中的「Google Cloud Databases」,或依序點選「View」>「Tool Windows」>「Google Cloud Databases」。
如果尚未選取專案,請按一下「選取 Google Cloud 專案」,然後按照提示載入專案。 Google Cloud Google Cloud
專案中的 Cloud SQL 執行個體會顯示在「Cloud SQL」 Google Cloud 下方。
如要連線至 Cloud SQL 執行個體,請以滑鼠右鍵點選執行個體,然後選取「Connect using Cloud SQL Proxy」(使用 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 中查看資料來源清單,請按一下側邊欄中的「Database」,或依序點選「View」>「Tool Windows」>「Database」。以滑鼠右鍵按一下資料來源,即可查看選項清單,例如檢視結構定義、資料表和其他資料庫作業。
如要進一步瞭解如何在 DataGrip 中使用資料庫,請參閱「DataGrip 快速入門」。
中斷 Cloud SQL 驗證 Proxy 連線
如要停止 Proxy 程序並釋出本機資料庫連接埠,請在終端機中按下 Ctrl+C
。
已知問題
本節列出所有已知問題和目前的解決方法。
設定其他通訊埠,連線至多個資料庫
如果 Cloud SQL Auth Proxy 忙碌,就不會自動選取連接埠,而且一律會依賴一個連接埠,因此您只能連線到特定類型的單一資料庫執行個體。
Cloud Code 會在終端機中執行 Cloud SQL Auth Proxy,如果遇到連接埠衝突,您可以在終端機中執行相同指令,並使用自訂 --port
旗標設定其他連接埠,連線至資料庫。例如:
--port=PORT_NUMBER
然後,您可以在資料庫連線中使用這個通訊埠。系統會自動產生指令。例如:
path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING