Pular para o conteúdo principal

Filtrar dados do CDF no Power BI

Adicione filtros no Power BI para filtrar grandes conjuntos de dados em milissegundos, em vez de minutos ou horas.

Os projetos do Cognite Data Fusion (CDF) podem conter milhões de linhas de dados. Baixar todas elas no Power BI não é eficiente ou viável.

A filtragem é essencial para criar conjuntos de dados viáveis no Power BI. O Cognite Power BI Connector envia a filtragem para o CDF usando o Cognite OData Service. Por sua vez, o CDF executa a filtragem e retorna apenas as linhas correspondentes para o Power BI.

Adicionar filtros no Power Query Editor

  1. Conecte o Power BI ao CDF.

  2. Selecione o botão de menu no cabeçalho da coluna à qual deseja adicionar o filtro.

  3. Selecione Filtros de Texto e o tipo de filtro que deseja, por exemplo, Começa com.

  4. Na caixa de diálogo Filtrar Linhas, especifique as condições para filtrar as linhas na coluna.

    Adicionar filtro do Power BI
  5. Selecione Avançado para definir vários filtros simultaneamente ou definir e adicionar um por vez.

    dica

    Sempre especifique a condição que filtra mais linhas primeiro.

  6. O Cognite Power BI Connector envia a consulta para a filtragem no CDF. E o Power Query exibe os resultados retornados do CDF.

    o Power Query oferece uma visualização do conjunto de resultados, que geralmente tem 1.000 linhas. A filtragem final ocorre quando você seleciona Fechar e Aplicar.

Filtragem compatível com os tipos de recursos do CDF

O Cognite Power BI Connector pode restringir ou enviar filtros para o CDF usando o Cognite OData Service. A filtragem pode acontecer no:

  • CDF: a filtragem mais eficaz. O CDF faz a filtragem e nenhum dado desnecessário é transmitido entre o CDF e o Power BI.

  • OData Service: o serviço do OData pode fazer a filtragem local por ser compatível com funcionalidades não existentes no CDF, como as funções contains e endswith. Primeiro, reduza o conjunto de dados o máximo possível usando a filtragem do CDF.

  • Power Query: o Power Query precisa recuperar todos os dados para fazer a filtragem. Para tabelas grandes, isso pode envolver quantidades significativas de dados. Reduza o conjunto de dados o máximo possível primeiro.

As tabelas abaixo descrevem qual filtragem é compatível com cada tipo de recurso no CDF, quais filtros serão enviados para o CDF e qual filtragem será feita localmente pelo OData Service.

Definições

  • Pushdown: funções de filtro que são enviadas para o serviço do OData e o CDF.

  • Local: filtragem local feita pelo serviço do OData antes de retornar o resultado para o Power BI.

  • FilterFunctions: Contains, StartsWith e EndsWith.

  • Comparison: <, <=, >, >= e =.

  • Search: faz pushdown, mas usa a API de pesquisa e requer filtragem local adicional.

    informações

    A pesquisa retorna um número limitado de linhas e talvez você não receba todos os dados correspondentes no CDF.

Assets (ativos)

PropriedadePushdownLocal
Id==
ExternalId=, StartsWith=, FilterFunctions
Name=, Search=, FilterFunctions
DescriptionSearch=, FilterFunctions
ParentId==
ParentExternalId==
DataSetId==
Source==
MetaData=
RootId==
CreatedTimeComparisonComparison
LastUpdatedTimeComparisonComparison

Time series (séries temporais)

PropriedadePushdownLocal
Id==
ExternalId=, StartsWith=, FilterFunctions
Name=, Search=, FilterFunctions
DescriptionSearch=, FilterFunctions
IsString==
MetaData=
Unit==
IsStep==
AssetId==
SecurityCategories
DataSetId==
CreatedTimeComparisonComparison
LastUpdatedTimeComparisonComparison

Data point

PropriedadePushdownLocal
Id==
TimeStampComparisonComparison

Events (eventos)

PropriedadePushdownLocal
Id==
ExternalId=, StartsWithFilterFunctions
DescriptionSearch=, FilterFunctions
Source==
Type==
SubType==
MetaData=
DataSetId==
StartTimeComparisonComparison
EndTimeComparisonComparison
CreatedTimeComparisonComparison
LastUpdatedTimeComparisonComparison
AssetIdsContainsContains

Files (arquivos)

PropriedadePushdownLocal
Id==
ExternalId=, StartsWith=, FilterFunctions
Name=, Search=, FilterFunctions
Source==
MimeType==
MetaData
DataSetId==
SourceCreatedTimeComparisonComparison
SourceModifiedTimeComparisonComparison
CreatedTimeComparisonComparison
LastUpdatedTimeComparisonComparison
UploadedTimeComparisonComparison
Uploaded==
AssetIdsContainsContains

Sequences (sequências)

PropriedadePushdownLocal
Id==
ExternalId=, StartsWith=, StartsWith
Name=, Search=, FilterFunctions
Description=, Search=, FilterFunctions
MetaData
AssetId==
DataSetId==
CreatedTimeComparisonComparison
LastUpdatedTimeComparisonComparison
Columns

Bancos de dados do CDF RAW

PropriedadePushdownLocal
Name==

Tabelas do CDF RAW

PropriedadePushdownLocal
Name==

Linhas do CDF RAW

PropriedadePushdownLocal
Key==, FilterFunction
LastUpdatedTimeComparisonComparison

Usar consultas personalizadas para filtrar dados

Você pode usar o Cognite Power BI connector para criar consultas personalizadas para filtrar propriedades. Por exemplo, para filtrar as propriedades Metadata do ativo:

  1. No Power BI, selecione Obter Dados na janela principal do Power BI e selecione o conector do Cognite Data Fusion.

  2. No campo do nome do projeto, digite o nome do projeto, o recurso e o filtro neste formato:

    <project-name>/<resource-type>/?$filter=<Filter>

  3. Selecione OK e, em seguida, Transformar Dados para abrir a visualização da consulta.

Exemplos

A filtragem segue a especificação do OData e você pode criar filtros com vários atributos ao encadear filtros com os termos AND/OR. Por exemplo, um filtro de igualdade usa o formato AttributeName eq 'AttributeValue':

Name eq '23-TE-96116-04'

Filtragem de metadados

Para metadados, a filtragem é executada em propriedades aninhadas dentro do objeto de metadados. Para filtrar uma propriedade de metadados, você precisa criar um filtro na formato "MetaData/NestedAttributeName eq 'NestedAttributeValue'", por exemplo:

MetaData/RES_ID eq '525283'

Este é um exemplo de uma consulta ao projeto de publicdata, filtrado em Metadata/RES_ID:

publicdata/Assets/?$filter=MetaData/RES_ID eq '525283'&amp;tenantID=48d5043c-cf70-4c49-881c-c638f5796997

Este é um filtro AND em Metadata/RES_ID e Name:

publicdata/Assets/?$filter=MetaData/RES_ID eq '525283' and Name eq '23-TE-96116-04'&amp;tenantID=48d5043c-cf70-4c49-881c-c638f5796997

Nos exemplos acima, tenantID=48d5043c-cf70-4c49-881c-c638f5796997 é o locatário configurado do Microsoft Entra ID no projeto de publicdata.

Depuração

Para depurar a filtragem, é útil usar ferramentas que permitem ver quais filtros são enviados para o serviço do OData, por exemplo Fiddler.