---
title: "Lire Snowflake sans clé dans le code : la doc de while.sh"
url: https://while.sh/fr/docs/briques/snowflake/
updated: 2026-11-21
---

# 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.

> 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 :

```yaml titre="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 :

| Variable | Ce qu'elle contient |
|---|---|
| `<NOM>_URL` | L'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 :

| Ressource | Prix | Détail |
|---|---|---|
| Appels de la passerelle | 0,30 € les 1 000 appels | au-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`.
