Bases de données

Connectez une base de données, et chaque membre de l’espace de travail peut l’interroger sans écrire de SQL : « quels sont nos cinq meilleurs clients en valeur de commandes ? » L’IA lit le schéma, écrit la requête, l’exécute et transforme le résultat en un tableau accompagné d’une conclusion. Chaque requête exécutée est accessible en un clic : la réponse est donc toujours vérifiable.

app.stickyprompts.com Enregistrement d'écran

Tutoriel 6 sur 14 · 1:28 Connect your tools Vidéo en anglais, enregistrée dans l'application réelle

Bases de données prises en charge

MySQL, MariaDB, PostgreSQL et SQL Server. Microsoft Power BI apparaît dans la catégorie Databases & BI avec la mention Coming soon. Vous pouvez connecter autant de bases de données que nécessaire.

Avant de commencer

Commencez par faire ces deux choses de votre côté. Ce sont elles qui rendent la connexion sûre.

1. Créez un utilisateur de base de données dédié à StickyPrompts, avec le minimum de privilèges qui suffit : pour la plupart des équipes, un accès en lecture aux tables sur lesquelles porteront les questions, et rien d’autre. Ne réutilisez jamais un compte administrateur ou un compte applicatif.
2. Rendez la base de données joignable. Autorisez l’adresse IP de StickyPrompts dans votre pare-feu ou, si la base se trouve sur un réseau privé, utilisez le SSH bridge (voir plus bas).

188.245.64.188

C’est de cette adresse que proviennent toutes les connexions de StickyPrompts aux bases de données. Autorisez-la sur le port de la base de données, et elle seule.

Connecter une base de données

1. Ouvrez Add connection et choisissez la base de données

   Accédez à Integrations, sélectionnez Add connection, choisissez Workspace (partagée avec tout le monde) ou Personal (pour vous uniquement), filtrez par Databases & BI et sélectionnez MySQL, MariaDB, PostgreSQL ou SQL Server. Seuls les propriétaires et les administrateurs de l’espace de travail peuvent ajouter des connexions d’espace de travail.

2. Décrivez-la

   Donnez-lui un nom et une description que tout le monde reconnaîtra, par exemple Northwind Retail DB et Commandes, clients et produits des magasins.

3. Saisissez les paramètres de connexion

   Champ	Ce qu’il faut saisir
   Host	L’adresse du serveur de base de données. Si vous utilisez le SSH bridge, l’adresse telle que la voit le serveur de rebond, généralement localhost.
   Port	En général 3306 pour MySQL et MariaDB, 5432 pour PostgreSQL, 1433 pour SQL Server.
   Database	Le nom de la base de données.
   Schema	Facultatif. Si vous le laissez vide, PostgreSQL utilise public et SQL Server utilise dbo.
   Username et password	L’utilisateur dédié à StickyPrompts.
   SSL mode	Require, Verify CA, Verify full ou Disable. Choisissez Verify full si votre serveur dispose d’un certificat vérifiable ; n’utilisez jamais Disable à travers Internet.

4. Choisissez le niveau d'autorisation

   Choisissez Read only, sauf raison précise de faire autrement. Voir Niveaux d’autorisation.

5. Testez et enregistrez

   Avant d’enregistrer, StickyPrompts se connecte à votre base de données avec ces paramètres. S’il ne parvient pas à joindre le serveur ou à s’authentifier, l’erreur s’affiche et rien n’est enregistré. Une fois enregistrée, la base apparaît sous Databases & BI, avec son niveau d’autorisation indiqué sur la carte.

   app.stickyprompts.com/integrations 1 Niveau d'autorisation 2 Partagée avec l'espace

Niveaux d’autorisation

Niveau	Ce que l’IA peut exécuter
Read only	Une seule instruction SELECT (ou WITH ... SELECT) à la fois. Tout le reste est refusé.
Read & write	SELECT, plus INSERT et UPDATE.
Full access	Tout ce que votre utilisateur de base de données a le droit d’exécuter, y compris DELETE, DROP et les modifications de schéma.

Read only contrôle chaque instruction avant son exécution et rejette tout ce qui n’est pas une lecture unique. Comme ce contrôle recherche des mots tels que update ou delete n’importe où dans le SQL, une lecture inoffensive qui contient l’un de ces mots - une colonne nommée update_note, par exemple - peut être refusée. Reformulez la question, ou demandez à l’IA d’éviter cette colonne.

Accéder à une base de données privée avec le SSH bridge

Si votre base de données n’est pas accessible depuis Internet, StickyPrompts peut s’y connecter via un serveur de rebond SSH (jump host ou bastion) qui, lui, peut la joindre.

1. Activez le SSH bridge

   Dans le formulaire de connexion à la base de données, activez le SSH bridge et saisissez les champs SSH host, SSH port (généralement 22) et SSH username du serveur de rebond.

2. Autorisez la clé de StickyPrompts sur le serveur de rebond

   Le formulaire affiche une clé publique. Ajoutez-la, sur une seule ligne, au fichier ~/.ssh/authorized_keys de cet utilisateur SSH sur le serveur de rebond :

   jump host

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

   $ chmod 600 ~/.ssh/authorized_keys

   Seule la clé publique est affichée. La clé privée ne quitte jamais StickyPrompts.

3. Indiquez l'hôte tel que le voit le serveur de rebond

   Renseignez Host avec l’adresse de la base de données telle que la voit le serveur de rebond : localhost si la base tourne sur le serveur de rebond lui-même, ou son adresse privée sur votre réseau. Autorisez 188.245.64.188 à joindre le port SSH du serveur de rebond.

Poser des questions

Posez vos questions comme vous le feriez à un analyste. Précisez la base de données si vous en avez plusieurs.

Dans notre base retail : quels sont nos 5 meilleurs clients en valeur totale de
commandes, et quelle part du chiffre d'affaires représentent-ils ? Un tableau et
une conclusion.

Quels produits se sont vendus à moins de 10 unités le mois dernier dans la base retail ?

L’IA liste d’abord vos connexions aux bases de données, lit ensuite les tables et leurs colonnes, puis exécute une ou plusieurs requêtes, en raisonnant entre chaque étape. Dépliez la ligne actions au-dessus de la réponse pour voir chaque appel et le SQL exécuté.

app.stickyprompts.com/conversations 1 Lit d'abord le schéma 2 Ouvrir pour voir le SQL

Dépannage

Problème	Ce qu’il faut vérifier
Connexion impossible	L’adresse 188.245.64.188 est-elle autorisée dans votre pare-feu, sur le bon port ? L’hôte est-il accessible depuis Internet, ou avez-vous besoin du SSH bridge ?
Erreurs SSL	Votre serveur ne prend peut-être pas en charge SSL, ou son certificat ne correspond pas au nom d’hôte avec Verify full. Essayez Require pour en avoir le cœur net, puis corrigez le certificat.
Le SSH bridge échoue	La clé publique figure-t-elle sur une seule ligne dans authorized_keys, pour le bon utilisateur ? Host contient-il l’adresse telle que la voit le serveur de rebond ?
Une requête de lecture est refusée	Voir la remarque sous Niveaux d’autorisation à propos de mots comme update dans une lecture.
La réponse semble fausse	Dépliez les actions et lisez le SQL. Indiquez à l’IA ce qu’il faut changer (« compte uniquement les commandes finalisées ») et reposez la question.

Pages associées