GraphQL schema คืออะไร? อธิบาย scalar type และ object type

Question

IT Interview Practice · Accepted Answer

**schema** คือสัญญา (contract) แบบมีชนิดข้อมูลของ GraphQL API ซึ่งเขียนด้วย SDL (Schema Definition Language) มันประกาศทุกชนิดข้อมูล ทุก field และ **root type** พิเศษ ได้แก่ `Query` (อ่าน) `Mutation` (เขียน) และอาจมี `Subscription` (ข้อมูลสด) server จะปฏิเสธ request ใด ๆ ที่ไม่ตรงกับ schema

## Scalar type เทียบกับ object type

- **Scalar type** คือค่าปลายทาง (leaf) ที่เก็บข้อมูลจริง: ชนิดที่มีมาให้ในตัวได้แก่ `Int`, `Float`, `String`, `Boolean` และ `ID` คุณยังนิยาม custom scalar เองได้ เช่น `DateTime`
- **Object type** จัดกลุ่ม field เข้าด้วยกัน field ของมันเป็น scalar *หรือ* object type อื่นก็ได้ ซึ่งเป็นวิธีจำลองความสัมพันธ์ (relationship)

```graphql
scalar DateTime                # a custom scalar

type User {                    # an object type
  id: ID!                      # ! means non-null (always present)
  name: String!
  createdAt: DateTime!
  posts: [Post!]!              # a list of Post objects, non-null list of non-null items
}

type Post {
  id: ID!
  title: String!
  author: User!                # points back to User -> a relationship
}

type Query {                   # root type: the entry points for reads
  user(id: ID!): User          # a field with an argument; returns a User (nullable)
}
```

เครื่องหมาย `!` หมายถึง **non-null** ส่วน `[Post!]!` คือ list แบบ non-null ที่สมาชิกภายในก็เป็น non-null ด้วย argument (`id: ID!`) ทำให้ field รับพารามิเตอร์ได้

## ทำไมจึงสำคัญ

schema คือแหล่งความจริงเพียงหนึ่งเดียว (single source of truth) — มันขับเคลื่อนการตรวจสอบความถูกต้อง เอกสารที่สร้างอัตโนมัติ และ client codegen การอ่าน `!` และ list type ได้อย่างถูกต้องเป็นข้อทดสอบคัดกรองระดับ junior ที่พบบ่อย และการตัดสินใจเรื่อง nullability ยังกำหนดวิธีที่ client จัดการ error

Scalar type เทียบกับ object type

ทำไมจึงสำคัญ

คำถามที่เกี่ยวข้อง