Référence CLI Prisma

Référence complète de toutes les commandes CLI Prisma. 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'utiliser

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 locale de développement (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 exemple
prisma init --with-model

Génération de Client

# Générer Prisma Client
prisma generate

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

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

Runtime Bun

Quand vous utilisez Bun, ajoutez toujours le flag --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 locale de développement

# Démarrer Prisma Postgres local
prisma dev

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

# Démarrer en arrière-plan (detached)
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

# Récupérer 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

# Seeder 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 des migrations
prisma migrate status

# Comparer les schémas et générer un diff
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 CLI Prisma actuelle

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 de seed
• 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 locale de développement
references/db-pull.md        - Introspection de base de données
references/db-push.md        - Push de schéma
references/db-seed.md        - Seeding de base de données
references/db-execute.md     - Exécution de SQL brut
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 des migrations
references/migrate-resolve.md - Résolution de migrations
references/migrate-diff.md   - Diffage de schéma
references/studio.md         - GUI de base de données
references/mcp.md            - Serveur MCP Prisma
references/validate.md       - Validation de schéma
references/format.md         - Formatage de schéma
references/debug.md          - Informations de débogage

Comment l'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.