跳到主要内容

Prisma

  • prisma/prisma
    • Apache-2.0, TS
  • 注意
    • 生成的客户端只能服务端执行 #3142
      • 浏览器端只能通过 GraphQL 使用
    • PG 多 Schema 需要构造多 Client
  • Prisma 介于 ORM 和 CMS 之间 - 定位类似于 RoR 的数据模块
  • 主要特性
    • 支持 GraphQL 接口
    • 支持多数据库 - PostgreSQL MySQL
    • 支持生成客户端 - TS JS GO
      • 支持实时订阅
    • 数据模型通过 DSL 定义 - 支持自动迁移
  • 架构: 应用 -> Prisma Client -> Prisma Server -> Database
  • 现有的一些问题 
# 安装命令行工具
npm install -g prisma
# 引导初始化
# 生成 datamodel.prisma docker-compose.yml prisma.yml
prisma init my-web
# 启动 prisma
cd my-web
# GQL控制台 http://localhost:4466/
# 管理控制台 http://localhost:4466/_admin
# 管理接口 http://localhost:4466/management
# 会在数据库创建 management 库进行管理
docker-compose up
# 部署新的模型
prisma deploy

命令行​

# 通过数据库生成模型
prisma introspect

prisma.yml​

# prisma 的服务端地址 - 格式 https|https://<地址>/<服务>/<环境/stage>
# 默认服务名字为 default - 等同于路径 http://localhost:4466/default/default
# http://localhost:4466/my-service - 服务名字为 my-service
# http://localhost:4466/my-service/dev - 环境为 dev
endpoint: http://localhost:4466
# schema 文件
# 可以使用数组指定多个
datamodel: datamodel.prisma
# 密钥
# secret: mysecret42
# 支持使用环境变量
secret: ${env:PRISMA_SECRET}

# 生成配置
generate:
  # 生成器
  # 可选类型 javascript-client typescript-client flow-client go-client graphql-schema
  - generator: typescript-client
    output: ./generated/prisma-client/

# 事件钩子
hooks:
  post-deploy:
    - prisma generate

# 基础数据
seed:
  # 执行脚本创建
  run: node data/seed.js
  # 导入备份数据创建
  import: database/backup.zip

# 任意变量定义
# 通过 ${self:custom.datamodelPath} 引用
custom:
  datamodelPath: myDatamodel

导入导出​

  • 导入接口 http://localhost:4466/my-app/dev/import
  • 导出接口 http://localhost:4466/my-app/dev/export
# 导入
curl '__SERVICE_ENDPOINT__/import' -H 'Content-Type: application/json' -H 'Authorization: Bearer __JWT_AUTH_TOKEN__' -d '{"valueType":"__NDF_TYPE__","values": __DATA__ }' -sSv

# 导出
curl '__SERVICE_ENDPOINT__/export' -H 'Content-Type: application/json' -H 'Authorization: Bearer __JWT_AUTH_TOKEN__' -d '{"fileType":"__NDF_TYPE__","cursor": {"table":__TABLE__,"row":__ROW__,"field":__FIELD__,"array":__ARRAY__}} }' -sSv

DSL​

  • 语法类似于 GraphQL

简单模型​

type User {
  id: ID! @id
  name: String!
  // 唯一约束
  email: String! @unique
  // 一对多
  addresses: [Address!]!
  // 默认值
  isAdmin: Boolean @default(value: "false")
  role: UserRole @default(value: "USER")

  // 会创建一个中间表 _UserLikedPosts{A,B}
  likedPost: [Post!]!  @relation(name: "UserLikedPosts")

  // 元数据字段
  createdAt: DateTime! @createdAt
  updatedAt: DateTime! @updatedAt

  // JSON 字段 - 默认 256K
  data: Json
}

type Address {
  id: ID! @id

  raw: String
  city: String
  country: String
  zip: String
  // 反向关联
  user: User @relation(link: INLINE)
}

// 如果不想使用创建的中间表可以手动指定
type UserLikedPosts @relationTable {
  user: User!
  post: Post!
}

// 枚举
enum UserRole {
  USER
  ADMIN
  VISITOR
}