本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用已儲存的查詢
<a name="saved-queries"></a>

您可以使用 Athena 主控台保存、編輯、執行、重新命名和刪除您在 Athena 查詢編輯器中建立的查詢。

## 考量和限制
<a name="saved-queries-considerations-and-limitations"></a>
+ 您可以更新儲存的查詢的名稱、描述和查詢文字。
+ 您只能在您自己的帳戶中更新查詢。
+ 您無法變更查詢所屬的工作群組或資料庫。
+ Athena 不會保留查詢修改的歷史記錄。如果您要保留查詢的特定版本，請使用其他名稱進行儲存。

**注意**  
Amazon Athena 資源現可在 Amazon SageMaker Unified Studio (預覽版) 內進行存取，如此可協助您存取組織的資料，並使用最佳工具對其採取行動。您可以將儲存的查詢從 Athena 工作群組移轉至 SageMaker Unified Studio 專案、使用現有的 Athena 工作群組設定專案，以及透過 IAM 角色更新維護必要許可。如需詳細資訊，請參閱[將 Amazon Athena 資源移轉至 Amazon SageMaker Unified Studio (預覽版)](https://github.com/aws/Unified-Studio-for-Amazon-Sagemaker/tree/main/migration/athena)。

**Topics**
+ [考量和限制](#saved-queries-considerations-and-limitations)
+ [儲存查詢並命名](saved-queries-name.md)
+ [執行已儲存的查詢](saved-queries-run.md)
+ [編輯已儲存的查詢](saved-queries-edit.md)
+ [重新命名或刪除已儲存的查詢](saved-queries-rename-or-delete.md)
+ [重新命名未顯示的已儲存查詢](saved-queries-rename-not-displayed.md)
+ [刪除未顯示的已儲存查詢](saved-queries-delete-not-displayed.md)
+ [使用 Athena API 更新已儲存的查詢](saved-queries-update-with-api.md)

# 儲存查詢並命名
<a name="saved-queries-name"></a>

**若要儲存查詢並為其命名**

1. 在 Athena 主控台查詢編輯器中，輸入或執行查詢。

1. 在查詢編輯器視窗上方的查詢標籤上，選擇三個垂直點，然後選擇 **Save as** (另存新檔)。

1. 在 **Save query** (儲存查詢) 對話方塊中，輸入查詢的名稱和選擇性描述。您可以使用可展開的 **Preview SQL query** (預覽 SQL 查詢) 視窗先確認查詢的內容，然後再儲存查詢。

1. 選擇 **Save query** (儲存查詢)。

   在查詢編輯器中，查詢的索引標籤顯示您指定的名稱。

# 執行已儲存的查詢
<a name="saved-queries-run"></a>

**執行已儲存的查詢**

1. 在 Athena 主控台中，選擇 **Saved queries** (已儲存的查詢) 索引標籤。

1. 在 **Saved queries** (已儲存的查詢) 清單中，選擇您要執行的查詢 ID。

   查詢編輯器會顯示您選擇的查詢。

1. 選擇**執行**。

# 編輯已儲存的查詢
<a name="saved-queries-edit"></a>

**若要編輯已儲存的查詢**

1. 在 Athena 主控台中，選擇 **Saved queries** (已儲存的查詢) 索引標籤。

1. 在 **Saved queries** (已儲存的查詢) 清單中，選擇您要編輯的查詢 ID。

1. 在查詢編輯器中編輯查詢。

1. 執行下列步驟之一：
   + 若要執行查詢，選擇 **Run** (執行)。
   + 若要儲存查詢，請選擇查詢標籤上的三個垂直點，然後選擇 **Save** (儲存)。
   + 若要以不同的名稱儲存查詢，請選擇查詢標籤上的三個垂直點，然後選擇 **Save as** (另存新檔)。

# 重新命名或刪除已儲存的查詢
<a name="saved-queries-rename-or-delete"></a>

**重新命名或刪除已顯示在查詢編輯器中的已儲存的查詢**

1. 選擇查詢標籤上的三個垂直點，然後選擇 **Rename** (重新命名) 或 **Delete** (刪除)。

1. 依照提示重新命名或刪除查詢。

# 重新命名未顯示的已儲存查詢
<a name="saved-queries-rename-not-displayed"></a>

**若要重新命名已顯示在查詢編輯器中的已儲存的查詢**

1. 在 Athena 主控台中，選擇 **Saved queries** (已儲存的查詢) 索引標籤。

1. 選取您要重新命名的查詢的核取方塊。

1. 選擇 **Rename (重新命名)**。

1. 在 **Rename query** (重新命名查詢) 對話方塊中，編輯查詢的名稱和查詢的描述。您可以使用可展開的 **Preview SQL query** (預覽 SQL 查詢) 視窗先確認查詢的內容，然後再重新命名。

1. 選擇 **Rename query** (重新命名查詢)。

   重命名的查詢會出現在 **Saved queries** (已儲存的查詢) 清單中。

# 刪除未顯示的已儲存查詢
<a name="saved-queries-delete-not-displayed"></a>

**若要刪除已顯示在查詢編輯器中的已儲存的查詢**

1. 在 Athena 主控台中，選擇 **Saved queries** (已儲存的查詢) 索引標籤。

1. 選取一個或多個您要刪除的查詢的核取方塊。

1. 選擇 **刪除**。

1. 在確認提示中，選擇 **Delete** (刪除)。

   將從 **Saved queries** (已儲存的查詢) 清單中刪除一個或多個查詢。

# 使用 Athena API 更新已儲存的查詢
<a name="saved-queries-update-with-api"></a>

如需有關使用 Athena API 更新已儲存的查詢的詳細資訊，請參閱 Athena API 參考中的 [UpdateNamedQuery](https://docs.aws.amazon.com/athena/latest/APIReference/API_UpdateNamedQuery.html) 動作。