Tutorial: Consulta de la base de datos replicada de Microsoft Fabric desde Cosmos DB en Microsoft Fabric

En este tutorial, consultará una base de datos reflejada de Fabric desde una base de datos de Cosmos DB existente en Fabric. Aprenderá a habilitar el reflejo en la base de datos, verificar el estado del reflejo y, a continuación, usar tanto los datos de origen como los reflejados para el análisis.

Prerrequisitos

• Una existente capacidad 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.

Configuración de Cosmos DB en la base de datos de Fabric

En primer lugar, asegúrese de que su base de datos de Cosmos DB en Fabric esté configurada correctamente y contenga datos para la replicación.

1. Abra el portal de Fabric (https://app.fabric.microsoft.com).

2. Acceda a su base de datos existente de Cosmos DB.

   Importante

   En este tutorial, la base de datos de Cosmos DB existente debe tener el conjunto de datos de ejemplo ya cargado. En los pasos restantes de este tutorial se supone que use el mismo conjunto de datos en esta base de datos.

3. Compruebe que la base de datos contiene al menos un contenedor con datos. Para ello, expanda el contenedor en el panel de navegación y observe que existen elementos.

4. En la barra de menús, seleccione Configuración para acceder a la configuración de la base de datos.

5. En el cuadro de diálogo Configuración , vaya a la sección Creación de reflejo para comprobar que la creación de reflejo está habilitada para esta base de datos.

   Nota:

   El reflejo está habilitado automáticamente para todas las bases de datos de Cosmos DB en Fabric. Esta característica no requiere ninguna configuración adicional y garantiza que los datos estén siempre listos para el análisis en OneLake.

Conexión a la base de datos de origen

A continuación, confirme que puede conectarse a la base de datos de Cosmos DB de origen y consultarla directamente.

1. Vuelva a la base de datos de Cosmos DB existente en el portal de Fabric.

2. Seleccione y expanda el contenedor existente para ver su contenido.

3. Seleccione Elementos para examinar los datos directamente en la base de datos.

4. Compruebe que puede ver los elementos en el contenedor. Por ejemplo, si usa el conjunto de datos de ejemplo, debería ver elementos con propiedades como name, categoryy countryOfOrigin.

5. Seleccione Nueva consulta en el menú para abrir el editor de consultas NoSQL.

6. Ejecute una consulta de prueba para comprobar la conectividad y la disponibilidad de los datos:

   SELECT COUNT(1) AS itemCount FROM container
   

   Esta consulta debe devolver el número total de elementos del contenedor.

Conexión a la base de datos reflejada

Ahora, acceda a la versión reflejada de la base de datos a través del punto de conexión de SQL Analytics para consultar los mismos datos mediante T-SQL.

1. En la barra de menús, seleccione la lista de Cosmos DB y, a continuación, seleccione Punto de conexión de SQL Analytics para cambiar a la vista de base de datos reflejada.

2. Compruebe que el contenedor aparece como una tabla en el punto de conexión de SQL Analytics. La tabla debe tener el mismo nombre que el contenedor.

3. Seleccione Nueva consulta SQL en el menú para abrir el editor de consultas de T-SQL.

4. Ejecute una consulta de prueba para comprobar que la creación de reflejo funciona correctamente:

   SELECT COUNT(*) AS itemCount FROM [dbo].[SampleData]
   

   Nota:

   Reemplace [SampleData] por el nombre del contenedor si no usa el conjunto de datos de ejemplo.

5. La consulta debe devolver el mismo recuento que la consulta NoSQL, lo que confirma que la creación de reflejo replica correctamente los datos.

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.

Contenido relacionado

• Más información sobre Cosmos DB en Microsoft Fabric
• Creación de reflejo de OneLake en la base de datos de Cosmos DB en Microsoft Fabric
• Acceso a datos reflejados de Cosmos DB desde Lakehouse en Microsoft Fabric
• Consulta de datos entre bases de datos en Cosmos DB en Microsoft Fabric