本頁面說明如何在 Cloud de Confiance 控制台,使用 Cloud SQL Studio 探索及管理 Cloud SQL 資料。
Cloud SQL Studio 可讓授權使用者直接與 SQL 資料庫互動,並透過 Cloud de Confiance 控制台執行 SQL 查詢,存取及操控資料。您可以執行一系列在 SQL 指令列用戶端上執行的動作,例如建立資料表和索引、修改資料表或設定檢視表。
Cloud SQL Studio 包含「Explorer」窗格,與查詢編輯器和 SQL 查詢結果資料表整合。您可以在這個介面執行 DDL、DML 和 DQL 陳述式。舉例來說,您可以使用 Cloud SQL Studio 的查詢編輯器建立資料表及查詢資料,不必設定第三方資料庫查詢工具。
您可以使用「Explorer」窗格查看資料庫物件並與其互動。您可以建立、修改及刪除資料庫物件,例如:
- Tables
- 資料欄
- 索引和鍵
- 函式
您也可以使用「Explorer」窗格,為資料表植入 SELECT 查詢。
輸入查詢或選取查詢的一部分時,Cloud SQL Studio 會自動驗證語法。
如果您是 Cloud SQL 新手,請參閱「Cloud SQL 總覽」。
必要角色和權限
如要取得完成本文件工作所需的權限,請要求管理員授予您專案的 Cloud SQL Studio 使用者 (roles/cloudsql.studioUser) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
如要使用 Cloud SQL Studio,您必須具備下列權限:
cloudsql.databases.listcloudsql.instances.executeSqlcloudsql.instances.getcloudsql.instances.login(僅在使用 IAM 資料庫驗證時才需要)cloudsql.users.list
此外,請確認您具備用於驗證的資料庫層級權限,以及所用特殊權限資料庫使用者的密碼。
向 Cloud SQL Studio 進行驗證
您必須先選取資料庫驗證方式,才能在 Cloud SQL Studio 中存取資料庫。如要使用 Cloud SQL Studio 登入資料庫,可以採用下列任一驗證類型:
IAM 資料庫驗證。使用這類驗證機制,您就能登入資料庫和 Cloud SQL Studio,不必管理額外密碼。您也可以利用 IAM 群組驗證,同時管理組織中多位使用者的資料庫存取權和權限。
內建資料庫驗證。您可以使用 MySQL 使用者帳戶和憑證,在 Cloud SQL Studio 中連線至資料庫。
探索您的資料
如要存取「Explorer」窗格,請按照下列步驟操作:
-
前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。
- 從清單中選取執行個體。
- 在導覽選單中,按一下「Cloud SQL Studio」。
- 使用資料庫名稱、使用者名稱和密碼登入 Cloud SQL Studio。「Explorer」窗格會顯示資料庫中的物件清單。
建立、修改及查詢資料
您可以使用 SQL 編輯器,執行 DDL、DML 和 DQL 陳述式的組合。您可以自行編寫查詢,也可以使用 Explorer 在查詢編輯器中填入範本。
如要建立資料結構、修改或查詢資料,請按照下列步驟操作:
-
前往 Cloud de Confiance 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。
- 從清單中選取執行個體。
- 在導覽選單中,按一下「Cloud SQL Studio」。
- 使用資料庫名稱、使用者名稱和密碼登入 Cloud SQL Studio。
- 使用下列任一方法編寫查詢:
- 如要自行編寫查詢,請按照下列步驟操作:
- 點選 開啟新分頁。
- 查詢編輯器顯示後,請編寫查詢。
- 如要使用範本編寫查詢,請按照下列步驟操作:
- 在「Explorer」窗格中,按一下資料庫物件或集合旁邊的「more_vert」more_vert「View actions」(查看動作)。系統會顯示一或多個可用動作。
- 按一下動作。查詢編輯器會填入範本。
- 替換範本中的所有預留位置。
- 如要自行編寫查詢,請按照下列步驟操作:
請使用下列任一方法執行查詢:
- 如要執行查詢編輯器中的所有陳述式,請按一下「執行」。
- 如要執行特定陳述式,請選取一或多個陳述式,然後按一下「執行所選項目」。
查詢結果會顯示在「結果」分頁中。如果有多個結果集,請從「All results」(所有結果) 下拉式選單中選取結果。
驗證查詢語法
在查詢編輯器中輸入查詢時,Cloud SQL Studio 會自動驗證陳述式,檢查是否有語法錯誤。
Cloud SQL Studio 會從 MySQL 執行個體即時驗證查詢。如果您已啟用稽核記錄或 MySQL 一般記錄,系統會像記錄其他工作階段一樣,記錄驗證工作階段。如要避免記錄這類驗證工作階段,可以將cloudsql_avoid_parse_session_logging 旗標設為 on。預設值為 off。
如要進一步瞭解如何設定資料庫旗標,請參閱「設定資料庫旗標」。
限制
- Cloud SQL Studio 支援輕量查詢。如果 SQL 回覆超過 10 MB,系統會截斷回覆。Cloud SQL Studio 會指出傳回部分結果的時間。
- 您只能對執行中的 Cloud SQL 執行個體執行查詢。
- Cloud SQL Studio 不支援外部伺服器。
- 如果要求處理時間超過五分鐘,系統會取消要求。不支援使用
SET SESSION MAX_EXECUTION_TIME設定較長的查詢逾時時間。如果是 MySQL 5.6 和 5.7 適用的 Cloud SQL,長時間執行的 DDL 陳述式逾時可能會導致孤立檔案或資料表無法安全復原。在大型資料表上執行ALTER TABLE等查詢時,請務必謹慎。 - SQL 指令碼執行完畢後,Cloud SQL Studio 不會保持資料庫連線。同樣地,編輯器分頁不會共用工作階段,每次執行都會啟動新的工作階段。
- 如果同時執行 DML、DQL 和 DDL 陳述式,系統只會顯示 DQL 查詢的結果。
- 關閉瀏覽器或瀏覽器分頁,並不會停止 Cloud SQL Studio 中的查詢執行作業。查詢會持續執行,直到完成或逾時。
Cloud SQL Studio 會使用
executeSqlAPI 執行查詢。Cloud SQL 會限制每個執行個體的並行executeSql要求數量,以免超載。如果達到上限,後續要求就會失敗,並傳回下列其中一項錯誤:At most 'x' concurrent queries may be run on this instance. Try again later.Maximum concurrent reads 'x' reached.
限制 (
x) 為每個執行個體 10 個查詢。
- Cloud SQL Studio 不支援對
BLOB資料執行SELECT查詢。如果 SQL 指令碼在輸出內容中產生BLOB資料欄,則 SQL 指令碼會失敗並顯示錯誤。 - Cloud SQL Studio 不支援 MySQL 適用的 Cloud SQL 用戶端指令,因此無法執行。
- Cloud SQL Studio 不支援
root使用者。 - 即使 MySQL 適用的 Cloud SQL 不需要資料庫也能連線,Cloud SQL Studio 仍一律需要資料庫。
- Cloud SQL Studio 不支援密碼空白的使用者。
USE database僅在執行中的查詢執行作業中具有狀態,且功能與 gcloud CLI 不同。- 資料庫使用者必須具備從 localhost 連線的權限。
執行多項查詢時,如果其中一項失敗,系統會傳回第一個遇到的錯誤。在錯誤發生前,批次中的部分陳述式可能已成功執行。您可以在
transaction陳述式中包裝多個查詢,避免發生這個問題:START TRANSACTION; YOUR_SQL_STATEMENTS COMMIT;更改下列內容:
- YOUR_SQL_STATEMENTS:您要執行做為這項查詢一部分的陳述式
Cloud SQL 不會驗證預備陳述式 (
preparable_stmt) 的 SQL 陳述式部分。
- SQL 指令碼及其執行回應,可能會在用戶端與目標執行個體位置之間的中繼位置傳輸。