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

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

Para extraer datos en Power BI, se recomienda usar consultas de Open Data Protocol (OData). OData es un estándar establecido por la Organización para el Avance de las Normas de Información Estructurada (OASIS) y aprobado por la Organización Internacional de Normalización y la Comisión Electrotécnica Internacional (ISO/IEC). OData 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 Introducción a los informes de ejemplo mediante consultas de OData. Para obtener información sobre otros enfoques, consulte Acerca de 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. Mediante 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 tutorial, usted hará lo siguiente:

Requisitos previos

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, instale esta extensión.

3. En Visual Studio Code, cree un archivo OData mediante la creación de un archivo vacío que tenga la extensión .odata. Puede asignarle el nombre que quiera, por ejemplo, filename.odata. Pero debe tener una extensión .odata para habilitar la funcionalidad de extensión OData.

Escritura de la consulta OData

Escriba la consulta OData. Para ver consultas de ejemplo, consulte Información general de 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. Para usar esta consulta, 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 Informes de ejemplo y índice de referencia rápido.

Después de escribir la consulta en Visual Studio Code, debería ver el 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, a continuación, seleccione Ver>paleta de comandos.

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

   

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

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

     

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

     

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 descritos en las secciones siguientes.

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. Para usar el comando OData: Combine para este propósito, siga estos pasos:

1. Realice una copia del archivo OData que contenga el texto de consulta multilínea. Este paso se recomienda, ya que no hay ninguna manera de volver a convertir la consulta de una sola línea en una consulta de varias líneas legible.

2. En Visual Studio Code, abra la copia del archivo OData y coloque el cursor en cualquier lugar del texto de la consulta.

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

   

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

Ejecución de la consulta desde Power BI

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

   

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

   

   Power BI muestra una página de vista previa.

   

Especificar opciones de consulta

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

   

2. En la cinta de opciones, seleccione Editor avanzado.

   

3. En la ventana Editor avanzado, desplácese horizontalmente para ver el [Implementation="2.0"] parámetro en la consulta.

   

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

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

   

   Este cambio ayuda a evitar errores de limitación. Los nuevos valores tienen el siguiente efecto:

   • Indican a Power BI que haga referencia a la versión 4 de OData.
   • Indican 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. Estas consultas pueden superar rápidamente el umbral de uso, más allá del cual se limita la cuenta de usuario.

5. Seleccione Listo para cerrar el Editor avanzado y volver al Editor de Power Query de Power BI. 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 hace normalmente en Power BI.

Contenido relacionado

• Datos disponibles en Analytics
• Establecer permisos para acceder a Analytics y a las vistas de Analytics
• Acerca de la integración de Power BI