> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Database connector
# Conector de base de datos
El Conector de base de datos te permite conectar de forma segura una base de datos compartida a un **Proyecto**, haciendo que sus datos estén disponibles para todos los miembros del proyecto a través del chat.
> **Cambio importante**: Los conectores de base de datos ya no se añaden directamente dentro de un chat. Ahora son **conectores compartidos a nivel de proyecto**, gestionados desde la barra lateral del proyecto.
Pide a tu administrador de TI que habilite el Conector de base de datos en la configuración del sistema [con el Manual del operador](/es/operator-manual/configuration/features).
***
## Crear un conector de base de datos
Para crear un conector de base de datos:
1. Abre tu **Barra lateral del proyecto**
2. Haz clic en **Conectores**
3. Haz clic en **Crear conector**
4. Selecciona **Base de datos**
5. Introduce los **detalles de conexión** requeridos
6. Establece la conexión
Una vez que la conexión sea exitosa, estarán disponibles opciones de configuración adicionales.
***
### Cadenas de conexión simplificadas
Una cadena de conexión es como una dirección que le dice al sistema dónde encontrar tu base de datos y cómo acceder a ella. Tu equipo de TI puede ayudarte a construir la cadena de conexión correcta para tu base de datos.
#### Tipos de base de datos admitidos
* Microsoft SQL Server
* PostgreSQL
* MySQL
* DB2
#### Cadena de conexión
**Notas de seguridad**:
* Nunca compartas tus cadenas de conexión con otros
* Usa solo las bases de datos que tu equipo de TI ha aprobado
* Asegúrate de que el usuario sea de solo lectura
Esto es lo que significa cada parte (pide a tu equipo de TI los valores correctos):
```
SQL Server: mssql+pyodbc://username:password@server:1433/database
PostgreSQL: postgresql://username:password@server:5432/database
MySQL: mysql+mysqldb://username:password@server:3306/database
DB2: db2+ibm_db://username:password@server:50000/database
```
**Examples**
```sql Microsoft SQL Server theme={null}
mssql+pyodbc://sa:password123@server.company.com:1433/SalesDatabase
mssql+pyodbc://dbuser:mypassword@192.168.1.50:1433/CustomerData
mssql+pyodbc://localhost:1433/TestDB?TrustServerCertificate=yes
```
```sql PostgreSQL theme={null}
postgresql://postgres:admin123@database.company.com:5432/company_data
postgresql://user:password@10.0.0.25:5432/sales_db
postgresql://localhost:5432/public_data
```
```sql MySQL theme={null}
mysql+mysqldb://root:password@mysql.company.com:3306/customer_info
mysql+mysqldb://appuser:secret123@127.0.0.1:3306/inventory
mysql+mysqldb://localhost:3306/reports
```
```sql DB2 theme={null}
db2+ibm_db://db2admin:password123@db2server.company.com:50000/SALESDB
db2+ibm_db://dbuser:mypassword@192.168.1.50:50000/PRODDATA
db2+ibm_db://localhost:50000/TESTDB
```
Recuerda: Reemplaza `username`, `password`, `server` y `database` con tus valores reales.
## Configuración avanzada
Después de que se haya establecido la conexión de la base de datos, puedes configurar parámetros avanzados para controlar cómo se usa la base de datos.
### Restricciones de tabla y esquema
Puedes limitar el acceso del conector a:
* **Esquemas** específicos
* **Tablas** específicas
Esto ayuda a:
* Reducir la exposición innecesaria de datos
* Mejorar la precisión de las consultas
* Evitar que el LLM consulte datos irrelevantes
### Descripción del conector
Puedes definir una **descripción** para el conector de base de datos.
Esta descripción se proporciona al LLM y debe explicar:
* Qué contiene la base de datos
* Cómo están estructurados los datos
* Cualquier regla o convención importante
Una buena descripción mejora significativamente la calidad de las consultas generadas por el LLM.
***
## Usar el conector de base de datos en el chat
Una vez creado, el conector de base de datos se puede usar en chats:
1. Abre o crea un chat dentro del proyecto
2. Usa el **selector de conectores** en la entrada del chat
3. Habilita el conector de base de datos
Cuando está habilitado, el LLM puede consultar la base de datos como parte de la conversación.
***
## Conectores preseleccionados
Los administradores del proyecto pueden configurar los conectores de base de datos para que estén **preseleccionados para cada chat nuevo** en el proyecto.
Esto es especialmente útil cuando:
* La base de datos es una parte central del flujo de trabajo del proyecto
* Los usuarios no técnicos necesitan acceso a MCPs o bases de datos sin tener que lidiar con configuración compleja
* Se requiere acceso consistente a datos en todas las conversaciones
***
## Uso personal y privado
Si un usuario quiere configurar sus **propios conectores de base de datos** sin compartirlos:
1. Crea un **proyecto privado**
2. Crea conectores de base de datos usando el mismo proceso
3. Úsalos exclusivamente dentro de ese proyecto privado
Los proyectos privados permiten experimentación o integraciones personales sin afectar entornos compartidos.
***
## Requisitos y consideraciones
* La base de datos debe ser accesible desde el entorno del conector
* El acceso de red, firewalls y listas de permitidos de IP pueden necesitar configuración
* Las consultas generadas por el LLM respetan el alcance configurado del conector
***
## Seguridad
* Las credenciales se almacenan de forma segura
* El LLM solo puede acceder a datos permitidos por la configuración del conector
* Las restricciones de esquema y tabla se aplican en el momento de la consulta
***
## Solución de problemas de conectividad con bases de datos
Si tu conector de base de datos se queda cargando indefinidamente o da timeout, verifica la conectividad de red desde la máquina donde está instalado Zylon.
### Probar la conexión
Ejecuta este comando desde la máquina donde está instalado Zylon:
```bash theme={null}
curl -v telnet://tu-servidor-db:puerto
```
### Interpretar resultados
**Conexión exitosa:**
```
* Connected to tu-servidor-db (xxx.xxx.xxx.xxx) port xxxx
```
La conectividad de red funciona correctamente. Si los problemas persisten, contacta a soporte.
**Timeout de conexión:**
```
* Failed to connect to tu-servidor-db port xxxx: Operation timed out
```
Problema de red detectado. Revisa reglas de firewall, security groups y listas de permitidos de IP.
**Conexión rechazada:**
```
* Connection refused
```
El servidor de base de datos no está escuchando en ese puerto. Verifica que la base de datos esté en ejecución y configurada para aceptar conexiones externas.
### Causas comunes
* Firewall bloqueando tráfico saliente desde el host de Zylon
* Security groups/ACLs bloqueando el puerto de la base de datos
* Hostname o puerto incorrecto
* Base de datos no aceptando conexiones desde la IP de Zylon
***