Cad iad na dea-chleachtais le haghaidh dhearadh schema GraphQL?

Question

IT Interview Practice · Accepted Answer

Tá dea-schema **cliant-tiománta, nullable de réir réamhshocraithe ag na himill, agus in-fhorbartha gan leaganacha**. Samhlaíonn sé an fearann i dtéarmaí a úsáideann cliaint iarbhír, ní táblaí do bhunachair sonraí.

## Nullability

Déan réimse non-null (`!`) amháin nuair is féidir leat é a fhilleadh *i gcónaí*. Is gaiste é ró-úsáid `!`: má bhíonn earráid ag réimse non-null, déanann sé a réad tuismitheora iomlán a null, rud a iompaíonn teip bheag ina bhlanc mór. Roghnaigh nullable d'aon rud a bhraitheann ar sheirbhís downstream.

```graphql
type User {
  id: ID!             # truly always present
  email: String!      # required in your DB -> safe as non-null
  avatarUrl: String   # comes from an external service -> nullable, so its failure is isolated
}
```

## Ainmniú & ionchuir

- Úsáid ainmneacha comhsheasmhacha, tuairisciúla; léitear booleans mar fhaisnéisí (`isPublished`).
- Tabhair aon chineál **`input`** amháin do gach mutation agus fill cineál **payload** — is féidir leat réimsí a chur leis níos déanaí gan an síniú a bhriseadh.

```graphql
input CreatePostInput { title: String!, body: String! }
type CreatePostPayload { post: Post!, errors: [UserError!]! }  # room to grow
type Mutation { createPost(input: CreatePostInput!): CreatePostPayload! }
```

## Forbairt gan leaganú

Seachnaíonn GraphQL URLanna `/v2`. Forbraíonn tú **go breiseach**: cuir réimsí leis gan srian, agus scoir na sean-chinn le `@deprecated` fad is atá cliaint ag aistriú.

```graphql
type User {
  fullName: String!
  name: String! @deprecated(reason: "Use fullName")   # keep serving until clients move off
}
```

Is é réimse a bhaint nó a athainmniú an t-aon fhíor-athrú briste, mar sin dear é ionas gur annamh a bhíonn ort. Seachain freisin cruth an DB a sceitheadh (nocht `fullName`, ní `first_name`/`last_name` má tá aon réimse amháin ó chliaint).

## Cén fáth a bhfuil sé tábhachtach

Is iad na roghanna seo a scarann schema a mhaireann blianta ó cheann a mbíonn cliaint ag troid ina choinne. Úsáideann agallóirí é seo chun **aibíocht dhearadh API** a thomhas — go háirithe an malartú nullability/earráide agus an dearcadh forbartha breisí, atá uathúil do GraphQL.

Nullability

Ainmniú & ionchuir

Forbairt gan leaganú

Cén fáth a bhfuil sé tábhachtach

Ceisteanna gaolmhara