Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Con Cosmos DB en Microsoft Fabric, puede crear informes interactivos de Power BI mediante los datos NoSQL. En esta guía se tratan dos enfoques para conectar Power BI a la base de datos de Cosmos DB en Fabric:
- SQL analytics endpoint (a través de OneLake): Utilice los datos reflejados a través del SQL analytics endpoint en modo DirectLake para un rendimiento óptimo sin consumo de RU.
- Conector de Azure Cosmos DB v2: conexión directa a la base de datos mediante el conector de Power BI con el modo DirectQuery o Importación
Cada enfoque ofrece ventajas distintas. El punto de conexión de SQL Analytics se recomienda para la mayoría de los escenarios de producción, mientras que el conector de Azure Cosmos DB v2 proporciona flexibilidad para los informes en tiempo real y el acceso directo a la base de datos.
Prerrequisitos
Una capacidad existente de Fabric
- Si no tiene capacidad de Fabric, inicie una versión de prueba de Fabric.
Una base de datos de Cosmos DB existente en Fabric
- Si aún no tiene una, cree una base de datos de Cosmos DB en Fabric.
Un contenedor existente con datos
- Si aún no tiene una, se recomienda cargar el contenedor de datos de ejemplo.
Importante
Para esta guía, la base de datos de Cosmos DB existente tiene el conjunto de datos de ejemplo ya cargado. En los ejemplos restantes se supone que usa el mismo conjunto de datos.
Elección del enfoque de informes
Seleccione el enfoque que mejor se adapte a sus requisitos:
| Caso de uso | Enfoque recomendado |
|---|---|
| Tipos de datos complejos (matrices, objetos, estructuras anidadas) | Punto de conexión de análisis SQL |
| Sin consumo de recursos de base de datos (RU) | Punto de conexión de análisis SQL |
| Evolución dinámica del esquema | Punto de conexión de análisis SQL |
| Datos en tiempo real con consultas directas de base de datos | Conector de Azure Cosmos DB v2 (DirectQuery) |
| Flujos de trabajo del conector de Power BI existentes | Conector de Azure Cosmos DB v2 |
Enfoque 1: Elaboración de informes mediante el endpoint de SQL Analytics
El punto de conexión de SQL Analytics proporciona acceso a datos reflejados en OneLake, lo que le permite compilar informes de Power BI con el modo DirectLake. Este enfoque ofrece un rendimiento óptimo sin consumir RU de base de datos y admite tipos de datos complejos, como matrices, objetos y estructuras jerárquicas.
Para obtener más información sobre los modos de modelo semántico en Power BI, consulte Modos de modelo semántico en el servicio Power BI.
Verificar la replicación de espejo
Antes de generar informes, asegúrese de que la replicación se haya completado exitosamente al menos una vez:
En el portal de Fabric (https://app.fabric.microsoft.com), acceda a su base de datos de Cosmos DB.
En la vista de base de datos, busque la pestaña Replicación y seleccione Supervisar replicación.
Compruebe que el estado de replicación se muestra como En ejecución o Completado y que los datos se han replicado correctamente en OneLake.
Importante
Si el reflejo no se ha completado al menos una vez, el endpoint de SQL Analytics no tendrá datos disponibles para los informes. Compruebe el panel de supervisión de replicación para ver si hay errores o operaciones pendientes.
Configuración del modelo semántico
Una vez que la creación de reflejo se haya completado correctamente, configure el modelo semántico:
En la barra de menús, seleccione la lista de Cosmos DB y, a continuación, seleccione Punto de conexión de SQL para cambiar al punto de conexión de SQL Analytics.
Seleccione la pestaña Informes .
En la cinta de opciones, seleccione Nuevo modelo semántico.
Seleccione las tablas que desea incluir en el informe.
Haga clic en Guardar.
Nota:
De forma predeterminada, los modelos semánticos están vacíos. Si omite este paso, cualquier intento de crear un informe de Power BI produce un error debido a un modelo semántico vacío.
Para más información sobre los modelos semánticos en Power BI, consulte Modelos semánticos en el servicio Power BI.
Creación y diseño del informe
Una vez configurado el modelo semántico, cree el informe de Power BI:
En la pestaña Informes , seleccione Nuevo informe.
Seleccione Continuar para abrir Power BI con el modelo semántico configurado.
En el editor de Power BI, arrastre campos desde el panel Datos al lienzo del informe.
Seleccione visualizaciones en el panel Visualizaciones para crear gráficos, tablas y otros elementos de informe.
Opcionalmente, use Copilot para generar sugerencias de informe:
- Seleccione Copilot en el menú.
- Seleccione Sugerir contenido para una nueva página de informe.
- Revise las sugerencias y seleccione Crear para agregarlas.
Sugerencia
También puede crear informes seleccionando Seleccionar un modelo semántico publicado en la pestaña Crear del portal de Tejido o seleccionando Modelos semánticos de Power BI en Power BI Desktop.
Para obtener más información sobre cómo crear informes en Power BI, consulte Introducción a la creación en el servicio Power BI.
Enfoque 2: Compilación de informes mediante el conector de Azure Cosmos DB v2
El conector de Power BI de Azure Cosmos DB v2 permite la conexión directa a la base de datos de Cosmos DB en Fabric desde el servicio Power BI. Este enfoque admite DirectQuery para informes en tiempo real e modo de importación para cargas de datos programadas.
Importante
El conector de Azure Cosmos DB v2 consume unidades de solicitud (RUs) de tu base de datos. El modo DirectQuery genera consultas con cada interacción del informe, mientras que el modo de importación consume RU durante la actualización de datos. Para más información, consulte Limitaciones del conector de Azure Cosmos DB v2.
Conectarse a la base de datos
En el portal de Fabric (https://app.fabric.microsoft.com), navega a tu área de trabajo.
Seleccione la pestaña Crear de la barra de herramientas izquierda y, a continuación, seleccione Obtener datos.
Busque y seleccione Azure Cosmos DB v2.
Escriba la dirección URL del punto de conexión de la base de datos de Cosmos DB en Fabric (disponible en la configuración de la base de datos).
Cuando se le pida que se autentique, seleccione Cuenta organizativa, inicie sesión y seleccione Siguiente.
Nota:
La autenticación de clave de cuenta no se admite para Cosmos DB en Fabric.
En el panel Navegador , seleccione la base de datos y el contenedor que contienen los datos necesarios para el informe.
El panel Vista previa muestra una lista de elementos de registro . Cada documento se representa como un tipo de registro en Power BI. Los bloques JSON anidados dentro de los documentos también aparecen como tipos de registro .
Expanda las columnas de registro para ver las propiedades del documento y, a continuación, seleccione Crear un informe. Opcionalmente, puede seleccionar Crear un modelo semántico solo o Transformar datos.
Creación de visualizaciones
Después de cargar los datos:
En el nuevo artefacto Informe , arrastre campos desde el panel Datos al lienzo del informe.
Seleccione visualizaciones en el panel Visualizaciones para crear gráficos, tablas y otros elementos de informe.
Configure filtros, segmentaciones de datos y otros elementos interactivos para mejorar el informe.
Opcionalmente, use Copilot para la creación de informes asistidos por IA.
Descripción de los modos de conexión y la actualización de datos
El conector de Azure Cosmos DB v2 admite dos modos de conexión con diferentes comportamientos de actualización:
Modo de importación:
- Carga datos en la memoria de Power BI para un rendimiento rápido de las consultas
- Requiere una actualización manual o programada para actualizar los datos
- Ideal para grandes conjuntos de datos en los que se da prioridad a la velocidad de la consulta
Modo DirectQuery:
- Consulta la base de datos en tiempo real con cada interacción con el informe
- Muestra siempre los datos actuales sin necesidad de actualizar
- El rendimiento depende de la optimización de la base de datos y el uso de claves de partición para minimizar el consumo de RU.
Para más información sobre la actualización de datos en Power BI, consulte Actualización de datos en Power BI.
Sugerencia
Use el modo de importación para visualizaciones más rápidas con actualizaciones de datos programadas. Use el modo DirectQuery para los requisitos de datos en tiempo real con consultas optimizadas y filtros de clave de partición para minimizar el consumo de RU.
Para más información sobre las limitaciones al usar el conector de Azure Cosmos DB v2, consulte Limitaciones del conector de Azure Cosmos DB v2.
Comparación: SQL Analytics endpoint vs. conector de Azure Cosmos DB v2
| Característica | Punto de conexión de análisis SQL | Conector de Azure Cosmos DB v2 |
|---|---|---|
| acceso a datos | Datos reflejados a través de OneLake | Conexión directa a la base de datos |
| Modo de conexión | DirectLake (puede revertir a DirectQuery) | DirectQuery o Importar |
| Consumo de RU | Ninguno | Sí (especialmente DirectQuery) |
| Actualización de datos | Casi en tiempo real (latencia de creación de reflejo) | En tiempo real (DirectQuery) o programado (Importación) |
| Tipos de datos complejos | Compatible (matrices, objetos, anidados) | No está soportado |
| Evolución del esquema | Controla esquemas dinámicos | Limitado (primeros 1000 documentos) |
| Disponible en | Servicio Power BI, Power BI Desktop | Servicio Power BI, Power BI Desktop |
| Más adecuado para | BI de producción, datos complejos, sin impacto en RU | Consultas en tiempo real, acceso directo, esquemas simples |
Sugerencia
Para la mayoría de los escenarios de BI de producción con Cosmos DB en Fabric, se recomienda utilizar el enfoque del punto de conexión de SQL Analytics. Proporciona una mejor compatibilidad con tipos de datos complejos, no consume RU de base de datos y controla la evolución del esquema de forma más eficaz. Use el conector de Azure Cosmos DB v2 con el modo DirectQuery cuando necesite acceso a datos en tiempo real y tenga consultas optimizadas, o use el modo de importación para escenarios que requieren conectividad directa de base de datos fuera del flujo de trabajo de creación de reflejo de Fabric.