Aller au contenu

Aller au sommaire de la doc

Snowflake

Votre appli lit un entrepôt Snowflake par son API SQL, avec une paire de clés ou un jeton d’accès. La clé privée, ou le jeton d’accès, reste au coffre de while : ni votre appli ni votre agent ne le voient.

Mis à jour le 21 novembre 2026.

Voir en Markdown

Lire un entrepôt Snowflake par son API SQL sans exposer la clé privée : un laissez-passer signé par while, la clé restée au crochet

Vous, à votre IA : Branche notre entrepôt Snowflake : je veux les ventes du jour dans l’appli.

Ce que votre agent écrit

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

while.yaml
apiVersion: while/v1
project: my-app
services:
  - name: web
    port: 3000
    connections: [snowflake]

Ce que reçoit votre appli

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

VariableCe qu’elle contient
<NOM>_URLL’adresse de la connexion : SNOWFLAKE_URL pour une connexion snowflake. La clé n’y est pas ; while ajoute le jeton signé à chaque appel passé par cette adresse.

Quand vous en servir

Servez-vous-en pour lire les données d’un entrepôt Snowflake depuis une appli ou un agent, sans copier de clé.

Comment ça marche

while appelle l’API SQL de Snowflake pour votre appli, avec une paire de clés ou un jeton d’accès programmatique (PAT). La clé privée reste au coffre de while, qui signe lui-même le jeton (JWT) que Snowflake attend.

La mise en place se fait en cinq étapes.

  1. Chez Snowflake, une personne crée un rôle en lecture seule (USAGE sur l’entrepôt, la base et le schéma, SELECT sur les tables) et un utilisateur de service qui n’a que ce rôle (TYPE = SERVICE, DEFAULT_ROLE).

  2. Elle crée une paire de clés RSA de 2048 bits (openssl genrsa 2048 | openssl pkcs8 -topk8 -nocrypt, ou une clé chiffrée par une phrase de passe), et pose la clé publique sur l’utilisateur : ALTER USER … SET RSA_PUBLIC_KEY='MIIB…'.

  3. Votre agent déclare la connexion : declare_connection { name: snowflake, model: snowflake, account: orgname-accountname, user, role, warehouse }. Avec un PAT, c’est model: snowflake_pat, sans user. while en déduit l’adresse du compte et la façon de s’authentifier, puis une personne qui peut configurer les connexions la valide.

  4. Une personne colle la clé privée, ou le PAT, sur la page de la connexion dans while. Une clé chiffrée se colle avec sa phrase de passe, au même endroit. Ni la clé ni sa phrase de passe ne passent par votre agent : while refuse une déclaration qui les contient.

  5. Votre agent vérifie avec call_connection, en lançant SELECT CURRENT_VERSION() par POST /api/v2/statements. Un 200 donne la version. Un 401 veut dire que la clé publique posée sur l’utilisateur n’est pas celle de la clé privée, ou que le compte ou l’utilisateur ne sont pas les bons.

Ce qu’il faut savoir

Une requête se lance par POST /api/v2/statements, en JSON (statement, timeout, database, schema, warehouse, role). Une requête courte répond 200 avec ses lignes ; une longue répond 202 avec un statementHandle, et GET /api/v2/statements/<statementHandle> se relit jusqu’au 200. Un grand résultat est découpé en partitions (resultSetMetaData.partitionInfo), et chacune se lit par GET …?partition=<n>. POST /api/v2/statements/<statementHandle>/cancel annule une requête.

while laisse passer ces appels comme des lectures, puisque l’API SQL lance toute requête en POST. C’est le rôle Snowflake qui décide ce qu’une requête peut écrire : donnez-lui un rôle en lecture seule. Le JWT vaut une heure au plus, et while le signe de nouveau avant son échéance.

Prix

Ces prix sont les mêmes dans toutes les offres, hors taxes :

RessourcePrixDétail
Appels de la passerelle0,30 € les 1 000 appelsau-delà de 500 000 par mois, offre Pro

Les outils MCP de votre agent

Votre agent s’en occupe avec les outils declare_connection et call_connection.

Donnez la phrase à votre IA, elle s’occupe du reste

À donner à votre IA

Lis while.sh/agents et aide-moi à démarrer avec while.

Copier la phrase

En 3 minutes, sans inscription, l’outil a son adresse. Pour le garder, créez votre compte.

Pour un projet d’entreprise, écrivez à l’équipe de while : hello@while.sh