

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

# Criar uma associação e participando de uma colaboração
<a name="create-membership"></a>

*Associação* é um recurso criado quando um membro ingressa em uma colaboração no AWS Clean Rooms. 

Você pode participar de uma colaboração como 
+ [membro que pode consultar](glossary.md#glossary-member-who-can-query)
+ [membro que pode executar consultas e trabalhos](glossary.md#glossary-member-who-can-run-queries-jobs)
+ [membro que pode receber os resultados](glossary.md#glossary-member-who-can-receive-results) de uma consulta ou de um trabalho
+ [membro pagando pelos custos de computação da consulta](glossary.md#glossary-member-paying-for-query-compute)
+ [membro pagando por consultas e empregos](glossary.md#glossary-member-paying-for-query-job-compute)

Todos os membros podem contribuir com dados.

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

Nesse procedimento, o membro convidado [se une à colaboração criando um recurso de associação](#create-membership).

Se o membro convidado for o membro que pode receber os resultados, ele especificará o destino e o formato dos resultados. Eles também fornecem um ARN de função de serviço para gravar no destino dos resultados.

Se o membro convidado for o membro responsável por pagar pelos custos de computação, ele aceitará suas responsabilidades de pagamento antes de ingressar na colaboração.

**Para criar uma associação e participar de uma colaboração**

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 seu membro Conta da AWS.

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

1. Na guia **Disponível para participar**, em **Colaborações disponíveis para participar**, escolha o **Nome** da colaboração.

1. Na página de detalhes da colaboração, na seção **Visão geral**, visualize os detalhes da colaboração, incluindo **os detalhes do seu membro** e uma lista dos outros membros.

   Verifique se Conta da AWS IDs para cada membro da colaboração são aqueles com quem você pretende entrar na colaboração.

1. Escolha **Criar associação**.

1. Na página **Criar associação**, na **Visão geral**, visualize o **nome da colaboração**, a **descrição da colaboração**, o Conta da AWS ID do **criador da colaboração**, **os detalhes do seu membro** e o Conta da AWS ID do membro que **pagará pelas consultas.**

1. Se o criador da colaboração tiver optado por ativar o **registro de análise**, escolha uma das seguintes opções para **armazenamento de registros no Amazon CloudWatch Logs**:    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/create-membership.html)
**nota**  
Depois de ativar o **registro de análise**, 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. Se o criador da colaboração ativou o **monitoramento detalhado** para essa colaboração, escolha se você deseja receber métricas detalhadas de observabilidade em sua CloudWatch conta.

   Para **monitoramento detalhado**:  
**Opções detalhadas de monitoramento**    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/create-membership.html)
**nota**  
Métricas de monitoramento detalhadas estão disponíveis somente para membros que podem executar consultas (executores de análise) e membros que estão configurados como pagadores pela colaboração.

1. Se **suas habilidades de membro** incluírem **Receber resultados**, **as configurações de Resultados usarão como padrão**:

   1. Para **resultados da consulta**, escolha a caixa de seleção **Definir configurações padrão para consultas** e, em seguida, especifique o **destino dos resultados no Amazon S3** inserindo o destino do S3 ou **escolha Procurar** no S3 para selecionar em uma lista de buckets do S3 disponíveis.  
**Example**  

      Por exemplo: **s3://bucket/prefix**

      1. Para o **formato Resultado**, 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 entregar 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 dar suporte a 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.
**nota**  
É necessário selecionar um perfil de serviço existente ou ter permissões para criar outro. Para obter mais informações, consulte [Criar um perfil de serviço para receber resultados](setting-up-roles.md#create-role-write-results).

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

------
#### [ Create and use a new service role ]
         + AWS Clean Rooms cria uma função de serviço com a política necessária para essa tabela.
         + O **nome do perfil de serviço** padrão é `cleanrooms-result-receiver-<timestamp>`
         + Você deve ter permissões para criar perfis e anexar políticas.

------
#### [ Use an existing service role ]

         1. Escolha um **nome do perfil de serviço existente** na lista suspensa.

            A lista de perfis é exibida se você tiver permissões para listar funções.

            Se você não tiver permissões para listar perfis, insira o nome do recurso da Amazon (ARN) do perfil que você deseja usar.

         1. Para visualizar o perfil de serviço, selecione o link externo **Visualizar no IAM**.

            Se não houver perfis de serviço existentes, a opção de **Usar um perfil de serviço existente** não estará disponível.

            Por padrão, AWS Clean Rooms não tenta atualizar a política de função existente para adicionar as permissões necessárias. 

------
**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 **Resultados do trabalho**, escolha a caixa de seleção **Definir configurações padrão para trabalhos** e, em seguida, especifique o **destino dos resultados no Amazon** S3 inserindo o destino do S3 ou **escolha Procurar** no S3 para selecionar em uma lista de buckets do S3 disponíveis.  
**Example**  

      Por exemplo: **s3://bucket/prefix**

      1. Especifique as permissões **de acesso ao serviço** escolhendo um **nome de função de serviço existente** na lista suspensa.

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

1. Se o criador da colaboração designou você como o membro que **pagará pelas consultas** ou **pagará pelas consultas e trabalhos**, 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) ou o [membro que paga pelas consultas e pelos custos de computação do trabalho](glossary.md#glossary-member-paying-for-query-job-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ê poderá entrar em contato com o membro que poderá executar consultas e trabalhos 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. Se tiver certeza de que deseja criar uma associação e participar da colaboração, escolha **Criar associação**.

Você tem acesso de leitura aos metadados da colaboração. Isso inclui informações como o nome de exibição e a descrição da colaboração, além de todos os nomes e Conta da AWS IDs de outros membros. 

Agora está tudo pronto para: 
+ [Prepare sua tabela de dados para ser consultada no AWS Clean Rooms](prepare-data.md). (Opcional se quiser consultar seus próprios dados de evento ou dados de identidade.)
+ [Associar a tabela configurada à sua colaboração](associate-configured-table.md): se quiser consultar dados de eventos.
+ [Adicionar uma regra de análise para a tabela configurada](add-analysis-rule.md): se quiser consultar dados de evento.
+ [Crie e associe um novo namespace de ID](create-new-id-namespace.md) — se você quiser criar uma tabela de mapeamento de ID para consultar dados de identidade.

Para obter informações sobre como sair de uma colaboração, consulte [Sair de uma colaboração](leave-collab.md).