Variables — параметры операции, передаваемые отдельно от текста запроса (JSON), чтобы не конкатенировать строки и безопасно подставлять значения.
Разбор
- Объявляются в сигнатуре:
query ($id: ID!) { user(id: $id) { ... } }.
- Отделяют query string от данных — удобно для кэша/Persisted Queries.
- Типы variables должны согласоваться со схемой.
- Предпочтительнее интерполяции строк на клиенте.
Итог
Variables отделяют значения от текста операции и безопаснее для клиентов.