# Uso de consultas guardadas
<a name="saved-queries"></a>

Puede utilizar la consola de Athena para guardar, editar, ejecutar, cambiar el nombre y eliminar las consultas creadas en el editor de consultas.

## Consideraciones y limitaciones
<a name="saved-queries-considerations-and-limitations"></a>
+ Puede actualizar el nombre, la descripción y el texto de consulta de las consultas guardadas.
+ Solo puede actualizar las consultas en su propia cuenta.
+ No puede cambiar el grupo de trabajo ni la base de datos a la que pertenece la consulta.
+ Athena no guarda un historial de modificaciones de consultas. Si desea conservar una versión concreta de una consulta, guárdela con otro nombre.

**nota**  
Ahora se puede acceder a los recursos de Amazon Athena desde el Estudio unificado de Amazon SageMaker (versión preliminar), lo que le ayuda a acceder a los datos de su organización y actuar sobre ellos con las mejores herramientas. Puede migrar consultas guardadas de un grupo de trabajo de Athena a un proyecto del Estudio unificado de SageMaker, configurar proyectos con grupos de trabajo de Athena existentes y mantener los permisos necesarios mediante actualizaciones de roles de IAM. Para obtener más información, consulte [Migración de recursos de Amazon Athena al Estudio unificado de Amazon SageMaker (versión preliminar)](https://github.com/aws/Unified-Studio-for-Amazon-Sagemaker/tree/main/migration/athena).

**Topics**
+ [Consideraciones y limitaciones](#saved-queries-considerations-and-limitations)
+ [Guardar una consulta con un nombre](saved-queries-name.md)
+ [Ejecución de una consulta guardada](saved-queries-run.md)
+ [Edición de una consulta guardada](saved-queries-edit.md)
+ [Cambio de nombre o eliminación de una consulta guardada](saved-queries-rename-or-delete.md)
+ [Cambio de nombre de una consulta guardada que no se muestra](saved-queries-rename-not-displayed.md)
+ [Eliminación de una consulta guardada que no se muestra](saved-queries-delete-not-displayed.md)
+ [Uso de la API de Athena para actualizar las consultas guardadas](saved-queries-update-with-api.md)

# Guardar una consulta con un nombre
<a name="saved-queries-name"></a>

**Para guardar una consulta y ponerle un nombre**

1. En el editor de consultas de la consola de Athena, ingrese o ejecute la consulta.

1. Sobre la ventana del editor de consultas, en la pestaña correspondiente a la consulta, seleccione los tres puntos verticales y, a continuación, **Save as** (Guardar como).

1. En el cuadro de diálogo **Save query** (Guardar consulta), ingrese un nombre para la consulta y una descripción opcional. Puede utilizar la ventana ampliable **Preview SQL query** (Vista previa de consultas SQL) para verificar el contenido de la consulta antes de guardarla.

1. Seleccione **Save query** (Guardar consulta).

   En el editor de consultas, la pestaña de la consulta muestra el nombre que ha especificado.

# Ejecución de una consulta guardada
<a name="saved-queries-run"></a>

**Para ejecutar una consulta guardada**

1. En la consola de Athena, elija la pestaña **Saved queries** (Consultas guardadas).

1. En la lista **Saved queries** (Consultas guardadas), elija el nombre de la consulta que quiera ejecutar.

   El editor de consultas muestra la consulta que eligió.

1. Seleccione **Ejecutar**.

# Edición de una consulta guardada
<a name="saved-queries-edit"></a>

**Para editar una consulta guardada**

1. En la consola de Athena, elija la pestaña **Saved queries** (Consultas guardadas).

1. En la lista **Saved queries** (Consultas guardadas), elija la ID de la consulta que quiera editar.

1. En el editor de consultas, edite la consulta.

1. Lleve a cabo uno de los siguientes pasos:
   + Elija **Run** (Ejecutar) para ejecutar la consulta.
   + Para guardar la consulta, seleccione los tres puntos verticales en la pestaña de la consulta y, a continuación, seleccione **Save** (Guardar).
   + Para guardar la consulta con otro nombre, elija los tres puntos verticales en la pestaña de la consulta y, a continuación, elija **Save as** (Guardar como).

# Cambio de nombre o eliminación de una consulta guardada
<a name="saved-queries-rename-or-delete"></a>

**Para cambiar el nombre de una consulta guardada que ya se muestra en el editor de consultas**

1. Elija los tres puntos verticales de la pestaña de la consulta y, a continuación, elija **Rename** (Cambiar nombre) o **Delete** (Eliminar).

1. Siga las instrucciones para cambiar el nombre de la consulta o eliminarla.

# Cambio de nombre de una consulta guardada que no se muestra
<a name="saved-queries-rename-not-displayed"></a>

**Para cambiar el nombre de una consulta guardada que no se muestra en el editor de consultas**

1. En la consola de Athena, elija la pestaña **Saved queries** (Consultas guardadas).

1. Seleccione la casilla de verificación de la consulta cuyo nombre quiera cambiar.

1. Elija **Rename (Cambiar nombre)**.

1. En el cuadro de diálogo **Rename query** (Cambio del nombre de la consulta), edite el nombre y la descripción de la consulta. Puede utilizar la ventana ampliable **Preview SQL query** (Vista previa de consultas SQL) para verificar el contenido de la consulta antes de cambiarle el nombre.

1. Elija **Rename query** (Cambio del nombre de la consulta).

   La consulta renombrada aparece en la lista **Saved queries** (Consultas guardadas).

# Eliminación de una consulta guardada que no se muestra
<a name="saved-queries-delete-not-displayed"></a>

**Para eliminar una consulta guardada que no se muestra en el editor de consultas**

1. En la consola de Athena, elija la pestaña **Saved queries** (Consultas guardadas).

1. Seleccione una o varias casillas de verificación correspondientes a las consultas que desee eliminar.

1. Elija **Eliminar**.

1. En el mensaje de confirmación, elija **Delete** (Eliminar).

   Una o más consultas se eliminan de la lista **Saved queries** (Consultas guardadas).

# Uso de la API de Athena para actualizar las consultas guardadas
<a name="saved-queries-update-with-api"></a>

Para obtener información sobre cómo utilizar la API de Athena para actualizar una consulta guardada, consulte la acción [UpdateNamedQuery](https://docs.aws.amazon.com/athena/latest/APIReference/API_UpdateNamedQuery.html) en la Referencia de API de Athena.