Référence Prisma CLI

Référence complète pour toutes les commandes Prisma CLI. Cette compétence fournit des conseils sur l'utilisation des commandes, les options et les bonnes pratiques pour les versions actuelles de Prisma.

Quand l'appliquer

Référencez cette compétence quand :

• Configuration d'un nouveau projet Prisma (prisma init)
• Génération de Prisma Client (prisma generate)
• Exécution de migrations de base de données (prisma migrate)
• Gestion de l'état de la base de données (prisma db push/pull)
• Utilisation d'une base de données de développement locale (prisma dev)
• Débogage de problèmes Prisma (prisma debug)

Catégories de règles par priorité

Catégories de commandes

Référence rapide

Configuration du projet

# Initialiser un nouveau projet (crée le dossier prisma/ et prisma.config.ts)
prisma init

# Initialiser avec une base de données spécifique
prisma init --datasource-provider postgresql
prisma init --datasource-provider mysql
prisma init --datasource-provider sqlite

# Initialiser avec Prisma Postgres (cloud)
prisma init --db

# Initialiser avec un modèle d'exemple
prisma init --with-model

Génération de Client

# Générer Prisma Client
prisma generate

# Mode surveillance pour le développement
prisma generate --watch

# Générer seulement un générateur spécifique
prisma generate --generator client

Runtime Bun

Lors de l'utilisation de Bun, ajoutez toujours le drapeau --bun pour que Prisma s'exécute avec le runtime Bun (sinon il revient à Node.js à cause du shebang CLI) :

bunx --bun prisma init
bunx --bun prisma generate

Base de données de développement local

# Démarrer Prisma Postgres local
prisma dev

# Démarrer avec un nom spécifique
prisma dev --name myproject

# Démarrer en arrière-plan (détaché)
prisma dev --detach

# Lister toutes les instances locales
prisma dev ls

# Arrêter une instance
prisma dev stop myproject

# Supprimer les données d'une instance
prisma dev rm myproject

Opérations de base de données

# Extraire le schéma d'une base de données existante
prisma db pull

# Pousser le schéma vers la base de données (sans migrations)
prisma db push

# Ensemencer la base de données
prisma db seed

# Exécuter du SQL brut
prisma db execute --file ./script.sql

Migrations (Développement)

# Créer et appliquer une migration
prisma migrate dev

# Créer une migration avec un nom
prisma migrate dev --name add_users_table

# Créer une migration sans l'appliquer
prisma migrate dev --create-only

# Réinitialiser la base de données et appliquer toutes les migrations
prisma migrate reset

Migrations (Production)

# Appliquer les migrations en attente (CI/CD)
prisma migrate deploy

# Vérifier le statut de la migration
prisma migrate status

# Comparer les schémas et générer une différence
prisma migrate diff --from-config-datasource --to-schema schema.prisma --script

Commandes utilitaires

# Ouvrir Prisma Studio (GUI de base de données)
prisma studio

# Démarrer le serveur MCP de Prisma pour les outils IA
prisma mcp

# Afficher les informations de version
prisma version
prisma -v

# Informations de débogage
prisma debug

# Valider le schéma
prisma validate

# Formater le schéma
prisma format

Configuration actuelle de Prisma CLI

Nouveau fichier de configuration

Utilisez prisma.config.ts pour la configuration CLI :

import 'dotenv/config'
import { defineConfig, env } from 'prisma/config'

export default defineConfig({
  schema: 'prisma/schema.prisma',
  migrations: {
    path: 'prisma/migrations',
    seed: 'tsx prisma/seed.ts',
  },
  datasource: {
    url: env('DATABASE_URL'),
  },
})

Comportement actuel des commandes

• Exécutez prisma generate explicitement après migrate dev, db push ou d'autres synchronisations de schéma quand vous avez besoin d'une sortie client fraîche
• Exécutez prisma db seed explicitement après migrate dev ou migrate reset quand vous avez besoin de données d'amorçage
• Utilisez prisma db execute --file ... pour les scripts SQL bruts

Variables d'environnement

Chargez les variables d'environnement explicitement dans prisma.config.ts, généralement avec dotenv :

// prisma.config.ts
import 'dotenv/config'

Fichiers de règles

Consultez les fichiers de règles individuels pour la documentation détaillée des commandes :

references/init.md           - Initialisation du projet
references/generate.md       - Génération du client
references/dev.md            - Base de données de développement local
references/db-pull.md        - Introspection de base de données
references/db-push.md        - Poussée de schéma
references/db-seed.md        - Amorçage de base de données
references/db-execute.md     - Exécution SQL brute
references/migrate-dev.md    - Migrations de développement
references/migrate-deploy.md - Migrations de production
references/migrate-reset.md  - Réinitialisation de base de données
references/migrate-status.md - Statut de migration
references/migrate-resolve.md - Résolution de migration
references/migrate-diff.md   - Diffusion de schéma
references/studio.md         - GUI de base de données
references/mcp.md            - Serveur Prisma MCP
references/validate.md       - Validation de schéma
references/format.md         - Formatage de schéma
references/debug.md          - Informations de débogage

Comment utiliser

Utilisez les catégories de commandes ci-dessus pour la navigation, puis ouvrez le fichier de référence de commande spécifique dont vous avez besoin.