Partilhar via

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

Observação

Esta funcionalidade está atualmente em pré-visualização pública. Essa visualização é fornecida sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.

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

Importante

Este artigo utiliza exclusivamente o conjunto de dados gráfico de exemplo AdventureWorks.

Pré-requisitos

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

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

  • O Graph está habilitado em seu locatário do Fabric:

    Habilite o gráfico em seu locatário do Fabric.

  • Uma casa de lago em OneLake com dados que você deseja analisar. Este guia de início rápido usa dados da Adventure Works como exemplo. Seus dados e resultados podem ser diferentes. Se não tiver uma casa no lago, crie uma seguindo estes passos, garantindo que desmarca a opção do esquema da casa do lago: Criar uma casa no lago com o OneLake.

    Importante

    Atualmente não podes usar um lakehouse que tenha o esquema do lakehouse (pré-visualização) ativado.

  • És membro de um espaço de trabalho ou tens permissão para criar itens nesse espaço. Para obter mais informações, consulte Espaços de trabalho no Microsoft Fabric.

    Importante

    A gestão de acesso ao grafo está restrita ao espaço de trabalho que o hospeda. O gráfico não está acessível a usuários fora do espaço de trabalho. Utilizadores no espaço de trabalho que têm acesso aos dados subjacentes no lakehouse podem consultar e modelar o grafo.

Criar um modelo de gráfico

Para criar um modelo de gráfico no Microsoft Fabric, siga estes passos:

  1. Vá para o espaço de trabalho do Microsoft Fabric.

  2. Selecione + Novo item.

  3. Selecione Analisar e treinar dados>Modelo de gráfico (visualização).

    Captura de tela mostrando o menu do novo item com a opção de selecionar Modelo de gráfico (visualização).

    Sugestão

    Como alternativa, digite "gráfico" na caixa de pesquisa e pressione Enter para procurar itens de gráfico.

  4. Insira um nome para o modelo de gráfico e selecione Criar.

Criar um gráfico

Na vista de gráfico, deverá ver os botões Guardar, Adicionar nó, Adicionar aresta e Obter dados.

Para criar um gráfico no Microsoft Fabric, siga estes passos:

  1. No modelo de gráfico, selecione Obter dados.

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

    Captura de tela mostrando o menu de seleção de dados no OneLake.

    Observação

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

  3. Em seguida, selecione Conectar.

  4. Selecione tabelas de dados e, em seguida, selecione Carregar.

  5. Você deve ver os dados disponíveis para uso em seu gráfico.

    Captura de ecrã que mostra a vista de dados no modelo gráfico.

    Observação

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

    • Booleano (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 assinados de 64 bits)
    • String (os valores são cadeias de caracteres Unicode)
    • Zoned DateTime (os valores são carimbos de data/hora juntamente com um deslocamento de tempo para o fuso horário)

Comece a modelar

Agora você pode começar a modelar adicionando nós e bordas ao gráfico. Usamos o modelo de dados da 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 do nó Tabela de mapeamento Coluna de mapeamento
Cliente customers CustomerID_K
Encomenda orders SalesOrderDetailID_K
Funcionário employees EmployeeID_K
Produto products ProductID_K
Categoria de Produto categorias de produtos CategoryID_K
ProdutoSubcategoria subcategorias de produtos SubcategoryID_K
Fornecedor vendors VendorID_K

Para adicionar os nós ao gráfico, siga estas etapas:

  1. No seu modelo de gráfico, selecione Adicionar nó para adicionar um novo nó ao gráfico.

  2. Na caixa de diálogo Adicionar nó ao gráfico, insira um nome para o Label e selecione a Mapping table e a Mapping column apropriadas.

    Captura de ecrã mostrando a caixa de diálogo Adicionar nó ao gráfico.

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

  3. Selecione Confirmar para adicionar o nó ao gráfico.

  4. Repita o processo para todos os outros nós. Você deve ver todos os nós representados no seu gráfico.

  5. Selecione Salvar para começar a gerar seu gráfico.

    Captura de tela mostrando todos os nós adicionados ao gráfico.

Adicionar arestas

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

Edge Tabela de mapeamento Coluna de mapeamento do nó de origem Coluna de mapeamento do nó de destino
vende orders Funcionário

EmployeeID_FK		 Encomenda

SalesOrderDetailID_K
compras orders Cliente

CustomerID_FK		 Encomenda

SalesOrderDetailID_K
contains orders Encomenda

SalesOrderDetailID_K		 Produto

ProductID_FK
éDoTipo products Produto

ProductID_K		 ProdutoSubcategoria

SubcategoryID_FK
pertenceTo subcategorias de produtos ProdutoSubcategoria

SubcategoryID_K		 Categoria de Produto

CategoryID_FK
produz produto do fornecedor Fornecedor

VendorID_FK		 Produto

ProductID_FK

Para adicionar as arestas ao gráfico, siga estas etapas:

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

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

    Captura de ecrã mostrando a caixa de diálogo para adicionar borda.

    Neste exemplo, a aresta é definida como „sells“ com a tabela de correspondência „orders“, conectando o nó de origem „Employee“ (EmployeeID_FK) ao nó de destino „Order“ (SalesOrderDetailID_K).

  3. Selecione Confirmar para adicionar a borda ao gráfico.

  4. Repita o processo para todas as outras bordas. Você deve ver todas as arestas representadas no seu gráfico.

    Captura de tela mostrando todas as bordas adicionadas ao gráfico.

A essa altura, você criou todos os nós e bordas para seu gráfico. Estes nós e arestas são a estrutura básica do seu modelo de grafo.

Carregue o gráfico

Para carregar o gráfico, selecione Guardar. Selecionar Guardar verifica o modelo do grafo, carrega os dados do OneLake, constrói o gráfico e prepara-o para consulta.

Importante

Atualmente, precisa de recarregar o gráfico (selecionando Guardar) sempre que o modelo ou os dados subjacentes são alterados.

Consultar o gráfico

Usando o construtor de consultas

Agora, podemos consultar o grafo selecionando nós e relacionamentos específicos. Todas as consultas são baseadas na estrutura gráfica que construímos na seção anterior.

Siga estes passos para mudar para a interface de criação de consultas e começar a consultar o seu gráfico interativamente.

  1. Selecione Modos>Construtor de consultas na página inicial do gráfico. A partir desta perspetiva, pode também criar um conjunto de consultas apenas de leitura, que tem as mesmas funcionalidades abaixo e permite partilhar os resultados das suas consultas.

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

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

    Captura de ecrã a mostrar a seleção do modo de consulta.

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

Usando o editor de código

Também podemos consultar o grafo usando a linguagem Graphics Query (GQL).

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

  1. Selecione Modos>Editor de código na página inicial do gráfico.
  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 gráficos 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 mais informações sobre o suporte à linguagem GQL, consulte o guia da linguagem GQL.

Conteúdo relacionado

  • Last updated on