prisma/prisma-postgres-setup

Que fait prisma-postgres-setup ?

Configurez une nouvelle base de données Prisma Postgres et connectez-la à un projet local à l'aide de l'API de gestion. À utiliser lorsque l'utilisateur demande de « configurer une base de données », « créer un projet Prisma Postgres », « obtenir une chaîne de connexion », « connecter mon application à Prisma Postgres » ou « provisionner une base de données ».

Utilisation

Lorsque vous recevez une demande de configuration d'une base de données Prisma Postgres, suivez les étapes suivantes :

1. Installer les dépendances : assurez-vous que @prisma/client et prisma sont installés.
2. Configurer le client Prisma : initialisez Prisma avec npx prisma init ou vérifiez que schema.prisma est présent.
3. Provisionner la base de données : utilisez l'API de gestion Prisma pour créer une nouvelle base de données Postgres et obtenir une chaîne de connexion (connectionString).
4. Mettre à jour les variables d'environnement : définissez DATABASE_URL dans le fichier .env avec la chaîne de connexion obtenue.
5. Exécuter les migrations : appliquez le schéma avec npx prisma migrate dev.
6. Confirmer la connexion : exécutez une requête de test pour valider la connexion à la base de données.

Configuration requise

• Un compte Prisma Data Platform avec un token d'accès à l'API de gestion (PRISMA_API_KEY).
• L'agent doit avoir accès au système de fichiers local pour écrire dans .env et schema.prisma.
• Node.js et npm/yarn/pnpm installés dans l'environnement de l'agent.

Exemple de workflow

# Étape 1 : Installer Prisma CLI
npm install prisma @prisma/client

# Étape 2 : Initialiser Prisma (si pas déjà fait)
npx prisma init

# Étape 3 : Appel à l'API de gestion Prisma (via curl ou une bibliothèque)
# (L'agent effectue cette étape en interne)

# Étape 4 : Copier la chaîne de connexion dans .env
# DATABASE_URL="postgresql://..."

# Étape 5 : Exécuter la migration initiale
npx prisma migrate dev --name init

# Étape 6 : Vérifier la connexion
npx prisma db push

Considérations importantes

• Sécurité : ne journalisez jamais les tokens d'API ou les chaînes de connexion en clair. Utilisez des variables d'environnement.
• Plates-formes prises en charge : Claude Code, Cursor, Codex et tout agent capable d'exécuter des commandes shell et de manipuler des fichiers locaux.
• Mode hors ligne : cette compétence nécessite un accès à Internet pour provisionner la base de données via l'API de gestion.

Dépannage

Problème	Solution
Erreur d'authentification	Vérifier que PRISMA_API_KEY est correctement défini et valide
Échec de migration	Vérifier le schéma Prisma et les contraintes de la base de données
Connexion refusée	S'assurer que la chaîne DATABASE_URL est correcte et que la base de données est accessible