Início Rápido: Criar seu primeiro grafo no Microsoft Fabric

Observação

Esse recurso está atualmente em versão prévia pública. Essa versão prévia é oferecida sem um Acordo de Nível de Serviço (SLA) e não é recomendada para cargas de trabalho em nível de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Supplemental Terms of Use for Microsoft Azure Previews.

Neste início rápido, você usa o grafo no Microsoft Fabric para criar um grafo básico com dois nós e uma borda e, em seguida, executar uma consulta. Esse processo leva cerca de 15 minutos.

Para obter um tutorial abrangente que aborda o modelo de dados completo do Adventure Works e cenários mais avançados, consulte o tutorial do grafo.

Pré-requisitos

Antes de iniciar este início rápido, verifique se:

1. o grafo está disponível em sua região.

2. O Graph está habilitado em seu tenant do Fabric. Um administrador do Fabric habilita essa configuração no portal de administração.

   

3. Você é membro de um workspace do Fabric 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. Os usuários fora do workspace não podem acessar o grafo. Os usuários no espaço de trabalho que têm acesso aos dados subjacentes no lakehouse podem modelar e consultar o grafo.

Carregar dados de exemplo

Para criar seu gráfico, primeiro carregue dados de exemplo em um lakehouse no espaço de trabalho do Fabric.

Baixe os dados de exemplo

1. Vá para os conjuntos de dados de exemplo GQL do grafo no GitHub.

2. Selecione o arquivo adventureworks_docs_sample.zip e baixe-o no computador local.

   Dica

   Para baixar um arquivo do GitHub, selecione o arquivo e, em seguida, selecione o ícone Download raw file.

3. Extraia o arquivo adventureworks_docs_sample.zip baixado para uma pasta em seu computador local.

   Dica

   No Explorador de Arquivos, clique com o botão direito do mouse no arquivo zip e selecione Extrair Tudo e escolha uma pasta de destino.

Criar uma casa no lago

1. Em Microsoft Fabric, selecione seu workspace.

2. Escolha + Novo item.

3. Selecione Armazenar data>Lakehouse.

4. Insira um nome (por exemplo, "AdventureWorksLakehouse"), desmarque a opção esquemas Lakehouse e selecione Criar.

   Importante

   Atualmente, o grafo não dá suporte a lakehouses com o esquema lakehouse (versão prévia) habilitado.

Carregar os dados em tabelas

Para este início rápido, você só precisa de duas tabelas: adventureworks_customers e adventureworks_orders. Carregue a pasta de dados de exemplo completa e carregue apenas essas duas tabelas.

1. Em seu lakehouse, passe o mouse sobre Arquivos, selecione as reticências (...) e, em seguida, selecione Carregar>Carregar pasta.
2. Navegue até a pasta extraída e carregue-a. Essa ação carrega todos os arquivos de dados de exemplo para o lakehouse.
3. Expanda Arquivos e a pasta carregada para ver as subpastas. Para este início rápido, você só precisa carregar dois deles como tabelas.
4. Passe o mouse sobre a subpasta adventureworks_customers, selecione as reticências (...) e escolha Carregar em Tabelas>Nova tabela.
5. Defina o tipo de arquivo como Parquet e selecione Carregar.
6. Repita os passos 4 a 5 para a subpasta adventureworks_orders.

Criar um modelo de grafo

1. Na sua área de trabalho Microsoft Fabric, selecione + Novo item.

2. 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.

3. Insira um nome (por exemplo, "MyFirstGraph") e selecione Criar.

Depois de criar o modelo de grafo, você é levado para o modo de exibição de grafo, em que pode ver que o modo padrão está definido como Modelo, com os botões Salvar, Obter dados, Adicionar nó e Adicionar aresta na parte superior.

Criar um grafo

Para criar um grafo em Microsoft Fabric, siga estas etapas no modo de exibição de grafo:

1. Selecione Obter dados.

2. No catálogo do OneLake, selecione seu lakehouse com os dados do Adventure Works.

3. Selecione Conectar.

4. Selecione as tabelas adventureworks_customers e adventureworks_orders, e em seguida, clique em Carregar.

   

Adicionar dois nós

1. Selecione Adicionar nó.

2. Configure o primeiro nó:

   • Rótulo: Cliente
   • Tabela de mapeamento: adventureworks_customers
   • ID da coluna de mapeamento: CustomerID_K

   

3. Selecione Confirmar.

4. Selecione Adicionar nó novamente.

5. Configure o segundo nó:

   • Rótulo: Pedido
   • Tabela de mapeamento: adventureworks_orders
   • ID da coluna de mapeamento: SalesOrderDetailID_K

6. Selecione Confirmar.

Adicionar uma borda

1. Selecione Adicionar borda.

2. Configurar a borda

   • Rótulo: compras
   • Tabela de mapeamento: adventureworks_orders
   • Nó de origem: Cliente
   • Coluna de mapeamento de origem: CustomerID_FK
   • Nó de destino: Ordem
   • Coluna de mapeamento de destino: SalesOrderDetailID_K

   

3. Selecione Confirmar.

4. Selecione Salvar para carregar o grafo.

Consultar seu grafo

Execute uma consulta GQL para localizar os cinco principais clientes por contagem de pedidos.

1. Selecione o modo de consulta .

2. Selecione o editor de código no menu superior.

3. Insira a seguinte consulta GQL na caixa de entrada:

   MATCH (c:Customer)-[:purchases]->(o:`Order`)
   RETURN c.fullName AS customer_name, count(o) AS num_orders
   GROUP BY customer_name
   ORDER BY num_orders DESC
   LIMIT 5
   

4. Selecione Executar consulta para ver os cinco principais clientes por contagem de pedidos.

A imagem a seguir mostra a consulta GQL e seus resultados:

Parabéns! Você criou seu primeiro grafo em Microsoft Fabric e executou uma consulta nele.

Próximas etapas

• tutorial de grafo – Criar um grafo completo com vários nós, bordas e consultas
• Guia de linguagem GQL – Aprender sintaxe GQL
• O que é o grafo no Microsoft Fabric? - Saiba mais sobre os conceitos do grafo