Tutorial: Configuración de la base de datos reflejada de Microsoft Fabric para Azure Cosmos DB

En este tutorial, configurará una base de datos reflejada de Fabric a partir de una cuenta existente de Azure Cosmos DB para NoSQL.

La creación de reflejo replica incrementalmente los datos de Azure Cosmos DB en Fabric OneLake casi en tiempo real, sin afectar al rendimiento de las cargas de trabajo transaccionales ni consumir unidades de solicitud (RU). Puede compilar informes de Power BI directamente en los datos de OneLake mediante el modo DirectLake. Puede ejecutar consultas ad hoc en SQL o Spark, crear modelos de datos mediante cuadernos y usar funcionalidades de inteligencia artificial integradas Copilot y avanzadas en Fabric para analizar los datos.

Prerrequisitos

• Una cuenta existente de Azure Cosmos DB para NoSQL.
  • Si no tiene una suscripción de Azure, pruebe Azure Cosmos DB para NoSQL gratis.
  • Si tiene una suscripción de Azure existente, cree una nueva cuenta de Azure Cosmos DB para NoSQL.
• Una capacidad de Fabric existente. Si no tiene una capacidad existente, inicie una versión de prueba de Fabric. Es posible que la creación de reflejo no esté disponible en algunas regiones de Fabric. Para obtener más información, consulte regiones admitidas.

Configuración de la cuenta de Azure Cosmos DB

En primer lugar, asegúrese de que la cuenta de Azure Cosmos DB de origen está configurada correctamente para usarla con la creación de reflejo de Fabric.

1. Vaya a la cuenta de Azure Cosmos DB en Azure Portal.

2. Asegúrese de que la copia de seguridad continua está habilitada. Si no está habilitado, siga la guía de migración de una cuenta de Azure Cosmos DB existente a la copia de seguridad continua para habilitar la copia de seguridad continua. Es posible que esta característica no esté disponible en algunos escenarios. Para obtener más información, consulte Limitaciones de la base de datos y de la cuenta.

3. Asegúrese de que las opciones de red están establecidas en acceso a la red pública para todas las redes. Si no es así, siga la guía de configuración del acceso de red a una cuenta de Azure Cosmos DB.

Creación de una base de datos reflejada

Ahora, cree una base de datos reflejada que sea el destino de los datos replicados. Para obtener más información, consulte Qué esperar de la creación de reflejo.

1. Vaya a la página principal del portal de Fabric .

2. Abra un área de trabajo existente o cree una nueva área de trabajo.

3. En el menú de navegación, seleccione Crear.

4. Seleccione Crear, busque la sección Almacén de Datos y, a continuación, seleccione Azure Cosmos DB Reflejado.

5. Proporcione un nombre para la base de datos reflejada y, a continuación, seleccione Crear.

Conexión a la base de datos de origen

A continuación, conecte la base de datos de origen a la base de datos reflejada.

1. En la sección Nueva conexión , seleccione Azure Cosmos DB para NoSQL.

2. Proporcione credenciales para la cuenta de Azure Cosmos DB para NoSQL, incluidos estos elementos:

   Credenciales de cuenta	Importancia
   Punto de conexión de Azure Cosmos DB	Punto de conexión de dirección URL de la cuenta de origen.
   Nombre de la conexión	Nombre único de la conexión.
   Tipo de autenticación	Seleccione Clave de cuenta o Cuenta organizativa.
   Clave de cuenta	Clave de lectura y escritura para la cuenta de origen.
   Cuenta organizativa	Token de acceso desde el identificador de Microsoft Entra.

   

   Nota:

   Para la autenticación de Id. de Microsoft Entra, se requieren los siguientes permisos de RBAC:

   • Microsoft.DocumentDB/databaseAccounts/readMetadata
   • Microsoft.DocumentDB/databaseAccounts/readAnalytics

   Para obtener más información, consulte la documentación del control de acceso basado en rol del plano de datos.

   Para obtener un ejemplo de un script que aplique automáticamente un control de acceso basado en funciones personalizado, consulte rbac-cosmos-mirror.sh en azure-samples/azure-cli-samples.

3. Seleccione Conectar. A continuación, seleccione una base de datos que se va a reflejar. Opcionalmente, seleccione contenedores específicos para reflejar.

Inicio del proceso de creación de reflejo

1. Seleccione Base de datos reflejada. Ahora comienza la creación de reflejo.

2. Espere de dos a cinco minutos. A continuación, seleccione Supervisar replicación para ver el estado de la acción de replicación.

3. Después de unos minutos, el estado debe cambiar a En ejecución, lo que indica que los contenedores se están sincronizando.

   Sugerencia

   Si no encuentra los contenedores y el estado de replicación correspondiente, espere unos segundos y actualice el panel. En raras ocasiones, es posible que reciba mensajes de error transitorios. Puede omitirlos de forma segura y continuar actualizando.

4. Cuando la creación de reflejo finaliza la copia inicial de los contenedores, aparece una fecha en la última columna de actualización . Si los datos se replicaron correctamente, la columna total de filas contendrá el número de elementos replicados.

Supervisión de la creación de reflejo de Fabric

Ahora que los datos están en funcionamiento, hay varios escenarios de análisis disponibles en Fabric.

1. Una vez configurada la creación de reflejo del tejido, se le dirigirá automáticamente al panel Estado de replicación .

2. Aquí, supervise el estado actual de replicación. Para más información y detalles acerca de los estados de replicación, consulte Supervisión de la replicación de la base de datos reflejada de Fabric.

Consulta de la base de datos de origen desde Fabric

Use el portal de Fabric para explorar los datos que ya existen en la cuenta de Azure Cosmos DB, consultando la base de datos de Cosmos DB de origen.

1. Vaya a la base de datos reflejada en el portal de Fabric.

2. Seleccione Ver y, a continuación, Base de datos de origen. Esta acción abre el explorador de datos de Azure Cosmos DB con una vista de solo lectura de la base de datos de origen.

   

3. Seleccione un contenedor y, a continuación, abra el menú contextual y seleccione Nueva consulta SQL.

4. Ejecute cualquier consulta. Por ejemplo, use SELECT COUNT(1) FROM container para contar el número de elementos del contenedor.

   Nota:

   Todas las lecturas de la base de datos de origen se enrutan a Azure y consumen las unidades de solicitud (RU) asignadas en la cuenta.

Análisis de la base de datos reflejada de destino

Ahora, use T-SQL para consultar los datos NoSQL que ahora están almacenados en Fabric OneLake.

1. Vaya a la base de datos reflejada en el portal de Fabric.

2. Cambie del punto de conexión de Azure Cosmos DB reflejado a SQL Analytics.

   

3. Cada contenedor de la base de datos de origen debe representarse en el punto de conexión de SQL Analytics como una tabla de almacenamiento.

4. Seleccione cualquier tabla, abra el menú contextual y, a continuación, seleccione Nueva consulta SQL y, por último, seleccione Seleccionar top 100.

5. La consulta ejecuta y devuelve 100 registros en la tabla seleccionada.

6. Abra el menú contextual de la misma tabla y seleccione Nueva consulta SQL. Escriba una consulta de ejemplo que use agregados como SUM, COUNT, MINo MAX. Una varias tablas en el almacén para ejecutar la consulta en varios contenedores.

   Nota:

   Por ejemplo, esta consulta se ejecutaría en varios contenedores:

   SELECT
       d.[product_category_name],
       t.[order_status],
       c.[customer_country],
       s.[seller_state],
       p.[payment_type],
       sum(o.[price]) as price,
       sum(o.[freight_value]) freight_value 
   FROM
       [dbo].[products] p 
   INNER JOIN
       [dbo].[OrdersDB_order_payments] p 
           on o.[order_id] = p.[order_id] 
   INNER JOIN
       [dbo].[OrdersDB_order_status] t 
           ON o.[order_id] = t.[order_id] 
   INNER JOIN
       [dbo].[OrdersDB_customers] c 
           on t.[customer_id] = c.[customer_id] 
   INNER JOIN
       [dbo].[OrdersDB_productdirectory] d 
           ON o.product_id = d.product_id 
   INNER JOIN
       [dbo].[OrdersDB_sellers] s 
           on o.seller_id = s.seller_id 
   GROUP BY
       d.[product_category_name],
       t.[order_status],
       c.[customer_country],
       s.[seller_state],
       p.[payment_type]
   

   En este ejemplo se supone el nombre de la tabla y las columnas. Use su propia tabla y columnas al escribir la consulta SQL.

7. Seleccione la consulta y, a continuación, seleccione Guardar como vista. Asigne a la vista un nombre único. Puede acceder a esta vista en cualquier momento desde el portal de Fabric.

8. Vuelva a la base de datos reflejada en el portal de Fabric.

9. Seleccione Nueva consulta visual. Use el editor de consultas para crear consultas complejas.

   

Creación de informes de BI en las consultas o vistas SQL

1. Seleccione la consulta o vista y, a continuación, seleccione Explorar estos datos (versión preliminar). Esta acción explora la consulta en Power BI directamente mediante Direct Lake en datos reflejados de OneLake.
2. Edite los gráficos según sea necesario y guarde el informe.

Más ejemplos

Obtenga más información sobre cómo acceder a los datos reflejados de Azure Cosmos DB y consultarlos en Fabric:

• Procedimiento para consultar datos anidados en bases de datos reflejadas de Microsoft Fabric desde Azure Cosmos DB
• Cómo acceder a los datos reflejados de Azure Cosmos DB en Lakehouse y en los cuadernos desde Microsoft Fabric
• Cómo: Combinar datos reflejados de Azure Cosmos DB con otras bases de datos reflejadas en Microsoft Fabric

Contenido relacionado

• Creación de reflejo de Azure Cosmos DB
• Preguntas más frecuentes: Bases de datos reflejadas de Microsoft Fabric desde Azure Cosmos DB