Compartir a través de


Cognite Data Fusion (OData)

Nota:

Este conector es propiedad de Cognite y lo proporciona.

Nota:

Use el conector de Power Query Cognite Data Fusion (OData) para capturar datos de los servicios OData de Cognite. El conector es compatible con versiones anteriores con los informes existentes y los usuarios pueden autenticarse con sus credenciales de Id. de Entra. Para los nuevos informes, se recomienda usar el conector de Power Query Cognite Data Fusion (API REST).

Resumen

Elemento Descripción
Estado de liberación Disponibilidad general
Productos Power BI (modelos semánticos)
Power BI (flujos de datos)
Arquitectura (Dataflow Gen2)
Tipos de autenticación admitidos Cuenta organizativa

Prerrequisitos

Este conector funciona con entornos de Cognite Data Fusion (CDF) federados con el identificador de Microsoft Entra (anteriormente Azure Active Directory). Para usar este conector, necesita lo siguiente:

  • Un proyecto de Cognite Data Fusion válido federado con el identificador de Entra de Microsoft
  • Una cuenta de usuario con acceso al proyecto de CDF a través de Microsoft Entra ID
  • Permisos de acceso adecuados en el proyecto de CDF

Capacidades soportadas

  • Importación

Conexión a Cognite Data Fusion desde Power Query Desktop

Para conectarse a Cognite Data Fusion desde Power Query Desktop, siga estos pasos:

  1. Seleccione Obtener datos en la cinta Inicio de Power BI Desktop. En el cuadro de diálogo Obtener datos, busque Cognite, seleccione el conector Cognite Data Fusion (OData) y, a continuación, seleccione Connect.

    Captura de pantalla que muestra cómo localizar el conector OData de CDF en Power BI Desktop.

  2. En el cuadro de diálogo Cognite Data Fusion (CDF), escriba los detalles para configurar la conexión al CDF y luego seleccione Aceptar:

    • identificador de origen de datos: para recuperar datos de CDF, escriba el nombre del proyecto de CDF, una dirección URL del modelo de datos o una consulta de OData personalizada.

      • Para autenticarse como usuario invitado en microsoft Entra ID, agregue el id. de inquilino de Entra, por ejemplo, dataSource?tenantId=MyEntraIDTenant.onmicrosoft.com.
      • Si pasa una dirección URL de OData personalizada que ya contiene parámetros de consulta, puede agregar el tenantId al final con la siguiente sintaxis: dataSource?$filter={Filter}&tenantId=MyEntraIDTenant.onmicrosoft.com.
    • dirección URL de la API de CDF: escriba la dirección URL de la API de Cognite, por ejemplo, https://api.cognitedata.com o https://az-eastus-1.cognitedata.com. Para acceder a algunos servicios de OData, es posible que también tenga que agregar la versión de la API, por ejemplo, https://bluefield.cognitedata.com/20230821.

    Captura de pantalla de la configuración de conexión en la que se configura el conector OData de CDF en Power BI Desktop.

  3. Para iniciar sesión en la cuenta de CDF, seleccione Iniciar sesión y siga el proceso de autenticación con las credenciales de la cuenta de Microsoft Entra ID.

    Captura de pantalla del cuadro de diálogo de autenticación donde se selecciona el botón de inicio de sesión.

  4. Una vez que haya iniciado sesión correctamente, seleccione Conectar.

    Captura de pantalla del cuadro de diálogo de autenticación donde ha iniciado sesión y está listo para conectarse.

  5. En Navegador, seleccione los datos que desea cargar o transformar.

    Captura de pantalla del navegador donde se seleccionan los datos que desea usar.

  6. Seleccione Cargar para importar los datos directamente o Transformar Datos para abrir el editor de Power Query para el filtrado y transformación de datos.

Conexión a Cognite Data Fusion desde Power Query Online

Para conectarse a Cognite Data Fusion desde Power Query Online, siga estos pasos:

  1. Seleccione la opción Cognite Data Fusion (OData) en la interfaz de obtención de datos. Las distintas aplicaciones tienen diferentes formas de obtener datos en Power Query Online. Para obtener más información sobre cómo acceder a la experiencia de obtención de datos de Power Query Online desde la aplicación, vaya a Dónde obtener datos.

    Captura de pantalla de la ventana de Obtener datos, con Cognite Data Fusion (OData) resaltado.

  2. En la sección de configuración de conexión , escriba la siguiente información:

    • identificador de origen de datos: para recuperar datos de CDF, escriba el nombre del proyecto de CDF, una dirección URL del modelo de datos o una consulta de OData personalizada.
      • Para autenticarse como usuario invitado en microsoft Entra ID, agregue el id. de inquilino de Entra, por ejemplo, dataSource?tenantId=MyEntraIDTenant.onmicrosoft.com.
      • Si pasa una dirección URL de OData personalizada que ya contiene parámetros de consulta, puede agregar el tenantId al final con la siguiente sintaxis: dataSource?$filter={Filter}&tenantId=MyEntraIDTenant.onmicrosoft.com.
    • dirección URL de la API de CDF: escriba la dirección URL de la API de Cognite, por ejemplo, https://api.cognitedata.com o https://az-eastus-1.cognitedata.com. Para acceder a algunos servicios de OData, es posible que también tenga que agregar la versión de la API, por ejemplo, https://bluefield.cognitedata.com/20230821.

    Captura de pantalla de la configuración de conexión en línea de Cognite Data Fusion (OData).

  3. En la sección Credenciales de conexión:

    • Si se conecta a CDF por primera vez, seleccione Crear nueva conexión del menú desplegable de Conexión.
    • Si se ha conectado anteriormente, puede seleccionar una conexión existente del menú desplegable Conexión.
    • Para la puerta de enlace de datos: si su organización usa una puerta de enlace para acceder a CDF, seleccione la puerta de enlace adecuada en el menú desplegable. Si la puerta de enlace de datos está establecida en (ninguno), el conector usa el servicio Power BI para conectarse directamente a CDF.
    • También puede seleccionar el nivel de privacidad de la conexión de datos en esta fase.
    • Para las nuevas conexiones, seleccione Iniciar sesión y siga el proceso de autenticación.

    Captura de pantalla de las credenciales de conexión en línea de Cognite Data Fusion (OData).

  4. Una vez que inicie sesión correctamente, seleccione Siguiente.

  5. En la sección Elegir datos, seleccione los datos que necesita y, a continuación, seleccione Crear para abrir el editor de Power Query y recuperar datos de CDF.

    Captura de pantalla del navegador en línea de Power Query que muestra las tablas disponibles.

Información adicional