

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Consulta de tablas configuradas con el editor de código SQL
<a name="use-sql-editor"></a>

Como miembro que puede realizar consultas, puede crear una consulta manualmente escribiendo código SQL en el editor de código SQL. El editor de código SQL se encuentra en la sección **Análisis** de la pestaña **Análisis** de la AWS Clean Rooms consola. 

El editor de código SQL se muestra de forma predeterminada. Si desea usar el creador de análisis para crear consultas, consulte[Consulta con el creador de análisis](query-data-analysis-builder.md). 

**importante**  
Si empieza a escribir una consulta SQL en el editor de código y luego activa la **interfaz de usuario del creador de análisis**, la consulta no se guarda.

AWS Clean Rooms admite muchos comandos, funciones y condiciones de SQL. Para obtener más información, consulte la [Referencia de SQL de AWS Clean Rooms](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html). 

**sugerencia**  
Si se lleva a cabo un mantenimiento programado mientras se está ejecutando una consulta, esta se termina y se revierte. Deberá reiniciar la consulta. 

**Consulta de tablas configuradas con el editor de código SQL**

1. Inicie sesión en [https://console.aws.amazon.com/cleanrooms Consola de administración de AWS](https://console.aws.amazon.com/cleanrooms/home) y abra la AWS Clean Rooms consola.

1. En el panel de navegación izquierdo, elija **Colaboraciones**.

1. Elija la colaboración cuyo estado de **Sus capacidades como miembro** sea **Realizar consultas**.

1. En la pestaña **Análisis**, en **Tablas**, consulte la lista de tablas y el tipo de regla de análisis asociado (regla de **análisis de agregación, regla** de **análisis de listas o regla** de **análisis personalizada**).
**nota**  
Si no ve las tablas que esperaba en la lista, puede deberse a los siguientes motivos:  
Las tablas no se han [asociado](associate-configured-table.md).
Las tablas no tienen [una regla de análisis configurada](add-analysis-rule.md).

1. (Opcional) Para ver el esquema de la tabla y los controles de las reglas de análisis, amplíe la tabla seleccionando el icono del signo más (**\$1**).

1. En la sección **Análisis**, en el **modo Análisis**, seleccione **Escribir código SQL**.
**nota**  
La sección **Análisis** solo se muestra si el miembro que puede recibir los resultados y el miembro responsable de pagar los costos de computación de las consultas se han unido a la colaboración como miembros activos.

1. Cree la consulta escribiéndola en el editor de código SQL.

   Para obtener más información sobre los comandos y funciones de SQL compatibles, consulte la [Referencia de AWS Clean Rooms SQL.](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html) 

   También puede usar las siguientes opciones para crear la consulta.

------
#### [ Use an example query ]

   Para usar una consulta de ejemplo

   1. Elija los tres puntos verticales que aparecen junto al nombre de la tabla.

   1. En **Insertar en el editor**, elija **Consulta de ejemplo**.
**nota**  
Al insertar una **consulta de ejemplo**, se anexa a la consulta que ya está en el editor.

      Aparece el ejemplo de consulta. Todas las tablas que aparecen en **Tablas** se incluyen en la consulta. 

   1. Edite los valores de marcadores de posición de la consulta.

------
#### [ Insert column names or functions ]

   Para insertar un nombre de columna o una función

   1. Seleccione los tres puntos verticales situados junto a una columna.

   1. En **Insertar en el editor**, elija **Nombre de columna**.

   1. Para insertar manualmente una función permitida en una columna, 

      1. Seleccione los tres puntos verticales situados junto a una columna.

      1. Seleccione **Insertar en el editor**.

      1. Seleccione el nombre de la función permitida (por ejemploINNER JOIN,SUM,SUM DISTINCT, oCOUNT).

   1. Pulse **Ctrl** \$1 **Espacio** para ver los esquemas de la tabla en el editor de código.
**nota**  
Los miembros que pueden realizar consultas pueden ver y usar las columnas de partición de cada asociación de tablas configuradas. Asegúrese de que la columna de particiones esté etiquetada como columna de particiones en la AWS Glue tabla subyacente a la tabla configurada.

   1. Edite los valores de marcadores de posición de la consulta.

------

1. Especifique el **tipo de trabajador** admitido y el **número de trabajadores**. 

   Puede elegir el tipo de instancia y el número de instancias (trabajadores) para ejecutar sus consultas SQL. 

   Para CR.1X, puede seleccionar hasta 128 trabajadores o un mínimo de 4 trabajadores. 

   Para CR.4X, puede seleccionar hasta 32 trabajadores o un mínimo de 4 trabajadores. 

   Utilice la siguiente tabla para determinar el tipo y la cantidad de trabajadores que necesita para su caso de uso.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/clean-rooms/latest/userguide/use-sql-editor.html)
**nota**  
Los diferentes tipos y número de trabajadores tienen costos asociados. Para obtener más información sobre los precios, consulta [AWS Clean Rooms los precios](https://aws.amazon.com/clean-rooms/pricing/).

1. En **Enviar los resultados a**, especifique quién puede recibir los resultados. 
**nota**  
Para recibir los resultados, el miembro de la colaboración debe estar configurado como receptor de resultados y debe ser un participante activo en la colaboración (**estado: Activo**)

1. (El miembro solo puede realizar consultas) La casilla **Usar la configuración de resultados predeterminada** está seleccionada de forma predeterminada. Manténgala seleccionada si desea conservar la configuración de resultados predeterminada.

   Si desea especificar una configuración de resultados diferente para esta consulta, desactive la casilla **Usar la configuración de resultados predeterminada** y, a continuación, seleccione lo siguiente. 

   1. **Formato de resultado** (**CSV** o **PARQUET**)

   1. **Archivos de resultados** (**individuales** o **múltiples**)

   1. **Destino de los resultados en Amazon S3**

   Cada miembro que pueda recibir los resultados puede especificar un **formato de resultados**, **archivos** de **resultados y un destino de resultados diferentes en Amazon S3**.

1. Para especificar las **propiedades de Spark**:

   1. Amplíe **Propiedades de Spark**.

   1. Selecciona **Añadir propiedades de Spark**.

   1. En el cuadro de diálogo de **propiedades de Spark**, elija un **nombre de propiedad** en la lista desplegable e introduzca un **valor**.

   En la siguiente tabla se proporciona una definición para cada propiedad.

   Para obtener más información sobre las propiedades de Spark, consulte [Propiedades de Spark](https://spark.apache.org/docs/latest/configuration.html#spark-properties) en la documentación de Apache Spark.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/clean-rooms/latest/userguide/use-sql-editor.html)

1. Seleccione **Ejecutar**.
**nota**  
No podrá ejecutar la consulta si el miembro que puede recibir los resultados no ha configurado los ajustes de resultados de consulta.

1. Consulte los **resultados**. 

   Para obtener más información, consulte [Recepción y uso de los resultados del análisis](receive-query-results.md).

1. Siga ajustando los parámetros y vuelva a ejecutar la consulta, o pulse el botón **\$1** para iniciar una nueva consulta en una pestaña nueva.

**nota**  
AWS Clean Rooms tiene como objetivo proporcionar mensajes de error claros. Si un mensaje de error no contiene detalles suficientes para ayudarle a solucionar el problema, póngase en contacto con el equipo de cuentas. Proporcióneles una descripción de cómo se produjo el error y el mensaje de error (incluidos los identificadores). Para obtener más información, consulte [Solución de problemas AWS Clean Rooms](troubleshooting.md).