# Conexión a Power BI

En este artículo, recorreremos el proceso de conexión de Microsoft Power BI a **Consulta de IoT**. Para hacerlo más ilustrativo, también construiremos un panel que se conecte a la base de datos analítica y supervise el estado en tiempo real de los vehículos, todo usando Microsoft Power BI.

{% hint style="info" %}
Esta guía forma parte de la **Consulta de IoT** suite de documentación y cubre específicamente la conexión de Power BI a su almacén de datos. Si aún está decidiendo qué herramienta de BI usar, consulte la [Seleccionar herramientas de BI](https://www.navixy.com/docs/analytics/es/iot-query/connection-setup/selecting-bi-tools) visión general.
{% endhint %}

## Funciones del panel

* Mostrar número total de vehículos
* Visualizar estados de movimiento del vehículo (en movimiento/detenido/aparcado)
* Visualizar estados de conexión (activo/inactivo/desconectado)
* Tabla detallada con el estado actual de todos los vehículos
* Filtrado por tipo de vehículo, grupo, estado de movimiento y estado de conexión
* Capacidades de exportación de datos e informes

## Requisitos técnicos

* Windows 10/11 o Windows Server 2016+
* Microsoft Power BI Desktop (versión actual)
* Cuenta de Microsoft para acceso a Power BI Service (opcional)
* Mínimo 4 GB de RAM (se recomiendan 8 GB)
* Acceso a Internet para la conexión a la base de datos

## Instalación y configuración

### 1. Instalar Power BI Desktop

1. Descargue Power BI Desktop desde el sitio oficial de Microsoft: <https://powerbi.microsoft.com/desktop/>
2. Ejecute el instalador y siga sus instrucciones.

### 2. Descargar el archivo del panel

1. Descargue el [moving\_status\_dashboard.pbix](https://raw.githubusercontent.com/SquareGPS/bi-intergrations/main/power_bi/moving_status_dashboard.pbix) archivo desde el [bi-intergrations repository](https://github.com/SquareGPS/bi-intergrations) -> `power_bi`. Puede clonar todo el repositorio para interacciones posteriores:

   ```sh
   git clone https://github.com/SquareGPS/bi-intergrations.git
   ```
2. Abra el `moving_status_dashboard.pbix` archivo descargado haciendo doble clic o a través del menú de Power BI Desktop: **Archivo → Abrir**.

## Conexión a la base de datos

### 1. Actualizar parámetros de conexión

1. Después de abrir el archivo del panel, vaya a **Transformar datos → Editar parámetros**.
2. Actualice los siguientes parámetros:

* `DB_HOST` - dirección del servidor de la base de datos
* `DB_NAME` - nombre de la base de datos
* `DB_USER` - nombre de usuario
* `DB_PASS` - contraseña (no guarde archivos con credenciales reales en accesos compartidos)
* `DB_PORT` - puerto de conexión (predeterminado 5432)

3. Haga clic **Aceptar** y aplique los cambios.

#### Referencia de parámetros de conexión

<table><thead><tr><th width="189.727294921875">Parámetro Lakehouse</th><th width="214.1817626953125">Ubicación de configuración de Power BI</th><th>Notas</th></tr></thead><tbody><tr><td><strong>Host</strong></td><td><code>DB_HOST</code> parámetro</td><td>La dirección del servidor de base de datos proporcionada en su correo electrónico de bienvenida</td></tr><tr><td><strong>Puerto</strong></td><td><code>DB_PORT</code> parámetro</td><td>Por defecto es 5432 para PostgreSQL</td></tr><tr><td><strong>Nombre de la base de datos</strong></td><td><code>DB_NAME</code> parámetro</td><td>El nombre de base de datos asignado</td></tr><tr><td><strong>Nombre de usuario</strong></td><td><code>DB_USER</code> parámetro</td><td>Su nombre de usuario de la base de datos</td></tr><tr><td><strong>Contraseña</strong></td><td><code>DB_PASS</code> parámetro</td><td>Su contraseña segura de la base de datos</td></tr><tr><td><strong>Modo SSL</strong></td><td>Configuración de conexión</td><td>Establecer en <strong>require</strong> en el cuadro de diálogo Opciones</td></tr><tr><td><strong>Esquema</strong></td><td>Editor de consultas</td><td>Especifique el esquema (<strong>raw_business_data</strong> o <strong>raw_telematics_data</strong>) en cada consulta</td></tr></tbody></table>

### 2. Configurar credenciales

1. Al conectarse por primera vez, Power BI solicitará las credenciales de acceso a la base de datos.
2. Seleccione **Cuenta y contraseña de la base de datos** como tipo de autenticación.
3. Introduzca las credenciales proporcionadas por su administrador.
4. Establezca el nivel de privacidad en **Organización** o **Privado**.

## Uso del panel

Después de configurar la conexión, usted puede:

1. **Actualizar datos** - haga clic en el **Actualizar** botón en la cinta o use el atajo de teclado Ctrl+R.
2. **Usar filtros** - aplique filtros en el panel derecho o directamente en los elementos del informe:
   1. Filtrar por tipo de vehículo
   2. Filtrar por grupos
   3. Filtrar por estado de movimiento/conexión
3. **Profundizar en los datos** - haga clic en los elementos de visualización para ver información detallada.
4. **Crear marcadores** - guarde configuraciones y vistas de filtros específicas para acceso rápido.

## Configuración de actualización de datos

### Actualización local

1. En Power BI Desktop, abra el menú **Inicio → Actualizar**.
2. Para configurar actualizaciones periódicas a través de Power BI Service, publique el informe en Power BI Service.

### Actualización en la nube (Power BI Service)

1. (Opcional) Publique el panel en Power BI Service usando el **Publicar** botón en Power BI Desktop.
2. En Power BI Service, vaya a la configuración del conjunto de datos.
3. En la **Actualización programada** sección, configure la frecuencia de actualización.
4. Para conectarse a una base de datos local o privada, necesitará instalar y configurar el Power BI Gateway.

## Resolución de problemas

### Problemas de conexión a la base de datos

* **Error de conexión:** Compruebe la corrección de las credenciales y los parámetros de conexión.
* **Error de firewall:** Asegúrese de que su dirección IP esté añadida a la lista de permitidos para el acceso a la base de datos.
* **Problemas con el Gateway:** Al usar Power BI Gateway, verifique el estado del servicio del gateway.

### Problemas de rendimiento

* **Carga lenta de visualizaciones:**
  * Reduzca el número de elementos mostrados simultáneamente
  * Compruebe el modo Importación/DirectQuery en el modelo de datos
* **Alto uso de memoria:**
  * Reduzca la cantidad de datos importados aplicando filtros a nivel de consulta
  * Elimine columnas innecesarias del modelo de datos

### Otros problemas

Aquí hay algunos trucos que pueden ayudarle a solucionar problemas comunes:

1. Vuelva a abrir Power BI Desktop y el archivo del panel
2. Compruebe si hay actualizaciones de Power BI Desktop
3. Reinstale Power BI Desktop si es necesario
4. Borre la caché de Power BI: **Archivo → Opciones → Global → Borrar elementos de la caché**

## Próximos pasos

Después de conectar con éxito Power BI a su instancia Private Telematics Lakehouse, le recomendamos que:

* Explore los esquemas de datos disponibles revisando la sección [Descripción del esquema](https://www.navixy.com/docs/analytics/es/iot-query/schema-overview) para comprender mejor la estructura de los datos y las relaciones.
* Comience con consultas simples centradas en entidades comerciales específicas antes de construir paneles complejos: consulte nuestras [consultas de ejemplo](https://www.navixy.com/docs/analytics/es/example-queries) para referencia.

### **Soporte**

Para preguntas técnicas o solicitudes de acceso a la base de datos de demostración, comuníquese con: <support@squaregps.com>