# Usar consultas salvas
<a name="saved-queries"></a>

É possível usar o console do Athena para salvar, editar, executar, renomear e excluir consultas criadas no editor de consultas.

## Considerações e limitações
<a name="saved-queries-considerations-and-limitations"></a>
+ É possível atualizar o nome, a descrição e o texto de consultas salvas.
+ Apenas é possível atualizar as consultas na sua própria conta.
+ Você não pode alterar o grupo de trabalho ou o banco de dados ao qual essa consulta pertence.
+ O Athena não mantém um histórico de modificações de consultas. Se quiser manter uma versão específica de uma consulta, salve-a com um nome diferente.

**nota**  
Os recursos do Amazon Athena agora podem ser acessados no Estúdio Unificado Amazon SageMaker (Preview), o que ajuda você a acessar os dados da sua organização e agir com base neles usando as melhores ferramentas. É possível migrar consultas salvas de um grupo de trabalho do Athena para um projeto do SageMaker Unified Studio, configurar projetos com grupos de trabalho existentes do Athena e manter as permissões necessárias por meio de atualizações de perfis do IAM. Para obter mais informações, consulte [Migrar recursos do Amazon Athena para o Estudio Unificado Amazon SageMaker (Preview)](https://github.com/aws/Unified-Studio-for-Amazon-Sagemaker/tree/main/migration/athena).

**Topics**
+ [Considerações e limitações](#saved-queries-considerations-and-limitations)
+ [Salvar uma consulta com um nome](saved-queries-name.md)
+ [Executar uma consulta salva](saved-queries-run.md)
+ [Editar uma consulta salva](saved-queries-edit.md)
+ [Renomear ou excluir uma consulta salva](saved-queries-rename-or-delete.md)
+ [Renomear uma consulta salva não exibida](saved-queries-rename-not-displayed.md)
+ [Excluir uma consulta salva não exibida](saved-queries-delete-not-displayed.md)
+ [Usar a API do Athena para atualizar consultas salvas](saved-queries-update-with-api.md)

# Salvar uma consulta com um nome
<a name="saved-queries-name"></a>

**Para salvar uma consulta e dar um nome para ela**

1. Insira ou execute uma consulta no editor de consultas do console do Athena.

1. Acima da janela do editor de consultas, na guia para a consulta, selecione os três pontos verticais e, em seguida, escolha **Save as** (Salvar como).

1. Na caixa de diálogo **Save query** (Salvar consulta), insira um nome para a consulta e uma descrição opcional. Você pode usar a janela expansível **Preview SQL query** (Visualizar consulta SQL) para verificar o conteúdo da consulta antes de a salvar.

1. Escolha **Save query** (Salvar consulta).

   No editor de consultas, a guia referente à consulta mostra o nome especificado.

# Executar uma consulta salva
<a name="saved-queries-run"></a>

**Como executar uma consulta salva**

1. No console do Athena, escolha a guia **Saved queries** (Consultas salvas).

1. Na lista **Saved queries** (Consultas salvas), escolha o ID da consulta que deseja executar.

   O editor de consultas mostra a consulta escolhida.

1. Escolha **Executar**.

# Editar uma consulta salva
<a name="saved-queries-edit"></a>

**Para editar uma consulta salva**

1. No console do Athena, escolha a guia **Saved queries** (Consultas salvas).

1. Na lista **Saved queries** (Consultas salvas), escolha o ID da consulta que deseja editar.

1. Edite consulta no editor de consultas.

1. Execute uma das seguintes etapas:
   + Para executar a consulta, escolha **Run** (Executar).
   + Para salvar a consulta, selecione os três pontos verticais na guia para a consulta e, em seguida, escolha **Save** (Salvar).
   + Para salvar a consulta com um nome diferente, selecione os três pontos verticais na guia para a consulta e, em seguida, escolha **Save as** (Salvar como).

# Renomear ou excluir uma consulta salva
<a name="saved-queries-rename-or-delete"></a>

**Para renomear ou excluir uma consulta salva já exibida no editor de consultas**

1. Selecione os três pontos verticais na guia para a consulta e, em seguida, escolha **Rename** (Renomear) ou **Delete** (Excluir).

1. Siga as solicitações para renomear ou excluir a consulta.

# Renomear uma consulta salva não exibida
<a name="saved-queries-rename-not-displayed"></a>

**Para renomear uma consulta salva não exibida no editor de consultas**

1. No console do Athena, escolha a guia **Saved queries** (Consultas salvas).

1. Marque a caixa de seleção referente à consulta que você deseja renomear.

1. Escolha **Rename (Renomear)**.

1. Na caixa de diálogo **Rename query** (Renomear consulta), edite o nome da consulta e sua descrição. Você pode usar a janela expansível **Preview SQL query** (Visualizar consulta SQL) para verificar o conteúdo da consulta antes de a renomear.

1. Escolha **Rename query** (Renomear consulta).

   A consulta renomeada aparece na lista **Saved queries** (Consultas salvas).

# Excluir uma consulta salva não exibida
<a name="saved-queries-delete-not-displayed"></a>

**Para excluir uma consulta salva não exibida no editor de consultas**

1. No console do Athena, escolha a guia **Saved queries** (Consultas salvas).

1. Marque uma ou mais das caixas de seleção referentes às consultas que você deseja excluir.

1. Escolha **Excluir**.

1. No prompt de confirmação, selecione **Excluir**.

   Uma ou mais consultas serão removidas da lista **Saved queries** (Consultas salvas).

# Usar a API do Athena para atualizar consultas salvas
<a name="saved-queries-update-with-api"></a>

Para informações sobre o uso da API do Athena para atualizar uma consulta salva, consulte a ação [UpdateNamedQuery](https://docs.aws.amazon.com/athena/latest/APIReference/API_UpdateNamedQuery.html) na Referência de APIs Athena.