Amazon Redshift dejará de admitir la creación de nuevas UDF de Python a partir del parche 198. Las UDF de Python existentes seguirán funcionando hasta el 30 de junio de 2026. Para obtener más información, consulte la [publicación del blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/).
# Creación de consultas con Amazon Redshift
Puede ingresar una consulta en el editor o seleccionar una consulta guardada en la lista de **Queries** (Consultas) y elegir **Run** (Ejecutar).
De manera predeterminada, **Limit 100** (Límite de 100) está configurado para limitar los resultados a 100 filas. Puede desactivar esta opción para devolver un conjunto de resultados más grande. Si desactiva esta opción, puede incluir la opción LIMIT en la instrucción SQL si desea evitar conjuntos de resultados muy grandes. Para obtener más información, consulte [Cláusula ORDER BY](https://docs.aws.amazon.com/redshift/latest/dg/r_ORDER_BY_clause.html) en la *Guía para desarrolladores de bases de datos de Amazon Redshift.*.
Para mostrar un plan de consultas en el área de resultados, active **Explain** (Explicar). Active **Explain graph** (Explicar gráfico) para que en los resultados también se muestre una representación gráfica del plan de explicación.
Para guardar una consulta en la carpeta **Queries** (Consultas), elija **Save** (Guardar).
Si una consulta es correcta, aparece un mensaje de éxito. Si la consulta devuelve información, los resultados se muestran en la sección **Results** (Resultados). Si el número de resultados excede el área de visualización, los números aparecen en la parte superior del área de resultados. Puede elegir los números para mostrar páginas sucesivas de resultados.
Puede filtrar y ordenar **Result** (Resultado) para cada columna. Para ingresar criterios de filtro en el encabezado de la columna de resultados, desplácese sobre la columna para ver un menú (![\[Filter menu\]](http://docs.aws.amazon.com/es_es/redshift/latest/mgmt/images/menu.png)) donde puede ingresar criterios para filtrar la columna.
Si la consulta contiene un error, el editor de consultas v2 muestra un mensaje de error en el área de resultados. El mensaje proporciona información sobre cómo corregir la consulta.
Puede exportar o copiar los resultados de la consulta mediante el menú contextual (clic derecho) en el área de resultados de la siguiente manera:
+ Elija **Copiar a** y luego **JSON** o **CSV** para descargar las filas seleccionadas en un archivo.
+ Elija **Copiar filas** para copiar las filas seleccionadas en el portapapeles.
+ Elija **Copiar filas con encabezados** para copiar las filas seleccionadas con los encabezados de las columnas en el portapapeles.
Puede elegir también **Exportar** en el área de resultados y, a continuación, elija **JSON** o **CSV** para descargar todo el conjunto de resultados de fila en un archivo. El número de filas del conjunto de resultados puede estar limitado por la opción **Limit** (Límite) o la cláusula `limit` de SQL de la consulta. El tamaño máximo del conjunto de resultados descargado es de 5 MB.
También puede utilizar el acceso directo Ctrl\$1C en Windows o Cmd\$1C en macOS para copiar los datos de la página de resultados actual al portapapeles. Si no se selecciona ninguna fila, la celda con enfoque se copia en el portapapeles. Si se seleccionan filas, las filas seleccionadas se copian en el portapapeles.
Para agregar una nueva pestaña de consulta, elija el icono ![\[New query tab\]](http://docs.aws.amazon.com/es_es/redshift/latest/mgmt/images/add-plus.png) y luego el **Editor**, que aparece en la fila con las pestañas de consulta. La pestaña de consulta utiliza una `Isolated session` o no. Con una sesión aislada, los resultados de un comando SQL, como la creación de una tabla temporal en una pestaña del editor, no son visibles en otra pestaña del editor. Al abrir una pestaña del editor en el editor de consultas v2, el valor predeterminado es una sesión aislada.
**Para ejecutar una consulta**
1. En el área de consulta, realice una de las siguientes acciones:
+ Ingrese una consulta.
+ Pegue una consulta que haya copiado.
+ Elija la carpeta **Queries** (Consultas), abra el menú contextual (clic derecho), seleccione una consulta guardada y elija **Open query** (Abrir consulta).
1. Confirme que eligió el valor de **Cluster** (Clúster), **Workgroup** (Grupo de trabajo) y **Database** (Base de datos) correctos para el SQL que va a ejecutar.
Inicialmente, puede elegir el **Cluster** (Clúster) o **Workgroup** (Grupo de trabajo) en vista de árbol. Elija la **Database** (Base de datos) en vista de árbol también.
Puede cambiar el **Clúster** o el **Grupo de trabajo** y la **Base de datos** en cada pestaña del editor con el control desplegable ubicado cerca del encabezado **Sesión aislada** de cada una.
Decida en cada pestaña del editor si desea ejecutar el SQL en una **Isolated session** (Sesión aislada). Una sesión aislada tiene su propia conexión a una base de datos. Se usa para ejecutar SQL que está aislado de otras sesiones del editor de consultas. Para obtener más información acerca de las conexiones, consulte [Apertura del editor de consultas v2](query-editor-v2-open.md).
1. Seleccione **Ejecutar**.
El área **Result** (Resultado) se abre y muestra los resultados de la consulta.
**Para mostrar el plan de explicación de una consulta**
1. Seleccione la consulta.
1. Active **Explain** (Explicación).
De manera predeterminada, el **Explain graph** (Gráfico de explicación) también está activado.
1. Seleccione **Ejecutar**.
La consulta se ejecuta y se muestra el plan de explicación en el área **Result** (Resultado) de la consulta.
El editor de consultas v2 es compatible con las siguientes características.
+ Puede crear consultas con varias instrucciones SQL en una pestaña de consulta. Las consultas se ejecutan en serie y se abren varias pestañas de resultados para cada consulta.
+ Puede crear consultas con variables de sesión y tablas temporales.
+ Puede crear consultas con parámetros reemplazables designados por `${parameter}`. Puede crear la consulta SQL con varios parámetros reemplazables y utilizar el mismo parámetro en varios lugares de la instrucción SQL.
Cuando se ejecuta la consulta, se presenta una ventana para ingresar el valor del parámetro. Cada vez que ejecuta la consulta, se presenta la ventana para ingresar los valores de los parámetros.
Para ver un ejemplo, consulta [Ejemplo: Ventas superiores a un parámetro específico](#query-editor-v2-example-sales-qtysold-greater-than-parameter).
+ Las consultas se versionan automáticamente. Puede elegir una versión anterior de una consulta que desea ejecutar.
+ No tiene que esperar a que se complete una consulta para continuar con su flujo de trabajo. Las consultas se siguen ejecutando incluso si cierra el editor de consultas.
+ Cuando se crean consultas, se admite la finalización automática de nombres de esquemas, tablas y columnas.
El editor SQL es compatible con las siguientes características:
+ Los corchetes iniciales y finales utilizados en SQL tienen colores coincidentes. Las líneas verticales se muestran en el editor para ayudarle a hacer coincidir los corchetes.
+ Puede contraer y expandir secciones del SQL.
+ Puede buscar y sustituir texto en el SQL.
+ Puede utilizar las teclas de acceso directo para varias tareas de edición habituales.
+ Los errores de SQL se resaltan en el editor para la ubicación adecuada de las áreas problemáticas.
Para obtener una demostración de las características del editor, vea el siguiente video.
[](http://www.youtube.com/watch?v=https://www.youtube.com/embed/9JAq0yDs0YE)
## Consultas de ejemplo
A continuación, encontrará descripciones de los distintos tipos de consultas que puede ejecutar.
Los datos utilizados en estas consultas proceden del esquema de ejemplo de `tickit`. Para obtener más información acerca de cómo cargar datos de `tickit` de ejemplo, consulte [Descarga de datos en una base de datos](query-editor-v2-loading.md). Para obtener más información sobre los datos de ejemplo de `tickit`, consulte [Bases de datos de ejemplo](https://docs.aws.amazon.com/redshift/latest/dg/c_sampledb.html) en la *Guía para desarrolladores de bases de datos de Amazon Redshift*.
Cuando ejecute estas consultas de ejemplo, confirme que eligió la base de datos correcta en el editor, como `sample_data_dev`.
**Topics**
+ [Ejemplo: Configuración de variables de sesión](#query-editor-v2-example-set-session-variable)
+ [Ejemplo: Evento principal por ventas totales](#query-editor-v2-example-top-event-sales)
+ [Ejemplo: Ventas superiores a un parámetro específico](#query-editor-v2-example-sales-qtysold-greater-than-parameter)
+ [Ejemplo: Creación de una tabla temporal](#query-editor-v2-example-create-temporary-table)
+ [Ejemplo: Selección de una tabla temporal](#query-editor-v2-example-select-from-temporary-table)
### Ejemplo: Configuración de variables de sesión
El siguiente comando establece el parámetro de configuración de servidor `search_path` en *public* (público) para la sesión. Para obtener más información, consulte [SET](https://docs.aws.amazon.com/redshift/latest/dg/r_SET.html) y [search\$1path](https://docs.aws.amazon.com/redshift/latest/dg/r_search_path.html) en la *Guía para desarrolladores de bases de datos de Amazon Redshift*.
```
set search_path to public;
```
### Ejemplo: Evento principal por ventas totales
En la siguiente consulta se encuentra el evento con mayor cantidad de ventas.
```
select eventname, count(salesid) totalorders, sum(pricepaid) totalsales
from sales, event
where sales.eventid=event.eventid
group by eventname
order by 3;
```
A continuación, se presenta una lista parcial de los resultados.
```
eventname totalorders totalsales
White Christmas 20 9352
Joshua Radin 38 23469
Beach Boys 58 30383
Linda Ronstadt 56 35043
Rascal Flatts 76 38214
Billy Idol 67 40101
Stephenie Meyer 72 41509
Indigo Girls 57 45399
...
```
### Ejemplo: Ventas superiores a un parámetro específico
En la siguiente consulta se encuentran las ventas en las que la cantidad vendida es mayor que el parámetro especificado por `${numberoforders}`. Cuando el valor del parámetro es `7`, el resultado es 60 filas. Cuando ejecuta la consulta, el editor de consultas v2 muestra una ventana que dice **Run query form** (Ejecutar formulario de consulta) para recopilar el valor de los parámetros de la instrucción SQL.
```
select salesid, qtysold
from sales
where qtysold > ${numberoforders}
order by 2;
```
A continuación, se presenta una lista parcial de los resultados.
```
salesid qtysold
20005 8
21279 8
130232 8
42737 8
74681 8
67103 8
105533 8
91620 8
121552 8
...
```
### Ejemplo: Creación de una tabla temporal
La siguiente instrucción crea la tabla temporal *eventsalestemp* seleccionando información de las tablas *sales* y *event*.
```
create temporary table eventsalestemp as
select eventname, count(salesid) totalorders, sum(pricepaid) totalsales
from sales, event
where sales.eventid=event.eventid
group by eventname;
```
### Ejemplo: Selección de una tabla temporal
En la siguiente instrucción se seleccionan los eventos, el total de pedidos y las ventas totales de la tabla temporal *eventsalestemp*, ordenados por total de pedidos.
```
select eventname, totalorders, totalsales
from eventsalestemp
order by 2;
```
A continuación, se presenta una lista parcial de resultados.
```
eventname totalorders totalsales
White Christmas 20 9352
Joshua Radin 38 23469
Martina McBride 50 52932
Linda Ronstadt 56 35043
Indigo Girls 57 45399
Beach Boys 58 30383
...
```