> For the complete documentation index, see [llms.txt](https://docs.powermonitor.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powermonitor.com.br/principais-funcionalidades/modelos-semanticos.md).

# Modelos Semânticos

Tudo o que o Power Monitor faz pelos modelos semânticos: monitoramento das atualizações, inventário, agendamentos, qualidade, tamanho e avaliação de performance.

**Modelo semântico** é o nome atual da Microsoft para o que era chamado de *dataset* no Power BI: o item que contém as tabelas, os relacionamentos, as medidas DAX e as conexões com as fontes de dados. O Power Monitor acompanha os modelos semânticos em várias frentes.

## Monitoramento das atualizações

* **Falhas de atualização:** verificadas **a cada 15 minutos** nos modelos em capacidade dos workspaces monitorados, com o alerta **Falha na Atualização do Dataset** (código e mensagem do erro, quem disparou, links).
* **Histórico:** status, horário e duração de cada atualização em **Monitoramento › Modelos Semânticos**. Passando o mouse sobre o status **Falha**, você vê o erro da última tentativa e o histórico recente do modelo.
* **Investigação:** o item **Investigar** (botão direito sobre uma linha com falha) abre um dossiê técnico com análise por IA, quando o recurso de IA está configurado.
* **Reprocessamento:** administradores podem colocar atualizações que falharam na **Fila de Tentativas**, e o Power Monitor dispara as novas atualizações de forma controlada.
* **Duração:** **Performance › Tempo Médio de Execução** e o alerta opcional **Desvio de Tempo de Execução**.
* **Atraso dos dados:** **Monitoramento › Atualização de Dados** verifica se a data mais recente de uma tabela está dentro do atraso aceitável.

Veja [Falhas de Atualização de Dados](/principais-funcionalidades/falhas-de-atualizacao.md).

## Inventário e governança

Em **Governança › Modelos Semânticos**, você encontra os modelos dos workspaces monitorados, com seus metadados técnicos e de governança (responsável, responsável da área de negócio, área e nível de criticidade), e pode **editar metadados de governança em massa** (administradores). As telas **Tamanho de Modelos** e **Mapeamento de Modelo** (em **Mapeamento**) complementam essas informações.

**Governança › Operação › Agendamentos** mostra um mapa de calor e uma linha do tempo dos agendamentos de atualização, para identificar horários congestionados.

## Qualidade

* **Score de Boas Práticas (BPA):** 55 regras (conjunto do Tabular Editor e diretrizes da Microsoft) em categorias como Performance, Expressões DAX, Formatação, Metadados, Nomenclatura e Layout do Modelo.
* **Score de IA:** 23 regras que avaliam a prontidão do modelo para o Copilot e para perguntas em linguagem natural (descrições, tabela de datas, medidas explícitas, nomenclatura).
* **Performance › Limpeza de Modelo:** colunas, tabelas e medidas não usadas por nenhum visual ou filtro dos relatórios conectados.
* **Dicionário de Dados** e **Linhagem de Dados**.

## Avaliação de Performance (beta)

Em **Performance › Avaliação de Performance**, um administrador solicita uma análise sob demanda de um modelo: estrutura VertiPaq (tabelas e colunas), Power Query, boas práticas, colunas não usadas e consumo na capacidade (interativo e em segundo plano), com recomendações priorizadas. Com o provedor de IA da organização configurado, é possível gerar também uma **Sugestão da IA**.

## Import, DirectQuery e Direct Lake

| Modo                              | Atualização monitorada?                            | Observação                                                                                                   |
| --------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Import**                        | ✅ Sim                                              | Falhas mais comuns: credenciais, gateway, volume de dados, capacidade                                        |
| **DirectQuery / Live Connection** | Não se aplica (não há atualização de dados)        | Depende da disponibilidade da fonte e do gateway                                                             |
| **Direct Lake**                   | Conforme as atualizações registradas pelo Power BI | Depende das tabelas Delta de origem estarem atualizadas; use **Atualização de Dados** para conferir o atraso |

## Páginas relacionadas

* [Modelos Semânticos (Monitoramento)](/power-monitor/monitoramento/modelos-semanticos.md)
* [Modelos Semânticos (Governança)](/power-monitor/governanca/modelos-semanticos.md)
* [Score de Boas Práticas](/power-monitor/qualidade-de-dados/score-de-boas-praticas-bpa.md)
* [Avaliação de Performance](/power-monitor/performance/avaliacao-de-performance.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.powermonitor.com.br/principais-funcionalidades/modelos-semanticos.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
