> 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 ao Power BI

Neste artigo, vamos percorrer o processo de conexão do Microsoft Power BI ao **IoT Query**. Para torná-lo mais ilustrativo, também criaremos um dashboard 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 do **IoT Query** conjunto de documentação e aborda especificamente a conexão do Power BI ao seu data warehouse. Se você ainda estiver decidindo qual ferramenta de BI usar, consulte a [Seleção de ferramentas de BI](/docs/analytics/pt-br/iot-query/connection-setup/selecting-bi-tools.md) visão geral.
{% endhint %}

## Recursos do dashboard

* Exibir o número total de veículos
* Visualizar os status de movimentação dos veículos (em movimento/parado/estacionado)
* Visualizar os 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 movimentação 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 as instruções.

### 2. Baixe o arquivo do dashboard

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

   ```sh
   git clone https://github.com/SquareGPS/bi-intergrations.git
   ```
2. Abra o `moving_status_dashboard.pbix` arquivo baixado clicando duas vezes nele ou por meio do menu do Power BI Desktop: **Arquivo → Abrir**.

## Conexão com o banco de dados

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

1. Após abrir o arquivo do dashboard, 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 **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>Observações</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>Schema</strong></td><td>Editor de consultas</td><td>Especifique o schema (<strong>raw_business_data</strong> ou <strong>raw_telematics_data</strong>) em cada consulta</td></tr></tbody></table>

### 2. Configure as credenciais

1. Ao se conectar pela primeira vez, o Power BI solicitará as credenciais de acesso ao banco de dados.
2. Selecione **Conta do banco de dados e senha** como 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 dashboard

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 Ctrl+R.
2. **Usar filtros** - aplique filtros no painel à direita 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 de filtro e visualizações específicas para acesso rápido.

## Configuração de 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 dashboard no Power BI Service usando o botão **Publicar** no Power BI Desktop.
2. No Power BI Service, vá para as configurações do conjunto de dados.
3. No **Atualização agendada** seção, configure a frequência de atualização.
4. Para se conectar 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 a correção das credenciais e dos parâmetros de conexão.
* **Erro de firewall:** Certifique-se de que seu endereço IP esteja adicionado à allowlist 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 das visualizações:**
  * Reduza o número de elementos exibidos simultaneamente
  * Verifique o modo Importar/DirectQuery no modelo de dados
* **Alto uso 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 algumas dicas que podem ajudá-lo a corrigir problemas comuns:

1. Reabra o Power BI Desktop e o arquivo do dashboard
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 → Global → Limpar itens do cache**

## Próximos passos

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

* Explore os schemas de dados disponíveis revisando a seção [Visão geral do esquema](/docs/analytics/pt-br/iot-query/schema-overview.md) para entender melhor a estrutura e as relações dos dados.
* Comece com consultas simples focadas em entidades de negócio específicas antes de criar dashboards complexos - confira nossas [consultas de exemplo](/docs/analytics/pt-br/example-queries.md) para 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/analytics/pt-br/iot-query/connection-setup/selecting-bi-tools/connecting-power-bi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.