Visualizar datos de Azure Cosmos DB for NoSQL con Power BI

Conozca cómo conectar datos de Azure Cosmos DB a Power BI Desktop y a crear informes detallados para elaborar información empresarial de utilidad.

Conectando

Conéctese a Azure Cosmos DB a través de Power BI Desktop mediante una de estas opciones:

• Usa Reflejo en Microsoft Fabric para replicar datos de Azure Cosmos DB en Fabric OneLake. Al realizar cambios en la base de datos, las modificaciones se envían rápidamente a Fabric OneLake. Este proceso no ralentiza la base de datos principal ni usa recursos adicionales. Los informes de Power BI acceden a los datos directamente a través de OneLake con el modo DirectLake. Con las funciones mejoradas de Copilot en Power BI dentro de Fabric, haga uso de la inteligencia artificial generativa para obtener información empresarial clave.

• Use Azure Synapse Link para crear informes de Power BI sin que afecten a los costes o al rendimiento de las cargas de trabajo transaccionales, así como sin canalizaciones de extracción, transformación y carga (ETL). Puede usar el modo DirectQuery o el modo de importación. Con DirectQuery, puede crear paneles o informes con datos en directo desde sus cuentas de Azure Cosmos DB, sin importar ni copiar los datos en Power BI.

• Conecte Power BI Desktop a la cuenta de Azure Cosmos DB mediante el conector de Azure Cosmos DB para Power BI. Esta opción solo está disponible en modo de importación y consumirá las unidades de solicitud (RU) asignadas a las cargas de trabajo transaccionales.

Prerequisites

Antes de seguir las instrucciones de este tutorial de Power BI, asegúrese de que tiene acceso a estos recursos:

• Descargue la versión más reciente de Power BI Desktop

• Cree una cuenta de base de datos de Azure Cosmos DB y agregue datos a los contenedores de Azure Cosmos DB.

Para compartir los informes en PowerBI.com, es necesario tener una cuenta en PowerBI.com. Para más información sobre Power BI y Power BI Pro, visite https://powerbi.microsoft.com/pricing.

Creación de informes de BI mediante la creación de reflejos en Microsoft Fabric

Habilite la duplicación en los contenedores de Azure Cosmos DB existentes para compilar informes o paneles de BI en estos datos casi en tiempo real. Para verlas instrucciones sobre cómo empezar a trabajar con Fabric y la duplicación, vea el tutorial sobre duplicación de Azure Cosmos DB.

Creación de informes de BI mediante Azure Synapse Link

Puede habilitar Azure Synapse Link en los contenedores de Azure Cosmos DB existentes y crear informes de BI sobre estos datos fácilmente a través del portal de Azure Cosmos DB. Power BI se conecta a Azure Cosmos DB con el modo Direct Query, lo que le permite consultar en tiempo real los datos de Azure Cosmos DB, sin afectar a las cargas de trabajo transaccionales.

Para crear un informe o panel de Power BI:

1. Inicie sesión en Azure Portal y vaya a su cuenta de Azure Cosmos DB.

2. En la sección Integrations (Integraciones), abra el panel Power BI y seleccione Get started (Introducción).

   Note

   Actualmente, esta opción está disponible solo para las cuentas API para NoSQL. Puede crear vistas de T-SQL directamente en grupos de SQL sin servidor de Synapse y crear paneles de BI para Azure Cosmos DB for MongoDB. Para obtener más información, consulte Uso de Power BI y grupos de Synapse SQL sin servidor para analizar los datos de Azure Cosmos DB mediante Synapse Link.

3. En la pestaña Enable Azure Synapse Link (Habilitar Azure Synapse Link) puede habilitar Azure Synapse Link en la cuenta a través de la sección Enable Azure Synapse link for this account (Habilitar Azure Synapse Link para esta cuenta). Si ya tiene habilitado Azure Synapse Link en su cuenta, no podrá ver esta pestaña. Este paso es un requisito previo para habilitar Synapse Link en los contenedores.

   Note

   Habilitar Azure Synapse Link tiene implicaciones de costo. Para obtener más información, consulte Precios de Azure Synapse Link.

4. Junto a la sección Enable Azure Synapse Link for your containers (Habilitar Azure Synapse Link para los contenedores), elija los contenedores necesarios para habilitar Azure Synapse Link.

   • Si ya ha habilitado Azure Synapse Link en algunos contenedores, verá marcada la casilla situada junto al nombre del contenedor. Podría desmarcarla, en función de los datos que quiera visualizar en Power BI.

   • Si Azure Synapse Link no está habilitado, puede habilitar esta función en los contenedores existentes. Si hay una habilitación en curso de Azure Synapse Link en cualquiera de los contenedores, los datos de esos contenedores no se incluirán. Debe volver a esta pestaña más adelante e importar datos cuando los contenedores estén habilitados.

   

5. Según la cantidad de datos de los contenedores, la habilitación de Azure Synapse Link puede tardar un poco. Para obtener más información, consulte el artículo Habilitar Azure Synapse Link en contenedores existentes.

   Puede comprobar el progreso en el portal como se muestra en la pantalla siguiente. Los contenedores se habilitan con Azure Synapse Link cuando el progreso alcanza el 100 %.

   

6. En la pestaña Select workspace (Seleccionar área de trabajo), elija el área de trabajo de Azure Synapse Analytics y seleccione Siguiente. En este paso se creará automáticamente vistas de T-SQL en Synapse Analytics para los contenedores seleccionados anteriormente. Para obtener más información sobre las vistas T-SQL necesarias para conectar su Azure Cosmos DB a Power BI, vea el artículo Preparar vistas.

   Note

   Las propiedades del contenedor de Azure Cosmos DB se representan como columnas en vistas de T-SQL, incluidos los datos JSON anidados profundos. Esta representación es un modo de inicio rápido de los paneles de BI. Estas vistas están disponibles en el área de trabajo o la base de datos de Synapse; también puede usar estas mismas vistas en el área de trabajo de Synapse para la exploración de datos, la ciencia de datos o la ingeniería de datos. En contextos avanzados, se podrían necesitar vistas más complejas o ajustar estas vistas para mejorar el rendimiento. Para más información. Consulte el artículo Prácticas recomendadas de Azure Synapse Link al usar grupos de SQL de Synapse sin servidor.

7. Elija un área de trabajo existente o cree uno. Para seleccionar un área de trabajo existente, proporcione los detalles de Suscripción, Área de trabajo y Base de datos. Azure Portal usa sus credenciales de Microsoft Entra para conectarse automáticamente al área de trabajo de Synapse y crear vistas de T-SQL. Asegúrese de que tiene permisos de "administrador de Synapse" para esta área de trabajo.

   

8. A continuación, seleccione Descargar .pbids para descargar el archivo de origen de datos de Power BI. Abra el archivo que ha descargado. Contiene la información de conexión necesaria y abre Power BI Desktop.

   

9. Ahora puede conectarse a los datos de Azure Cosmos DB desde Power BI Desktop. Se muestra una lista de vistas T-SQL correspondientes a los datos de cada contenedor.

   Por ejemplo, en la pantalla siguiente se muestran los datos de la flota de vehículos. Puede cargar estos datos para analizarlo o transformarlo antes de cargarlo.

   

10. Ahora puede empezar a crear el informe mediante datos analíticos de Azure Cosmos DB. Los cambios en los datos no se reflejarán en el informe, tan pronto como los datos se replican en el almacén analítico, lo que suele ocurrir en un par de minutos.

Creación de informes de BI mediante el conector de Power BI

Actualmente, la conexión a Azure Cosmos DB con el conector de Power BI solo se admite en las cuentas de Azure Cosmos DB for NoSQL y API para Gremlin.

1. Ejecute Power BI Desktop.

2. También puede obtener datos, consultar orígenes recientes o abrir otros informes directamente desde la pantalla de bienvenida. Seleccione la opción "X" para cerrar la pantalla. Se muestra la vista Informe de Power BI Desktop.

   

3. Seleccione la cinta de opciones Inicio y luego elija Obtener datos. Se muestra la pantalla Obtener datos .

4. Seleccione Azure, Azure Cosmos DB (Beta) y luego Conectar.

   

5. En la página Vista previa del conector, seleccione Continuar. Aparece la ventana de Azure Cosmos DB.

6. Indique la dirección URL del punto de conexión de la cuenta de Azure Cosmos DB de la que desea recuperar los datos y seleccione Aceptar. Para usar su propia cuenta, puede recuperar la dirección URL del cuadro de texto con el URI en la sección Claves de Azure Portal. Si lo prefiere, puede indicar el nombre de la base de datos, el nombre de la colección o usar el navegador para seleccionar la base de datos y la colección para identificar la procedencia de los datos.

7. Si se va a conectar a este punto de conexión por primera vez, se le pedirá las credenciales de la cuenta.

8. Con la cuenta conectada correctamente, aparece el panel Navegador. El panel Navegador muestra la lista de bases de datos que hay en la cuenta.

9. Seleccione la base de datos de donde proceden los datos del informe y expándala. Ahora, seleccione una colección que contenga los datos que recuperar.

   El panel de vista previa muestra una lista de elementos Registro . Un documento se representa como un tipo Registro en Power BI. De forma similar, un bloque JSON anidado dentro de un documento también es un Registro. Para ver los documentos de propiedades como columnas, seleccione el botón gris con dos flechas en direcciones opuestas que simbolizan la expansión del registro.

10. La vista de informe de Power BI Desktop es donde puede empezar a crear informes para visualizar datos. Cree informes arrastrando y soltando campos en el lienzo del informe .

11. Hay dos formas de actualizar los datos: de forma no planificada y de forma programada. Seleccione Actualizar ahora para actualizar los datos. Consulte la documentación de Power BI para obtener más información sobre la opción de actualización programada.

Problemas y limitaciones conocidos

• En el caso de los contenedores de Azure Cosmos DB con particiones, una consulta SQL con una función de agregado se pasa a Azure Cosmos DB si la consulta también contiene un filtro (cláusula WHERE) en la clave de partición. Si la consulta de funciones agregadas no incluye un filtro en la clave de partición, el conector realizará la agregación.

• El conector no pasa una función de agregado cuando sigue a TOP o LIMIT.

• Azure Cosmos DB procesa la operación TOP al final cuando procesa una consulta. Por ejemplo, en la consulta siguiente, TOP se aplica en la subconsulta, mientras que la función de agregado se aplica sobre ese conjunto de resultados:

  SELECT COUNT(1) FROM (SELECT TOP 4 - FROM EMP) E
  

• Si DISTINCT se incluye en una función de agregado, el conector no pasa la función de agregado a Azure Cosmos DB. DISTINCT en una función de agregado no lo admite Azure Cosmos DB for NoSQL.

• Para la función de agregado SUM, Azure Cosmos DB devuelve el valor "undefined" si alguno de los argumentos de SUM es string, boolean o null. Si hay valores null, el conector pasa la consulta a Azure Cosmos DB para reemplazar los valores null por cero durante el cálculo de SUM.

• Para la función de agregado AVG, Azure Cosmos DB devuelve "undefined" como un conjunto de resultados si alguno de los argumentos de SUM es string, boolean o null. El conector expone una propiedad de conexión para deshabilitar la eliminación de la función de agregado AVG a Azure Cosmos DB en caso de que se deba invalidar este funcionamiento predeterminado de Azure Cosmos DB. Cuando está deshabilitado el envío de AVG, no se pasará a Azure Cosmos DB y el conector controlará la ejecución de la operación de agregación de AVG. Para obtener más información, vaya a "Habilitar envío de la función AVERAGE" en Opciones avanzadas.

• Los contenedores de Azure Cosmos DB con clave de partición grande no se admiten en el conector.

• El envío de agregación está deshabilitado para la sintaxis siguiente debido a las limitaciones del servidor:

  • La consulta no se filtra en una clave de partición o cuando el filtro de clave de partición usa el operador OR con otro predicado en el nivel superior de la cláusula WHERE.

  • La consulta tiene una o varias claves de partición que aparecen en una cláusula IS NOT NULL en la cláusula WHERE.

• El conector V2 no admite tipos de datos complejos, como matrices, objetos y estructuras jerárquicas. Use la funcionalidad Crear duplicación de Azure Cosmos DB para estos casos.

• El conector V2 usa el muestreo de los primeros 1000 documentos para elaborar el esquema inferido. Este método no se recomienda en casos de evolución del esquema en los que solo se actualizan algunos documentos. Por ejemplo, es posible que una propiedad recién agregada a un documento de un contenedor con miles de documentos no se incluya en el esquema inferido. Recomendamos la función Creación de reflejo en Fabric para Azure Cosmos DB para esos escenarios.

• El conector V2 no admite valores que no sean de cadena en las propiedades del objeto.

• El envío de filtrado está deshabilitado en la sintaxis siguiente por las limitaciones del servidor:

  • Cuando se hace referencia a la consulta que contiene una o varias columnas de agregado en la cláusula WHERE

Contenido relacionado

• Obtenga más información sobre Power BI en Introducción a Power BI.
• Obtenga más información sobre Azure Cosmos DB en la página de destino con la documentación de Azure Cosmos DB.