本頁面說明如何使用 Google Cloud 控制台中的 Cloud SQL Studio 探索及管理 Cloud SQL 資料。
授權使用者可透過 Cloud SQL Studio 直接與 SQL 資料庫互動,並從 Google Cloud 控制台執行 SQL 查詢,存取及操作資料。您可以執行一系列動作,例如建立資料表和索引、修改資料表或設定檢視區塊,就像在 SQL 指令列用戶端上執行一樣。
Cloud SQL Studio 包含「Explorer」窗格,可與查詢編輯器和 SQL 查詢結果資料表整合。您可以在這個介面執行 DDL、DML 和 DQL 陳述式。舉例來說,您可以使用 Cloud SQL Studio 中的查詢編輯器建立資料表及查詢資料,不必設定第三方資料庫查詢工具。
您可以使用「Explorer」窗格查看及操作資料庫物件。 您可以建立、變更及刪除資料庫物件,例如:
- 資料表
- 資料欄
- 索引和索引鍵
- 函式
您也可以使用「Explorer」窗格,為資料表產生 SELECT
查詢。
如果您是 Cloud SQL 新手,請參閱 Cloud SQL 總覽。
必要角色和權限
如要取得完成本文工作所需的權限,請要求管理員授予您專案的 Cloud SQL Studio 使用者 (roles/cloudsql.studioUser
) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。
如要使用 Cloud SQL Studio,您必須具備下列權限:
cloudsql.databases.list
cloudsql.instances.executeSql
cloudsql.instances.get
cloudsql.instances.login
(僅在使用 IAM 資料庫驗證時需要)cloudsql.users.list
此外,請確認您擁有用於驗證的資料庫層級權限,以及所用特權資料庫使用者的密碼。
驗證 Cloud SQL Studio
如要在 Cloud SQL Studio 中存取資料庫,請先選取資料庫驗證方法。如要使用 Cloud SQL Studio 登入資料庫,可以採用下列任一驗證方式:
探索您的資料
如要存取「Explorer」窗格,請按照下列步驟操作:
-
前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。
- 從清單中選取執行個體。
- 按一下導覽選單中的「Cloud SQL Studio」。
- 使用資料庫名稱、使用者名稱和密碼登入 Cloud SQL Studio。「Explorer」窗格會顯示資料庫中的物件清單。
建立、修改及查詢資料
您可以使用 SQL 編輯器,執行 DDL、DML 和 DQL 陳述式的組合。您可以自行撰寫查詢,也可以使用探索器,透過範本填入查詢編輯器。
如要建立資料結構、修改或查詢資料,請按照下列步驟操作:
-
前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。
- 從清單中選取執行個體。
- 按一下導覽選單中的「Cloud SQL Studio」。
- 使用資料庫名稱、使用者名稱和密碼登入 Cloud SQL Studio。
- 使用下列任一方法撰寫查詢:
- 如要自行編寫查詢,請按照下列步驟操作:
- 按一下 開啟新分頁。
- 查詢編輯器隨即顯示,請編寫查詢。
- 如要從範本開始撰寫查詢,請按照下列步驟操作:
- 在「Explorer」窗格中,找到資料庫物件或集合,然後依序點選旁邊的「more_vert」more_vert「View actions」(查看動作)。系統會顯示一或多個可用動作。
- 按一下所需動作,查詢編輯器會填入範本。
- 替換範本中的所有預留位置。
- 如要自行編寫查詢,請按照下列步驟操作:
- 請使用下列任一方法執行查詢:
- 如要執行查詢編輯器中的所有陳述式,請按一下「執行」。
- 如要執行特定陳述式,請選取一或多個陳述式,然後按一下「執行選取的項目」。
- 查詢結果會顯示在「結果」分頁中。如果有多個結果集,請從「所有結果」下拉式清單中選取結果。
限制
- Cloud SQL Studio 支援輕量查詢。如果回應超過 10 MB,可能會遭到截斷。Cloud SQL Studio 會在傳回部分結果時顯示相關訊息。
- 您只能對正在執行的 Cloud SQL 執行個體執行查詢。
- Cloud SQL Studio 不支援外部伺服器。
- 如果要求超過五分鐘,系統就會取消。系統不支援使用
SET SESSION MAX_EXECUTION_TIME
設定較長的查詢逾時時間。如果 Cloud SQL for MySQL 5.6 和 5.7 的 DDL 陳述式執行時間過長而逾時,可能會導致孤立檔案或資料表無法安全復原。對大型資料表執行ALTER TABLE
等查詢時,請務必謹慎。 - 執行 SQL 指令碼完成後,Cloud SQL Studio 不會保持資料庫連線開啟。同樣地,編輯器分頁不會共用工作階段,每次執行都會啟動新的工作階段。
- 如果您同時執行 DML、DQL 和 DDL 陳述式,系統只會顯示 DQL 查詢的結果。
- 關閉瀏覽器或瀏覽器分頁不會停止 Cloud SQL Studio 中的查詢執行作業。查詢作業會持續執行,直到完成或逾時為止。
- Cloud SQL Studio 不支援對
BLOB
資料執行SELECT
查詢。如果 SQL 指令碼在輸出內容中產生BLOB
資料欄,則 SQL 指令碼會失敗並顯示錯誤。 - Cloud SQL Studio 不支援 Cloud SQL for MySQL 用戶端指令,也無法執行這些指令。
- Cloud SQL Studio 不支援
root
使用者。 - 即使 MySQL 適用的 Cloud SQL 不需要資料庫即可連線,Cloud SQL Studio 仍一律需要資料庫。
- Cloud SQL Studio 不支援密碼為空白的使用者。
USE database
僅適用於有效查詢執行作業,功能與 gcloud CLI 中的功能不同。- 資料庫使用者必須具備從本機連線的權限。
執行多項查詢時,如果其中一項查詢失敗,系統會傳回第一個遇到的錯誤。錯誤發生前,批次中的部分陳述式可能已成功執行。您可以在
transaction
陳述式中包裝多個查詢,避免發生這個問題:START TRANSACTION; YOUR_SQL_STATEMENTS COMMIT;
更改下列內容:
- YOUR_SQL_STATEMENTS:您要執行的陳述式,做為這項查詢的一部分