# PostgreSQL

Conecte su base de datos PostgreSQL y sus tablas llegan a <Term id="nexus">Nexus</Term> para analizarlas y crear aplicaciones. El trabajo se hace sobre la copia, sin cargar nunca la base de datos de su producto.

La IA de su <Term id="studio">Studio</Term> prepara la conexión; usted la termina con un usuario y una contraseña que solo leen.

## Antes de empezar [#antes-de-empezar]

- Un <Term id="project">proyecto</Term>. La IA de su Studio hace el trabajo. Consulte [Crear un proyecto](/docs/es/projects/create-a-project).
- Un **usuario de base de datos de solo lectura**. Nunca le dé a Klarety el usuario que usa su aplicación. Pídale a su administrador de base de datos que cree uno, o ejecute esto como propietario de la base de datos (cambie los nombres por los suyos):

```sql title="read_only_user.sql"
CREATE ROLE klarety_reader LOGIN PASSWORD 'choose-a-long-password';
GRANT CONNECT ON DATABASE your_database TO klarety_reader;
GRANT USAGE ON SCHEMA public TO klarety_reader;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO klarety_reader;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO klarety_reader;
```

  La última línea hace que también se puedan leer las tablas que se creen después en ese esquema, pero solo las que cree el usuario que ejecuta estos comandos. Repita las líneas `USAGE` y `SELECT` por cada esquema que quiera compartir.
- La dirección de la base de datos (nombre de host y puerto) y el nombre de la base de datos.
- La base de datos debe aceptar conexiones desde fuera de su red. Si solo acepta direcciones conocidas, hable primero con quien la administra.

## Conéctelo [#conéctelo]

<Steps>
<Step>
### Abra PostgreSQL [#abra-postgresql]
Vaya a <AppLink to="connectors" />, busque **PostgreSQL** y ábralo.
</Step>
<Step>
### Envíe la solicitud a la IA de un proyecto [#envíe-la-solicitud-a-la-ia-de-un-proyecto]
En **Conéctelo con la IA de su Studio**, elija el **Proyecto** que usará PostgreSQL. **Lo que se le pide a la IA** empieza con una solicitud para conectar PostgreSQL a este proyecto para que pueda cargar tablas de su base de datos con un usuario de solo lectura. Edítela para que diga exactamente lo que necesita, por ejemplo: "Cargue las tablas clientes y pedidos de nuestra base de datos de producción y actualice pedidos cada noche". Luego seleccione **Enviar a la IA**.

La IA empieza de inmediato si el Studio está abierto, o cuando se abra. Seleccione **Abrir Studio** para ir allí.

<Screenshot src="/docs/_media/connect-data-with-ai-in-dashboard-data-page.png" alt="Conectar PostgreSQL con la IA de un proyecto desde la página de Conectores" />
</Step>
<Step>
### Termine la conexión [#termine-la-conexión]
La IA prepara la conexión y nunca le pide una clave en el chat. El borrador aparece como **Esperando su respuesta**. Seleccione **Conectar** para abrir el diálogo de conexión de PostgreSQL.

Para una base de datos, el diálogo tiene dos campos: **Nombre de usuario** y **Contraseña**. Ingrese el usuario de solo lectura que preparó. El diálogo muestra la única dirección a la que se envía el usuario, que es la de su base de datos. Revísela antes de continuar.
</Step>
<Step>
### Elija qué puede hacer la IA [#elija-qué-puede-hacer-la-ia]
En **Qué puede hacer la IA con ello**, elija **Puede leer** (nada cambia) o **Puede leer y modificar** (la IA también puede agregar, modificar y eliminar elementos). Luego seleccione **Conectar**.

<Screenshot src="/docs/_media/slack-connector-how-to-connect-in-ui.png" alt="El diálogo de conexión de PostgreSQL con la elección de acceso" />
</Step>
<Step>
### Pruébela y avise a la IA [#pruébela-y-avise-a-la-ia]
El diálogo indica que PostgreSQL está conectado. Seleccione **Probar** y luego **Avisar a la IA** para que continúe.
</Step>
</Steps>

También puede empezar desde un proyecto: en **Configuración**, **Claves**, descríbalo en **¿Qué quiere conectar?** y seleccione **Pedir a la IA que conecte**.

<Callout type="warn" title="Manténgala de solo lectura">
  Elija **Puede leer**. Aun con un usuario de solo lectura, esto evita que la IA intente cambiar algo.
</Callout>

## Lo que obtiene [#lo-que-obtiene]

Cada tabla que pida se convierte en una <Term id="table">tabla</Term> de Nexus con las mismas columnas. La IA la lee con una consulta por tabla, así que puede pedir una parte: "solo los pedidos desde 2025" o "solo las columnas que necesitamos para los informes".

- Consulte las tablas en el <AppLink to="data.sql" /> y únalas con sus otros datos.
- Pídale a la IA que mantenga una tabla al día, por ejemplo cada noche. Ella crea un <Term id="agent">agente</Term> que la vuelve a cargar según un horario. Consulte [Qué hacen los agentes](/docs/es/agents).
- Decida quién ve cada tabla en [Acceso a datos](/docs/es/data/data-access).

## Probar, pausar y reconectar [#probar-pausar-y-reconectar]

Las conexiones de un proyecto aparecen en su **Configuración**, en **Claves**, con su estado.

<Screenshot src="/docs/_media/manage-connections-by-toggle-on-off-per-project.png" alt="Las conexiones de un proyecto en Configuración, Claves" />

| Estado | Qué significa |
| --- | --- |
| **Esperando su respuesta** | La preparó la IA. Seleccione **Conectar** para terminarla. |
| **Funciona** | Conectada y lista para el proyecto. |
| **Requiere reconexión** | La clave o el inicio de sesión dejó de funcionar. Seleccione **Reconectar**. |
| **En pausa** | Nadie puede usarla hasta que seleccione **Reanudar**. |

Desde la misma fila: **Probar**, **Pausar**, **Desactivar aquí** (este proyecto deja de usarla) o **Quitar** (elimina la clave y todos los Studios que la usan dejan de acceder a PostgreSQL).

Una conexión pertenece al proyecto donde se creó. Propietarios y administradores las ven todas en **Sus conexiones**, en <AppLink to="connectors" />. Sigue desactivada para otros proyectos hasta que un administrador la active en la lista de proyectos que pueden usarla.

## Si la prueba falla [#si-la-prueba-falla]

**Probar** indica uno de estos resultados:

- Funciona: el proyecto llegó al servicio.
- La clave fue rechazada: seleccione **Reconectar** e ingrese una nueva.
- No se puede acceder al servicio: revise que esté disponible y acepte conexiones externas, y pruebe de nuevo.
- Internet está desactivado: el internet del proyecto está **Desactivado**. Actívelo en su **Configuración**. Con **Solo permitidos**, el Studio solo llega a sus conexiones y a los sitios que usted agregue.
- Aún no está conectada: seleccione **Conectar**.

Propios de las bases de datos:

- **Se rechaza el usuario.** Revise el nombre de usuario y la contraseña, y que el usuario tenga `CONNECT` sobre la base de datos. Seleccione **Reconectar** para ingresarlos de nuevo.
- **Falta una tabla.** El usuario de solo lectura no la ve. Otorgue `USAGE` sobre su esquema y `SELECT` sobre la tabla, y vuelva a pedírselo a la IA.
- **La dirección no es la que esperaba.** No continúe. Indíquele a la IA el host correcto en el chat; la dirección no es un secreto.

## A dónde va su clave [#a-dónde-va-su-clave]

La clave o el inicio de sesión se cifra con un servicio de claves administrado en cuanto selecciona **Conectar**, y ni siquiera la IA puede leerlo. El Studio nunca tiene la clave. Si el único sitio al que se envía no es la dirección propia del servicio, Klarety se lo advierte y le pide escribir el sitio para confirmar.

## Siguientes pasos [#siguientes-pasos]

- [Tablas](/docs/es/data/tables)
- [Editor SQL](/docs/es/data/sql-editor)
- [Cómo funcionan los conectores](/docs/es/connectors)