Stockage

Chaque projet doté d'une base a un stockage de fichiers, organisé en seaux, servi à l'adresse du projet au format de storage-js. Cette page dit comment s'en servir, comment l'accès aux fichiers se décide, ce que chaque palier permet, et ce qui n'est pas encore servi, à commencer par le point d'accès compatible S3.

Ce qui est servi

Le stockage est servi sous https://<identifiant>.donnees.bastide.app/storage/v1 (voir Base de données pour l'adresse). Votre application garde supabase-js : les chemins, les corps et les réponses sont ceux que storage-js appelle.

Note. Le point compatible S3 (pour le SDK AWS, rclone ou tout client S3) n'est pas encore servi. Il est prévu avec le lot L2 ; le servir à moitié ferait écrire une application contre une surface qui changera. Employez storage-js, ou l'API HTTP qu'il appelle.

Il n'y a pas d'écran de la console pour les seaux et les fichiers, ni d'outil MCP : le stockage se pilote depuis votre application. L'écran Données affiche le point d'entrée /storage/v1 dans la carte « Base PostgreSQL ».

Les seaux

Un seau se crée avec trois réglages :

• public : un seau public sert ses fichiers sans clé, par l'URL publique ;
• taille maximale d'un fichier : la plus petite de celle du seau et de celle du palier s'applique ;
• types admis : une liste de types MIME, image/* admet toute image ; la comparaison ignore la casse et les paramètres. Une liste vide admet tout.

import { createClient } from "@supabase/supabase-js";

const supabase = createClient("https://<identifiant>.donnees.bastide.app", "<clé publiable>");

await supabase.storage.createBucket("avatars", {
  public: false,
  fileSizeLimit: "5MB",
  allowedMimeTypes: ["image/*"],
});
await supabase.storage.from("avatars").upload(`${userId}/portrait.png`, fichier);

Créer un seau demande en pratique la clé secrète, côté serveur, ou une politique qui l'autorise.

Qui peut lire et écrire

Chaque requête s'exécute sous le rôle de l'appelant : le rôle anonyme avec la seule clé publiable, le rôle authentifié avec un jeton de session, le rôle de service avec une clé secrète. Ce sont les politiques de la table storage.objects de votre base qui décident ; la plateforme ne porte aucune règle d'accès aux fichiers. Une lecture refusée l'est par la politique, pas par l'application.

Une politique de stockage s'écrit comme une autre (voir Sécurité des données). Par exemple, chacun ne lit que son dossier :

create policy "lire son dossier" on storage.objects for select
  using (bucket_id = 'avatars' and (storage.foldername(name))[1] = (select auth.uid())::text);

Trois chemins se passent de clé, parce qu'un navigateur n'ajoute aucun en-tête à une balise <img> ou à un formulaire : l'URL publique d'un seau public, l'URL signée de lecture, et l'URL signée de téléversement. La permission d'une URL signée est jugée quand elle est signée.

• Une URL signée vit une heure par défaut, sept jours au plus ; au-delà, 400 duree_refusee.
• Un téléversement est d'abord éprouvé sous votre politique : un refus coûte une requête, pas un fichier envoyé.

Les limites par palier

Les tailles se comptent en puissances de 1 024. Aujourd'hui, rien n'est facturé au-delà de l'inclus : l'inclus est le quota.

• À 80 % du quota, le franchissement est consigné au journal d'audit du projet.
• À 100 %, toute nouvelle écriture est refusée (413, quota_atteint) avec un message qui nomme le quota ; les lectures continuent.

Le nettoyage

Chaque jour, une passe par projet retire ce qui ne sert plus : un téléversement repris que personne n'a nourri depuis 24 heures, un téléversement en plusieurs parties abandonné depuis 24 heures, et des octets qu'aucun objet ne désigne depuis une heure. Chaque passe qui retire quelque chose se consigne.

Sauvegarde des fichiers

Les fichiers de vos seaux ne sont pas restaurés avec la base : une restauration de base rend les lignes de storage.objects à l'instant du dump, pas les octets. Gardez ailleurs une copie de ce qui ne se reconstruit pas (voir Sauvegardes).

Erreurs fréquentes

Voir aussi

• Base de données, Sécurité des données, Authentification, Sauvegardes
• Cache et images, Limites par palier, Migrer depuis Supabase

Signaler une erreur sur cette page