Adicionando uma regra de análise a uma tabela configurada - AWS Clean Rooms
Adicionar uma regra de análise de agregação a uma tabela (fluxo guiado)Adicionar uma regra de análise de lista a uma tabela (fluxo guiado)Adicionar uma regra de análise personalizada a uma tabela (fluxo guiado)Adicionar regra de análise a uma tabela (JSONeditor)Próximas etapas

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

Adicionando uma regra de análise a uma tabela configurada

As seções a seguir descrevem como adicionar uma regra de análise à 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:

Só pode haver uma regra de análise por tabela configurada. Você pode configurar a regra de análise a qualquer momento antes de associar suas tabelas configuradas à colaboração.

Importante

Se você estiver usando Computação Criptográfica para o 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).

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

A regra de análise de agregação permite consultas que agregam estatísticas sem revelar informações em nível de linha usando COUNTSUM, e funcionam em dimensões opcionais. AVG

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 AWS Clean Rooms console 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 3: Escolher 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: Especificar controles de consulta, para Funções agregadas:

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

      • COUNT

      • COUNT DISTINCT

      • SUM

      • SUM DISTINCT

      • 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…
      AND 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 SELECT instrução e as ORDER BY partes WHERE GROUPBY, e 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…
    Tudo atualmente suportado 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 Próximo.

  12. Na Etapa 3: Especificar controles dos resultados de 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. Para Análises adicionais aplicadas à saída, selecione uma opção com base em sua meta.

    Seu objetivo Opção recomendada
    Permita somente consultas diretas nessa tabela. Impeça que análises adicionais sejam executadas nos resultados da consulta. A tabela só pode ser usada para consultas diretas. Não permitido
    Permita, mas não exija, consultas diretas e análises adicionais nessa tabela. Permitido
    Exija que a tabela só possa ser usada em consultas diretas processadas com uma das análises adicionais necessárias. As consultas diretas nessa tabela devem ser processadas posteriormente antes que possam ser retornadas. Obrigatório

  14. Escolha Próximo.

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

Adicionar uma regra de análise de lista a 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 AWS Clean Rooms console.

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 AWS Clean Rooms console 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: Escolher 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…
      AND 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 Próximo.

  10. Em Etapa 3: Especifique os controles dos resultados da consulta, para Análises adicionais aplicadas à saída, selecione uma opção com base em sua meta.

    Seu objetivo Opção recomendada
    Permita somente consultas diretas nessa tabela. Impeça que análises adicionais sejam executadas nos resultados da consulta. A tabela só pode ser usada para consultas diretas. Não permitido
    Permita, mas não exija, consultas diretas e análises adicionais nessa tabela. Permitido
    Exija que a tabela só possa ser usada em consultas diretas processadas com uma das análises adicionais necessárias. As consultas diretas nessa tabela devem ser processadas posteriormente antes que possam ser retornadas. Obrigatório

  11. 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 lista para a tabela.

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

A regra de análise personalizada permite SQL consultas personalizadas em uma tabela configurada. A regra de análise personalizada é necessária se você estiver usando:

  • modelos de análise — para permitir um conjunto específico de SQL consultas pré-aprovadas ou um conjunto específico de contas que podem fornecer consultas que usam seus dados

  • privacidade diferencial — para se proteger contra tentativas de identificação do usuário

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

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

  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, 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: Escolher 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 em 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 de seus usuários, como a user_id coluna cuja privacidade você deseja proteger.

      Para 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 Próximo.

  8. Em Etapa 3: especificar controles de consulta,

    1. Em Tipo de controle, escolha uma opção com base na sua meta.

      Seu objetivo Opção
      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 Contas da AWS Permitido criar qualquer consulta, escolha Adicionar e Conta da AWS, em seguida, escolha a Conta da AWS ID apropriada.

  9. Escolha Próximo.

  10. Em Etapa 4: Especifique os controles dos resultados da consulta,

    1. Para Colunas não permitidas na saída, escolha uma opção com base em sua meta.

      Seu objetivo Opção recomendada
      Permitir que todas as colunas sejam retornadas nas saídas da consulta Nenhum
      Impedir que determinadas colunas sejam retornadas nas saídas da consulta Lista personalizada

    2. Escolha uma das seguintes opções:

      Se você escolheu... Então…
      Nenhum Prossiga para Análises adicionais aplicadas à saída
      Lista personalizada Em Especificar colunas não permitidas, escolha as colunas que você deseja remover das saídas da consulta.

    3. Para Análises adicionais aplicadas à saída, selecione uma opção com base em sua meta.

      Seu objetivo Opção recomendada
      Permita somente consultas diretas nessa tabela. Impeça que análises adicionais sejam executadas nos resultados da consulta. A tabela só pode ser usada para consultas diretas. Não permitido
      Permita, mas não exija, consultas diretas e análises adicionais nessa tabela. Permitir
      Exija que a tabela só possa ser usada em consultas diretas processadas com uma das análises adicionais necessárias. As consultas diretas nessa tabela devem ser processadas posteriormente antes que possam ser retornadas. Obrigatório

  11. Escolha Próximo.

  12. Em Etapa 5: 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.

Adicionar regra de análise a uma tabela (JSONeditor)

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

Para adicionar uma agregação, lista ou regra de análise personalizada a uma tabela (JSONeditor)

  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, 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 3: Escolher tipo, em Tipo, escolha a opção Agregação, Lista ou Personalizado.

  6. Em Método de criação, selecione JSONeditor e, em seguida, 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

    1. Especifique os parâmetros para a regra de análise selecionada na definição da regra de análise.

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

    1. Selecione seu JSON arquivo na sua unidade local.

    2. Escolha Open (Abrir).

      A definição da regra de análise exibe a regra de análise do arquivo carregado.

  8. Escolha 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: