Power BI connector (REST API)

Use el conector REST API de Power BI para obtener datos a través de los servicios OData de Cognite u otras API de Cognite mediante GET, POST y consultas GraphQL para los modelos de datos Cognite.

Beta

Las funciones descritas en esta sección se encuentran actualmente en pruebas beta con clientes seleccionados y están sujetas a cambios.

Configurar una conexión a Cognite Data Fusion (CDF)

Siga estos pasos para conectar un proyecto Cognite Data Fusion (CDF) como fuente de datos en Power BI.

1. En Power BI Desktop, inicie sesión con la cuenta de su organización.

2. En la pestaña Inicio, seleccione Obtener datos y, luego, Más. En el cuadro de diálogo Obtener datos, busque Cognite y seleccione el conector Cognite Data Fusion (API REST).

   

3. En el cuadro de diálogo, ingrese los detalles para configurar la conexión a CDF:

   • CDF project: Ingrese el nombre del proyecto de CDF al que se está conectando.

   • CDF organization: Ingrese la organización que usará para iniciar sesión en CDF.

   

4. Cuando se le solicite, inicie sesión con las credenciales de su cuenta.

5. Seleccione Connect para abrir la ventana Navigator.

6. Seleccione la(s) función(es) que desea usar y, luego, seleccione Transformar datos para abrir Power Query Editor y recuperar datos de CDF.

   

Use el tamaño de página máximo admitido si realiza solicitudes que admiten paginación (a través de los parámetros limit en las solicitudes GET/POST o el parámetro first en las consultas GraphQL). Los tamaños de página más pequeños aumentan el número de llamadas a la API y pueden afectar significativamente los tiempos de carga. Consulte la documentación de la API de Cognite para conocer el tamaño máximo de página admitido por cada punto de conexión. En el caso de las consultas GraphQL, el límite máximo es de 1000 instancias por página.

Filtrado de datos

Cuando utiliza las funciones de la API REST, puede aplicar filtros del lado del servidor para reducir los datos iniciales cargados en Power BI.

Si utiliza OData, Power BI puede delegar algunos filtros al servicio OData cuando utiliza el editor Power Query.

En el caso de las consultas GraphQL, puede aplicar filtros directamente en la consulta para reducir la cantidad de datos cargados en Power BI. También puede utilizar las variables de consulta GraphQL para parametrizar sus consultas y hacerlas más reutilizables.

Actualización programada

Después de publicar su informe en el servicio Power BI, puede programar actualizaciones de datos para mantenerlos actualizados.

Gestión de errores

Cuando escriba solicitudes GET y POST personalizadas, puede recibir errores si proporciona una URL o un cuerpo no válidos. Si recibe un mensaje de error CogniteAPIError, consulte la Documentación de referencia de la API de Cognite y ajuste su solicitud.