ГрапхКЛ је моћан језик упита који омогућава клијентима да од сервера затраже само податке који су им потребни. Помаже вам да повећате брзину захтева јер можете да прилагодите упите да преузимају само одређене податке.
ГрапхКЛ има два типа операција: упите и мутације. Упркос својим сличностима, они служе сасвим различитим сврхама.
Разлике између ГрапхКЛ упита и мутација
Упити и мутације су слични по томе, ви их користите за постављање захтева ГрапхКЛ АПИ-ји. Међутим, разликују се по синтакси, начину извршавања и употреби.
Синтакса упита и мутација
Основна синтакса ГрапхКЛ упита је следећа:
упита гетПродуцт($ид: ИД!) {
производ (ид: $ид) {
име
Цена
}
}
Ево шта овај код означава:
- упит је кључна реч која идентификује захтев као упит.
- гетПродуцт је назив операције
- $ид је променљива
- ИД! је тип променљиве.
Ако вам нису потребне променљиве, изоставите их и дефинишите упит овако:
куери гетПродуцтс {
производи {
име
Цена
}
}
У неким ситуацијама можете да изоставите кључну реч и име упита, написујући ГрапхКЛ упит овако:
производи {
име
Цена
}
Иако овај формат функционише, употреба кључне речи упита је боља за читљивост.
Синтакса мутација је слична упитима осим употребе кључне речи мутација.
мутација АддНевПродуцт ($наме: Стринг!, $прице: Нумбер!) {
аддПродуцт (име: $наме, цена: $прице) {
име
Цена
}
}
Различити начини извршења
Друга разлика између упита и мутације је у томе што се упити покрећу паралелно док се мутације покрећу синхроно. Када покренете две мутације, оне ће се извршавати једна за другом, редом
Контрастне употребе за упите и мутације
Требало би да користите упите само за операције РЕАД. На пример, користите упит када преузимате производе са АПИ крајње тачке.
Користите мутације за операције ЦРЕАТЕ, УПДАТЕ и ДЕЛЕТЕ. То су у суштини операције које мењају податке ускладиштене у бази података.
На пример, користите мутацију када ажурирате име клијента преко крајње тачке налога.
Стекните навику да правилно користите упите и мутације
ГрапхКЛ је моћан језик упита који вам омогућава да захтевате само податке који су вам потребни. Постоје две операције које можете извршити у ГрапхКЛ-у: упити и мутације.
Ове операције се разликују по синтакси, извршењу и њиховој намени. Требало би да користите упите за операције РЕАД и мутације за операције ЦРЕАТЕ, УПДАТЕ и ДЕЛЕТЕ.