Partekatu bidez

Guía de inicio rápido para Graph en Microsoft Fabric

Nota:

Esta característica actualmente está en su versión preliminar pública. Esta versión preliminar se ofrece sin un contrato de nivel de servicio y no es aconsejable usarla para cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure.

En este inicio rápido, aprenderá a crear un modelo de grafos en Microsoft Fabric.

Importante

En este artículo se usa exclusivamente el conjunto de datos del grafo de ejemplo adventureWorks.

Prerrequisitos

Para empezar a trabajar con graph en Microsoft Fabric, necesita los siguientes requisitos previos:

  • El grafo está disponible en su región.

  • Graph está habilitado en el cliente de Fabric:

    Habilite el grafo en el inquilino de Fabric.

  • Una lakehouse en OneLake con datos que desea analizar. En este inicio rápido se usan datos de Adventure Works como ejemplo. Los datos y los resultados pueden diferir. Si no tiene un lakehouse, cree uno siguiendo estos pasos, asegurándose de deseleccionar la opción de esquema de lakehouse: Cree un lakehouse con OneLake.

    Importante

    Actualmente no puedes usar un Lakehouse que tenga esquema lakehouse (vista previa) habilitado.

  • Es miembro de un área de trabajo o tiene permiso para crear elementos en el área de trabajo. Para obtener más información, consulte Áreas de trabajo en Microsoft Fabric.

    Importante

    La administración de acceso del grafo está restringida al área de trabajo que la hospeda. El gráfico no es accesible para los usuarios fuera del área de trabajo. Los usuarios del área de trabajo que tienen acceso a los datos subyacentes de lakehouse pueden modelar y consultar el grafo.

Creación de un modelo de grafo

Para crear un modelo de grafo en Microsoft Fabric, siga estos pasos:

  1. Vaya al área de trabajo de Microsoft Fabric.

  2. Seleccione + Nuevo elemento.

  3. Seleccione Analizar y entrenar datos>Modelo de grafo (versión preliminar).

    Captura de pantalla que muestra el menú de nuevo elemento con la opción para seleccionar el modelo Graph (vista previa).

    Sugerencia

    Como alternativa, escriba "grafo" en el cuadro de búsqueda y presione Entrar para buscar elementos de grafo.

  4. Escriba un nombre para el modelo de grafos y seleccione Crear.

Creación de un grafo

En la vista de gráfico, debería ver los botones Guardar, Agregar nodo y Agregar borde y Obtener datos .

Para crear un grafo en Microsoft Fabric, siga estos pasos:

  1. En el modelo de grafo, seleccione Obtener datos.

  2. En el catálogo de OneLake, seleccione datos de Fabric para usarlos en el grafo.

    Captura de pantalla que muestra el menú de selección de datos en OneLake.

    Nota:

    En este inicio rápido se usan datos de Adventure Works como ejemplo. El conjunto de datos y los resultados pueden diferir.

  3. A continuación, seleccione Conectar.

  4. Seleccione tablas de datos y, a continuación, seleccione Cargar.

  5. Deberás ver datos disponibles para su uso en el gráfico.

    Captura de pantalla que muestra la vista de datos en el modelo de grafo.

    Nota:

    Graph en Microsoft Fabric admite actualmente los siguientes tipos de datos:

    • Boolean (los valores son true y false)
    • Double (los valores son números de punto flotante de 64 bits)
    • Entero (los valores son enteros con signo de 64 bits)
    • String (los valores son cadenas de caracteres Unicode)
    • DateTime con zona (los valores son marcas de tiempo junto con un turno de tiempo para la zona horaria)

Inicio del modelado

Ahora puede empezar a modelar agregando nodos y bordes al grafo. Usamos el modelo de datos Adventure Works como ejemplo.

Agregar nodos

En esta sección, creamos nodos para cada entidad en el modelo de datos Adventure Works.

Etiqueta de nodo Tabla de mapeo Columna de mapeo
Cliente customers CustomerID_K
Pedido orders SalesOrderDetailID_K
Empleado employees IdentificaciónDeEmpleado_K
Producto products ProductID_K
Categoría de Producto categorías de productos CategoryID_K
Subcategoría de Producto subcategorías de productos SubcategoryID_K
Proveedor vendors VendorID_K

Para agregar los nodos al grafo, siga estos pasos:

  1. En el modelo de grafo, seleccione Agregar nodo para agregar un nuevo nodo al grafo.

  2. En el cuadro de diálogo Agregar nodo al grafo, escriba un nombre de etiqueta y seleccione la tabla de asignación adecuada y la columna de asignación.

    Captura de pantalla que muestra el cuadro de diálogo Agregar nodo al grafo.

    En este ejemplo, la etiqueta del nodo es "Customer", la tabla de asignación es "customers" y la columna de asignación es "CustomerID_K".

  3. Seleccione Confirmar para agregar el nodo al grafo.

  4. Repita el proceso para todos los demás nodos. Debería ver todos los nodos representados en el gráfico.

  5. Seleccione Guardar para empezar a generar el grafo.

    Captura de pantalla que muestra todos los nodos agregados al gráfico.

Agregar bordes

En esta sección, se crean bordes para definir las relaciones entre los nodos del modelo de datos adventure Works.

Edge Tabla de mapeo Columna de asignación de nodos de origen Columna de asignación de nodos de destino
Vende orders Empleado

EmpleadoID_FK		 Pedido

SalesOrderDetailID_K
Compras orders Cliente

CustomerID_FK		 Pedido

SalesOrderDetailID_K
contains orders Pedido

SalesOrderDetailID_K		 Producto

ProductID_FK
isOfType products Producto

ProductID_K		 SubcategoríaDeProducto

SubcategoryID_FK
perteneceA subcategorías de productos SubcategoríaDeProducto

SubcategoryID_K		 Categoría de Producto

CategoryID_FK
produce producto del proveedor Proveedor

VendorID_FK		 Producto

ProductID_FK

Para agregar los bordes al grafo, siga estos pasos:

  1. Seleccione Agregar borde para crear una relación entre nodos.

  2. En el cuadro de diálogo Agregar borde , seleccione la tabla de asignación, los nodos de origen y de destino y defina la relación.

    Captura de pantalla que muestra el cuadro de diálogo Agregar borde.

    En este ejemplo, la arista se define como "sells" con la tabla de asignación "orders", conectando el nodo de origen "Employee" (EmployeeID_FK) al nodo de destino "Order" (SalesOrderDetailID_K).

  3. Seleccione Confirmar para agregar el borde al gráfico.

  4. Repita el proceso para todos los demás bordes. Debería ver todos los bordes representados en el gráfico.

    Captura de pantalla que muestra todos los bordes agregados al gráfico.

En este punto, ha creado todos los nodos y bordes del grafo. Estos nodos y bordes son la estructura básica del modelo de grafos.

Cargar el gráfico

Para cargar el gráfico, seleccione Guardar. Al seleccionar Guardar , se comprueba el modelo de grafo, se cargan datos de OneLake, se crea el grafo y se prepara para realizar consultas.

Importante

Actualmente, debe volver a cargar el gráfico (seleccionando Guardar) siempre que se cambie el modelo o los datos subyacentes.

Consulta el gráfico

Uso del generador de consultas

Ahora, podemos consultar el gráfico seleccionando nodos y relaciones específicos. Todas las consultas se basan en la estructura de grafos que creamos en la sección anterior.

Siga estos pasos para cambiar al generador de consultas y empezar a consultar el grafo de forma interactiva:

  1. Seleccione Modos>Constructor de consultas en la página principal del gráfico. Desde esta vista, también puede crear un conjunto de consultas de solo lectura, que tiene las mismas funcionalidades que a continuación y le permite compartir los resultados de la consulta.

  2. Seleccione Agregar nodo para ver los nodos disponibles para realizar consultas.

  3. Seleccione un nodo para agregarlo a la consulta. En este ejemplo, agregamos el nodo Customer .

    Captura de pantalla que muestra la selección del modo de consulta.

  4. Desde aquí puede compilar la consulta agregando nodos y bordes, aplicando filtros y seleccionando propiedades para devolver en los resultados.

Uso del editor de código

También podemos consultar el gráfico mediante el lenguaje de consulta de gráficos (GQL).

Siga estos pasos para cambiar al editor de código y empezar a consultar el grafo mediante GQL:

  1. Seleccione Modo>Editor de código en la página principal del grafo.
  2. Escriba una consulta GQL en el campo de entrada, como MATCH (n:`Order`) RETURN count(n) AS num_orders.
  3. Seleccione Ejecutar consulta para ejecutar la consulta.

También puede ejecutar consultas más complejas, como consultas que combinan patrones de grafos coincidentes, filtrado, agregación, ordenación y limitación de nivel superior:

MATCH (v:Vendor)-[:produces]->(p:`Product`)->(sc:`ProductSubcategory`)->(c:`ProductCategory`), 
      (o:`Order`)-[:`contains`]->(p)
FILTER c.categoryName = 'Components'
LET vendorName = v.vendorName, subCategoryName = sc.subCategoryName
RETURN vendorName, subCategoryName, count(p) AS num_products, count(o) AS num_orders
GROUP BY vendorName, subCategoryName
ORDER BY num_orders DESC
LIMIT 5

Para obtener más información sobre la compatibilidad con el lenguaje GQL, consulte la guía del lenguaje GQL.

Contenido relacionado

  • Last updated on