

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Consultar tabelas configuradas usando o editor de código SQL
<a name="use-sql-editor"></a>

Como membro que pode consultar, você pode criar uma consulta manualmente escrevendo código SQL no editor de código SQL. O editor de código SQL está localizado na seção **Análise** da guia **Análise** no AWS Clean Rooms console. 

O editor de código SQL é exibido por padrão. Se quiser usar o criador de análises para criar consultas, consulte [Consultar com o construtor de análises](query-data-analysis-builder.md). 

**Importante**  
Se você começar a escrever uma consulta SQL no editor de código e depois ativar a **Interface do usuário do construtor de análises**, sua consulta não será salva.

AWS Clean Rooms oferece suporte a muitos comandos, funções e condições SQL. Para obter mais informações, consulte a [Referência SQL do AWS Clean Rooms](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html). 

**dica**  
Se uma manutenção programada ocorrer enquanto uma consulta estiver sendo executada, a consulta será encerrada e revertida e será necessário reiniciá-la. Você deve reiniciar a consulta. 

**Como consultar tabelas configuradas usando o editor de código SQL**

1. Faça login no Console de gerenciamento da AWS e abra o AWS Clean Rooms console em [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. No painel de navegação à esquerda, escolha **Colaborações**.

1. Escolha a colaboração que tem o status **Executar consultas** em **Suas habilidades de membro**.

1. Na guia **Análise**, em **Tabelas**, visualize a lista de tabelas e o tipo de regra de análise associada (regra de **análise de agregação, regra** de **análise de lista ou regra** de **análise personalizada**).
**nota**  
Se não estiver vendo as tabelas que espera na lista, isso pode ser pelos seguintes motivos:  
As tabelas não foram [associadas](associate-configured-table.md).
As tabelas não têm uma [regra de análise configurada](add-analysis-rule.md).

1. (Opcional) Para visualizar os controles do esquema e da regra de análise da tabela, expanda a tabela selecionando o ícone do sinal de adição (**\$1**).

1. Na seção **Análise**, para o **modo Análise**, selecione **Gravar código SQL**.
**nota**  
A seção **Análise** só será exibida se o membro que pode receber os resultados e o membro responsável por pagar pelos custos de computação da consulta tiverem ingressado na colaboração como membro ativo.

1. Crie a consulta digitando a consulta no editor de código SQL.

   Para obter mais informações sobre comandos e funções SQL compatíveis, consulte a [Referência AWS Clean Rooms SQL.](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html) 

   Você também pode usar as opções a seguir para criar sua consulta.

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

   Para usar um exemplo de consulta

   1. Clique nos três pontos verticais ao lado da tabela.

   1. Em **Inserir no editor**, escolha **Exemplo de consulta**.
**nota**  
A inserção de uma **consulta de exemplo** a anexa à consulta que já está no editor.

      O exemplo de consulta é exibido. Todas as tabelas listadas em **Tabelas** estão incluídas na consulta. 

   1. Edite os valores do espaço reservado na consulta.

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

   Para inserir um nome ou função de coluna

   1. Selecione os três pontos verticais ao lado de uma coluna.

   1. Em **Inserir no editor**, escolha **Nome da coluna**.

   1. Para inserir manualmente uma função permitida em uma coluna, 

      1. Selecione os três pontos verticais ao lado de uma coluna.

      1. Selecione **Inserir no editor**.

      1. Selecione o nome da função permitida (como INNER JOINSUM,SUM DISTINCT, ouCOUNT).

   1. Pressione **Ctrl** \$1 **Espaço** para visualizar os esquemas da tabela no editor de código.
**nota**  
Os membros que podem consultar podem visualizar e usar as colunas de partição em cada associação de tabela configurada. Certifique-se de que a coluna de partição esteja rotulada como uma coluna de partição na AWS Glue tabela subjacente à tabela configurada.

   1. Edite os valores do espaço reservado na consulta.

------

1. Especifique o **tipo de trabalhador** suportado e o **número de trabalhadores**. 

   Você pode escolher o tipo de instância e o número de instâncias (trabalhadores) para executar suas consultas SQL. 

   Para o CR.1X, você pode selecionar até 128 trabalhadores ou um mínimo de 4 trabalhadores. 

   Para o CR.4X, você pode selecionar até 32 trabalhadores ou um mínimo de 4 trabalhadores. 

   Use a tabela a seguir para determinar o tipo e o número de trabalhadores necessários para seu caso de uso.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/use-sql-editor.html)
**nota**  
Diferentes tipos de trabalhadores e números de trabalhadores têm custos associados. Para saber mais sobre os preços, consulte os [AWS Clean Rooms preços](https://aws.amazon.com/clean-rooms/pricing/).

1. Em **Enviar resultados para**, especifique quem pode receber os resultados. 
**nota**  
Para receber resultados, o membro da colaboração deve estar configurado como receptor de resultados e deve ser um participante ativo na colaboração (**Status: Ativo**)

1. (Membro que pode consultar somente) A caixa de seleção **Usar suas configurações padrão de resultados** está marcada por padrão. Mantenha essa opção selecionada se quiser manter suas configurações de resultado padrão.

   Se você quiser especificar configurações de resultados diferentes para essa consulta, desmarque a caixa de seleção **Usar suas configurações de resultado padrão** e escolha o seguinte. 

   1. **Formato do resultado** (**CSV** ou **PARQUET**)

   1. **Arquivos de resultados** (**únicos** ou **múltiplos**)

   1. **Destino dos resultados no Amazon S3**

   Cada membro que pode receber resultados pode especificar um **formato de resultado****, arquivos** de **resultados e destino de resultados diferentes no Amazon S3**.

1. Para especificar as **propriedades do Spark:**

   1. Expanda as **propriedades do Spark**.

   1. Escolha **Adicionar propriedades do Spark**.

   1. **Na caixa de diálogo de **propriedades do Spark**, escolha um **nome de propriedade** na lista suspensa e insira um Valor.**

   A tabela a seguir fornece uma definição para cada propriedade.

   Para obter mais informações sobre as propriedades do Spark, consulte Propriedades do [Spark na documentação](https://spark.apache.org/docs/latest/configuration.html#spark-properties) do Apache Spark.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/use-sql-editor.html)

1. Escolha **Executar**.
**nota**  
Você não poderá executar a consulta se o membro que pode receber os resultados não tiver definido as configurações dos resultados da consulta.

1. Visualize os **Resultados**. 

   Para obter mais informações, consulte [Recebendo e usando os resultados da análise](receive-query-results.md).

1. Continue ajustando os parâmetros e execute sua consulta novamente ou escolha o botão **\$1** para iniciar uma nova consulta em uma nova guia.

**nota**  
AWS Clean Rooms visa fornecer mensagens de erro claras. Se uma mensagem de erro não tiver detalhes suficientes para ajudá-lo a solucionar o problema, entre em contato com a equipe da conta. Forneça a eles uma descrição de como o erro ocorreu e a mensagem de erro (incluindo quaisquer identificadores). Para obter mais informações, consulte [Solução de problemas AWS Clean Rooms](troubleshooting.md).