Bases de datos

Conecta una base de datos y cualquier persona del espacio de trabajo podrá hacerle preguntas sin escribir SQL: «¿cuáles son nuestros cinco mejores clientes por valor de pedido?». La IA lee el esquema, escribe la consulta, la ejecuta y convierte el resultado en una tabla y una conclusión. Cada consulta que ejecutó está a un clic, así que siempre puedes comprobar la respuesta.

app.stickyprompts.com Grabación de pantalla

Tutorial 6 de 14 · 1:28 Connect your tools Vídeo en inglés, grabado en la aplicación real

Bases de datos compatibles

MySQL, MariaDB, PostgreSQL y SQL Server. Microsoft Power BI aparece en Databases & BI con la etiqueta Coming soon (próximamente). Puedes conectar todas las bases de datos que necesites.

Antes de empezar

Haz primero estas dos cosas por tu parte. Son las que hacen que la conexión sea segura.

1. Crea un usuario de base de datos exclusivo para StickyPrompts con los privilegios mínimos imprescindibles: para la mayoría de los equipos, acceso de lectura a las tablas sobre las que se va a preguntar y nada más. Nunca reutilices una cuenta de administrador o de aplicación.
2. Haz que la base de datos sea accesible. Permite la dirección IP de StickyPrompts en tu firewall o, si la base de datos está en una red privada, usa el SSH bridge (puente SSH, que se explica más abajo).

188.245.64.188

Esa es la dirección desde la que llegan todas las conexiones de base de datos de StickyPrompts. Permítela en el puerto de la base de datos, y solo a ella.

Conectar una base de datos

1. Abre Add connection y elige la base de datos

   Ve a Integrations, selecciona Add connection, elige Workspace (compartida con todos) o Personal (solo para ti), filtra por Databases & BI y selecciona MySQL, MariaDB, PostgreSQL o SQL Server. Solo los propietarios y administradores del espacio de trabajo pueden añadir conexiones del espacio de trabajo.

2. Descríbela

   Dale un nombre y una descripción que la gente reconozca, como Northwind Retail DB y Pedidos, clientes y productos de las tiendas.

3. Introduce los datos de conexión

   Campo	Qué introducir
   Host	La dirección del servidor de base de datos. Si usas el SSH bridge, la dirección tal como la ve el servidor de salto, normalmente localhost.
   Port	Normalmente 3306 para MySQL y MariaDB, 5432 para PostgreSQL y 1433 para SQL Server.
   Database	El nombre de la base de datos.
   Schema	Opcional. Si lo dejas vacío, PostgreSQL usa public y SQL Server usa dbo.
   Usuario y contraseña	Los del usuario exclusivo de StickyPrompts.
   SSL mode	Require, Verify CA, Verify full o Disable. Usa Verify full cuando tu servidor tenga un certificado que puedas verificar; nunca uses Disable a través de internet.

4. Elige el nivel de permiso

   Elige Read only, salvo que tengas un motivo concreto para no hacerlo. Consulta Niveles de permiso.

5. Prueba y guarda

   StickyPrompts se conecta a tu base de datos con estos datos antes de guardar. Si no consigue llegar al servidor o iniciar sesión, verás el error y no se guardará nada. Una vez guardada, la base de datos aparece en Databases & BI con su nivel de permiso en la tarjeta.

   app.stickyprompts.com/integrations 1 Nivel de permiso 2 Compartida con el espacio de trabajo

Niveles de permiso

Nivel	Qué puede ejecutar la IA
Read only	Una sola instrucción SELECT (o WITH ... SELECT) cada vez. Todo lo demás se rechaza.
Read & write	SELECT, además de INSERT y UPDATE.
Full access	Todo lo que tu usuario de base de datos tenga permitido ejecutar, incluidos DELETE, DROP y los cambios de esquema.

Read only comprueba cada instrucción antes de ejecutarla y rechaza todo lo que no sea una única lectura. Como la comprobación busca palabras como update o delete en cualquier parte del SQL, una lectura inofensiva que contenga una de esas palabras (por ejemplo, una columna llamada update_note) puede rechazarse. Reformula la pregunta o pide a la IA que evite esa columna.

Llegar a una base de datos privada con el SSH bridge

Si tu base de datos no es accesible desde internet, StickyPrompts puede conectarse a través de un servidor de salto SSH (jump host o bastión) que sí llegue a ella.

1. Activa el SSH bridge

   En el formulario de la conexión de base de datos, activa el SSH bridge e introduce los campos SSH host, SSH port (normalmente 22) y SSH username del servidor de salto.

2. Autoriza la clave de StickyPrompts en el servidor de salto

   El formulario muestra una clave pública. Añádela como una sola línea a ~/.ssh/authorized_keys de ese usuario SSH en el servidor de salto:

   servidor de salto

   $ echo 'ssh-ed25519 AAAA...copied-from-stickyprompts' >> ~/.ssh/authorized_keys

   $ chmod 600 ~/.ssh/authorized_keys

   Solo se muestra la clave pública. La clave privada nunca sale de StickyPrompts.

3. Indica el host tal como lo ve el servidor de salto

   En Host, escribe la dirección de la base de datos tal como la ve el servidor de salto: localhost si la base de datos se ejecuta en el propio servidor de salto, o su dirección privada en tu red. Permite que 188.245.64.188 llegue al puerto SSH del servidor de salto.

Hacer preguntas

Pregunta como se lo preguntarías a un analista. Si tienes más de una base de datos, indica cuál.

En nuestra base de datos de retail: ¿quiénes son nuestros 5 mejores clientes por
valor total de pedidos y qué parte de los ingresos representan? Una tabla y una conclusión.

¿Qué productos vendieron menos de 10 unidades el mes pasado según la base de datos de retail?

La IA primero enumera tus conexiones de base de datos, después lee las tablas y sus columnas y, por último, ejecuta una o varias consultas, razonando entre un paso y otro. Despliega la línea actions que hay sobre la respuesta para ver cada llamada y el SQL que ejecutó.

app.stickyprompts.com/conversations 1 Primero lee el esquema 2 Ábrelo para ver el SQL

Solución de problemas

Problema	Qué comprobar
No se puede conectar	¿Está permitida 188.245.64.188 en tu firewall, en el puerto correcto? ¿Se puede llegar al host desde internet o necesitas el SSH bridge?
Errores de SSL	Puede que tu servidor no admita SSL o que, con Verify full, su certificado no coincida con el nombre del host. Prueba con Require para confirmarlo y después corrige el certificado.
Falla el SSH bridge	¿Está la clave pública en una sola línea en authorized_keys del usuario correcto? ¿Es Host la dirección tal como la ve el servidor de salto?
Se rechaza una consulta de lectura	Consulta la nota de Niveles de permiso sobre palabras como update dentro de una lectura.
La respuesta parece incorrecta	Despliega las acciones y lee el SQL. Dile a la IA qué debe cambiar («cuenta solo los pedidos completados») y vuelve a preguntar.

Páginas relacionadas