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:

  

• 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 una instancia de Lakehouse, cree una siguiendo estos pasos: Creación de una instancia de Lakehouse con OneLake.

  Importante

  No puede usar una instancia de Lakehouse que tenga habilitado el esquema lakehouse (versión preliminar).

• 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

Graph en Microsoft Fabric usa los mismos roles de área de trabajo que otros elementos de Microsoft Fabric. En la tabla siguiente se resumen los permisos asociados a la funcionalidad de cada rol de área de trabajo de Microsoft Fabric en los modelos de grafos.

Capacidad	Admin	Miembro	Colaborador	Visor
Creación o modificación del modelo de grafo	✔	✔	✔	✖
Eliminación del modelo de grafo	✔	✔	✔	✖
Visualización y lectura del contenido del modelo de grafos	✔	✔	✔	✔
Uso compartido del 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).

   

   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.

   

   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.

   

   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.

   

   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.

   

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.

   

   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.

   

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

Cargar el gráfico

Para cargar el gráfico, seleccione Guardar. Esto comprobará el modelo de grafos, cargará datos de OneLake, construirá el grafo y lo preparará 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

Graph en Microsoft Fabric usa los mismos roles de área de trabajo que otros elementos de Microsoft Fabric. Los siguientes permisos de rol de área de trabajo se aplican en función de si ejecuta consultas a través del elemento Graph Model o QuerySet.

Permisos de rol del área de trabajo para el modelo de Graph

Capacidad	Admin	Miembro	Colaborador	Visor
Creación o modificación del modelo de grafo	✔	✔	✔	✖
Eliminación del modelo de grafo	✔	✔	✔	✖
Visualización y lectura del contenido del modelo de grafos	✔	✔	✔	✔
Uso compartido del modelo de grafo	✔	✔	✖	✖
Creación o modificación de consultas de grafos	✔	✔	✔	✖
Crear o modificar un elemento de QuerySet de grafos	✔	✔	✔	✖

Permisos de rol del espacio de trabajo para Graph QuerySet

Capacidad	Admin	Miembro	Colaborador	Visor
Crear o modificar un elemento de QuerySet de grafos	✔	✔	✔	✖
Eliminar elemento QuerySet	✔	✔	✔	✖
Ver y leer contenido del elemento QuerySet	✔	✔	✔	✔
Conexión a la instancia de grafo	✔	✔	✔	✖
Compartir querySet	✔	✔	✖	✖

Nota:

Todos los usuarios necesitan acceso de lectura al elemento de instancia de grafo subyacente para ejecutar consultas en la instancia de grafo a la que se hace referencia desde el elemento QuerySet de grafos. Solo se admiten permisos de lectura, escritura y recompartición para el elemento QuerySet.

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 .

   

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 grafos 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

• Guía del lenguaje GQL
• Referencia abreviada de GQL
• Pruebe Microsoft Fabric de forma gratuita
• Tutoriales completos en Microsoft Fabric