Configurando uma regra de análise em uma tabela configurada

As seções a seguir descrevem como configurar uma regra de análise para sua tabela configurada. Ao definir as regras de análise, é possível autorizar o membro que pode consultar a executar consultas que correspondam a uma regra de análise específica compatível com o AWS Clean Rooms.

AWS Clean Rooms suporta os seguintes tipos de regras de análise: agregação, lista e customização.

Só pode haver uma regra de análise por tabela configurada.

Importante

Se você estiver usando Computação Criptográfica Clean Rooms e tiver tabelas de dados criptografadas na colaboração, a regra de análise adicionada à tabela configurada criptografada deverá ser consistente com a forma como os dados foram criptografados. Por exemplo, se você criptografou os dados para SELECT (regra de análise de agregação), não deve adicionar a regra de análise para JOIN (regra de análise de lista).

Para obter uma compreensão dos tipos de regras de análise que estão disponíveis em AWS Clean Rooms, consulte Regras de análise em AWS Clean Rooms.

Para obter mais informações sobre a regra de análise de agregação, consulte Regra de análise de agregação.

Para obter mais informações sobre a regra de análise de lista, consulte Regra de análise de lista.

Para obter mais informações sobre a regra de análise personalizada, consulte Regra de análise personalizada em AWS Clean Rooms.

Depois de revisar e compreender essas seções, você pode executar os seguintes procedimentos:

Configurando uma regra de análise de agregação em uma tabela (fluxo guiado)

A regra de análise de agregação permite consultas que agregam estatísticas sem revelar informações no nível de linha usando funções COUNT, SUM e AVG ao longo de dimensões opcionais.

Esse procedimento descreve o processo de adicionar uma regra de análise de agregação à sua tabela configurada usando a opção Fluxo guiado no console AWS Clean Rooms.

Para adicionar a regra de análise de agregação a uma tabela (fluxo guiado)

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 esquerdo, escolha Tabelas configuradas.

3. Escolha a tabela configurada.

4. Na página de detalhes da tabela configurada, escolha Configurar regra de análise.

5. Em Etapa 1: Escolha o tipo, em Tipo, deixe a opção Agregação selecionada por padrão.

6. Em Método de criação, selecione Fluxo guiado e escolha Avançar.

7. Na Etapa 2: Especifique os controles de consulta, para Funções agregadas:

   1. Escolha uma Função agregadas no menu suspenso:

      • CONTAGEM

      • CONTAGEM DISTINTA

      • SUM

      • SOMA DISTINTA

      • AVG

   2. Escolha quais colunas podem ser usadas na Função agregadas no menu suspenso Colunas.

   3. (Opcional) Escolha Adicionar outra função para adicionar outra função agregada e associar uma ou mais colunas a essa função.

      nota

      Pelo menos uma função agregada é necessária.

   4. (Opcional) Escolha Remover para remover uma função agregada.

8. Para Controles de junção,

   1. Escolha uma opção para Permitir que a tabela seja consultada sozinha:

      Se você escolher...	Então…
      Não, somente a sobreposição pode ser consultada	A tabela só pode ser consultada quando unida a uma tabela de propriedade do membro que pode consultar.
      Sim	A tabela pode ser consultada sozinha ou quando unida a outras tabelas.

   2. Em Especificar colunas de junção, escolha as colunas que você deseja permitir que sejam usadas na instrução INNER JOIN.

      Isso é opcional se você tiver selecionado Sim na etapa anterior.

   3. Em Especificar operadores permitidos para correspondência, escolha quais operadores, se houver, podem ser usados para correspondência em várias colunas de junção. Se você selecionar duas ou mais colunas JOIN, um desses operadores será necessário.

      Se você escolher...	Então…
      E	Você pode incluir AND nas condições de correspondência INNER JOIN a união de uma coluna a outra coluna entre as tabelas.
      OU	Você pode incluir OR nas condições de correspondência INNER JOIN para combinar várias correspondências de colunas entre tabelas. Esse operador lógico é útil para obter uma taxa de correspondência mais alta.

9. (Opcional) Para Controles de dimensão, no menu suspenso Especificar colunas de dimensão, escolha quais colunas você deseja permitir que sejam usadas na instrução SELECT e as partes WHERE, GROUP, BY e ORDER BY da consulta.

   nota

   A função de agregação ou as colunas de junção não podem ser usadas como colunas de Dimensão.

10. Para Funções escalares, escolha uma opção para Quais funções escalares você deseja permitir?

    Se você escolher...	Então…
    Todos atualmente suportados por AWS Clean Rooms	Você permite todas as funções escalares atualmente suportadas pelo AWS Clean Rooms. Você pode escolher Exibir lista para ver a lista completa de Funções escalares suportadas no AWS Clean Rooms.
    Uma lista personalizada	Você pode personalizar quais funções escalares permitir. Escolha uma ou mais opções no menu suspenso Especificar funções escalares permitidas.
    Nenhum	Você não quer permitir nenhuma função escalar.

    Para obter mais informações, consulte Funções escalares.

11. Escolha Next (Próximo).

12. Na Etapa 3: Especifique os controles dos resultados da consulta, para Restrições de agregação:

    1. Selecione a lista suspensa para cada nome de Coluna.

    2. Selecione a lista suspensa para cada Número mínimo de valores distintos que devem ser atendidos para que cada linha de saída seja retornada, depois que a função COUNT DISTINCT for aplicada a ela.

    3. Escolha Adicionar restrição para adicionar mais restrições de agregação.

    4. (Opcional) Escolha Remover para remover uma restrição de agregação.

13. Escolha Next (Próximo).

14. Em Etapa 4: revisar e configurar, revise as seleções feitas nas etapas anteriores, edite se necessário e escolha Configurar regra de análise.

Você vê uma mensagem de confirmação de que configurou com êxito uma regra de análise de agregação na tabela.

Configurando uma regra de análise de lista em uma tabela (fluxo guiado)

A regra de análise de lista permite consultas que geram listas em nível de linha da sobreposição entre a tabela associada e uma tabela do membro que pode consultar.

Esse procedimento descreve o processo de adicionar a regra de análise de lista à tabela configurada usando a opção Fluxo guiado no console AWS Clean Rooms.

Para adicionar uma regra de análise de lista a uma tabela (fluxo guiado)

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 esquerdo, escolha Tabelas configuradas.

3. Escolha a tabela configurada.

4. Na página de detalhes da tabela configurada, escolha Configurar regra de análise.

5. Em Etapa 1: Escolha o tipo, em Tipo, escolha a opção Lista.

6. Em Método de criação, selecione Fluxo guiado e escolha Avançar.

7. Em Etapa 2: Especificar controles de consulta, para controles de junção:

   1. Em Especificar colunas de junção, escolha as colunas que você deseja permitir que sejam usadas na instrução INNER JOIN.

   2. Em Especificar operadores permitidos para correspondência, escolha quais operadores, se houver, podem ser usados para correspondência em várias colunas de junção. Se você selecionar duas ou mais colunas JOIN, um desses operadores será necessário.

      Se você escolher...	Então…
      E	Você pode incluir AND nas condições de correspondência INNER JOIN a união de uma coluna a outra coluna entre as tabelas.
      OU	Você pode incluir OR nas condições de correspondência INNER JOIN para combinar várias correspondências de colunas entre tabelas. Esse operador lógico é útil para obter uma taxa de correspondência mais alta.

8. (Opcional) Para Controles de lista, no menu suspenso Especificar colunas da lista, escolha quais colunas você deseja permitir que sejam usadas na saída da consulta (ou seja, usadas na instrução SELECT) ou usadas para filtrar resultados (ou seja, a instrução WHERE).

9. Escolha Next (Próximo).

10. Em Etapa 3: revisar e configurar, revise as seleções feitas nas etapas anteriores, edite se necessário e escolha Configurar regra de análise.

Você vê uma mensagem de confirmação de que configurou com êxito uma regra de análise de lista para a tabela.

Configurando uma regra de análise personalizada em uma tabela (fluxo guiado)

A regra de análise personalizada permite consultas SQL personalizadas em uma tabela configurada. A regra de análise personalizada é necessária se usar modelos de análise ou privacidade diferencial.

Esse procedimento descreve o processo de adicionar a regra de análise personalizada à tabela configurada usando a opção Fluxo guiado no console AWS Clean Rooms.

Para adicionar uma regra de análise personalizada a uma tabela (fluxo guiado)

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 esquerdo, escolha Tabelas configuradas.

3. Escolha a tabela configurada.

4. Na página de detalhes da tabela configurada, escolha Configurar regra de análise.

5. Em Etapa 1: Escolha o tipo, em Tipo, escolha a opção Personalizado.

6. Em Método de criação, selecione Fluxo guiado e escolha Avançar.

7. Em Etapa 2: definir privacidade diferencial, determine se você deseja que a privacidade diferencial seja ativada ou desativada. A privacidade diferencial é uma técnica matematicamente comprovada para proteger seus dados contra ataques de reidentificação.

   1. Em Privacidade diferencial:

      Se você…	A seguir, escolha…
      Tem dados no nível de usuário e deseja proteção contra tentativas de reidentificação	Ativar
      Não tem dados no nível de usuário ou não precisa de proteção contra tentativas de reidentificação	Desativar

   2. Se você optou por Ativar a privacidade diferencial, selecione a coluna Identificador de usuário que contém o identificador exclusivo dos usuários, como a coluna user_id, cuja privacidade você deseja proteger. Se quiser ativar a privacidade diferencial para duas ou mais tabelas em uma colaboração, você deve configurar a mesma coluna da coluna Identificador de usuário em ambas as regras de análise para manter uma definição consistente dos usuários nas tabelas. Em caso de configuração incorreta, o membro que pode consultar recebe uma mensagem de erro informando que há duas colunas a escolher para calcular o número de contribuições do usuário (por exemplo, o número de impressões de anúncios feitas por um usuário) enquanto executa a consulta.

   3. Escolha Next (Próximo).

8. Em Etapa 3: especificar controles de consulta,

   1. Para o Tipo de controle:

      Se você deseja ...	A seguir, escolha…
      Revise cada novo modelo de análise antes de executá-lo na tabela configurada	Revise cada nova análise antes que ela possa ser executada nesta tabela
      Permita que qualquer modelo de análise ou consulta direta seja executada em sua tabela configurada	Permita que qualquer consulta criada por colaboradores específicos seja executada sem revisão nesta tabela

   2. Escolha uma das seguintes opções:

      Se você escolheu...	Então…
      Revise cada nova análise antes que ela possa ser executada nesta tabela	Em Modelos de análise que podem ser executados, escolha Adicionar modelo de análise e, em seguida, escolha a Colaboração e o Modelo de análise apropriados nas listas suspensas.
      Permita que qualquer consulta criada por colaboradores específicos seja executada sem revisão nesta tabela	Em Permitido criar qualquer consulta Contas da AWS, escolha Adicionar Conta da AWS e, em seguida, escolha o ID Conta da AWS apropriado.

9. Escolha Next (Próximo).

10. Em Etapa 4: revisar e configurar, revise as seleções feitas nas etapas anteriores, edite se necessário e escolha Configurar regra de análise.

Você verá uma mensagem de confirmação de que configurou com êxito uma regra de análise personalizada para a tabela.

Configurando a regra de análise em uma tabela (editor JSON)

O procedimento a seguir mostra como adicionar uma regra de análise a uma tabela usando a opção do Editor JSON no console AWS Clean Rooms.

Para configurar uma agregação, lista ou regra de análise personalizada em uma tabela (editor JSON)

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 esquerdo, escolha Tabelas configuradas.

3. Escolha a tabela configurada.

4. Na página de detalhes da tabela configurada, escolha Configurar regra de análise.

5. Em Etapa 1: Escolha o tipo, em Tipo, escolha a opção Agregação, Lista ou Personalizado.

6. Em Método de criação, selecione Editor JSON e escolha Avançar.

7. Em Etapa 2: Especificar controles, você pode optar por inserir uma estrutura de consulta (Inserir modelo) ou inserir um arquivo (Importar do arquivo).

   Se você escolher...	Então…
   Inserir modelo	Especifique os parâmetros para a regra de análise selecionada na definição da regra de análise. Você pode pressionar Ctrl + Barra de espaço para ativar o preenchimento automático. Para obter mais informações sobre parâmetros de regra de análise de agregação, consulte Regra de análise de agregação - controles de consulta. Para obter mais informações sobre parâmetros de regra de análise de lista, consulte Regra de análise de lista - controles de consulta.
   Importar do arquivo	Selecione seu arquivo JSON na sua unidade local. Escolha Open (Abrir). A definição da regra de análise exibe a regra de análise do arquivo carregado.

8. Escolha Next (Próximo).

9. Em Etapa 3: revisar e configurar, revise as seleções feitas nas etapas anteriores, edite se necessário e escolha Configurar regra de análise.

Você receberá uma mensagem de confirmação de que configurou com êxito uma regra de análise para a tabela.

Próximas etapas

Agora que você configurou uma regra de análise em sua tabela configurada, você está pronto para:

• Associar uma tabela configurada a uma colaboração

• Consulte as tabelas de dados (como um membro que pode consultar)