

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

# Criando uma colaboração para consultas
<a name="create-collab-queries"></a>

Neste procedimento, você, como [criador da colaboração](glossary.md#glossary-collaboration-creator), executa as seguintes tarefas:
+ [Crie uma colaboração](create-collaboration.md).
+ Convide um ou mais [membros](glossary.md#glossary-member) para a [colaboração](glossary.md#glossary-collaboration).
+ Atribua habilidades aos membros, como o [membro que pode consultar](glossary.md#glossary-member-who-can-query) e o [membro que pode receber resultados](glossary.md#glossary-member-who-can-receive-results).

  Se o criador da colaboração também for o membro que pode receber os resultados, ele especificará o destino e o formato dos resultados. Eles também fornecem uma função de serviço Amazon Resource Name (ARN) para gravar os resultados no destino dos resultados.
+ Configure qual [membro é responsável por pagar pelos custos de computação na colaboração](glossary.md#glossary-member-paying-for-query-compute).

Antes de começar, você deve cumprir os seguintes pré-requisitos: 
+ Você tem o nome e o Conta da AWS ID de cada membro que deseja convidar para a colaboração.
+ Você tem permissão para compartilhar o nome e o Conta da AWS ID de cada membro com todos os membros da colaboração.
**nota**  
Você não pode adicionar mais membros depois de criar a colaboração. 

Para obter informações sobre como criar uma colaboração usando o AWS SDKs, consulte a *[Referência AWS Clean Rooms da API](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html)*.

**Para criar uma colaboração para consultas**

1. Faça login no Console de gerenciamento da AWS e abra o [AWS Clean Rooms console](https://console.aws.amazon.com/cleanrooms/home) com o Conta da AWS que funcionará como criador da colaboração.

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

1. No canto superior direito, selecione **Criar colaboração**.

1. Em **Etapa 1: Definir colaboração**, faça o seguinte:

   1. Em **Detalhes**, insira o **Nome** e a **Descrição** da colaboração.

      Essas informações ficarão visíveis para os membros da colaboração que forem convidados a participar da colaboração. O **Nome** e a **Descrição** os ajudam a entender a que se refere a colaboração. 

   1. Para **membros**:

      1. Para **membro 1: você**, insira o **Nome de exibição do membro** conforme você deseja que ele apareça para a colaboração.
**nota**  
Seu Conta da AWS ID é incluído automaticamente como ** Conta da AWS ID de membro**.

      1. Para **Membro 2**, insira o **nome de exibição do** **membro e a Conta da AWS ID** do membro que você deseja convidar para a colaboração.

         O **Nome de exibição do membro** e o **ID da Conta da AWS do membro** estarão visíveis para todos os convidados para a colaboração. Depois que você insere e salva os valores desses campos, eles se tornam editáveis.
**nota**  
Você deve informar ao membro da colaboração que seu **ID da Conta da AWS do membro** e **Nome de exibição do membro** estarão visíveis para todos os colaboradores convidados e ativos na colaboração.

      1. Se quiser adicionar outro membro, escolha **Adicionar outro membro**. Em seguida, insira o **nome de exibição do** **membro e o Conta da AWS ID** do membro para cada membro que pode contribuir com dados que você deseja convidar para a colaboração.

   1. Se você quiser ativar o **registro de análise**, marque a caixa de seleção **Ativar registro de análise**.

      1. Escolha a caixa **de seleção Registros das consultas** em Tipos de **registro compatíveis**.

        Você receberá registros gerados a partir de consultas SQL em sua conta Amazon CloudWatch Logs.

   1. Se você quiser ativar o **monitoramento detalhado**, marque a caixa de seleção **Ativar monitoramento detalhado**.

      O executor da análise e o pagador configurado podem optar por ativar métricas detalhadas ao criar sua associação. Quando ativadas, métricas detalhadas de monitoramento serão publicadas CloudWatch para monitoramento operacional das colaborações, incluindo desempenho de consultas e utilização de recursos. Essas métricas estarão disponíveis para o executor de análise e o pagador configurado em seus respectivos s. Conta da AWS

      Para obter mais informações sobre CloudWatch preços, consulte [CloudWatch Preços](https://aws.amazon.com/cloudwatch/pricing/).

   1. Em **Regiões permitidas de resultados da consulta**, selecione uma ou mais para Regiões da AWS onde você deseja enviar os resultados da consulta.

      Por padrão, somente a região atual (como N. Virginia us-east-1) é selecionada. 
**Importante**  
Quando você ativa a entrega de resultados de consultas entre regiões, seus resultados podem ser processados e armazenados fora da região de origem.

      Para obter mais informações sobre regiões, consulte [Regiões e endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html) no *Referência geral da AWS*. 

   1. (Opcional) Gerencie o acesso aos seus dados com a **aprovação automática da solicitação de alteração**, definindo quais configurações podem ser alteradas automaticamente sem aprovações manuais para uma solicitação de alteração. Por padrão, algumas configurações só podem ser alteradas enviando uma solicitação de alteração que deve ser aprovada por todos os membros antes de entrar em vigor.
      + **Conceder habilidades aos membros** — Escolha as habilidades que podem ser concedidas aos membros da colaboração sem aprovação manual. Os membros sempre podem contribuir com dados.
        + Escolha habilidades:
          + Contribuir com dados *(sempre ativado)*
          + Receba resultados
        + **Aprove automaticamente novos membros com essas habilidades** — Se permitido, todos os membros adicionados com as habilidades selecionadas acima participarão instantaneamente da colaboração. Membros adicionados com outras habilidades ainda precisarão de aprovação manual para ingressar.
      + **Habilidades que podem ser revogadas automaticamente** - Escolha as habilidades que podem ser revogadas sem aprovação manual. Os membros sempre podem contribuir com dados.
        + Escolha habilidades:
          + Contribuir com dados *(sempre ativado)*
          + Receba resultados

      Se você escolher essa opção, poderá rastrear todas as modificações na configuração da colaboração por meio do **histórico de solicitações de alteração**, localizado na guia **Detalhes** da página de detalhes da colaboração.

   1. (Opcional) Se você quiser ativar o recurso de **computação criptográfica**, marque a caixa de seleção **Ativar computação criptográfica**.

      1. Escolha os seguintes **parâmetros de cobertura criptográfica**:
         + **Permitir colunas plaintext**

           Escolha **Não** se você precisar de tabelas totalmente criptografadas.

           Escolha **Sim** se quiser que as colunas cleartext sejam permitidas na tabela criptografada.

           Para executar SUM ou AVG em determinadas colunas, as colunas devem estar em cleartext.
         + **Preservar valores NULL**

           Escolha **Não** se não quiser preservar os valores NULL. Os valores NULL não aparecerão como NULL em uma tabela criptografada.

           Escolha **Sim** se quiser preservar os valores NULL. Os valores NULL aparecerão como NULL em uma tabela criptografada.

      1. Escolha os seguintes **parâmetros de impressão digital**:
         + **Permitir duplicatas**

           Escolha **Não** se não quiser que entradas duplicadas sejam permitidas em uma coluna fingerprint.

           Escolha **Sim** se quiser que entradas duplicadas sejam permitidas em uma coluna fingerprint.
         + **Permitir JOIN de colunas com nomes diferentes**

           Escolha **Não** se não quiser unir colunas fingerprint com nomes diferentes.

           Escolha **Sim** se quiser unir colunas fingerprint com nomes diferentes.

      Para obter mais informações sobre **Parâmetros de computação criptográfica**, consulte [Parâmetros de computação criptográfica](crypto-computing-parameters.md).

      Para obter mais informações sobre como criptografar seus dados para uso em AWS Clean Rooms, consulte[Preparar tabelas de dados criptografadas com computação criptográfica para o Clean Rooms](prepare-encrypted-data.md).
**nota**  
Verifique essas configurações cuidadosamente antes de concluir a próxima etapa. Depois de criar a colaboração, você só pode editar o nome da colaboração, a descrição e se os registros estão armazenados no Amazon CloudWatch Logs.

   1. Se quiser habilitar **Tags** para o recurso de colaboração, escolha **Adicionar nova tag** e, em seguida, insira o par **Chave** e **Valor**.

   1. Escolha **Próximo**.

1. Para a **Etapa 2: Especificar as habilidades dos membros**, para **Análise usando consultas e trabalhos**, nos **Tipos de análise suportados**, deixe a caixa de seleção **Consultas** marcada e execute a ação recomendada, com base em sua meta.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/create-collab-queries.html)

   1. Se você estiver usando Clean Rooms ML, para **modelagem de ML usando fluxos de trabalho criados especificamente**, 

      1. (Opcional) Selecione o membro que pode **receber resultados de modelos treinados** na lista suspensa.

      1. (Opcional) Selecione o membro que pode **receber a saída da inferência do modelo** na lista suspensa.

   1. Veja as habilidades dos membros em **Resolução de ID usando AWS Entity Resolution**.

   1. Escolha **Próximo**.

1. Para **a Etapa 3: Configurar o pagamento**, para **Análise usando consultas**, execute uma das ações a seguir com base em sua meta.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/create-collab-queries.html)

   **Para **modelagem de ML usando fluxos de trabalho específicos**, o **criador do modelo semelhante configurado é o membro que pagará pela modelagem semelhante**.**

   Para **resolução de ID com AWS Entity Resolution**, o **criador da tabela de mapeamento de ID** é o membro que **pagará pela tabela de mapeamento de ID**.

1. Para **a Etapa 4: Configurar a associação**, escolha uma das seguintes opções:

------
#### [ Yes, join by creating membership now ]

   1. Para **padrões de configurações de resultados**, para **configurações de resultados de consulta**, se você for o membro que pode **receber** resultados, 

      1. Para o **destino dos resultados no Amazon S3**, insira o destino do Amazon S3 ou **escolha Procurar** no S3 para selecionar um bucket do S3.

      1. Para o **Formato do resultado** da consulta, escolha **CSV** ou **PARQUET**.

      1. (Somente Spark) Para os **arquivos de resultados**, escolha **Múltiplo** ou **Único**.

      1. (Opcional) Para **acesso ao serviço**, se você quiser enviar consultas que levem até 24 horas para seu destino do S3, marque a caixa de seleção **Adicionar uma função de serviço para atender consultas que levem até 24 horas para serem concluídas**.

         Consultas grandes que levem até 24 horas para serem concluídas serão enviadas ao seu destino S3.

         Se você não marcar a caixa de seleção, somente as consultas concluídas em 12 horas serão entregues na sua localização do S3. 

      1. Especifique as permissões de **Acesso ao serviço** selecionando **Criar e usar um novo perfil de serviço** ou **Usar um perfil de serviço existente**.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/create-collab-queries.html)
**nota**  
AWS Clean Rooms requer permissões para consultar de acordo com as regras de análise. Para obter mais informações sobre permissões para AWS Clean Rooms, consulte[AWS políticas gerenciadas para AWS Clean Rooms](security-iam-awsmanpol.md).
Se a função não tiver permissões suficientes para AWS Clean Rooms, você receberá uma mensagem de erro informando que a função não tem permissões suficientes para AWS Clean Rooms. A política de perfil deve ser adicionada antes de continuar.
Se você não conseguir modificar a política de função, receberá uma mensagem de erro informando que AWS Clean Rooms não foi possível encontrar a política para a função de serviço.

   1. Para **configurações de registros**, escolha uma das seguintes opções para **armazenamento de registros no Amazon CloudWatch Logs**:
**nota**  
A seção **Configurações de registros** será exibida se você optar por ativar o **registro de consultas**. 

      1. Escolha **Ativar** e os registros de consulta relevantes para você serão armazenados na sua conta Amazon CloudWatch Logs.

         Cada membro pode receber somente logs de consultas iniciadas por ele ou que contenham seus dados.

         O membro que pode receber os resultados também recebe logs de todas as consultas realizadas em uma colaboração, mesmo que seus dados não sejam acessados em uma consulta.

         Em **Tipos de registro compatíveis**, a caixa de seleção **Registros de consulta** está ativada por padrão.
**nota**  
Depois de ativar o **registro de consultas**, pode levar alguns minutos para que o armazenamento de registros seja configurado e comece a receber registros no Amazon CloudWatch Logs. Durante esse breve período, o membro que pode consultar pode executar consultas que, na verdade, não enviam logs.

      1. Escolha **Desativar** e os registros de consulta relevantes para você não serão armazenados na sua conta Amazon CloudWatch Logs.

   1. Se quiser habilitar **Tags** para o recurso de associação, escolha **Adicionar nova tag** e insira o par **Chave** e **Valor**. 

   1. Se você for o membro que está pagando pela **computação do Query**, indique sua aceitação marcando a caixa de seleção **Eu concordo em pagar pelos custos de computação nesta colaboração**.
**nota**  
Você deve marcar essa caixa de seleção para continuar.  
Para obter mais informações sobre como o preço é calculado, consulte [Preços para AWS Clean Rooms](what-is.md#pricing).

      Se você for o [membro que paga pelos custos de computação da consulta](glossary.md#glossary-member-paying-for-query-compute), mas não o [membro que pode consultar](glossary.md#glossary-member-who-can-query), é recomendável usar AWS Budgets para configurar um orçamento AWS Clean Rooms e receber notificações quando o orçamento máximo for atingido. Para obter mais informações sobre como configurar um orçamento, consulte [Gerenciando seus custos com AWS Budgets](https://docs.aws.amazon.com/cost-management/latest/userguide/budgets-managing-costs.html) no *Guia do Usuário do AWS Cost Management *. Para obter mais informações sobre a configuração de notificações, consulte o tópico [Criação de um Amazon SNS para notificações de orçamento](https://docs.aws.amazon.com/cost-management/latest/userguide/budgets-sns-policy.html) no *Guia do usuário do AWS Cost Management *. Se o orçamento máximo tiver sido atingido, você pode entrar em contato com o membro que pode fazer consultas ou [sair da colaboração](leave-collab.md). Se você deixar a colaboração, não será mais permitida a execução de consultas e, portanto, você não será mais cobrado pelos custos de computação da consulta.

   1. Escolha **Próximo**.

   Tanto a colaboração quanto sua associação são criadas. 

   Seu status na colaboração está ativo.

------
#### [ No, I will create a membership later ]

   1. Escolha **Próximo**.

      Somente a colaboração é criada. 

      Seu status na colaboração está inativo.

------

1. Para **a Etapa 5: revisar e criar**, faça o seguinte:

   1. Revise as seleções feitas nas etapas anteriores e edite, se necessário. 

   1. Escolha uma das opções.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/create-collab-queries.html)

Depois que sua colaboração for criada com sucesso, você poderá ver a página de detalhes da colaboração em **Colaborações**.

Agora está tudo pronto para: 
+ [Prepare sua tabela de dados para ser analisada em AWS Clean Rooms](prepare-data.md). (Opcional se você quiser analisar seus próprios dados de eventos ou consultar dados de identidade.)
+ [Associar a tabela configurada à sua colaboração](associate-configured-table.md). (Opcional se você quiser analisar seus próprios dados de eventos.)
+ [Adicionar uma regra de análise para a tabela configurada](add-analysis-rule.md). (Opcional se você quiser analisar seus próprios dados de eventos.)
+ [Criar uma associação e participar de uma colaboração](create-membership.md). (Opcional se você já tiver criado uma associação.)
+ [Convide membros para participarem da colaboração](invite-members.md).