# Conectando o Power BI

Neste artigo, percorreremos o processo de conectar o Microsoft Power BI ao **Consulta IoT**. Para tornar mais ilustrativo, também construiremos 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 do **Consulta IoT** conjunto de documentação e cobre especificamente a conexão do Power BI ao seu data warehouse. Se você ainda está decidindo qual ferramenta de BI usar, consulte o [Selecionando ferramentas de BI](https://www.navixy.com/docs/analytics/pt-br/iot-query/connection-setup/selecting-bi-tools) visão geral.
{% endhint %}

## Recursos do painel

* Exibir 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 ao banco de dados

## Instalação e configuração

### 1. Instalar 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. Baixar o arquivo do painel

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 o repositório inteiro para interações futuras:

   ```sh
   git clone https://github.com/SquareGPS/bi-intergrations.git
   ```
2. Abra o `moving_status_dashboard.pbix` arquivo baixado dando um duplo clique ou através do menu do Power BI Desktop: **Arquivo → Abrir**.

## Conexão com o banco de dados

### 1. Atualizar parâmetros de conexão

1. Após 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 **OK** e aplique as alterações.

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

<table><thead><tr><th width="189.727294921875">Parâmetro 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>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. Configurar 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

Após 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. **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. **Aprofundar nos dados** - clique nos elementos de visualização para ver informações detalhadas.
4. **Criar favoritos** - salve configurações e visualizações de filtros específicos 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 através 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 seção **Atualização agendada** , configure a frequência de atualização.
4. Para conectar a um banco de dados local ou privado, será necessário 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:** Assegure-se de que seu endereço IP esteja 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 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 alguns truques que podem ajudá-lo a corrigir problemas comuns:

1. Reabra o Power BI Desktop e o arquivo do painel
2. Verifique 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 esquemas de dados disponíveis revisando a [Visão geral do esquema](https://www.navixy.com/docs/analytics/pt-br/iot-query/schema-overview) seção para entender melhor a estrutura e os relacionamentos dos dados.
* Comece com consultas simples focadas em entidades de negócio específicas antes de construir painéis complexos - consulte nossas [consultas de exemplo](https://www.navixy.com/docs/analytics/pt-br/example-queries) para referência.

### **Suporte**

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