Aller au contenu

Aller au sommaire de la doc

Lire la base d’un autre projet

Une appli lit la base d’un autre projet de votre organisation, en lecture seule, par son pilote habituel. Les approbateurs de la base choisissent ce qu’elle lit.

Mis à jour le 9 novembre 2026.

Voir en Markdown

Vous, à votre agent : Fais lire au tableau de bord la base de l’entrepôt des ventes.

Ce que votre agent écrit

Votre agent l’écrit dans while.yaml, à la racine de votre appli :

while.yaml
databases:
  - from: ventes/main
    access: read

Ce que reçoit votre appli

Votre appli reçoit ces variables d’environnement à chaque mise en ligne :

VariableCe qu’elle contient
DB_VENTES_MAIN_URLL’adresse de la base lue (ici la base main du projet ventes).
DB_VENTES_MAIN_USERLe rôle PostgreSQL de votre appli dans cette base.
DB_VENTES_MAIN_PASSWORDSon mot de passe.

Quand vous en servir

Servez-vous-en quand un projet a besoin des données d’un autre, comme un entrepôt : il lit sa base plutôt qu’appeler une API, en production seulement.

Comment ça marche

Une appli lit en lecture seule la base PostgreSQL d’un autre projet de l’organisation, par son pilote habituel et DB_<NAME>_URL. Les approbateurs de la base source valident, et choisissent ce qu’elle lit.

Ce qu’il faut savoir

La première mise en ligne qui déclare la lecture demande la validation des approbateurs de la base source. Une fois validée, chaque appli lectrice a son rôle PostgreSQL dans cette base, exactement à ses droits : la base entière, ou les schémas, tables et colonnes que les approbateurs choisissent. Le projet source voit qui le lit (outil explain_access).

Seule la production lit : une prévisualisation ne lit pas, parce que son code n’est pas relu. Les deux projets sont dans la même organisation, qui lit 10 bases au plus (quota). La lecture se fait sur l’instance principale de la base source, avec 5 connexions par appli, 30 secondes par requête et 60 secondes au plus d’inactivité dans une transaction. Retirer la lecture coupe la connexion ; la redonner demande une nouvelle mise en ligne du projet lecteur, avec un mot de passe neuf.

Le réseau ne réserve pas encore le pooler de la base source aux seules applis lectrices : ce sont leurs droits PostgreSQL qui séparent ce que chacune lit.

Les outils MCP de votre agent

Votre agent s’en occupe avec les outils deploy_app, plan_deploy et explain_access.

Branchez votre agent, il s’occupe du reste

À coller dans votre agent

Lis while.sh/agents, puis mets mon appli en ligne avec while.

Copier les instructions

Pas besoin de compte pour essayer : votre appli est en ligne tout de suite. Pour la garder, connectez-vous.

Un projet pour votre entreprise ? Parlez à l’équipe : hello@while.sh