本文属使用Prisma构建GraphQL服务系列。

Prisma使用专用的中间格式导入和导出数据：规范化数据格式（Normalized Data Format，NDF）。

+--------------+                    +----------------+                       +------------+
| +--------------+                  |                |                       |            |
| |            | |                  |                |                       |            |
| | SQL        | |  (1) transform   |      NDF       |  (2) chunked upload   |   prisma   |
| | MongoDB    | | +--------------> |                | +-------------------> |            |
| | JSON       | |                  |                |                       |            |
| |            | |                  |                |                       |            |
+--------------+ |                  +----------------+                       +------------+
  +--------------+

在本教程中，您将执行以下步骤：

• 创建一个Prisma服务
• 为服务种一些初始数据
• 导出NDF中的数据
• 将服务部署到新stage
• 导入NDF中的数据

创建Prisma服务

(1) 在终端中，切换至您选择的目录并运行以下命令：

prisma init import-example

(2) 当提示使用什么样的模板时，选择Minimal setup: database-only。

这创建了一个名为import-example的新目录，其中包含根配置文件prisma.yml以及datamodel.graphql中服务数据模型(data model)的定义。

接着，您将更新数据模型也包括关系。

(3) 打开datamodel.graphql并将内容更改为如下所示：

type User {
  id: ID! @unique
  name: String!
  posts: [Post!]!
}

type Post {
  id: ID! @unique
  title: String!
  author: User!
}

创建初始数据

接下来，您将为该服务创建一些初始数据。

(4) 在import-example目录中创建一个名为seed.graphql的新文件，并向其添加以下突变：

mutation {
  createUser(data: {
    name: "Sarah",
    posts: {
      create: [
        { title: "GraphQL is awesome" },
        { title: "It really is" },
        { title: "How to GraphQL is the best GraphQL tutorial" }
      ]
    }
  }) {
    id
  }
}

现在你需要告诉CLI你创建了这个文件。您可以通过在prisma.yml中设置seed属性来完成此操作。

(5) 打开prisma.yml并更新其内容，如下所示：

service: import-example
stage: dev

datamodel: datamodel.graphql

# to enable auth, provide
# secret: my-secret
disableAuth: true

seed:
  import: seed.graphql

在部署服务时，CLI现在会将seed.graphql中定义的突变发送到您的服务的API。

(6) 通过运行以下命令来部署Prisma服务：

prisma deploy

(7) 当提示您在何处（即向哪个群集）部署您的Prisma服务时，请选择其中一个公共群集选项：prisma-eu1或prisma-us1。 （请注意，在使用Docker进行部署时初始化数据也可以）

CLI现在部署该服务并在seed.graphql中执行突变。为了说明种子数据效果，你可以打开一个GraphQL Playground并发送以下查询：

{
  users {
    name
    posts {
      title
    }
  }
}

Prisma API将返回以下数据：

{
  "data": {
    "users": [
      {
        "name": "Sarah",
        "posts": [
          {
            "title": "GraphQL is awesome"
          },
          {
            "title": "It really is"
          },
          {
            "title": "How to GraphQL is the best GraphQL tutorial"
          }
        ]
      }
    ]
  }
}

导出NDF数据

是时候以标准化数据格式导出了。

(8) 在终端import-example目录中，执行以下命令：

prisma export

这将创建一个名为export-__TIMESTAMP__.zip的新文件，其中__TIMESTAMP__表示导出的确切时间。 zip目录中的文件是NDF文件。要了解更多关于结构的信息，请查看NDF参考文档。

部署服务到新地方

接下来，您将通过将服务部署到新stage来创建服务的“克隆”。

(9) 打开prisma.yml并将stage属性设置为新值。同时删除seed和cluster属性！

service: import-example
stage: test

datamodel: datamodel.graphql

# to enable auth, provide
# secret: my-secret
disableAuth: true

(10) 再次运行prisma deploy将服务部署到新的test stage。

(11) 像上面一样，当提示您在何处（即向哪个群集）部署您的Prisma服务时，请选择其中一个公共群集选项：prisma-eu1或prisma-us1。

导入NDF数据

现在服务正在运行，您可以从zip目录导入数据！

(12) 在终端中运行以下命令。请注意，您需要将__DATA__占位符替换为导出的zip目录的路径（例如export-2018-01-13T19：28：25.921Z.zip）：

prisma import --data __DATA__

搞定！为了验证导入了数据，你可以在GraphQL Playground打开当前test的stage并重新发送上述查询。