GraphJin项目教程：使用GraphQL实现数据插入操作-CSDN博客

GraphJin项目教程：使用GraphQL实现数据插入操作

GraphJin作为一个强大的GraphQL到SQL转换工具，为开发者提供了便捷的数据操作方式。本文将详细介绍如何使用GraphJin实现各种数据插入场景，包括单表插入、多表关联插入以及批量插入等操作。

单表插入操作

在GraphJin中，向单个表插入数据是最基础的操作。我们可以通过简单的GraphQL mutation语句实现：

mutation createUser {
  users(insert: { email: $email, full_name: $full_name }) {
    id
    email
    full_name
  }
}

这个示例展示了如何向users表插入一条记录，同时返回新创建记录的id、email和full_name字段。

数据验证

在实际应用中，我们通常需要对输入数据进行验证。GraphJin提供了@constraint指令来实现这一功能：

mutation createUser {
  @constraint(variable: "email", format: "email", min: 1, max: 100)
  @constraint(variable: "full_name", requiredIf: { nameRequired: true } ) {
  users(insert: { email: $email, full_name: $full_name }) {
    id
    email
    full_name
  }
}

这里我们为email字段设置了格式验证（必须是有效的电子邮件格式）和长度限制（1-100个字符），同时为full_name字段设置了条件性必填验证（当nameRequired变量为true时必填）。

多表关联插入

GraphJin的强大之处在于能够轻松处理多表关联插入操作，这在传统SQL中通常需要多个语句和事务处理。

同时插入关联数据

mutation createPurchaseCustomerAndProduct {
  purchases(
    insert: {
      id: $purchase_id
      quantity: $quantity
      customer: {
        id: $customer_id
        email: $customer_email
        full_name: $customer_name
      }
      product: {
        id: $product_id
        name: $product_name
        description: $product_description
        price: $product_price
      }
    }
  ) {
    quantity
    customer {
      id
      full_name
      email
    }
    product {
      id
      name
      price
    }
  }
}

这个例子展示了如何在一个操作中同时创建purchase记录及其关联的customer和product记录。GraphJin会自动处理外键关联关系，开发者无需关心执行顺序。

连接现有记录

有时候我们不需要创建新记录，而是将新记录与已有记录关联：

mutation createProductAndSetOwner {
  products(
    insert: {
      id: 2005
      name: "Product 2005"
      description: "Description for product 2005"
      price: 2015.5
      tags: ["Tag 1", "Tag 2"]
      category_ids: [1, 2, 3, 4, 5]
      owner: { connect: { id: 6 } }
    }
  ) {
    id
    name
    owner {
      id
      full_name
      email
    }
  }
}

这里使用connect操作符将新创建的product与id为6的已有user记录关联起来。

递归表插入

处理树形结构数据（如评论系统）时，GraphJin同样提供了简洁的语法：

mutation createReplyComment {
  comments(
    insert: {
      id: 5003
      body: "Comment body 5003"
      created_at: "now"
      comments: { find: "parent", connect: { id: 5 } }
    }
  ) {
    id
    body
  }
}

find: "parent"表示在父方向查找关系，将新评论作为id为5的评论的回复。

批量插入操作

对于需要一次性插入多条记录的场景，GraphJin支持批量插入：

mutation bulkCreateProducts {
  product(insert: $data) {
    id
    name
  }
}

配合以下变量数据：

{
  "data": [
    {
      "name": "Art of Computer Programming",
      "description": "The Art of Computer Programming (TAOCP)...",
      "price": 30.5
    },
    {
      "name": "Compilers: Principles, Techniques, and Tools",
      "description": "Known to professors, students...",
      "price": 93.74
    }
  ]
}

这种批量操作方式极大提高了数据导入的效率。