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á.

# Adicionar uma regra de análise a uma tabela configurada
<a name="add-analysis-rule"></a>

As seções a seguir descrevem como adicionar uma regra de análise à sua tabela configurada. Ao definir as regras de análise, é possível autorizar o membro que pode consultar a executar consultas que correspondam a uma regra de análise específica compatível com o AWS Clean Rooms.

AWS Clean Rooms suporta os seguintes tipos de regras de análise:
+ [Regra de análise de agregação](analysis-rules-aggregation.md)
+ [Regra de análise de lista](analysis-rules-list.md)
+ [Regra de análise personalizada em AWS Clean Rooms](analysis-rules-custom.md)

Só pode haver uma regra de análise por tabela configurada. É possível configurar a regra de análise a qualquer momento antes de associar suas tabelas configuradas à colaboração.

**Importante**  
Se você estiver usando Computação Criptográfica para o Clean Rooms e tiver tabelas de dados criptografadas na colaboração, a regra de análise adicionada à tabela configurada criptografada deverá ser consistente com a forma como os dados foram criptografados. Por exemplo, se você criptografou os dados para SELECT (regra de análise de agregação), não deverá adicionar a regra de análise para JOIN (regra de análise de lista).

**Topics**
+ [

## Adicionar uma regra de análise de agregação a uma tabela (fluxo guiado)
](#add-agg-analysis-rule-console-wizard)
+ [

## Adicionar uma regra de análise de lista a uma tabela (fluxo guiado)
](#add-list-analysis-rule-console-wizard)
+ [

## Adicionar uma regra de análise personalizada a uma tabela (fluxo guiado)
](#add-custom-analysis-rule-wizard)
+ [

## Adicionar a regra de análise a uma tabela (editor JSON)
](#add-analysis-rule-console-json-editor)
+ [

## Próximas etapas
](#add-analysis-rule-next-step)

## Adicionar uma regra de análise de agregação a uma tabela (fluxo guiado)
<a name="add-agg-analysis-rule-console-wizard"></a>

A *regra de análise de agregação* possibilita consultas que agregam estatísticas sem revelar informações em nível de linha por meio das funções COUNT, SUM e AVG com dimensões opcionais.

Esse procedimento descreve o processo de adicionar uma regra de análise de agregação à sua tabela configurada usando a opção **Fluxo guiado** no console AWS Clean Rooms .

**nota**  
As tabelas configuradas usando fontes de dados não S3 oferecem suporte somente às regras de [análise personalizadas](#add-custom-analysis-rule-wizard).

**Para adicionar a regra de análise de agregação a uma tabela (fluxo guiado)**

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, selecione **Tables (Tabelas)**.

1. Escolha a tabela configurada.

1. Na página de detalhes da tabela configurada, escolha **Configurar regra de análise**.

1. Em **Etapa 1: Escolha o tipo de regra de análise, em Tipo** de **regra de análise**, escolha a opção **Agregação**.

1. Em **Método de criação**, selecione **Fluxo guiado** e escolha **Avançar**. 

1. Na **Etapa 2: Especificar controles de consulta**, para **Funções agregadas**:

   1. Escolha uma **Função agregadas** no menu suspenso:
      + **CONTAGEM**
      + **CONTAGEM DISTINTA**
      + **SUM**
      + **SOMA DISTINTA**
      + **AVG**

   1. Escolha quais colunas podem ser usadas na **Função agregadas** no menu suspenso **Colunas**.

   1. (Opcional) Escolha **Adicionar outra função** para adicionar outra função agregada e associar uma ou mais colunas a essa função.
**nota**  
Pelo menos uma função agregada é necessária.

   1. (Opcional) Escolha **Remover** para remover uma função agregada.

1. Para **Controles de junção**, 

   1. Escolha uma opção para **Permitir que a tabela seja consultada sozinha**:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/add-analysis-rule.html)

   1. Em **Especificar colunas de junção**, escolha as colunas que você deseja permitir que sejam usadas na instrução INNER JOIN.

      Isso é *opcional* se você tiver selecionado **Sim** na etapa anterior.

   1. Em **Especificar operadores permitidos para correspondência**, escolha quais operadores, se houver, podem ser usados para correspondência em várias colunas de junção. Se você selecionar duas ou mais colunas JOIN, um desses operadores será necessário.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/add-analysis-rule.html)

1. *(Opcional)* Para **Controles de dimensão**, no menu suspenso **Especificar colunas de dimensão**, escolha quais colunas você deseja permitir que sejam usadas na instrução SELECT e as partes WHERE, GROUP, BY e ORDER BY da consulta.
**nota**  
A função de agregação ou as colunas de junção não podem ser usadas como colunas de **Dimensão**.

1. Para **Funções escalares**, escolha uma opção para **Quais funções escalares você deseja permitir**?    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/add-analysis-rule.html)

   Para obter mais informações, consulte [Funções escalares](analysis-rules-aggregation.md#scalar-functions).

1. Escolha **Próximo**.

1. Na **Etapa 3: Especificar controles dos resultados de consulta**, para **Restrições de agregação**:

   1. Selecione a lista suspensa para cada nome de **Coluna**.

   1. Selecione a lista suspensa para cada **Número mínimo de valores distintos** que devem ser atendidos para que cada linha de saída seja retornada, depois que a função COUNT DISTINCT for aplicada a ela.

   1. Escolha **Adicionar restrição** para adicionar mais restrições de agregação.

   1. (Opcional) Escolha **Remover** para remover uma restrição de agregação.

1. Em **Análises adicionais aplicadas à saída**, selecione uma opção com base em seu objetivo.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/add-analysis-rule.html)

1. Escolha **Próximo**.

1. Em **Etapa 4: Revisar e configurar**, revise as seleções feitas nas etapas anteriores, edite se necessário e escolha **Configurar regra de análise**.

Você vê uma mensagem de confirmação de que configurou com êxito uma regra de análise de agregação na tabela.

## Adicionar uma regra de análise de lista a uma tabela (fluxo guiado)
<a name="add-list-analysis-rule-console-wizard"></a>

A *regra de análise de lista* permite consultas que geram listas em nível de linha da sobreposição entre a tabela associada e uma tabela do membro que pode consultar.

Esse procedimento descreve o processo de adicionar a regra de análise de lista à tabela configurada usando a opção **Fluxo guiado** no AWS Clean Rooms console. 

**nota**  
As tabelas configuradas usando fontes de dados não S3 oferecem suporte somente às regras de [análise personalizadas](#add-custom-analysis-rule-wizard).

**Para adicionar uma regra de análise de lista a uma tabela (fluxo guiado)**

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, selecione **Tables (Tabelas)**.

1. Escolha a tabela configurada.

1. Na página de detalhes da tabela configurada, escolha **Configurar regra de análise**.

1. Em **Etapa 1: Escolha o tipo de regra de** **análise, em Tipo de regra de** análise, escolha a opção **Lista**.

1. Em **Método de criação**, selecione **Fluxo guiado** e escolha **Avançar**. 

1. Em **Etapa 2: Especificar controles de consulta**, para **controles de junção**:

   1. Em **Especificar colunas de junção**, escolha as colunas que você deseja permitir que sejam usadas na instrução INNER JOIN.

   1. Em **Especificar operadores permitidos para correspondência**, escolha quais operadores, se houver, podem ser usados para correspondência em várias colunas de junção. Se você selecionar duas ou mais colunas JOIN, um desses operadores será necessário.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/add-analysis-rule.html)

1. *(Opcional)* Para **Controles de lista**, no menu suspenso **Especificar colunas da lista**, escolha quais colunas você deseja permitir que sejam usadas na saída da consulta (ou seja, usadas na instrução SELECT) ou usadas para filtrar resultados (ou seja, a instrução WHERE).

1. Escolha **Próximo**.

1. Em **Etapa 3: Especificar controles de resultados de consulta**, para **Análises adicionais aplicadas à saída**, selecione uma opção com base em seu objetivo.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/add-analysis-rule.html)

1. Em **Etapa 4: Revisar e configurar**, revise as seleções feitas nas etapas anteriores, edite se necessário e escolha **Configurar regra de análise**.

Você vê uma mensagem de confirmação de que configurou com êxito uma regra de análise de lista para a tabela.

## Adicionar uma regra de análise personalizada a uma tabela (fluxo guiado)
<a name="add-custom-analysis-rule-wizard"></a>

A regra de análise personalizada permite consultas ou PySpark trabalhos SQL personalizados em uma tabela configurada. A regra de análise personalizada será necessária se você estiver usando:
+ [Modelos de análise](create-analysis-template.md) para permitir um conjunto específico de consultas ou PySpark trabalhos SQL pré-aprovados ou um conjunto específico de contas que podem fornecer consultas que usam seus dados.
+ [AWS Clean Rooms Privacidade diferencial](differential-privacy.md) para proteção contra tentativas de identificação do usuário.
+ Fontes de dados não S3, como Amazon Athena ou Snowflake.

Esse procedimento descreve o processo de adicionar a regra de análise personalizada à tabela configurada usando a opção **Fluxo guiado** no AWS Clean Rooms console. 

**Para adicionar uma regra de análise personalizada a uma tabela (fluxo guiado)**

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, selecione **Tables (Tabelas)**.

1. Escolha a tabela configurada.

1. Na página de detalhes da tabela configurada, escolha **Configurar regra de análise**.

1. Em **Etapa 1: Escolha o tipo de regra de análise**, em **Tipo de regra de análise**, escolha a opção **Personalizada**.

1. Em **Método de criação**, selecione **Fluxo guiado** e escolha **Avançar**. 

1. Em **Etapa 2: Especificar controles de análise**, em **Controles de análise direta**, escolha uma opção com base em sua meta.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/add-analysis-rule.html)

1. Na **Etapa 3: Especificar os controles dos resultados da análise**, 

   1. Para **controles de resultados de Job**, observe que nenhum controle de resultados adicional é suportado.

   1. Em **Controles de resultados da consulta**, em **Colunas não permitidas na saída**, escolha as colunas que você deseja que sejam permitidas na saída da consulta, com base na sua meta.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/add-analysis-rule.html)

   1. Em **Análises adicionais aplicadas à saída**, escolha se análises adicionais podem ser aplicadas à saída da consulta, com base em sua meta.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/add-analysis-rule.html)

   1. Escolha **Próximo**.

1. (Opcional) Em **Etapa 4: Definir privacidade diferencial**, determine se você deseja que a privacidade diferencial seja ativada ou desativada. 

   A privacidade diferencial é uma técnica matematicamente comprovada para proteger seus dados contra ataques de reidentificação. 
**nota**  
AWS Clean Rooms A privacidade diferencial só está disponível para colaborações em que os dados são armazenados no Amazon S3.

   Para **Privacidade diferencial**, escolha se deseja ativar ou desativar a privacidade diferencial, com base em sua meta.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/add-analysis-rule.html)

1. Em **Etapa 5: Revisar e configurar**, revise as seleções feitas nas etapas anteriores, edite-as, se necessário, e escolha **Configurar regra de análise**.

Você verá uma mensagem de confirmação de que configurou com êxito uma regra de análise personalizada para a tabela.

## Adicionar a regra de análise a uma tabela (editor JSON)
<a name="add-analysis-rule-console-json-editor"></a>

O procedimento a seguir mostra como adicionar uma regra de análise a uma tabela usando a opção do **editor JSON** no AWS Clean Rooms console.

**nota**  
As tabelas configuradas usando fontes de dados não S3 oferecem suporte somente às regras de [análise personalizadas](#add-custom-analysis-rule-wizard).

**Como adicionar uma agregação, uma lista ou uma regra de análise personalizada a uma tabela (editor JSON)**

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, selecione **Tables (Tabelas)**.

1. Escolha a tabela configurada.

1. Na página de detalhes da tabela configurada, escolha **Configurar regra de análise**.

1. Em **Etapa 1: Escolha o tipo de regra de** **análise, em Tipo de regra de** análise, escolha a opção **Agregação**, **Lista** ou **Personalizada**.

1. Em **Método de criação**, selecione **Editor JSON** e escolha **Avançar**. 

1. Em **Etapa 2: Especificar controles**, você pode optar por inserir uma estrutura de consulta (**Inserir modelo**) ou inserir um arquivo (**Importar do arquivo**).    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/add-analysis-rule.html)

1. Escolha **Próximo**.

1. Em **Etapa 3: Revisar e configurar**, revise as seleções feitas nas etapas anteriores, edite-as se necessário e escolha **Configurar regra de análise**.

Você receberá uma mensagem de confirmação de que configurou com êxito uma regra de análise para a tabela.

## Próximas etapas
<a name="add-analysis-rule-next-step"></a>

Agora que você configurou uma regra de análise em sua tabela configurada, você está pronto para: 
+ [Associar uma tabela configurada a uma colaboração](associate-configured-table.md)
+ [Consulte as tabelas de dados](running-sql-queries.md) (como um membro que pode consultar)