Compartir a través de


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

En este tutorial, configurará una base de datos reflejada de Fabric a partir de una cuenta existente de Azure Cosmos DB for 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 las funcionalidades avanzadas de Copilot e inteligencia artificial integradas en Fabric para analizar los datos.

Importante

La creación de reflejo para Azure Cosmos DB está actualmente en versión preliminar. No se admiten cargas de trabajo de producción durante la versión preliminar. Actualmente, solo se admiten cuentas de Azure Cosmos DB for NoSQL.

Requisitos previos

Sugerencia

En la versión preliminar pública, se recomienda usar una copia de prueba o desarrollo de los datos existentes de Azure Cosmos DB que se pueda recuperar rápidamente de una copia de seguridad.

Configuración de la cuenta de Azure Cosmos DB.

En primer lugar, asegúrese de que la cuenta de Azure Cosmos DB de origen se haya configurado 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á habilitada, siga la guía 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 la característica no esté disponible en algunos escenarios. Para obtener más información, consulte Limitaciones de la cuenta y la base de datos.

  3. Asegúrese de que las opciones de red se hayan configurado en Acceso la red pública para todas las redes. Si no es así, siga la guía Configuración del acceso de red a una cuenta de Azure Cosmos DB.

Creación de una base de datos reflejada

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.

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

  4. Seleccione Crear, busque la sección Almacenamiento de datos y, a continuación, seleccione Azure Cosmos DB reflejada (versión preliminar).

  5. Escriba 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 for NoSQL.

  2. Escriba las credenciales de la cuenta de Azure Cosmos DB for NoSQL, incluidos estos elementos:

    Valor
    Punto de conexión de Azure Cosmos DB Punto de conexión de la dirección URL de la cuenta de origen.
    Nombre de la conexión Nombre único para la conexión.
    Tipo de autenticación Seleccione Clave de cuenta.
    Clave de cuenta Clave de lectura y escritura para la cuenta de origen.

    Captura de pantalla del cuadro de diálogo Nueva conexión con credenciales para una cuenta de Azure Cosmos DB for NoSQL.

  3. Seleccione Conectar. A continuación, seleccione una base de datos para reflejarla.

    Nota:

    Se reflejan todos los contenedores de la base de datos.

Inicio del proceso de creación de reflejo

  1. Seleccione Base de datos reflejada. Comenzará la creación de reflejo.

  2. Espere de dos a cinco minutos. A continuación, seleccione Supervisión de la 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 para indicar que los contenedores se están sincronizando.

    Sugerencia

    Si no ve los contenedores ni 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 ignorarlos de forma segura y seguir actualizando.

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

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

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

  1. Una vez configurada la creación de reflejo en Fabric, se le redirigirá automáticamente al panel Estado de replicación.

  2. Aquí puede supervisar el estado actual de la replicación. Para más información y detalles sobre 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 en Fabric

Use el portal de Fabric para explorar los datos existentes en la cuenta de Azure Cosmos DB y consultar 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.

    Captura de pantalla del explorador de datos con una vista de solo lectura de datos NoSQL en la cuenta de Azure Cosmos DB.

  3. Seleccione un contenedor, abra el menú contextual y, a continuación, 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 unidades de solicitud (RU) asignadas a la cuenta.

Análisis de la base de datos reflejada de destino

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

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

  2. Cambie del punto de conexión Azure Cosmos DB reflejado a Análisis SQL.

    Captura de pantalla del selector para cambiar entre elementos en el portal de Fabric.

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

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

  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, MIN o 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 sus propias tablas y columnas al escribir la consulta SQL.

  7. Seleccione la consulta y, a continuación, seleccione Guardar como vista. Asigne un nombre único a la vista. 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.

    Captura de pantalla del editor de consultas para consultas visuales y de texto en Fabric.

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.

Sugerencia

También puede usar Copilot u otras mejoras para crear paneles e informes sin ningún movimiento de datos adicional.

Más ejemplos

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