Guia de início rápido do Graph no Microsoft Fabric

Observação

Esse recurso está atualmente em versão prévia pública. Essa versão prévia é oferecida sem um SLA e não é recomendada para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares para Versões Prévias do Microsoft Azure.

Neste início rápido, você aprenderá a criar um modelo de grafo no Microsoft Fabric.

Importante

Este artigo usa exclusivamente o conjunto de dados de grafo de exemplo AdventureWorks.

Pré-requisitos

Para começar a usar o graph no Microsoft Fabric, você precisa dos seguintes pré-requisitos:

• O Graph está disponível em sua região.

• O Graph está habilitado no tenant do Fabric.

  

• Um lakehouse no OneLake com dados que você deseja analisar. Este início rápido usa dados do Adventure Works como exemplo. Seus dados e resultados podem ser diferentes. Se você não tiver uma Lakehouse, crie uma seguindo estas etapas, garantindo que você desmarque a opção de esquema de Lakehouse: Criar uma Lakehouse com o OneLake.

  Importante

  No momento, você não pode usar lakehouse que tenha schema lakehouse (versão prévia) habilitado.

• Você é membro de um workspace ou tem permissão para criar itens no workspace. Para obter mais informações, consulte Workspaces no Microsoft Fabric.

  Importante

  O gerenciamento de acesso do grafo é restrito ao workspace que o hospeda. O grafo não é acessível para usuários fora do workspace. Os usuários no espaço de trabalho que têm acesso aos dados subjacentes no lakehouse podem modelar e consultar o grafo.

Criar um modelo de grafo

Para criar um modelo de grafo no Microsoft Fabric, siga estas etapas:

1. Vá para o workspace do Microsoft Fabric.

2. Escolha + Novo item.

3. Selecione Analisar e treinar dados>Modelo de gráfico (versão prévia).

   

   Dica

   Como alternativa, insira "grafo" na caixa de pesquisa e pressione Enter para pesquisar itens de grafo.

4. Insira um nome para o modelo de grafo e selecione Criar.

Criar um grafo

No modo de exibição de grafo, você deverá ver os botões Salvar, Adicionar nó, Adicionar aresta e Obter dados.

Para criar um grafo no Microsoft Fabric, siga estas etapas:

1. Em seu modelo de grafo, selecione Obter dados.

2. No catálogo do OneLake, selecione dados do Fabric para usar em seu grafo.

   

   Observação

   Este início rápido usa dados do Adventure Works como exemplo. O conjunto de dados e os resultados podem ser diferentes.

3. Depois, selecione Conectar.

4. Selecione tabelas de dados e selecione Carregar.

5. Você deve ver os dados disponíveis para uso em seu grafo.

   

   Observação

   Atualmente, o Graph no Microsoft Fabric dá suporte aos seguintes tipos de dados:

   • Booliano (os valores são true e false)
   • Duplo (os valores são números de ponto flutuante de 64 bits)
   • Inteiro (os valores são inteiros com sinal de 64 bits)
   • Cadeia de caracteres (valores são cadeias de caracteres Unicode)
   • DateTime com fuso horário (os valores são carimbos de data/hora junto com um deslocamento de tempo para o fuso horário)

Iniciar modelagem

Agora você pode iniciar a modelagem adicionando nós e bordas ao grafo. Usamos o modelo de dados do Adventure Works como exemplo.

Adicionar nós

Nesta seção, criamos nós para cada entidade no modelo de dados da Adventure Works.

Rótulo de nó	Tabela de mapeamento	Coluna de mapeamento
Customer	customers	CustomerID_K
Pedido	orders	SalesOrderDetailID_K
Funcionário	employees	ID do Funcionário_K
Product	products	ProductID_K
Categoria de Produto	categorias de produtos	CategoryID_K
SubcategoriaDoProduto	subcategorias de produto	SubcategoryID_K
Fornecedor	vendors	VendorID_K

Para adicionar os nós ao grafo, siga estas etapas:

1. No modelo de grafo, selecione Adicionar nó para adicionar um novo nó ao grafo.

2. Na caixa de diálogo Adicionar nó ao grafo, insira um rótulo e selecione a tabela de mapeamento e a coluna de mapeamento apropriadas.

   

   Neste exemplo, o rótulo do nó é "Cliente", a tabela de mapeamento é "clientes" e a coluna de mapeamento é "CustomerID_K".

3. Selecione Confirmar para adicionar o nó ao grafo.

4. Repita o processo para todos os outros nós. Você deve ver todos os nós representados no grafo.

5. Selecione Salvar para começar a gerar o grafo.

   

Adicionar bordas

Nesta seção, criamos bordas para definir as relações entre os nós no modelo de dados do Adventure Works.

Edge	Tabela de mapeamento	Coluna de mapeamento de nó de origem	Coluna de mapeamento de nó de destino
Vende	orders	Funcionário IDFuncionario_FK	Pedido SalesOrderDetailID_K
Compras	orders	Customer CustomerID_FK	Pedido SalesOrderDetailID_K
contém	orders	Pedido SalesOrderDetailID_K	Product ProductID_FK
éDoTipo	products	Product ProductID_K	Subcategoria de Produto SubcategoryID_FK
belongsTo	subcategorias de produto	Subcategoria de Produto SubcategoryID_K	Categoria de Produto CategoryID_FK
produz	produtovendedor	Fornecedor VendorID_FK	Product ProductID_FK

Para adicionar as bordas ao grafo, siga estas etapas:

1. Selecione Adicionar aresta para criar uma relação entre nós.

2. Na caixa de diálogo Adicionar aresta, selecione a tabela de mapeamento, o nó de origem, o nó de destino e defina a relação.

   

   Neste exemplo, a borda é definida como "vende" com a tabela de mapeamento "orders", conectando o nó de origem "Employee" (EmployeeID_FK) ao nó de destino "Order" (SalesOrderDetailID_K).

3. Selecione Confirmar para adicionar a borda ao grafo.

4. Repita o processo para todas as outras bordas. Você deve ver todas as bordas representadas no grafo.

   

Neste ponto, você criou todos os nós e bordas para o grafo. Esses nós e bordas são a estrutura básica do modelo de grafo.

Carregar o grafo

Para carregar o grafo, selecione Salvar. Selecionar Salvar verifica o modelo de grafo, carregar dados do OneLake, construir o grafo e prepará-lo para consulta.

Importante

No momento, você precisa recarregar o grafo (selecionando Salvar) sempre que o modelo ou os dados subjacentes forem alterados.

Consultar o grafo

Utilizar o construtor de consultas

Agora, podemos consultar o grafo selecionando nós e relações específicos. Todas as consultas são baseadas na estrutura de grafo que criamos na seção anterior..

Siga estas etapas para ativar o construtor de consultas e começar a consultar seu grafo interativamente.

1. Selecione Modos>Construtor de Consultas na página inicial do grafo. Nessa exibição, você também pode criar um conjunto de consultas somente leitura, que tem as mesmas funcionalidades abaixo e permite compartilhar os resultados da consulta.

2. Selecione Adicionar nó para ver os nós disponíveis para consulta.

3. Selecione um nó para adicioná-lo à consulta. Neste exemplo, adicionamos o nó Cliente.

   

4. A partir daqui, você pode criar sua consulta adicionando nós e bordas, aplicando filtros e selecionando propriedades para retornar nos resultados.

Usando o editor de código

Também podemos consultar o grafo usando a GQL (Linguagem de Consulta Gráfica).

Siga estas etapas para alternar para o editor de código e começar a consultar seu grafo usando GQL:

1. Selecione Modos>editor de código na página inicial do grafo.
2. Insira uma consulta GQL no campo de entrada, como MATCH (n:`Order`) RETURN count(n) AS num_orders.
3. Selecione Executar consulta para executar a consulta.

Você também pode executar consultas mais complexas, como consultas que combinam padrões de grafo correspondentes, filtragem, agregação, classificação e limitação top-k:

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 obter mais informações sobre o suporte à linguagem GQL, consulte o guia de linguagem GQL.

Conteúdo relacionado

• Guia de idioma GQL
• Referência abreviada de GQL
• Experimente o Microsoft Fabric gratuitamente
• Tutoriais completos no Microsoft Fabric