Criando uma colaboração em AWS Clean Rooms

Uma colaboração é um limite lógico seguro AWS Clean Rooms no qual os membros podem realizar consultas SQL em tabelas configuradas.

Qualquer membro AWS Clean Rooms pode criar uma colaboração.

O criador da colaboração pode designar um único membro para consultar e receber resultados. No entanto, o criador da colaboração pode querer impedir que o membro que pode consultar tenha acesso aos resultados da consulta. Nesse caso, o criador da colaboração pode designar um membro para quem pode consultar e outro membro que pode receber os resultados.

Na maioria dos casos, o membro que pode consultar também é o membro que paga pelos custos de computação da consulta. No entanto, o criador da colaboração pode configurar um membro diferente para ser responsável pelo pagamento dos custos de computação da consulta.

Para obter informações sobre como criar uma colaboração usando os SDKs AWS, consulte a Referência da API AWS Clean Rooms.

Crie uma colaboração

Antes de começar, certifique-se de ter cumprido os seguintes pré-requisitos:

• Você tem o nome e o ID Conta da AWS de cada membro que deseja convidar para a colaboração.

• Você tem permissão para compartilhar o nome e o ID Conta da AWS de cada membro com todos os membros da colaboração.

nota

Você não pode adicionar mais membros após a criação da colaboração.

Para criar uma colaboração usando o console AWS Clean Rooms

1. Faça login no AWS Management Console e abra o console AWS Clean Rooms com o Conta da AWS que funcionará como criador da colaboração.

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

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

4. Em Etapa 1: definir a 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.

   2. 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 ID Conta da AWS é incluído automaticamente como ID de membro Conta da AWS.

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

         O Nome de exibição do membro e o ID do membro Conta da AWS estarão visíveis para todos os convidados para a colaboração. Depois de inserir e salvar os valores desses campos, eles não são editáveis.

         nota

         Você deve informar ao membro da colaboração que seu ID de membro Conta da AWS e Nome de exibição do membro estarão visíveis para todos os colaboradores convidados e ativos na colaboração.

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

   3. Para Habilidades de membro, escolha uma das seguintes opções,

      Se você deseja...	Então…
      Consulte os dados na colaboração e receba os resultados	Escolha você mesmo como o membro que pode Executar consultas. Deixe que a configuração padrão do membro que pode Receber resultados seja a Mesma de quem executa consultas.
      Consulte os dados na colaboração e designe um membro diferente para receber os resultados	Escolha você mesmo como o membro que pode Executar consultas. Selecione o membro que pode Receber resultados na lista suspensa.
      Receba os resultados da consulta na colaboração e designe um membro diferente para consultar os dados	Selecione o membro que pode Executar consultas na lista suspensa. Escolha você mesmo como membro que pode Receber resultados da lista suspensa.
      Crie e gerencie a colaboração, designe um membro diferente para consultar os dados e atribua um membro diferente para receber os resultados	Selecione o membro que pode Executar consultas na lista suspensa. Selecione o membro que pode Receber resultados na lista suspensa.

   4. Para Configuração de pagamento, escolha uma das seguintes opções:

      Se você deseja...	Então…
      Designe o membro que pode Executar consultas para ser o membro que paga pelos custos de computação da consulta	Deixe que a configuração padrão do membro que Pagará pelas consultas seja a Mesma de quem executa as consultas.
      Atribua um membro diferente para pagar pelos custos de computação da consulta	Selecione o membro que Pagará pelas consultas na lista suspensa.

   5. Se você quiser habilitar o Log de consultas, marque a caixa de seleção Suporte ao log de consultas para esta colaboração.

   6. Se você quiser habilitar o recurso de Computação criptográfica, marque a caixa de seleção Suporte à computação criptográfica nesta colaboração e escolha os seguintes parâmetros de computação criptográfica:

      • Permitir colunas cleartext

        Escolha Não se você não quiser que as colunas cleartext sejam permitidas na tabela criptografada.

        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 dentro de cleartext.

      • Permitir duplicatas

        Escolha Não se você 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 colunas JOIN com nomes diferentes

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

        Escolha Sim se quiser unir colunas fingerprint com nomes diferentes.

      • Preserve valores NULL

        Escolha Não se você 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.

      Para obter mais informações sobre Parâmetros de computação criptográfica, consulte Parâmetros de computação criptográfica.

      Para obter mais informações sobre como criptografar seus dados para uso em AWS Clean Rooms, consulte Preparando tabelas de dados criptografadas com computação criptográfica para Clean Rooms.

      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 logs de consulta estão armazenados no Amazon CloudWatch Logs.

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

   8. Escolha Next (Próximo).

5. Para a Etapa 2: Configurar associação, faça o seguinte:

   1. Selecione uma opção:

      Se você escolher...	Então…
      Sim, cadastrar-se criando uma associação agora	Tanto a colaboração quanto sua associação são criadas. Seu status na colaboração está ativo.
      Não, vou criar uma associação mais tarde	Somente a colaboração é criada. Seu status na colaboração é inativo.

   2. Se você for o membro que pode Receber resultados, em Padrões de configurações de resultados da consulta, escolha uma opção:

      Se você…	Então…
      Mantenha a caixa de seleção Definir configurações padrão agora marcada. (Isso é selecionado por padrão.)	Para o Destino dos resultados no Amazon S3, insira o destino do Amazon S3. Para o Formato do resultado da consulta, escolha CSV ou PARQUET.
      Desmarque a caixa de seleção Definir configurações padrão agora	Somente a colaboração é criada. Seu status na colaboração é inativo.

   3. Se você optar por habilitar o Log de consultas na etapa 4.e, escolha uma das seguintes opções para armazenamento de logs no Amazon CloudWatch Logs:

      Se você escolher...	Então…
      Ativar	Os registros de consulta relevantes para você são armazenados no 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 executadas em uma colaboração, mesmo que seus dados não sejam acessados em uma consulta.
      Desativar	Os logs de consulta relevantes para você não são armazenados na sua conta do Amazon CloudWatch Logs.

      nota

      Depois de ativar o logs de consultas, pode levar alguns minutos para que o armazenamento de registros seja configurado e comece a receber logs no Amazon CloudWatch Logs. Durante esse breve período, o membro que pode consultar pode executar consultas que, na verdade, não enviam logs.

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

   5. Se você for o membro que está Pagando pelas consultas, indique sua aceitação marcando a caixa de seleção Eu concordo em pagar pelos custos de computação da consulta 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.

      Se você for o Membro que paga pelos custos de computação da consulta, mas não o Membro que pode consultar, é recomendável usar AWS Budgets para configurar um orçamento para 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 comAWS Budgets no Guia do Usuário 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 no Guia do usuário 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. 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.

   6. Escolha Next (Próximo).

6. Para a Etapa 3: revisar e criar, faça o seguinte:

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

   2. Escolha uma das seguintes opções:

      Se você escolheu...	A seguir, escolha…
      Crie uma associação com a colaboração (Sim, cadastrar-se criando uma associação agora)	Criar colaboração e associação
      Criar a colaboração e não criar uma associação no momento (Não, criarei uma associação mais tarde)	Criar colaboração

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

Próximas etapas

Agora está tudo pronto para:

• Prepare sua tabela de dados para ser consultada AWS Clean Rooms. (Opcional se você quiser consultar seus próprios dados.)

• Associar a tabela configurada à sua colaboração. (Opcional se você quiser consultar seus próprios dados.)

• Configurar uma regra de análise para a tabela configurada. (Opcional se você quiser consultar seus próprios dados.)

• Crie uma associação e participe de uma colaboração.

• Gerenciar sua colaboração.