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

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019

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

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

Power BI ejecutar consultas de 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 agregar previamente 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 errores de compilación. Las agregaciones se logran en el lado servidor y solo se devuelven los valores agregados a Power BI. Con la agregación previa, puede llevar a cabo 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

  • Debe ser miembro de un proyecto con acceso básico o superior. Si no se ha agregado como miembro del proyecto, ahora se agrega. Cualquier persona con acceso al proyecto, excepto las partes interesadas, puede ver las vistas de Analytics.
  • Para que los datos de Analytics estén disponibles, se debe habilitar el servicio correspondiente. Por ejemplo, para consultar los datos de seguimiento del trabajo, Boards debe estar habilitado. Si está deshabilitada, no se mostrarán las vistas de Analytics. Para volver a habilitar un servicio, consulte Activación o desactivación Azure DevOps servicio de mantenimiento
  • Para usar vistas de Analytics,habilite la característica de vista previa Vistas de análisis para usuarios individuales o para la organización.
  • Además, debe tener el permiso *View Analytics establecido en Permitir. Para más información, consulte Concesión de permisos para acceder al servicio Analytics.
  • Para usar Power BI para Azure DevOps o para ejecutar una consulta de OData para Analytics, debe tener el permiso de View Analytics establecido en Permitir. De forma predeterminada, se concede acceso a todos los colaboradores con acceso Básico. Para editar vistas compartidas de Analytics,debe tener el permiso * Editar vistascompartidas de Analytics establecido en Permitir. Para más información, consulte Concesión de permisos para acceder al servicio Analytics.
  • Debe ser miembro de un proyecto con acceso básico o superior. Si no se ha agregado como miembro del proyecto, ahora se agrega. Cualquier persona con acceso al proyecto, excepto las partes interesadas, puede ver las vistas de Analytics.
  • Compruebe que Analytics está instalado y, si no es así, habilite esta opción. Debe ser propietario de la cuenta o miembro del grupo administrador de Project recopilación para agregar extensiones o habilitar el servicio.
  • Para que los datos de Analytics estén disponibles, se debe habilitar el servicio correspondiente. Por ejemplo, para consultar los datos de seguimiento del trabajo, Boards debe estar habilitado. Si está deshabilitada, no se mostrarán las vistas de Analytics. Para volver a habilitar un servicio, consulte Activación o desactivación Azure DevOps servicio de mantenimiento
  • Para usar vistas de Analytics,habilite la característica de vista previa Vistas de análisis para usuarios individuales o para la organización.
  • Además, debe tener el permiso *View Analytics establecido en Permitir. Para más información, consulte Concesión de permisos para acceder al servicio Analytics.
  • Para usar Power BI para Azure DevOps o para ejecutar una consulta de OData para Analytics, debe tener el permiso de View Analytics establecido en Permitir. De forma predeterminada, se concede acceso a todos los colaboradores con acceso Básico. Para editar vistas compartidas de Analytics,debe tener el permiso Editar vistas compartidas de Analytics establecido en Permitir. Para más información, consulte Concesión de permisos para acceder al servicio Analytics.

Uso 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.

Instalar Visual Studio Code

Para descargar e instalar Visual Studio Code, vaya a la página Visual Studio Code descargar.

Instalación de la extensión OData

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

Creación de un archivo .odata

En Visual Studio Code, cree y guarde un archivo denominado filename.odata. Puede darle el nombre que quiera, pero debe tener una extensión .odata para habilitar la funcionalidad de extensión OData.

Escritura de la consulta de OData

Escriba la consulta OData. Para consultas de ejemplo, revise la Información general de los informes de ejemplo mediante consultas de OData.

La consulta siguiente devuelve los 10 elementos de trabajo principales en una ruta de acceso de área específica. 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 consultar entre proyectos, omita /{project} completamente.

Para obtener más información sobre cómo escribir consultas de OData en Analytics, vea Referencia rápida de consultas de OData.

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

Visual Studio Code OData extension - syntax highlighting

Prueba de la consulta de OData

Para probar la consulta de OData, coloque el cursor en cualquier lugar del texto de la consulta y seleccione Ver paletade comandos. En el cuadro de búsqueda, escriba odata para abrir todos los comandos de OData:

Visual Studio Code OData extension - Command Palette

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

El conjunto de resultados de la consulta 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.

Visual Studio Code OData extension - JSON output

Si la consulta tiene un error, el servicio Analytics devuelve un error en formato JSON. Por ejemplo, este error indica que la consulta ha seleccionado un campo que no existe:

Visual Studio Code OData extension - JSON error

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

Ejecute la consulta de OData desde Power BI

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

Antes de usar la consulta en Power BI, debe convertir la consulta 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 multilínea y, a continuación, ejecutar OData: Combinar en la copia. Esto se hace porque no hay ninguna manera de volver a convertir la consulta de una sola línea en una consulta multilínea legible.

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

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

Visual Studio Code OData extension - Combine to single-line query

Copie toda la línea para usarla en la sección siguiente.

Ejecute la consulta desde Power BI

Abra Power BI, seleccione Obtener datosy, a continuación, seleccione el conector de fuente OData. Para obtener más información, vea Crear un Power BI con una consulta de OData.

Power BI -

En la ventana de 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 - OData Feed - Paste in query

Power BI muestra una página de vista previa:

Power BI - OData Feed - Power BI Data Preview

Especificar opciones de consulta

En la página de vista previa, seleccione Editar para abrir Power Query Editor.

Power BI - OData Feed - Power Query Editor

En la cinta de opciones, seleccione Editor avanzado.

Power BI - OData Feed - Select Advanced Editor

En el panel Consulta, desplácese horizontalmente para ver el parámetro .

Power BI - OData Feed - Advanced Editor - Scroll Right

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

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

Replace the string.

Nota

Las siguientes acciones ayudan a realizar esta medida preventiva:

Evite errores de limitación. Power Query intenta resolver valores NULL como errores generando una consulta adicional para cada valor NULL que encuentre. Esto puede dar lugar a miles de consultas, lo que superará rápidamente el umbral de uso, más allá del cual se limitará la cuenta de usuario.

Para evitar este problema:

  • Indique a Power BI que haga referencia a OData v4.
  • Indique al servicio Analytics que omita los valores null, lo que mejora el rendimiento de las consultas.

Nota

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

Seleccione Aceptar para cerrar el Editor avanzado y volver al Editor de Power BI Power Query. Puede usar el editor Power Query para realizar estas acciones opcionales:

  • Cambie el nombre de la consulta "Query1" por 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 la columna a un tipo de datos específico.
  • Agregue columnas calculadas.
  • Quitar columnas.
  • Expanda las columnas en campos específicos.

Creación de un informe mediante los datos

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

Power BI