> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/pt-br/iot-query/connection-setup/selecting-bi-tools/connecting-power-bi.md).

# Conectando o Power BI

Conecte o Power BI ao IoT Query por meio do conector PostgreSQL. Consulte dados telemáticos em tempo real e crie Relatórios e painéis interativos de monitoramento de Frota

Neste artigo, vamos percorrer o processo de conectar o Microsoft Power BI a **IoT Query**. Para torná-lo mais ilustrativo, também criaremos um painel que se conecta ao banco de dados analítico e monitora o status em tempo real dos Veículos, tudo usando o Microsoft Power BI.

{% hint style="info" %}
Este guia faz parte da **IoT Query** suíte de documentação e cobre especificamente a conexão do Power BI ao seu data warehouse. Se você ainda estiver decidindo qual ferramenta de BI usar, consulte a [Selecionando ferramentas de BI](/docs/analytics/pt-br/iot-query/connection-setup/selecting-bi-tools.md) Visão geral.
{% endhint %}

## Funcionalidades do painel

* Exibir o número total de Veículos
* Visualizar status de Movimento dos Veículos (Em movimento/Parado/Estacionado)
* Visualizar status de conexão (ativo/ocioso/offline)
* Tabela detalhada com o status atual de todos os Veículos
* Filtragem por tipo de veículo, Grupo, status de Movimento e status de conexão
* Capacidades de exportação de dados e relatórios

## Requisitos técnicos

* Windows 10/11 ou Windows Server 2016+
* Microsoft Power BI Desktop (versão atual)
* Conta Microsoft para acesso ao Power BI Service (opcional)
* Mínimo de 4 GB de RAM (8 GB recomendados)
* Acesso à internet para conexão com o banco de dados

## Instalação e configuração

### 1. Instale o Power BI Desktop

1. Baixe o Power BI Desktop no site oficial da Microsoft: <https://powerbi.microsoft.com/desktop/>
2. Execute o instalador e siga suas instruções.

### 2. Baixe o arquivo do painel

1. Baixe o [Em movimento\_status\_dashboard.pbix](https://raw.githubusercontent.com/Navixy/bi-integrations/main/power_bi/moving_status_dashboard.pbix) arquivo do [repositório bi-intergrations](https://github.com/Navixy/bi-integrations) -> `power_bi`. Você pode clonar todo o repositório para interações adicionais:

   ```sh
   git clone https://github.com/Navixy/bi-integrations.git
   ```
2. Abra o arquivo baixado `Em movimento_status_dashboard.pbix` arquivo dando duplo clique ou pelo menu do Power BI Desktop: **Arquivo → Abrir**.

## Conexão com o banco de dados

### 1. Atualize os parâmetros de conexão

1. Depois de abrir o arquivo do painel, vá para **Transformar dados → Editar parâmetros**.
2. Atualize os seguintes parâmetros:

* `DB_HOST` - endereço do servidor de banco de dados
* `DB_NAME` - nome do banco de dados
* `DB_USER` - nome de usuário
* `DB_PASS` - senha (não salve arquivos com credenciais reais em acesso compartilhado)
* `DB_PORT` - porta de conexão (padrão 5432)

3. Clique em **OK** e aplique as alterações.

#### Referência de parâmetros de conexão

<table><thead><tr><th width="189.727294921875">Parâmetro do Lakehouse</th><th width="214.1817626953125">Localização da configuração do Power BI</th><th>Notas</th></tr></thead><tbody><tr><td><strong>Host</strong></td><td><code>DB_HOST</code> parâmetro</td><td>O endereço do servidor de banco de dados fornecido no seu e-mail de boas-vindas</td></tr><tr><td><strong>Porta</strong></td><td><code>DB_PORT</code> parâmetro</td><td>O padrão é 5432 para PostgreSQL</td></tr><tr><td><strong>Nome do banco de dados</strong></td><td><code>DB_NAME</code> parâmetro</td><td>O nome do banco de dados atribuído a você</td></tr><tr><td><strong>Nome de usuário</strong></td><td><code>DB_USER</code> parâmetro</td><td>Seu nome de usuário do banco de dados</td></tr><tr><td><strong>Senha</strong></td><td><code>DB_PASS</code> parâmetro</td><td>Sua senha segura do banco de dados</td></tr><tr><td><strong>Modo SSL</strong></td><td>Configurações de conexão</td><td>Defina como <strong>require</strong> na caixa de diálogo Opções</td></tr><tr><td><strong>Esquema</strong></td><td>Editor de consultas</td><td>Especifique o esquema (<strong>raw_business_data</strong> ou <strong>raw_telematics_data</strong>) em cada consulta</td></tr></tbody></table>

### 2. Configure credenciais

1. Ao conectar pela primeira vez, o Power BI solicitará credenciais de acesso ao banco de dados.
2. Selecione **Conta e senha do banco de dados** como o tipo de autenticação.
3. Insira as credenciais fornecidas pelo seu administrador.
4. Defina o nível de privacidade como **Organização** ou **Privado**.

## Usando o painel

Depois de configurar a conexão, você pode:

1. **Atualizar dados** - clique no **Atualizar** botão na faixa de opções ou use o atalho de teclado Ctrl+R.
2. **Use filtros** - aplique filtros no painel direito ou diretamente nos elementos do relatório:
   1. Filtrar por tipo de veículo
   2. Filtrar por grupos
   3. Filtrar por status de Movimento/conexão
3. **Detalhar os dados** - clique nos elementos de visualização para ver informações detalhadas.
4. **Criar marcadores** - salve configurações específicas de filtros e visualizações para acesso rápido.

## Configuração da atualização de dados

### Atualização local

1. No Power BI Desktop, abra o menu **Página inicial → Atualizar**.
2. Para configurar atualizações regulares por meio do Power BI Service, publique o relatório no Power BI Service.

### Atualização na nuvem (Power BI Service)

1. (Opcional) Publique o painel no Power BI Service usando o **Publicar** botão no Power BI Desktop.
2. No Power BI Service, vá para as configurações do conjunto de dados.
3. Na **Atualização agendada** seção, configure a frequência de atualização.
4. Para conectar-se a um banco de dados local ou privado, você precisará instalar e configurar o Power BI Gateway.

## Solução de problemas

### Problemas de conexão com o banco de dados

* **Erro de conexão:** Verifique se as credenciais e os parâmetros de conexão estão corretos.
* **Erro de firewall:** Certifique-se de que seu endereço IP foi adicionado à lista de permissões para acesso ao banco de dados.
* **Problemas com o Gateway:** Ao usar o Power BI Gateway, verifique o status do serviço do gateway.

### Problemas de desempenho

* **Carregamento lento da visualização:**
  * Reduza o número de elementos exibidos simultaneamente
  * Verifique o modo Import/DirectQuery no modelo de dados
* **Uso elevado de memória:**
  * Reduza a quantidade de dados importados aplicando filtros no nível da consulta
  * Remova colunas desnecessárias do modelo de dados

### Outros problemas

Aqui estão alguns truques que podem ajudar você a corrigir problemas comuns:

1. Reabra o Power BI Desktop e o arquivo do painel
2. Verifique se há atualizações do Power BI Desktop
3. Reinstale o Power BI Desktop, se necessário
4. Limpe o cache do Power BI: **Arquivo → Opções → Geral → Limpar itens do cache**

## Próximas etapas

Depois de conectar com sucesso o Power BI à sua instância Private Telematics Lakehouse, recomendamos que você:

* Explore os esquemas de dados disponíveis revisando a [Visão geral do esquema](/docs/analytics/pt-br/iot-query/schema-overview.md) seção para entender melhor a estrutura e os relacionamentos dos dados.
* Comece com consultas simples focadas em entidades de negócios específicas antes de criar painéis complexos - confira nossas [consultas de exemplo](/docs/analytics/pt-br/example-queries.md) como referência.

### **Suporte**

Para dúvidas técnicas ou solicitações de acesso ao banco de dados de demonstração, entre em contato com: <support@squaregps.com>


---

# 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://navixy.com/docs/analytics/pt-br/iot-query/connection-setup/selecting-bi-tools/connecting-power-bi.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.