迁移脚本
最好的方法确实是使用一个结合了多个突变的迁移脚本,因此只有一个 HTTP 请求被发送到 GraphQL 后端。
考虑这个模式:
type Image {
id: ID!
name: String!
}
我们可以使用 GraphQL 别名在一个请求中多次包含相同的突变:
mutation {
first: updateImage(id: "first-id", name: "01_lg.jpg") {
id
name
}
second: updateImage(id: "second-id", name: "02_lg.jpg") {
id
name
}
}
我们将在迁移脚本中使用这种机制。我将使用Lokka和 Node 来描述它,但是您可以选择您喜欢的任何语言和 GraphQL 客户端。
首先,我们查询所有现有图像以获取它们的id
and name
:
const queryImages = async() => {
const result = await client.query(`{
images: allImages {
id
name
}
}`)
return result.images
}
然后我们相应地替换名称并构造一个大请求,包括必要的updateImage
突变,每个突变都有不同的 GraphQL 别名。
如果您的图像名称可能包含问题中提到sm
的部分中的字符串,则此脚本将中断!{someid}
在这种情况下,请进行相应调整。
const migrateImages = async(images) => {
// beware! if your ids contain the string 'sm', adjust the string replacement accordingly!
const updateMutations = _.chain(images)
.map(image => ({ id: image.id, name: image.name.replace('sm', 'lg')}))
.map(image => `
${image.id}: updateImage(id: "${image.id}", name: "${image.name}") {
id
name
}`)
.value()
.join('\n')
const result = await client.mutate(`{
${updateMutations}
}`)
console.log(`Updated ${Object.keys(result).length} images`)
console.log(result)
}
而已。如果您必须更新数千张图像,则以一百个为一组对突变进行批处理可能比在一个请求中对所有图像进行批处理要好。请注意,突变在 GraphQL 服务器上按顺序运行。
运行迁移
目前,我建议使用以下工作流程来运行迁移:
- 克隆你的项目
- 在克隆的项目上运行迁移脚本
- 验证迁移是否成功运行。再检查一遍 :)
- 在您的原始项目上运行迁移
您可以在此处找到代码和进一步的说明。
虽然这种方法非常适合与您的示例一样简单的迁移,但它并不适合所有情况。我们已经在考虑为这个用例创建一个集成的体验,例如在您的 Graphcool 项目中进行交互式迁移,以及模拟迁移、检查等。如果您有任何建议,请在Slack中告诉我。