Conexión a datos mediante consultas de Power BI y OData

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Para extraer datos en Power BI, se recomienda usar consultas de Open Data Protocol (OData). OData es un estándar OASIS aprobado por ISO/IEC que define los procedimientos recomendados para compilar y consumir API REST. Para obtener más información, consulte la documentación de OData.

Para empezar a trabajar rápidamente, consulte Información general de informes de ejemplo que usan consultas de OData. Para obtener información sobre otros enfoques, consulte la introducción a la integración de Power BI.

Power BI puede ejecutar consultas OData, que pueden devolver un conjunto filtrado o agregado de datos a Power BI. Las consultas de OData tienen dos ventajas:

  • Todo el filtrado se realiza en el lado servidor. Solo se devuelven los datos que necesita, lo que conduce a tiempos de actualización más cortos.
  • Puede preagregar datos del lado servidor. Una consulta de OData puede llevar a cabo agregaciones como la acumulación de elementos de trabajo y las tasas de error de compilación. Las agregaciones se realizan en el lado servidor y solo se devuelven los valores agregados a Power BI. Con la agregación previa, puede realizar agregaciones en grandes conjuntos de datos, sin necesidad de extraer todos los datos detallados en Power BI.

En este artículo aprenderá a:

  • Escribir y probar consultas de OData.
  • Ejecute una consulta de OData desde Power BI.

Requisitos previos

  • Para ver los datos de Analytics y consultar el servicio, debe ser miembro de un proyecto con acceso básico o superior. De forma predeterminada, a todos los miembros del proyecto se les conceden permisos para consultar Analytics y definir vistas de Analytics.
  • Para obtener información sobre otros requisitos previos relacionados con las actividades de habilitación de características y servicios y seguimiento de datos generales, consulte Permisos y requisitos previos para acceder a Analytics.

Uso de Visual Studio Code para escribir y probar consultas de OData

La manera más fácil de escribir y probar OData es usar Visual Studio Code con la extensión OData. Visual Studio Code es un editor de código gratuito disponible en Windows, Mac y Linux. La extensión OData proporciona resaltado de sintaxis y otras funciones que son útiles para escribir y probar consultas.

Instalación de Visual Studio Code y la extensión OData

  1. Instale Visual Studio Code.

  2. Abra Visual Studio Code, seleccione Extensiones y busque odata. En la lista de resultados, seleccione vscode-odata y, a continuación, instálelo.

  3. Cree y guarde un archivo OData en Visual Studio Code, por ejemplo, filename.odata. Asígnele el nombre que quiera, pero debe tener una .odata extensión para habilitar la funcionalidad de extensión OData.

Escritura de la consulta OData

  1. Escriba la consulta OData. Para ver consultas de ejemplo, consulte Información general de informes de ejemplo que usan consultas de OData.

    La consulta siguiente devuelve los 10 elementos de trabajo principales en una ruta de acceso de área específica.

  2. Reemplace {organization}, {project} y {area path} por sus valores.

    https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
    $select=WorkItemId,Title,WorkItemType,State,CreatedDate
    &$filter=startswith(Area/AreaPath,'{area path}')
    &$orderby=CreatedDate desc
    &$top=10

    Para realizar consultas entre proyectos, omita /{project} completamente.

Para obtener más información, consulte Referencia rápida de consultas de OData.

Después de escribir la consulta en Visual Studio Code, debería ver el resaltado de sintaxis.

Captura de pantalla que muestra la extensión OData de Visual Studio Code con resaltado de sintaxis.

Prueba de la consulta de OData

  1. Para probar la consulta OData, coloque el cursor en cualquier lugar del texto de la consulta y seleccione Ver>paleta de comandos.

  2. En el cuadro de búsqueda, escriba odata para abrir todos los comandos de OData.

    Captura de pantalla que muestra la paleta de comandos de la extensión OData de Visual Studio Code.

  3. Seleccione OData: Abrir. Esta acción combina la consulta de varias líneas en una dirección URL de una línea y la abre en el explorador predeterminado.

    • El conjunto de resultados de la consulta de OData está en formato JSON. Para ver los resultados, instale la extensión formateador JSON para el explorador. Hay varias opciones disponibles para Chrome y Microsoft Edge.

      Captura de pantalla que muestra la salida JSON de la extensión OData de Visual Studio Code.

    • Si la consulta tiene un error, el servicio Analytics devuelve un error en formato JSON. Por ejemplo, este error indica que la consulta seleccionó un campo que no existe.

      Captura de pantalla que muestra el error JSON de la extensión OData de Visual Studio Code.

Después de comprobar que la consulta funciona correctamente, puede ejecutarla desde Power BI.

Ejecución de la consulta de OData desde Power BI

Para ejecutar la consulta de OData desde Power BI, siga los pasos de la sección siguiente.

Combinación de la consulta OData de varias líneas en una consulta de una sola línea

Antes de usar la consulta en Power BI, debe convertir la consulta de OData multilínea en una consulta de una sola línea. La manera más sencilla de hacerlo es usar Visual Studio Code con la extensión OData y usar el comando OData: Combine .

Nota:

En el archivo filename.odata , es posible que desee crear primero una copia del texto de consulta de varias líneas y, a continuación, ejecutar OData: Combine en la copia. Realice este paso en primer lugar porque no hay ninguna manera de volver a convertir la consulta de una sola línea en una consulta multilínea legible.

  1. En Visual Studio Code, coloque la consulta en cualquier lugar del texto de la consulta y, a continuación, seleccione Ver>paleta de comandos. En el cuadro de búsqueda, escriba odata. A continuación, en la lista de resultados, seleccione OData: Combine.

    La consulta de varias líneas se convierte en una consulta de una sola línea.

    Captura de pantalla que muestra la extensión OData de Visual Studio Code combinada con una consulta de una sola línea.

  2. Copie toda la línea para su uso en la sección siguiente.

Ejecución de la consulta desde Power BI

  1. Seleccione Obtener fuente OData de datos>. Para obtener más información, consulte Creación de un informe de Power BI con una consulta de OData.

    Captura de pantalla que muestra el comando fuente de OData de Power BI.

  2. En la ventana fuente de OData , en el cuadro DIRECCIÓN URL , pegue la consulta de OData que copió en la sección anterior y, a continuación, seleccione Aceptar.

    .

    Power BI muestra una página de vista previa.

    Captura de pantalla que muestra la página de vista previa de la fuente OData de Power BI.

Especificar opciones de consulta

  1. Seleccione Editar en la página de vista previa para abrir Editor de Power Query.

    Captura de pantalla que muestra Editor de Power Query abrir para la fuente OData de Power BI.

  2. Seleccione Editor avanzado en la cinta de opciones.

    Captura de pantalla que muestra Editor avanzado seleccionada para la fuente OData de Power BI.

  3. Desplácese horizontalmente para ver el [Implementation="2.0"] parámetro en el panel Consulta .

    Captura de pantalla que muestra la fuente OData de Power BI con el Editor avanzado desplazado a la derecha.

  4. Reemplace por [Implementation="2.0"] la cadena siguiente:

    [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]

    Captura de pantalla que muestra la cadena de reemplazo.

    Nota:

    Para evitar errores de limitación, realice las siguientes acciones:

    • Indique a Power BI que haga referencia a OData v4.
    • Indique al servicio Analytics que omita los valores que sean NULL, lo que mejora el rendimiento de las consultas. Power Query intenta resolver valores NULL como errores mediante la generación de otra consulta para cada valor NULL que encuentra. Esta acción puede dar lugar a miles de consultas, lo que supera rápidamente el umbral de uso, más allá del cual se limita la cuenta de usuario.

    La siguiente acción es necesaria para que Power BI ejecute correctamente una consulta de OData en azure DevOps Analytics Service.

  5. Seleccione Aceptar para cerrar el Editor avanzado y volver a Power BI Editor de Power Query. Puede usar Editor de Power Query para realizar las siguientes acciones opcionales:

    • Cambie el nombre de la Query1 consulta como algo más específico.
    • Transformar columnas en un tipo específico. Power BI detecta automáticamente el tipo, pero es posible que desee convertir columnas en un tipo de datos específico.
    • Agregue columnas calculadas.
    • Quitar columnas.
    • Expanda columnas en campos específicos.

Creación de un informe mediante los datos

Seleccione Cerrar y aplicar para guardar la configuración y extraer los datos en Power BI. Una vez que se actualicen los datos, puede crear un informe como lo haría normalmente en Power BI.

Captura de pantalla que muestra el botón Cerrar y aplicar de Power BI.