

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 modelagem de ML
<a name="create-collab-ml-modeling"></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 
  + [Membro que pode consultar](glossary.md#glossary-member-who-can-query)
  + [Membro que pode receber resultados](glossary.md#glossary-member-who-can-receive-results)
  + Membro que pode receber resultados de modelos treinados
  + Membro que pode produzir resultados a partir da inferência do modelo

  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, treinamento de modelos e custos de inferência de modelos 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 modelagem de ML**

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** e, em **Tipos de registro compatíveis**, escolha **Registros de consultas**.

   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: Especifique as habilidades dos membros**, 

   1. Para **Análise usando consultas e trabalhos**, em **Tipos de análise suportados**, deixe a caixa de seleção **Consultas** marcada.

   1. Em **Executar consultas**, escolha o membro que iniciará o treinamento do modelo

   1. Em **Receber resultados das análises**, escolha um ou mais membros que receberão os resultados da consulta.

   1. Para **modelagem de ML usando fluxos de trabalho criados especificamente**, 

      1. Em **Receber resultados de modelos treinados**, escolha o membro que receberá os resultados do modelo treinado, incluindo artefatos e métricas do modelo.

      1. Em **Receber saída da inferência do modelo**, escolha o membro que receberá os resultados da inferência do modelo.

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

1. Para a **Etapa 3: Configurar o pagamento**, 

   1. Em **Análise usando consultas**, para **Pagar por consultas**, execute uma das seguintes ações:
      + Para que o mesmo membro pague e execute consultas, selecione o mesmo membro que você escolheu para **Executar consultas**.
      + Para que um membro diferente pague pelos custos da consulta, selecione sua conta de membro.

   1. Para **modelagem de ML usando fluxos de trabalho criados especificamente**, 

      1. Escolha o membro que **pagará pelo treinamento de modelos**.

   1. Escolha o membro que **pagará pelo trabalho de inferência.**

   1. Para **Pay for Lookalike Modeling**, nenhuma ação é necessária. O **criador do modelo de sósia configurado** é o membro que pagará pela modelagem semelhante.

   1. (Opcional) Escolha o membro que **pagará pela geração de dados sintéticos**.

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

1. Escolha **Próximo**.

1. Para **a Etapa 4: Configurar associação**, em **Associação de colaboraçã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. Marque a caixa **de seleção Definir configurações padrão para consultas.**

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

      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-ml-modeling.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ção de ML**, 

      1. Escolha a caixa de seleção **Criar configuração de ML** e, em seguida, especifique o **destino de saída do modelo no Amazon** S3 inserindo o destino do S3 ou **escolha Procurar** no S3 para selecionar em uma lista de buckets do S3 disponíveis.

      1. Especifique as permissões de **acesso ao serviço** escolhendo **Criar e usar uma nova função de serviço** ou **Usar uma função de serviço existente**.

      1. Se o bucket do S3 estiver criptografado, marque a caixa de seleção **O bucket de destino é criptografado com uma chave KMS** e, em seguida, insira **AWS KMS key**ou selecione **Criar um AWS KMS key para criar uma** nova chave KMS.

   1. Se você quiser ativar as **tags de associação** para o recurso de associação, escolha **Adicionar nova tag** e insira o par de **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-run-queries-jobs), é 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-ml-modeling.html)