建立及管理已儲存的查詢

如要在不同工作階段重複使用及共用常見的資料庫作業,您可以在 Bigtable Studio 建立、整理及管理已儲存的 SQL 指令碼。詳情請參閱「已儲存的查詢總覽」。

已儲存的查詢功能只能在控制台中使用,無法透過 API 使用。

必要的角色

如要取得使用已儲存的查詢所需的權限,請要求系統管理員授予您下列專案的 Identity and Access Management (IAM) 角色:

  • 如要查看已儲存的查詢:Bigtable 讀取者 (roles/bigtable.reader)
  • 如要查看、建立、修改及刪除已儲存的查詢:Bigtable 使用者 (roles/bigtable.user)
  • 如要管理、查看、建立、修改及刪除已儲存的查詢: Bigtable 管理員 (roles/bigtable.admin)。 這個角色具備廣泛權限,可完整存取 Bigtable,僅供管理員使用。

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

這些預先定義的角色具備使用已儲存查詢所需的權限。如要進一步瞭解必要權限,請參閱「必要權限」。

所需權限

如要建立、查看、修改及刪除已儲存的查詢,您必須在專案層級具備下列 IAM 權限:

動作 必要的 IAM 權限
建立已儲存的查詢
  • databasesconsole.studioQueries.create
查看已儲存的查詢
  • databasesconsole.studioQueries.search
  • databasesconsole.locations.get
  • databasesconsole.locations.list
修改已儲存的查詢
  • databasesconsole.studioQueries.update
刪除已儲存的查詢
  • databasesconsole.studioQueries.delete
管理已儲存的查詢
(僅限管理員使用)
  • databasesConsole.studioQueries.list
  • databasesconsole.locations.list

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

Studio 查詢使用者 (roles/databasesconsole.studioQueryUser) 角色提供建立、查看及寫入已儲存的查詢的權限。這個角色符合大多數使用者的需求。

請僅將 Studio 查詢管理員 (roles/databasesconsole.studioQueryAdmin) 角色授予管理員。如要進一步瞭解 Bigtable IAM,請參閱「使用 IAM 控管 Bigtable 存取權」。

建立已儲存的查詢

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

  1. 前往 Google Cloud 控制台的 Bigtable「Instances」(執行個體) 頁面。
    執行個體
  2. 選取要建立已儲存的查詢的執行個體。
  3. 在導覽選單中,點選「Bigtable Studio」。

    「Explorer」窗格會顯示執行個體中的資料表、檢視表和查詢清單。

  4. 在「編輯器」分頁執行查詢。

    結果會顯示在「Results」(結果) 表格中。

  5. 如果對結果不滿意,請修改查詢並再次執行。確認查詢正確無誤後,按一下「Save」(儲存)。
  6. 在「儲存查詢」對話方塊中,輸入已儲存的查詢的名稱。
  7. 按一下 [儲存]。

選用:

  • 如要以其他名稱儲存查詢,請按一下「Save as」(另存為) 展開箭頭,選擇「Save as query」(另存為查詢),然後在對話方塊中輸入新名稱。
  • 如要變更這項已儲存的查詢使用的區域,請選取「顯示進階選項」。然後從「Region」(區域) 清單中選取區域。

您也可以將查詢儲存為邏輯或連續 materialized view。

開啟並執行已儲存的查詢

如要將已儲存的查詢做為新查詢開啟,請按照下列步驟操作:

  1. 在「Bigtable Studio」頁面的「Explorer」窗格中,前往「Queries」(查詢) 區段。
  2. 按一下已儲存的查詢,即可在新編輯器分頁中開啟。您也可以視需要按一下已儲存的查詢旁的 「View actions」(查看動作)。然後點選「Open query」(開啟查詢),在新編輯器分頁中開啟查詢。
  3. 按一下「執行」。

更新已儲存的查詢

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

  1. 在「Bigtable Studio」頁面的「Explorer」窗格中,前往「Queries」(查詢) 區段。
  2. 按一下已儲存的查詢,即可在新編輯器分頁中開啟。您也可以視需要按一下已儲存的查詢旁的 「View actions」(查看動作)。然後點選「Open query」(開啟查詢),在新編輯器分頁中開啟查詢。
  3. 修改查詢。
  4. 如要儲存修改後的查詢,請按一下「儲存」。

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

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

  1. 前往 Google Cloud 控制台的 Bigtable「Instances」(執行個體) 頁面。
    執行個體
  2. 選取執行個體。已儲存的查詢是專案的子項,因此只要具備必要角色,就能從任何執行個體或資料庫查看專案中所有已儲存的查詢。
  1. 在「Bigtable Studio」頁面的「Explorer」窗格中,前往「Queries」(查詢) 區段。
  2. 按一下已儲存的查詢旁的「 查看動作」。然後按一下「管理查詢」。

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

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

刪除已儲存的查詢

您可以在 Google Cloud 控制台的「Bigtable Studio」頁面或「Saved queries」(已儲存的查詢) 頁面刪除已儲存的查詢。

  1. 在「Bigtable Studio」頁面的「Explorer」窗格中,前往「查詢」部分。
  2. 按一下要刪除的已儲存查詢旁的 「View actions」(查看動作)。接著,按一下「刪除查詢」,即可刪除已儲存的查詢。
  3. 在「Delete query」(刪除查詢) 對話方塊中,點選「Delete」(刪除)。

您也可以在「已儲存的查詢」頁面刪除已儲存的查詢。如要在「Saved queries」(已儲存的查詢) 頁面刪除已儲存的查詢,請按照下列步驟操作:

  1. 前往「Saved queries」(已儲存的查詢) 頁面。
  2. 按一下要刪除的已儲存的查詢旁的 「View actions」(查看動作)。
  3. 按一下「刪除查詢」,即可刪除已儲存的查詢。
  4. 在「Delete query」(刪除查詢) 對話方塊中,點選「Delete」(刪除)。

後續步驟