# Configuración de la conexión

Esta guía explica cómo conectarse a su **IoT Query** instancia, que está construida sobre **Neon PostgreSQL**.

## Parámetros de conexión

Cuando su **IoT Query** instancia esté configurada, recibirá estos parámetros de conexión por correo electrónico:

<table><thead><tr><th width="164.9091796875">Parámetro</th><th>Descripción</th></tr></thead><tbody><tr><td><strong>Host</strong></td><td>La dirección del servidor de base de datos</td></tr><tr><td><strong>Puerto</strong></td><td>El puerto de conexión (normalmente 5432)</td></tr><tr><td><strong>Nombre de la base de datos</strong></td><td>El nombre de base de datos asignado</td></tr><tr><td><strong>Nombre de usuario</strong></td><td>Su nombre de usuario de la base de datos</td></tr><tr><td><strong>Contraseña</strong></td><td>Su contraseña segura de la base de datos</td></tr><tr><td><strong>Modo SSL</strong></td><td>El modo de conexión SSL</td></tr></tbody></table>

## Arquitectura de datos

Su **IoT Query** organiza los datos en esquemas específicos:

* [`raw_business_data`](https://www.navixy.com/docs/analytics/es/schema-overview/bronze-layer#raw_business_data-structure) - Contiene tablas de datos empresariales (usuarios, objetos, tareas, etc.)
* [`raw_telematics_data`](https://www.navixy.com/docs/analytics/es/schema-overview/bronze-layer#raw_telematics_data-structure) - Contiene datos telemáticos de los dispositivos del cliente (trayectos GPS, lecturas de sensores)

{% hint style="info" %}
Al consultar datos, debe especificar tanto el esquema (p. ej. `raw_business_data`) como la tabla (p. ej. `objects`) nombre: `SELECT * FROM raw_business_data.objects LIMIT 10;`
{% endhint %}

## Compatibilidad con PostgreSQL

**IoT Query** es totalmente compatible con el protocolo PostgreSQL. Puede conectarse usando:

* Clientes PostgreSQL estándar (pgAdmin, DBeaver, etc.)
* Lenguajes de programación con controladores PostgreSQL (Python, Java, Node.js)
* Herramientas de inteligencia empresarial que soportan PostgreSQL (Tableau, Power BI)

## Formato de la cadena de conexión

Para acceso programático, use el formato estándar de cadena de conexión de PostgreSQL:

```sql
postgresql://username:password@host:port/database?sslmode=ssl_mode
```

Ejemplo con marcadores de posición:

{% code overflow="wrap" %}

```sql
postgresql://client_user:your_password@db.example.cloud:5432/client_123_dwh?sslmode=require
```

{% endcode %}

## Seguridad de la conexión

Consideraciones importantes de seguridad:

* **Cifrado SSL** - La transmisión de sus datos está cifrada según el modo SSL especificado
* **Configuración de red** - Su red debe permitir conexiones salientes al host y puerto proporcionados
* **Seguridad de las credenciales** - Sus credenciales de conexión son únicas para su instancia y deben mantenerse seguras

### Mejores prácticas para conexiones

Al trabajar con su **IoT Query**:

* **Gestione conexiones inactivas** - Cierre las conexiones cuando no estén en uso para liberar recursos
* **Use agrupación de conexiones** - Para aplicaciones con acceso frecuente a la base de datos
* **Almacene las credenciales de forma segura** - Nunca codifique las credenciales en scripts o aplicaciones
* **Establezca tiempos de espera adecuados** - Configure tiempos de espera de conexión razonables para su caso de uso

## Solución de problemas de conexión

Si encuentra problemas de conexión:

1. Verifique que sus parámetros de conexión coincidan con los indicados en su correo de bienvenida
2. Confirme que su red permite la conexión al host y puerto especificados
3. Asegúrese de que su cliente soporta el modo SSL requerido

## Próximos pasos

Después de establecer una conexión, continúe con la [Descripción del esquema](https://www.navixy.com/docs/analytics/es/iot-query/schema-overview) sección para aprender sobre las estructuras de datos y tablas disponibles.