建立及管理已儲存的查詢

本頁說明如何建立及管理已儲存的查詢。在 Spanner Studio 中編寫 SQL 指令碼時，您可以儲存及管理這些指令碼。詳情請參閱「已儲存的查詢總覽」。

已儲存的查詢功能僅適用於 Google Cloud 控制台。

必要的角色

如要取得使用已儲存查詢所需的權限，請要求管理員將專案的下列 IAM 角色授予您：

  • 如要建立及刪除儲存的查詢： Studio 查詢使用者 (roles/databasesconsole.studioQueryUser)
  • 如要管理專案中的所有已儲存查詢 (包括存取「已儲存的查詢」頁面)： Studio 查詢管理員 (roles/databasesconsole.studioQueryAdmin)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這些預先定義的角色具備使用已儲存查詢所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

所需權限

如要使用已儲存的查詢，必須具備下列權限：

  • 如何建立及刪除已儲存的查詢：
    • databasesconsole.studioQuery.create
    • databasesconsole.studioQuery.update
    • databasesconsole.studioQuery.delete
    • databasesconsole.studioQuery.search
  • 如要管理專案中的所有已儲存查詢，請按照下列步驟操作：
    • databasesconsole.studioQuery.create
    • databasesconsole.studioQuery.update
    • databasesconsole.studioQuery.delete
    • databasesconsole.studioQuery.search
    • databasesconsole.studioQuery.list
    • databasesconsole.studioQuery.get

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

「Studio 查詢使用者」(roles/databasesconsole.studioQueryUser) 角色可讓使用者建立、查看及撰寫已儲存的查詢。這項設定適用於多數使用者。

Studio 查詢管理員 (roles/databasesconsole.studioQueryAdmin) 角色只能授予管理員。如要進一步瞭解 Spanner Identity and Access Management (IAM)，請參閱 IAM 總覽。

權限

如要建立已儲存的查詢，您必須具備下列專案層級的 IAM 權限：

  • databasesconsole.locations.get
  • databasesconsole.locations.list
  • databasesconsole.studioQueries.create

如要查看已儲存的查詢，您必須具備專案層級的下列權限：

  • databasesconsole.studioQueries.search

如要修改及刪除已儲存的查詢，您必須具備專案層級的下列權限：

  • databasesconsole.studioQueries.update

執行查詢的權限是從資料庫繼承而來。您可能擁有查看權限，但沒有執行查詢的權限。

建立已儲存的查詢

如要建立已儲存的查詢，請按照下列步驟操作：

  1. 前往Google Cloud 控制台的 Spanner「Instances」(執行個體) 頁面。

    執行個體

  2. 選取要建立已儲存查詢的執行個體。

  3. 選取要建立已儲存查詢的資料庫。

  4. 在導覽選單中，按一下「Spanner Studio」。

  5. 在「Spanner Studio」頁面中，按一下 「新分頁」，或使用空白的編輯器分頁。

  6. 在查詢編輯器中輸入有效的 SQL 查詢。

  7. 按一下 [儲存]。

  8. 在「儲存查詢」對話方塊中，輸入已儲存查詢的名稱。

  9. 按一下 [儲存]。

開啟並執行已儲存的查詢

如要開啟現有已儲存的查詢做為新查詢，請按照下列步驟操作：

  1. 在「Spanner Studio」頁面中，按一下「新增分頁」，或使用空白的編輯器分頁。
  2. 在「Explorer」窗格中，前往「Queries」部分。按一下已儲存的查詢，即可在新編輯器分頁中開啟。或者，按一下已儲存查詢旁的「查看動作」，然後按一下「開啟查詢」，即可在新編輯器分頁中開啟查詢。
  3. 按一下「執行」。

更新已儲存的查詢

如要更新現有的已儲存查詢，請按照下列步驟操作：

  1. 在「Spanner Studio」頁面中，按一下「新增分頁」，或使用空白的編輯器分頁。
  2. 在「Explorer」窗格中，前往「Queries」部分。按一下已儲存的查詢，即可在新編輯器分頁中開啟。或者，按一下已儲存查詢旁的「查看動作」，然後按一下「開啟查詢」，即可在新編輯器分頁中開啟查詢。
  3. 修改查詢。
  4. 如要儲存修改後的查詢，請按一下「儲存」。

查看及管理所有已儲存的查詢清單

如要查看專案中所有已儲存查詢的清單，請按照下列步驟操作：

  1. 前往Google Cloud 控制台的 Spanner「Instances」(執行個體) 頁面。

    執行個體

  2. 選取任一執行個體。(由於已儲存的查詢是專案的子項，只要您具備必要角色，就能從任何執行個體或資料庫查看專案中的所有已儲存查詢)。

  3. 選取任何資料庫。

  4. 在「Spanner Studio」頁面中，按一下「新增分頁」，或使用空白的編輯器分頁。

  5. 在「Explorer」窗格中，前往「Queries」部分。按一下已儲存查詢旁的「查看動作」。然後按一下「管理查詢」。

    「已儲存的查詢」頁面隨即開啟。這個頁面會列出這個專案中的所有預存查詢 (包括其他產品的預存查詢)。 Google Cloud

您可以在「已儲存的查詢」頁面搜尋、篩選、查看及刪除查詢。您無法在「已儲存的查詢」頁面上編輯現有查詢。

如要刪除「已儲存的查詢」頁面上的已儲存查詢，請按照下列步驟操作：

  1. 找出要刪除的已儲存查詢，然後按一下旁邊的「查看動作」。
  2. 按一下「刪除查詢」即可刪除已儲存的查詢。
  3. 在「刪除查詢」對話方塊中，按一下「刪除」。

刪除已儲存的查詢

  1. 在「Spanner Studio」頁面中，按一下「新增分頁」，或使用空白的編輯器分頁。
  2. 在「Explorer」窗格中，展開「Queries」資料夾。找出要刪除的已儲存查詢，然後按一下旁邊的「查看動作」。然後按一下「刪除查詢」，即可刪除已儲存的查詢。
  3. 在「刪除查詢」對話方塊中，按一下「刪除」。

後續步驟