M↗O MESTRE DOS DADOS ← Portal

Guia ilustrado · Microsoft Fabric IQ · recurso em preview

Ontologia:
dados com contexto.

Uma tabela informa o que aconteceu. Uma ontologia ajuda a explicar o que aquilo significa, como as coisas se relacionam e quais regras do negócio precisam ser consideradas por pessoas e agentes.

Adaptação didática dos seis capítulos oficiais da Microsoft Learn. Nomes de itens e botões aparecem em inglês para facilitar a reprodução na interface.

LAKESHORE RETAIL · EXEMPLO
ONOntologiasignificado + vínculos + regras
LojaProdutoEstoqueSensorRemessaVendas
Pergunta → Quais lojas precisam de intervenção?

Antes de clicar

O que é uma ontologia no Fabric?

É uma camada que descreve tipos de entidade (Loja, Produto, Remessa), suas propriedades (StoreId, TemperatureC), relações (a loja opera a unidade de refrigeração) e regras (quando um estoque está em risco). Ela vincula esses conceitos a dados já existentes, sem obrigar o usuário a raciocinar apenas pelos nomes das tabelas.

01 / DADO

Fontes

Tabelas Delta no Lakehouse, telemetria no Eventhouse e medidas de um modelo semântico do Power BI.

02 / SIGNIFICADO

Conceitos

Loja, produto congelado, posição de estoque e a relação entre uma remessa e seu destino.

03 / CONTEXTO

Regras

O que é uma exceção de temperatura, qual estoque exige atenção e como calcular uma métrica.

04 / AÇÃO

Perguntas

O agente cruza conceitos e dados para investigar quais lojas precisam de intervenção.

EXEMPLO DO TUTORIAL

“Quais lojas prioritárias no Oeste têm produto congelado abaixo do estoque de segurança, uma exceção recente de temperatura e disponibilidade na prateleira abaixo da meta? Qual é a próxima remessa?”

Mapa oficial das entidades e relações da empresa fictícia Lakeshore Retail
Mapa do exemplo Lakeshore Retail. As setas mostram relações; as ramificações amarelas indicam herança. Imagem: Microsoft Learn, introdução.

Não confunda: a ontologia descreve o domínio de negócio e liga conceitos a dados. A visualização em grafo é um recurso opcional para explorar conexões; o modelo semântico do Power BI continua responsável pelas medidas DAX que você já governa.

00 / PREPARAR

Monte o ambiente e carregue os exemplos.

O tutorial usa três fontes diferentes no mesmo workspace. Faça essa preparação antes de criar a ontologia.

Pré-requisitos

Você precisa de um workspace com capacidade habilitada para Fabric e das configurações do tenant Users can create ontology (preview) items e Users can create Fabric items ativas. Um administrador pode verificá-las em OneLake catalog → Govern → Configurations → Tenant settings. O recurso está em preview e a interface pode mudar.

  1. Baixe os dados de exemplo. Na pasta Ontology samples · New experience ↗, obtenha os CSVs e SalesReport.pbix. O cenário representa a empresa fictícia Lakeshore Retail.
  2. Crie o Lakehouse. No workspace, use + New item → Lakehouse e nomeie LakeshoreStaticDataLH. Mantenha Lakehouse schemas selecionado. Em Get data → Upload files, envie os CSVs estáticos. Não envie refrigeration_telemetry.csv nem SalesReport.pbix aqui. Para cada CSV, use Load to Tables → New table.
  3. Crie o Eventhouse. Faça + New item → Eventhouse, nomeie LakeshoreTelemetryDataEH e, no banco KQL criado, use Get data → Local file. Importe refrigeration_telemetry.csv para uma tabela chamada RefrigerationTelemetry.
  4. Importe o relatório. No workspace, use Import → Report, Paginated Report or Workbook → From this computer e escolha SalesReport.pbix. Isso cria também o modelo semântico com dados de vendas e medidas DAX.
Tabelas de dados estáticos carregadas no Lakehouse
Lakehouse com as tabelas Delta. Fonte: Microsoft Learn · etapa 0.
Tabela RefrigerationTelemetry no Eventhouse
Telemetria no banco KQL do Eventhouse. Fonte: Microsoft Learn · etapa 0.
Relatório e modelo semântico SalesReport no workspace
Relatório e modelo semântico importados. Fonte: Microsoft Learn · etapa 0.

Ao terminar: o workspace deve conter Lakehouse, Eventhouse e modelo semântico antes da criação da ontologia.

01 / MODELAR

Crie entidades, vincule dados e desenhe relações.

Agora você transforma tabelas técnicas em objetos reconhecíveis para o negócio.

  1. Crie o item. No workspace, escolha + New item → Ontology (preview), informe LakeshoreOntology e selecione o workspace como localização.
  2. Adicione a entidade base. Na faixa superior, use + Add entity type e crie Location. Em … → Bind data → Add, escolha LakeshoreStaticDataLH → dbo → dimlocations. Revise as propriedades propostas e confirme Create.
  3. Modele a herança. Crie Store herdando de Location em Additional configuration. A herança traz as propriedades, mas não dispensa o vínculo da entidade filha com a fonte. Em Manage property bindings, associe a tabela dimlocations e revise as colunas.
  4. Complete o domínio. Crie também centro de distribuição, produto, produto congelado, perecível, estoque, fornecedor, remessa, unidade de refrigeração e telemetria. Use as fontes indicadas na tabela abaixo; para Refrigeration Telemetry, a origem é o Eventhouse.
  5. Traga as vendas. Abra Ontology agent em Plan e peça uma entidade Sale vinculada à tabela Sales do modelo SalesReport. Revise o plano, mude para Act e aplique. Confira propriedades e duas métricas importadas do modelo semântico.
  6. Crie relações. Em Store → Add relationship, relacione Store a Refrigeration Unit com o verbo operates; associe LocationId a StoreId. Repita para os vínculos do mapa abaixo.
Mapa resumido das fontes usadas no tutorial oficial
EntidadeOrigemObservação
Location, Store, Distribution CenterdimlocationsStore e Distribution Center herdam de Location.
Product, Frozen Product, Perishable ProductdimproductsOs dois tipos específicos herdam de Product.
Inventoryfact_inventory_positionsPosição atual e disponibilidade do estoque.
Supplier, Shipment, Refrigeration Unitdimsuppliers, factshipments, dim_refrigeration_unitsFornecimento, remessas e equipamento.
Refrigeration TelemetryRefrigerationTelemetry no EventhouseLeituras de temperatura.
SaleSales no modelo SalesReportCriada com auxílio do agente; medidas DAX preservadas.
Mapa de relações do exemplo, com os campos usados para associar os registros
RelaçãoOrigem e chaveDestino e chave
operatesStore · LocationIdRefrigeration Unit · StoreId
deliversToShipment · ToStoreIdStore · LocationId
occursAtSale · StoreIdStore · LocationId
stockedAtInventory · StoreIdStore · LocationId
originatesAtShipment · FromLocationIdDistribution Center · LocationId
forProductSale · ProductIdProduct · ProductId
stockedAtProduct · ProductIdInventory · ProductId
suppliedByProduct · SupplierIdSupplier · SupplierId
containsShipment · ProductIdProduct · ProductId
hasTelemetryReadingRefrigeration Unit · UnitIdRefrigeration Telemetry · UnitId
Tela para criar um novo item Ontology no Microsoft Fabric
Criação do item Ontology. Fonte: Microsoft Learn · etapa 1.
Seleção de tabela do OneLake para vincular à entidade Location
Seleção da fonte no OneLake. Fonte: Microsoft Learn · etapa 1.
Configuração da entidade Store herdando de Location
Herança de Store a partir de Location. Fonte: Microsoft Learn · etapa 1.
Canvas com os relacionamentos entre entidades da ontologia
Entidades e relações após a modelagem. Fonte: Microsoft Learn · etapa 1.
Leia um vínculo assim: Shipment.ToStoreId → Store.LocationId significa que a remessa é entregue à loja correspondente. O nome da relação traz significado; as chaves fazem a ligação com os dados.
02 / ENRIQUECER

Registre o significado que a tabela não conta.

Metadados e regras evitam que o agente adivinhe o que “prioritário”, “em risco” ou “exceção” querem dizer.

  1. Descreva entidades. Abra Store → View Entity Type details → Entity metadata e explique que lojas de prioridade Tier 1 exigem resposta no mesmo dia. Descreva também centro de distribuição, produtos congelados e perecíveis. Sinônimos podem ajudar o agente a reconhecer termos usados pelo time.
  2. Defina as métricas. Em Inventory, registre que On-Shelf Availability % é a soma de ShelfAvailableUnits dividida pela soma de ShelfCapacityUnits, deixando em branco quando o denominador é zero. No exemplo, menos de 95% indica baixa disponibilidade.
  3. Explique propriedades e relações. Em ProductId, informe que é o identificador corporativo, não um SKU de fornecedor. Documente TemperatureC como graus Celsius e descreva relações como deliversTo e stockedAt em linguagem de negócio.
  4. Cadastre regras. Em Overview → Rules → + Create rule, registre as condições abaixo e vincule cada regra aos conceitos relevantes.
01

Exceção da cadeia fria

Produto congelado ficou acima da temperatura máxima de armazenamento por mais de 20 minutos.

02

Estoque em risco

O estoque projetado fica abaixo do estoque de segurança antes da próxima entrega prevista.

03

Reposição atrasada

A chegada estimada da remessa passa mais de 4 horas da chegada programada.

Campos de metadados e descrição da entidade Store
Metadados da entidade Store. Fonte: Microsoft Learn · etapa 2.
Formulário para cadastrar regra de negócio na ontologia
Criação de uma regra de negócio. Fonte: Microsoft Learn · etapa 2.
03 / EXPLORAR

Verifique o modelo antes de perguntar ao agente.

Uma ontologia bem desenhada precisa fazer sentido visualmente e mostrar instâncias reais das fontes.

Full ontology

Mostra todas as entidades e relações. Use para conferir se alguma peça ficou isolada.

Lineage

Mostra a herança entre entidades, como Location → Store.

Relationship

Mostra os vínculos de uma entidade selecionada com outras entidades.

Instances

Mostra as linhas que originaram cada tipo de entidade. Em Inventory, confira ProductId, OnHandQuantity e ShelfAvailableUnits.

Visualização completa das entidades e relacionamentos da ontologia
Vista completa do canvas. Fonte: Microsoft Learn · etapa 3.
Aba Instances mostrando registros de uma entidade
Registros de origem na aba Instances. Fonte: Microsoft Learn · etapa 3.
OPCIONAL / GRAFO

Materialize conexões para explorar caminhos.

Se quiser usar o grafo integrado, defina primeiro as chaves de cada entidade em Define entity type key; por exemplo, Store.LocationId, Product.ProductId e a chave composta Inventory(StoreId, ProductId). Depois use Manage graph → Continue → Materialize e, quando terminar, Explore graph.

Limite importante desta prévia: a projeção em grafo aceita tabelas Delta de Lakehouse ou banco espelhado. As entidades Sale (modelo semântico) e Refrigeration Telemetry (Eventhouse) não entram nesse grafo, embora permaneçam na ontologia. O grafo não é necessário para consultar a ontologia com o agente.

Tela de configuração das entidades elegíveis para a projeção em grafo
Escolha das entidades elegíveis para o grafo. Fonte: Microsoft Learn · etapa 3.
Resultado de uma consulta de caminho entre loja e fornecedor no grafo
Exemplo de consulta de caminho entre loja e fornecedor. Fonte: Microsoft Learn · etapa 3.

Para reproduzir o exemplo de caminhos da Microsoft, selecione Store como origem e Supplier como destino, filtre City = Seattle e SupplierName = Cascade Fresh Products, limite a dois saltos e execute Run.

04 / AGENTE

Faça perguntas que atravessam as fontes.

O agente usa definições, vínculos e dados para responder; a qualidade da resposta depende da qualidade dessas três camadas.

  1. Abra o painel. Na página inicial da ontologia, escolha Ontology agent. O painel abre em Plan, modo em que explora e consulta sem alterar o modelo.
  2. Comece pequeno. Pergunte quais produtos congelados estão em lojas prioritárias da região Oeste. Em seguida, pergunte quais posições estão abaixo do estoque de segurança.
  3. Adicione os sinais. Peça as lojas com exceção de temperatura, a disponibilidade de prateleira, as remessas previstas e a margem bruta em queda.
  4. Faça a pergunta final. Combine os critérios para identificar lojas que exigem intervenção e mostre a próxima remessa e a chegada esperada. Revise as fontes e os critérios antes de usar a conclusão operacionalmente.
PERGUNTA FINAL · EXEMPLO EM PORTUGUÊS

Quais lojas de alta prioridade da região Oeste têm produtos congelados abaixo do estoque de segurança, uma exceção recente de temperatura e disponibilidade na prateleira abaixo da meta? Para cada loja, mostre a próxima remessa e a previsão de chegada.

O resultado concreto varia com os dados carregados e com as permissões da sua conta. Os exemplos ilustrados abaixo são da documentação oficial.
Painel do Ontology agent aberto na ontologia
Abertura do Ontology agent. Fonte: Microsoft Learn · etapa 4.
Resposta ilustrativa do agente à pergunta sobre as lojas prioritárias
Resposta do exemplo oficial; não é uma execução desta página. Fonte: Microsoft Learn · etapa 4.
Plan × Act

Plan serve para propor, examinar e consultar. Act aplica mudanças de modelagem após sua revisão. Em produção, mantenha um responsável pelos vínculos e regras, valide a resposta com a fonte e limite o acesso do agente ao necessário.

05 / CONCLUIR

O que você construiu?

Uma camada de significado que reúne dados estáticos, telemetria e métricas governadas para responder a uma pergunta operacional concreta.

✓ Fontes no Lakehouse, Eventhouse e Power BI✓ Entidades e vínculos com chaves conferidas✓ Metadados, métricas e regras documentados✓ Instâncias verificadas antes de usar o agente

Depois do exercício: a Microsoft orienta excluir o workspace de prática em Workspace settings → Remove this workspace e apagar os arquivos locais de exemplo. Essa ação remove todos os itens do workspace; execute-a apenas se ele foi criado exclusivamente para este tutorial e você não precisa mais dos recursos.

FONTES / LEITURA

Continue na documentação oficial.

Esta página explica o fluxo com palavras próprias. As capturas de interface foram adaptadas do tutorial da Microsoft Learn e estão atribuídas em cada legenda. Confira a documentação se a interface mudar durante o período de preview.