Power BI connector (REST API)
Use o conector da REST API doPower BI para buscar dados com os serviços do OData do Cognite ou outras APIs do Cognite usando GET, POST e com consultas do GraphQL para modelos de dados do Cognite.
As funcionalidades descritas nesta seção estão em fase Beta com clientes selecionados e sujeitas a alterações.
Configurar uma conexão com o Cognite Data Fusion (CDF)
Siga estas etapas para conectar um projeto do Cognite Data Fusion (CDF) como uma fonte de dados em Power BI:
-
Em
Power BI Desktop, faça login com sua conta organizacional. -
Na guia Página inicial, selecione Obter dados e depois Mais. Na caixa de diálogo Obter dados, pesquise por Cognite e selecione o conector do Cognite Data Fusion (API REST).
-
Na caixa de diálogo, insira os detalhes para configurar a conexão com o
CDF:-
CDF project: Digite o nome do projeto do
CDFao qual você está se conectando. -
CDF organization: Insira a organização a ser usada para fazer login
CDF.
-
-
Quando solicitado, faça login com suas credenciais de conta.
-
Selecione Conectar para abrir a janela Navegador.
-
Selecione a(s) função(ões) que deseja usar e, em seguida, selecione Transformar Dados para abrir o
Power Query Editore recuperar os dados doCDF.
Use o tamanho máximo de página compatível se fizer solicitações oferecem suporte a paginação (por meio dos parâmetros limit em solicitações GET/POST ou do parâmetro first em consultas de GraphQL). Tamanhos de página menores aumentam as chamadas de API e podem impactar significativamente os tempos de carregamento. Consulte a documentação da API do Cognite para o tamanho máximo de página compatível para cada ponto de extremidade. Para consultas do GraphQL, o limite máximo é de 1000 instâncias por página.
Filtragem de dados
Ao utilizar as funções da API REST, você pode aplicar filtros no lado do servidor para reduzir os dados iniciais carregados no Power BI.
Se você estiver usando OData, Power BI pode enviar alguns filtros para o serviço do OData ao usar o editor do Power Query.
Para consultas do GraphQL, você pode aplicar filtros diretamente na consulta para reduzir a quantidade de dados carregados no Power BI. Você também pode usar variáveis de consulta do GraphQL para parametrizar suas consultas e torná-las mais reutilizáveis.
Atualização agendada
Após publicar seu relatório no serviço do Power BI, você pode agendar atualizações de dados para manter seus dados atualizados.
Tratamento de erros
Ao escrever solicitações personalizadas de GET e POST, podem ocorrer erros se você fornecer uma URL ou um corpo inválido. Se você receber uma mensagem de erro CogniteAPIError, consulte a documentação de referência da API do Cognite e ajuste sua solicitação.