Filtragem de resultados de consulta em painéis e planilhas¶

Concessão de permissão para criar filtros personalizados¶

Para permitir que um usuário crie filtros personalizados, um usuário com a função ACCOUNTADMIN deve conceder as permissões relevantes para uma função concedida a esse usuário. Você só pode usar o Snowsight para conceder às funções a capacidade de criar filtros personalizados.

Para conceder uma permissão de função para criar filtros personalizados para sua conta, faça o seguinte:

1. Faça login no Snowsight.

2. Selecione Projects » Worksheets para abrir a lista de planilhas e abrir uma planilha ou selecione Projects » Dashboards para abrir a lista de painéis e abrir um painel.

3. Selecione e, se estiver em uma planilha, selecione Manage Filters.

4. Na caixa de diálogo que aparece, selecione Edit Permission.

5. Na caixa de diálogo Filter Permissions, selecione as funções às quais você deseja conceder permissão para criar filtros.

6. Selecione Save.

Criação de um filtro personalizado¶

Você deve usar o Snowsight para criar um filtro, e deve usar uma função com permissões para criar filtros personalizados.

Para criar um filtro personalizado, faça o seguinte:

1. Faça login no Snowsight.

2. Selecione Projects » Worksheets para abrir a lista de planilhas e abrir uma planilha ou selecione Projects » Dashboards para abrir a lista de painéis e abrir um painel.

3. Selecione e, se estiver em uma planilha, selecione Manage Filters.

4. Na caixa de diálogo Filters que aparece, selecione + Filter.

5. Para adicionar um filtro, preencha o seguinte:

   1. Para Display Name, insira um nome para o filtro. Este nome aparece no filtro ao selecioná-lo em uma planilha ou painel.

   2. Para SQL Keyword, insira a palavra-chave exclusiva a ser inserida nas consultas. Use o formato :<cadeia de caracteres>, sem espaços. Por exemplo: :page_path.

   3. Para Description, insira uma descrição do filtro.

   4. Para Role, selecione uma função para associar ao filtro e execute a consulta usada para preencher os valores do filtro, se o filtro for baseado em uma consulta. Somente funções com permissões para criar filtros personalizados aparecem na lista suspensa. Consulte Gerenciamento da propriedade de filtros personalizados para obter mais detalhes.

   5. Para Warehouse, selecione um warehouse a ser usado para atualizar os valores do filtro, se o filtro for baseado em uma consulta. A função de proprietário do filtro deve ter o privilégio USAGE no warehouse que você selecionar. Se quiser executar e validar sua consulta como parte dessas etapas, o warehouse deverá estar em execução.

   6. Para Options via, escolha se os valores do filtro serão preenchidos por uma consulta ou uma lista:

      • Se selecionar Query, selecione Write Query e consulte Como escrever uma consulta para preencher um filtro para orientação na escrita de uma consulta de filtro.

      • Se você selecionar List, faça o seguinte:

        1. Selecione Edit List.

        2. Opcionalmente, para Name, insira um nome para o item da lista. O nome aparece na lista suspensa do filtro. Se você não fornecer um nome, o Value é usado.

        3. Para Value, insira o valor do nome da coluna a ser usado no filtro.

        4. Continue adicionando pares de nome e valor até que sua lista esteja completa e selecione Save.

6. Na caixa de diálogo Add Filter, para Value Type, escolha se os itens da lista são os tipos de dados Text ou Number.

7. Se você deseja que os usuários possam selecionar vários itens na lista suspensa de opções de filtro, ative o seletor para Multiple values can be selected.

8. Se você deseja que os usuários vejam os resultados de todos os itens na coluna, ative o seletor para Include an «All» option e, em seguida, selecione como quer a opção All funcione:

   • Selecionar Any value para ter All no filtro significa que a coluna à qual o filtro se aplica pode ter qualquer valor nos resultados, independentemente de o valor existir ou não na lista de filtros.

   • Selecionar Any value in list of options para ter All no filtro significa que a coluna à qual o filtro se aplica contém qualquer item na lista de filtros.

9. Se deseja que os usuários vejam os resultados de itens não especificados no filtro, ative o seletor para Include an «Other» option.

10. Selecione Save.

11. Selecione Done, para fechar a caixa de diálogo Filters.

Gerenciamento da propriedade de filtros personalizados¶

Cada filtro personalizado tem uma função associada. Qualquer pessoa com essa função pode editar ou excluir o filtro. Usuários com a função ACCOUNTADMIN podem visualizar e editar todos os filtros na conta.

Se a função associada a um filtro for descartada, a função que descarta a função do filtro não herda a propriedade do filtro personalizado. Em vez disso, um usuário com a função ACCOUNTADMIN pode editar o filtro e alterar a função associada ao filtro.

Gerenciamento da frequência de atualização para um filtro personalizado¶

Um filtro personalizado preenchido por uma consulta SQL também tem uma frequência de atualização. A frequência de atualização pode ser de hora em hora, diária ou nunca.

O filtro é executado com base em quando foi salvo e quanto tempo levou para executar a consulta que atualiza as opções do filtro.

Por exemplo, se você salvar um filtro que tenha uma frequência de atualização de consulta por hora às 10:07 AM, a primeira consulta de atualização será executada às 11:07 AM ou depois. Se um grande número de consultas de atualização de filtro for programado para ser executado ao mesmo tempo, as consultas serão enfileiradas para limitar o número de consultas de atualização de filtro em execução ao mesmo tempo. A próxima atualização do filtro é baseada em quando a última atualização foi concluída. Neste exemplo, se a consulta for atualizada às 11:07 AM leva 20 minutos para ser concluída, a próxima consulta de atualização será executada às 12:27 PM ou depois.

As atualizações do filtro são executadas pelo usuário que criou ou modificou o filtro pela última vez e são visíveis em Query History como um dos tipos de Queries executed by user tasks. Consulte Monitoramento da atividade de consulta com o Histórico de consultas para detalhes sobre o uso de Query History.

Para determinar qual filtro é responsável por uma atualização de consulta de filtro, você deve abrir a lista de filtros e abrir cada filtro para visualizar os detalhes.

SELECT * FROM SNOWFLAKE.ACCOUNT_USAGE.LOGIN_HISTORY
WHERE
    FIRST_AUTHENTICATION_FACTOR = 'OAUTH_ACCESS_TOKEN'
    AND
    REPORTED_CLIENT_TYPE = 'SNOWFLAKE_UI'
    AND
    EVENT_TIMESTAMP > DATEADD('DAY', -2, CURRENT_DATE());
ORDER BY
    EVENT_TIMESTAMP DESC;

Como aplicar e salvar filtros¶

Quando você altera as opções selecionadas em um filtro, a opção para aplicar suas alterações aparece. Ao selecionar Apply, a planilha ou o painel é executado e os resultados filtrados atualizados aparecem, permitindo que você revise as alterações sem salvar.

Após aplicar alterações a um filtro em um painel, a opção para salvar suas alterações é exibida. Ao selecionar Save, as alterações feitas no painel são salvas e ficam disponíveis para outros usuários do painel.

Por exemplo, você pode selecionar Apply para alterar um filtro e ver os resultados de All Time, mas você não quer que o painel execute um volume tão grande de dados na próxima vez que alguém abrir o painel, então você não seleciona Save. Após executar seu painel para todo o período, você altera o filtro de intervalo de datas para Last 7 days, selecione Apply para executar o painel e, em seguida, selecione Save para salvar esse valor de filtro padrão para usuários do painel.

Exemplo: Trabalho com filtros de data¶

Por exemplo, dada uma tabela com dados de pedidos, como a tabela ORDERS no banco de dados SNOWFLAKE_SAMPLE_DATA e no esquema TPCH_SF1, você pode querer consultar a tabela e agrupar os resultados por um intervalo específico, como por dia ou por semana, e especificar um intervalo de datas específico para recuperar os resultados.

Para fazer isso, você pode escrever uma consulta da seguinte forma:

SELECT
    COUNT(O_ORDERDATE) as orders,
    :datebucket(O_ORDERDATE) as bucket
FROM
    SNOWFLAKE_SAMPLE_DATA.TPCH_SF1.ORDERS
WHERE
    O_ORDERDATE = :daterange
GROUP BY
    :datebucket(O_ORDERDATE)
ORDER BY
    bucket;

Neste exemplo, você:

• Conte o número de pedidos e recupere os detalhes sobre a data do pedido na tabela ORDERS.

• Filtre seus resultados por um intervalo de datas específico, incluindo o filtro :daterange do sistema em sua cláusula WHERE.

• Agrupe seus resultados por um período específico, incluindo o filtro do sistema :datebucket em sua cláusula GROUP BY.

• Classifique os resultados do período mais antigo para o mais recente, incluindo a cláusula ORDER BY.

Quando você adiciona filtros à sua consulta, os botões de filtro correspondentes aparecem na parte superior da planilha ou do painel:

Para manipular os resultados que você vê na consulta, use os filtros para selecionar valores específicos.

Para este exemplo, defina o filtro Group by, que corresponde ao filtro de intervalo de datas, para agrupar por Day. Defina o outro filtro, que corresponde ao filtro de intervalo de datas, para All time.

Quando você seleciona Apply e aplica o filtro aos resultados, os resultados são agrupados por dia, e resultados como a saída a seguir são exibidos:

+--------+------------+
| orders |  buckets   |
+--------+------------+
|    621 | 1992-01-01 |
|    612 | 1992-01-02 |
|    598 | 1992-01-03 |
|    670 | 1992-01-04 |
+--------+------------+

Você pode selecionar um intervalo de datas diferente para mostrar um agrupamento diferente de dados. Por exemplo, para visualizar dados de pedidos semanais, defina o filtro Group by para Week e selecione Apply. Resultados como a saída a seguir são exibidos:

+--------+------------+
| orders |  buckets   |
+--------+------------+
|   3142 | 1991-12-30 |
|   4404 | 1992-01-06 |
|   4306 | 1992-01-13 |
|   4284 | 1992-01-20 |
+--------+------------+