Files
Kokorone/.agents/skills/prisma-cli/references/db-execute.md
T
Jeffery f44200f543 feat: 完成 B 群組 — 資料層與核心領域模型
- 導入 Prisma 7.9.1 + SQLite(better-sqlite3 driver adapter),prisma.config.ts 管理連線設定
- 完整資料模型:User/Work/Character/CharacterAlias/EpisodicMemory/SemanticMemory/
  ProceduralRule/EmotionState/Relationship/SentimentLedgerEntry
- packages/db:Prisma Client 存取層(ESM,因 Prisma 7 產出的 generated client 僅支援 ESM)
- apps/api 隨之改為 ESM 以相容 packages/db
- packages/shared:新增角色/記憶/情緒/關係共用型別,api 與 web 皆從此匯入
- prisma/seed.ts:建立測試使用者與元氣型測試角色,含完整關係帳本與記憶種子資料
- apps/api:新增 GET /characters
- scripts/smoke/B.mjs:驗證資料表齊全、API 讀出種子角色、關係與記憶可寫入讀出
- 保留 Prisma 官方隨 CLI 附的 agent skill 文件(.agents/skills 等),供後續群組查閱

npm run restart && npm run smoke -- B 皆通過(B-V),A 群組冒煙測試無回歸。
2026-08-13 09:43:15 +08:00

1.8 KiB

prisma db execute

Execute native commands (SQL) to your database.

Command

prisma db execute [options]

What It Does

  • Connects to your database using the configured datasource
  • Executes a script provided via file (--file) or stdin (--stdin)
  • Useful for running raw SQL, maintenance tasks, or applying diffs from migrate diff
  • Not supported on MongoDB

Options

Option Description
--file Path to a file containing the script to execute
--stdin Use terminal standard input as the script
--config Custom path to your Prisma config file

Current Option Surface

prisma db execute uses the datasource configured in prisma.config.ts. Use --config if you need a separate config file for another environment.

Examples

Execute from file

prisma db execute --file ./script.sql

Execute from stdin

echo "TRUNCATE TABLE User;" | prisma db execute --stdin

Execute migrate diff output

Pipe the output of migrate diff directly to the database:

prisma migrate diff \
  --from-empty \
  --to-schema prisma/schema.prisma \
  --script \
| prisma db execute --stdin

Configuration

Uses datasource from prisma.config.ts:

export default defineConfig({
  datasource: {
    url: env('DATABASE_URL'),
  },
})

Use Cases

  • Manual Migrations: Applying raw SQL changes
  • Data Maintenance: Truncating tables, cleaning up data
  • Schema Synchronization: Applying migrate diff scripts
  • Debugging: Running test queries (though typically not for fetching data)

Limitations

  • No Data Return: The command reports success/failure, not query results (rows). Use Prisma Client or prisma studio to view data.
  • SQL Only: Primarily for SQL databases.