# 保存されたクエリを使用する
<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 ロールの更新を介した必要なアクセス許可の維持が可能です。詳細については、「[Migrating Amazon Athena resources to 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. クエリエディタウィンドウの上にあるクエリのタブで 3 つの縦のドットを選択し、**[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. **[Run]** (実行) を選択します。

# 保存されたクエリを編集する
<a name="saved-queries-edit"></a>

**保存されたクエリを編集するには**

1. Athena コンソールを開き、**[Saved queries]** (保存されたクエリ) タブを選択します。

1. **[Saved queries]** (保存されたクエリ) リストで、編集するクエリの ID を選択します。

1. クエリエディタでクエリを編集します。

1. 次のいずれかのステップを実行します。
   + クエリを実行するには、**[Run]** (実行) を選択します。
   + クエリを保存するには、クエリのタブで、3 つの縦のドットを選択し、**[Save]** (保存) を選択します。
   + 別の名前でクエリを保存するには、クエリのタブで、**[Save as]** (名前を付けて保存) を選択します。

# 保存したクエリの名前を変更するか、または削除する
<a name="saved-queries-rename-or-delete"></a>

**クエリエディタに既に表示されている保存済みのクエリの名前を変更またはクエリを削除するには**

1. クエリのタブにある 3 つの縦のドットを選択し、**[Rename]** (名前の変更) または **[Delete]** (削除) を選択します。

1. プロンプトに従って、クエリの名前を変更またはクエリを削除します。

# 表示されていない保存済みクエリの名前を変更する
<a name="saved-queries-rename-not-displayed"></a>

**クエリエディタに表示されていない保存済みクエリの名前を変更するには**

1. Athena コンソールを開き、**[Saved queries]** (保存されたクエリ) タブを選択します。

1. 名前を変更するクエリのチェックボックスを選択します。

1. [**名前の変更**] を選択します。

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. **[削除]** を選択します。

1. 確認プロンプトで、**[Delete]** (削除) を選択します。

   1 つ以上のクエリが、**[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) アクションを参照してください。