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

Azure DevOps Services | Azure DevOps Server 2022: 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 ISO/IEC aprobado por OASIS 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, consulte 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 agregar previamente el lado servidor de datos. 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

  • Debe ser miembro de un proyecto con acceso básico o superior. Si no se ha agregado como miembro del proyecto, se agrega ahora. Cualquier persona con acceso al proyecto, excepto las partes interesadas, puede ver las vistas de Análisis.
  • 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, los paneles deben estar habilitados . Si está deshabilitado, no se mostrarán las vistas de Analytics . Para volver a habilitar un servicio, consulte Activación o desactivación de un servicio de Azure DevOps.
  • Para usar las vistas de Analytics, habilite la característica vista previa de vistas de Análisis para usuarios individuales o para la organización.
  • Además, debe tener el permiso *Ver 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 ejercer una consulta de OData para Analytics, debe tener el permiso View Analytics establecido en Permitir. De forma predeterminada, se concede acceso a todos los colaboradores con acceso básico. Para editar las vistas de Análisis compartidas, debe tener el permiso *Editar vistas de Análisis compartidas 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, se agrega ahora. Cualquier persona con acceso al proyecto, excepto las partes interesadas, puede ver las vistas de Análisis.
  • Compruebe que Analytics está instalado y, si no es así, habilitelo. Debe ser propietario de la cuenta o miembro del grupo Administradores de colecciones de proyectos 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, los paneles deben estar habilitados . Si está deshabilitado, no se mostrarán las vistas de Analytics . Para volver a habilitar un servicio, consulte Activación o desactivación de un servicio de Azure DevOps.
  • Para usar las vistas de Analytics, habilite la característica vista previa de vistas de Análisis para usuarios individuales o para la organización.
  • Además, debe tener el permiso *Ver 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 ejercer una consulta de OData para Analytics, debe tener el permiso View Analytics establecido en Permitir. De forma predeterminada, se concede acceso a todos los colaboradores con acceso básico. Para editar las vistas de Análisis compartidas, debe tener establecido el permiso Editar vistas de Análisis compartido en Permitir. Para más información, consulte Concesión de permisos para acceder al servicio 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

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

Instalación de la extensión OData

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

Creación de un archivo .odata

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

Escritura de la consulta de OData

Escriba la consulta de OData. Por ejemplo, consulte 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 realizar consultas entre proyectos, omita /{project} por completo.

Para obtener más información sobre cómo escribir consultas de OData en Analytics, 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:

Visual Studio Code extensión OData: resaltado de sintaxis

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>paleta de comandos. En el cuadro de búsqueda, escriba odata para mostrar todos los comandos de OData:

extensión Visual Studio Code OData: paleta de comandos

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.

Visual Studio Code extensión OData: salida JSON

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 extensión OData: error JSON

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

Ejecución de la consulta de OData desde Power BI

Combinar la consulta de 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 quiera crear primero una copia del texto de consulta de varias líneas y, a continuación, ejecutar OData: Combine en la copia. Esto se debe a que 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 seleccione Ver>paleta de comandos. En el cuadro de búsqueda, escriba odata y, 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.

Visual Studio Code extensión de OData: combinación con una consulta de una sola línea

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

Ejecución de la consulta desde Power BI

Abra Power BI, seleccione Obtener datos y, a continuación, seleccione el conector de fuente de OData . Para más información, consulte Creación de un informe de Power BI con una consulta de OData.

Power BI: comando

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: fuente de OData: pegar una consulta

Power BI muestra una página de vista previa:

Power BI: fuente de OData: versión preliminar de datos de Power BI

Especificar opciones de consulta

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

Power BI: fuente de OData: Editor de Power Query

En la cinta de opciones, seleccione Editor avanzado.

Power BI: fuente de OData: selección de Editor avanzado

En el panel Consulta , desplácese horizontalmente para ver el [Implementation="2.0"] parámetro.

Power BI- Fuente OData - Editor avanzado - Desplazarse a la derecha

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

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

Reemplace la cadena.

Nota

Las siguientes acciones ayudan a realizar esta medida preventiva:

Evitar errores de limitación. Power Query intenta resolver valores NULL como errores mediante la generación de una consulta adicional para cada valor NULL que encuentra. 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 que Power BI ejecute correctamente una consulta de OData en el servicio Azure DevOps Analytics.

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

  • Cambie el nombre de la consulta "Query1" 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 la columna 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 & 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.

Botón