Gerenciando colaborações no AWS Clean Rooms

Os tópicos a seguir descrevem como o criador da colaboração pode gerenciar uma colaboração AWS Clean Rooms usando o console AWS Clean Rooms.

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

Editar colaborações

Saiba como editar as diferentes partes de uma colaboração.

Tópicos

• Editar nome e descrição da colaboração
• Editar tags de colaboração
• Editar tags de associação
• Editar tags de tabela associadas
• Editar tags do modelo de análise
• Editar tags de política de privacidade diferencial

Editar nome e descrição da colaboração

Depois de criar a colaboração, você só pode editar o nome e a descrição da colaboração.

nota

Se você habilitou os Logs de consultas, você pode editar se os logs de consulta estão armazenados na sua conta do Amazon CloudWatch Logs.

Para editar o nome e a descrição da colaboração

1. Faça logon no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração que você criou.

4. Na página de detalhes da colaboração, escolha Ações e, em seguida, escolha Editar colaboração.

5. Para Detalhes, edite o nome e a descrição da colaboração.

6. Escolha Salvar alterações.

Editar tags de colaboração

Como criador de colaboração, depois de criar uma colaboração, você pode gerenciar as tags no recurso de colaboração.

Para editar as tags de colaboração

1. Faça logon no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração que você criou.

4. Escolha uma das seguintes opções:

   Se você é...	Então ...
   Um membro da colaboração	Escolha a guia Detalhes.
   O criador da colaboração, mas não um membro da colaboração	Role para baixo até a seção Tags da página.

5. Para obter detalhes da colaboração, escolha Gerenciar tags.

6. Na página Gerenciar tags é possível fazer o seguinte:

   • Para remover uma tag, selecione Remover.

   • Para adicionar uma tag, escolha Adicionar nova tag.

   • Para salvar suas alterações, escolha Salvar alterações

Editar tags de associação

Como criador de colaboração, depois de criar uma colaboração, você pode gerenciar as tags no recurso de associação.

Para editar as tags de associação

1. Faça login no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração que você criou.

4. Escolha a guia Detalhes.

5. Em Detalhes da associação, selecione Gerenciar tags.

6. Na página Gerenciar tags é possível fazer o seguinte:

   • Para remover uma tag, selecione Remover.

   • Para adicionar uma tag, escolha Adicionar nova tag.

   • Para salvar suas alterações, escolha Salvar alterações.

Editar tags de tabela associadas

Como criador de colaboração, depois de associar tabelas a uma colaboração, você pode gerenciar as tags no recurso de tabela associado.

Para editar as tags de tabela associadas

1. Faça logon no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração que você criou.

4. Escolha a guia Tabelas.

5. Para Tabelas associadas por você, escolha uma tabela.

6. Na página de detalhes da tabela configurada, em Tags, escolha Gerenciar tags.

   Na página Gerenciar tags é possível fazer o seguinte:

   • Para remover uma tag, selecione Remover.

   • Para adicionar uma tag, escolha Adicionar nova tag.

   • Para salvar suas alterações, escolha Salvar alterações.

Editar tags do modelo de análise

Como criador de colaboração, depois de criar uma colaboração, você pode gerenciar as tags no atributo do modelo de análise.

Para editar as tags de associação

1. Faça login no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração que você criou.

4. Escolha a guia Modelos.

5. Na seção Modelos de análise criados por você, escolha o modelo de análise.

6. Na página de detalhes da tabela do modelo de análise, role para baixo até a seção Tags.

7. Selecione Gerenciar tags.

8. Na página Gerenciar tags é possível fazer o seguinte:

   • Para remover uma tag, selecione Remover.

   • Para adicionar uma tag, escolha Adicionar nova tag.

   • Para salvar suas alterações, escolha Salvar alterações.

Editar tags de política de privacidade diferencial

Como criador de colaboração, depois de criar uma colaboração, você pode gerenciar as tags no atributo do modelo de análise.

Para editar as tags de associação

1. Faça login no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração que contém a política de privacidade diferencial que você deseja editar.

4. Escolha a guia Tabelas.

5. Na guia Tabelas, selecione Gerenciar tags.

6. Na página Gerenciar tags é possível fazer o seguinte:

   • Para remover uma tag, selecione Remover.

   • Para adicionar uma tag, escolha Adicionar nova tag.

   • Para salvar suas alterações, escolha Salvar alterações.

Excluindo colaborações

Como criador de colaborações, você pode excluir uma colaboração que você criou.

nota

Ao excluir uma colaboração, você e todos os membros não poderão executar consultas, receber resultados ou contribuir com dados. Cada membro da colaboração continua a ter acesso aos seus próprios dados como parte de sua associação.

Para excluir uma colaboração

1. Faça logon no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração que você deseja atualizar ou excluir.

4. Em Ações, escolha Excluir colaboração.

5. Confirme a exclusão e escolha Excluir.

Visualizando colaborações

Como criador de colaborações, você pode ver todas as colaborações que criou.

Para ver as colaborações

1. Faça logon no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Na página Colaborações, em Última utilização, veja as últimas 5 colaborações usadas.

4. Na guia Com associação ativa, veja a lista de colaborações com associação ativa.

   Você pode classificar por nome, data de criação da associação e detalhes do seu membro.

   É possível usar a barra de Pesquisa para procurar uma colaboração.

5. Na guia Disponível para participar, veja a lista de colaborações disponíveis para participar.

6. Na guia Não mais disponível, visualize a lista de colaborações excluídas e associações para colaborações que não estão mais disponíveis (associações removidas).

Visualização de tabelas e regras de análise

Para visualizar tabelas associadas às regras de colaboração e análise

1. Faça logon no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração.

4. Escolha a guia Tabelas.

5. Escolha uma das seguintes opções:

   1. Para visualizar suas tabelas associadas na colaboração, em Tabelas associadas por você, escolha uma tabela (texto azul).

   2. Para visualizar outras tabelas associadas à colaboração, em Tabelas associadas por colaboradores, escolha uma tabela (texto azul).

6. Veja os detalhes da tabela e as regras de análise na página de detalhes da tabela.

Visualizar logs de uso de privacidade diferencial

Como membro da colaboração que protege dados com privacidade diferencial, depois de criar uma colaboração com privacidade diferencial, você pode monitorar o uso do orçamento de privacidade.

Para ver quantas agregações foram executadas e quanto do orçamento de privacidade foi usado

1. Faça login no AWS Management Console e abra o console AWS Clean Rooms com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração.

4. Escolha a guia Tabelas.

5. Escolha Visualizar logs de uso (texto em azul).

6. Veja os detalhes de uso, incluindo o orçamento de privacidade e a quantidade de utilitário fornecida.

Monitorar o status do membro

Como criador da colaboração, depois de criar uma colaboração, você pode monitorar o status de todos os membros na guia Membros.

Para verificar o status de um membro

1. Faça logon no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração que você criou.

4. Escolha a guia Membros.

5. Veja o status de membro de cada membro.

Remoção de um membro de uma colaboração

nota

A remoção de um membro também remove todos os conjuntos de dados associados da colaboração.

Como remover um membro de uma colaboração

1. Faça logon no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração que você criou.

4. Escolha a guia Membros.

5. Selecione o botão de opção ao lado do membro a ser removido.

   nota

   Um criador de colaboração não pode escolher seu próprio ID de conta.

6. Escolha Remover.

7. Na caixa de diálogo, confirme a decisão de remover o membro digitando confirm no campo de entrada de texto.

   nota

   Se você remover o membro que está pagando pelos custos de computação da consulta, nenhuma outra consulta poderá ser executada na colaboração.

Saindo de uma colaboração

Como membro da colaboração, você pode sair de uma colaboração excluindo sua associação. Se você for o criador da colaboração, só poderá sair de uma colaboração excluindo a colaboração.

nota

Ao excluir sua associação, você sai da colaboração e não pode voltar a participar dela. Se você for o membro que está pagando pelos custos de computação da consulta e excluir sua associação, não será permitida a execução de mais consultas.

Para deixar uma colaboração

1. Faça logon no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Em Com associação ativa, escolha a colaboração da qual você é membro.

4. Escolha Ações.

5. Escolha Excluir associação.

6. Na caixa de diálogo, confirme a decisão de sair da colaboração digitando no campo de entrada de texto e, confirm em seguida, escolha Esvaziar e excluir associação.

   Você vê uma mensagem no console indicando que a associação foi excluída.

   O criador da colaboração vê o status do Membro como Saiu.

Editar associações de tabelas configuradas

Como membro da colaboração, você pode editar as associações de tabelas configuradas que você criou.

Para editar associações de tabelas configuradas

1. Faça logon no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração.

4. Escolha a guia Tabelas.

5. Para Tabelas associadas por você, escolha uma tabela.

6. Na página de detalhes da tabela, role para baixo para ver os detalhes da associação da tabela.

7. Selecione a opção Editar.

8. Na página Editar associações de tabelas configuradas, atualize a Descrição ou as informações de acesso ao serviço.

9. Escolha Salvar alterações.

Desassociação de tabelas configuradas

Como membro da colaboração, você pode desassociar uma tabela configurada da colaboração. Essa ação impede que o membro que pode consultar consulte a tabela.

Como desassociar uma tabela configurada

1. Faça logon no AWS Management Console e abra o AWS Clean Rooms console com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração.

4. Escolha a guia Tabelas.

5. Em Tabelas associadas por você, selecione o botão de opção ao lado da tabela que você deseja desassociar.

6. Escolha Desassociar.

7. Na caixa de diálogo, confirme a decisão de desassociar a tabela configurada e impedir o membro que pode consultar a tabela escolhendo Desassociar.

Editar uma política de privacidade diferencial

A qualquer momento após configurar a política de privacidade diferencial, você pode atualizá-la para refletir melhor suas necessidades de privacidade.

Para editar a política de privacidade diferencial

1. Faça login no AWS Management Console e abra o console AWS Clean Rooms com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração.

4. Na guia Tabelas da página de colaboração, em Tabelas associadas por você, escolha Editar.

5. Na página Editar privacidade diferencial, escolha novos valores para as seguintes propriedades:

   • Orçamento de privacidade: mova a barra deslizante para aumentar ou diminuir o orçamento a qualquer momento durante uma colaboração. Você não poderá diminuir o orçamento depois que o membro que pode consultar tiver começado a consultar seus dados. Se o Orçamento de privacidade for aumentado, o AWS Clean Rooms continuará usando o orçamento existente até que seja totalmente consumido antes de utilizar o orçamento de privacidade recém-adicionado.

   • Ruído adicionado por consulta: mova a barra deslizante para aumentar ou diminuir o ruído adicionado por consulta a qualquer momento durante uma colaboração.

   nota

   É possível escolher exemplos interativos para explorar como os diferentes valores de Orçamento de privacidade e Ruído adicionado por consulta afetam o número de funções agregadas que você pode executar.

   Não é possível alterar o valor da Atualização do orçamento de privacidade. Para alterar a seleção, você deverá excluir a política de privacidade diferencial e criar outra.

6. Escolha Save changes (Salvar alterações).

Você verá uma mensagem de confirmação de que editou com sucesso a política de privacidade diferencial.

Excluir uma política de privacidade diferencial

É possível excluir a política de privacidade diferencial na guia Tabelas de uma colaboração.

Para excluir a política de privacidade diferencial

1. Faça login no AWS Management Console e abra o console AWS Clean Rooms com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração.

4. Na guia Tabelas da página de colaboração, ao lado de Política de privacidade diferencial, selecione Excluir.

5. Se você tiver certeza de que deseja excluir a política de privacidade diferencial, escolha Excluir.

Depois de excluir uma política de privacidade diferencial, você não poderá acessar os logs de uso do orçamento de privacidade dessa política. Tabelas com privacidade diferencial ativada não poderão ser consultadas se a política de privacidade diferencial for excluída.

Visualizar os parâmetros de privacidade diferencial calculados

Para usuários com experiência em privacidade diferencial, você pode visualizar os parâmetros de privacidade diferencial calculados na guia Consultas de uma colaboração.

Para visualizar os parâmetros de privacidade diferencial calculados

1. Faça login no AWS Management Console e abra o console AWS Clean Rooms com seu Conta da AWS (se ainda não tiver feito isso).

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

3. Escolha a colaboração.

4. Na guia Consultas, na seção Resultados, selecione Visualizar parâmetros de privacidade diferencial calculados.

Na tabela de Parâmetros de privacidade diferencial calculados, você pode ver os valores de sensibilidade das funções agregadas, que são definidos como o valor máximo pelo qual o resultado de uma função pode mudar se os registros de um único usuário forem adicionados, removidos ou modificados. A lista inclui os seguintes parâmetros de privacidade diferencial:

• O Limite de contribuição do usuário (UCL) é o número máximo de linhas contribuídas por um usuário em uma consulta SQL. Por exemplo, se você quiser contar o número total de impressões correspondentes em uma campanha específica em que cada usuário pode ter várias impressões, a privacidade diferencial do AWS Clean Rooms precisa limitar o número de impressões de um único usuário para garantir que o cálculo da privacidade diferencial seja preciso. Em outras palavras, se algum usuário tiver mais impressões do que o limite, o AWS Clean Rooms pegará automaticamente uma amostra aleatória uniforme das impressões desse usuário de acordo com o valor calculado de UCL e excluirá as impressões restantes desse usuário ao executar a consulta. O valor de UCL será igual a 1 se você estiver contando o número de usuários exclusivos. Isso ocorre porque adicionar, remover ou modificar um único usuário pode alterar a contagem de usuários distintos em no máximo 1.

• Valor mínimo é o limite inferior de uma expressão usada em uma função agregada, como sum(). Por exemplo, se a expressão for uma coluna conhecida como purchase_value, o valor mínimo será o limite inferior da coluna.

• Valor máximo é o limite superior de uma expressão usada em uma função agregada, como sum(). Por exemplo, se a expressão for uma coluna conhecida como purchase_value, o valor máximo será o limite superior da coluna.

Na tabela Parâmetros de privacidade diferencial calculados, você pode usar esses parâmetros para entender melhor a quantidade total de ruído nos resultados da consulta. Por exemplo, quando o Ruído adicionado por consulta configurado é de 30 usuários e uma consulta COUNT DISTINCT (user_id) é executada, a privacidade diferencial do AWS Clean Rooms adiciona um ruído aleatório que fica entre -30 e 30 com alta probabilidade porque a sensibilidade de COUNT DISTINCT é 1. No caso de uma consulta COUNT com a mesma configuração, a privacidade diferencial AWS Clean Rooms adiciona ruído estatístico que é escalado pelo limite de contribuição do usuário, pois um único usuário pode contribuir com várias linhas para o resultado da consulta. No caso de uma consulta SUM como SUM (purchase_value) em que todos os valores da coluna são positivos, o ruído total é escalado pelo limite de contribuição do usuário multiplicado pelo valor máximo. AWS Clean Rooms A privacidade diferencial calcula automaticamente os parâmetros de sensibilidade para realizar a adição de ruído no tempo de execução da consulta e esgota o orçamento de privacidade. O esgotamento do orçamento de privacidade é necessário porque os parâmetros de sensibilidade dependem dos dados.