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 com o construtor de análises
Você pode usar o criador de análises para criar consultas sem precisar escrever código SQL. Com o criador de análises, você pode criar uma consulta para uma colaboração que tenha:
+ Uma única tabela que usa a [regra de análise de agregação](analysis-rules-aggregation.md) sem a necessidade de JOIN
+ Duas tabelas (uma de cada membro) que usam a [regra de análise de agregação](glossary.md#glossary-agg-analysis-rule)
+ Duas tabelas (uma de cada membro) que usam a [regra de análise de lista](glossary.md#glossary-list-analysis-rule)
+ Duas tabelas (uma de cada membro) que usam a regra de análise de agregação e duas tabelas (uma de cada membro) que usam a regra de análise de lista
Se quiser escrever consultas SQL manualmente, consulte [Consultar tabelas configuradas usando o editor de código SQL](use-sql-editor.md).
O criador de análises aparece como a opção de **interface do usuário do Criador** de **análises** na seção **Análise da guia Análise** no AWS Clean Rooms console.
**Importante**
Se você ativar a **Interface do usuário do construtor de análises**, começar a criar uma consulta no construtor de análises e, depois, desativar a **Interface do usuário do construtor de análises**, sua consulta não será salva.
**dica**
Se uma manutenção programada ocorrer enquanto uma consulta estiver sendo executada, a consulta será encerrada e revertida. Você deve reiniciar a consulta.
Os tópicos a seguir explicam como usar o analysis builder (criador de análise).
**Topics**
+ [Use o analysis builder para consultar uma única tabela (agregação)](#use-analysis-builder-one-table)
+ [Use o construtor de análise para consultar duas tabelas (agregação ou lista)](#use-analysis-builder-two-tables)
## Use o analysis builder para consultar uma única tabela (agregação)
Esse procedimento demonstra como usar a **interface do usuário do Analysis Builder** no AWS Clean Rooms console para criar uma consulta. A consulta é para uma colaboração que tem uma única tabela que usa a [regra de análise de agregação](analysis-rules-aggregation.md) sem JOIN necessidade.
**Para usar o analysis builder para consultar uma única tabela**
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 tabela e o tipo de regra de análise associado. (O tipo de regra de análise deve ser a **regra de análise de agregação**.)
**nota**
Se não estiver vendo a tabela que espera, isso pode ser pelos seguintes motivos:
A tabela não foi [associada](associate-configured-table.md).
A tabela não tem uma [regra de análise configurada](add-analysis-rule.md).
1. Na seção **Análise**, ative a **IU do Analysis Builder**.
1. Crie uma consulta.
Se quiser ver todas as métricas de agregação, vá para a etapa 9.
1. Em **Escolher métricas**, revise as métricas agregadas que foram pré-selecionadas por padrão e remova qualquer métrica, se necessário.
1. (Opcional) Em **Adicionar segmentos – opcional**, escolha um ou mais parâmetros.
**nota**
**Adicionar segmentos – opcional** só é exibido se as dimensões forem especificadas para a tabela.
1. (Opcional) Em **Adicionar filtros – opcional**, escolha **Adicionar filtro** e, em seguida, escolha um **parâmetro**, operador e **valor**.
Para adicionar mais filtros, escolha **Adicionar outro filtro**.
Para remover um filtro, selecione **Remover**.
**nota**
Não é possível usar ORDER BY em consultas de agregação.
Somente o operador AND é compatível com filtros.
1. (Opcional) Em **Adicionar descrição – opcional**, insira uma descrição para ajudar a identificar a consulta na lista de consultas.
1. Expanda **Visualizar código SQL**.
1. Visualize o código SQL que é gerado pelo construtor de análises.
1. Para copiar o código SQL, escolha **Copiar**.
1. Para editar o código SQL, escolha **Editar no editor de código SQL**.
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. 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).
## Use o construtor de análise para consultar duas tabelas (agregação ou lista)
Este procedimento descreve como usar o criador de análise no AWS Clean Rooms console para criar uma consulta para uma colaboração que tenha:
+ Duas tabelas (uma de cada membro) que usam a [regra de análise de agregação](analysis-rules-aggregation.md)
+ Duas tabelas (uma de cada membro) que usam a [regra de análise de lista](analysis-rules-list.md)
+ Duas tabelas (uma de cada membro) que usam a regra de análise de agregação e duas tabelas (uma de cada membro) que usam a regra de análise de lista
**Para usar o analysis builder para consultar duas tabelas**
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 **Suas habilidades de membro** como **Executar consultas..**
1. Na guia **Análise**, em **Tabelas**, visualize as duas tabelas e o tipo de regra de análise associada (regra de **análise de agregação ou regra** de **análise de lista**).
**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. Na seção **Análise**, ative a **IU do Analysis Builder**.
1. Crie uma consulta.
Se a colaboração contiver duas tabelas que usam a **regra de análise de agregação** e duas tabelas que usam a **regra de análise de lista**, primeiro escolha **Agregação** ou **Lista** e, em seguida, siga as instruções com base na regra de análise selecionada.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/query-data-analysis-builder.html)
1. Expanda **Visualizar código SQL**.
1. Visualize o código SQL que é gerado pelo construtor de análises.
1. Para copiar o código SQL, escolha **Copiar**.
1. Para editar o código SQL, escolha **Editar no editor de código SQL**.
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. 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).