Привіт Світ пояснив

SubQuery TeamПриблизно 2 хв

Привіт Світ пояснив

У посібнику з швидкого старту Hello World ми пройшли кілька простих команд і дуже швидко отримали приклад і запущено. Це дозволило вам переконатися, що у вас є всі попередні реквізити, і ви можете використовувати місцевий майданчик, щоб зробити простий запит, щоб отримати перші дані з SubQuery. Тут ми детальніше розглянемо, що означають усі ці команди.

subql init

Перша команда, яку ми запустили, була subql init subqlHelloWorld.

Це робить важкий підйом і створює для вас цілу купу файлів. Як зазначається в офіційній документації , ви в основному будете працювати над такими файлами:

  • Маніфест в project.yaml
  • Схема GraphQL в схемі a.graphql
  • Картографування функціонує в каталозі src / mappings /

key subql files

Ці файли є основою всього, що ми робимо. Як такий, ми приділимо більше часу цим файлам в іншій статті. Поки що просто знайте, що схема містить опис даних, які користувачі можуть запитувати з API SubQuery, файлу проекту yaml, який містить параметри типу "конфігурація", і, звичайно, картографічні обробники, що містять машинопис, який містить функції, що перетворюють дані.

yarn install

Наступне, що ми зробили - yarn install. встановлення npm також може бути використано.

Короткий урок історії. Node Package Manager або npm спочатку був випущений у 2010 році і є надзвичайно популярним менеджером пакетів серед розробників JavaScript. Це пакет за замовчуванням, який автоматично встановлюється кожного разу, коли ви встановлюєте Node.js у свою систему. Спочатку компанія Yarn була випущена Facebook у 2016 році з наміром вирішити деякі недоліки у виконанні та безпеці роботи з npm (на той час).

Що робить yarn - це подивитися на файл package.json та завантажити різні інші залежності. Дивлячись на файл package.json, не схоже, що існує багато залежностей, але коли ви запустите команду, ви помітите, що додано 18 983 файли. Це тому, що кожна залежність також матиме свої залежності.

key subql files

yarn codegen

Потім ми запустили yarn codegen або npm run-script код. Це означає, що схема GraphQL (у schema.graphql) і генерує пов'язані файли моделей машинопису (отже, вихідні файли матимуть розширення .ts). Ніколи не слід змінювати жоден із цих створених файлів, а лише змінювати джерело файл schema.graphql.

key subql files

yarn build

yarn build або npm run-script збірка потім була виконана. Це має бути знайоме для досвідчених програмістів. Він створює папку дистрибуції, виконуючи такі речі, як оптимізація коду, що готується до розгортання.

key subql files

docker-compose

Останнім кроком стала комбінована команда докера docker-compose pull & amp; & amp; докер-compose up (можна також запускати окремо). Команда pull захоплює всі необхідні зображення з Docker Hub, і команда up запускає контейнер.

> docker-compose pull
Pulling postgres        ... done
Pulling subquery-node   ... done
Pulling graphql-engine  ... done

Коли контейнер запускається, ви побачите, що термінал виплюнув багато тексту, що показує стан вузла та двигуна GraphQL. Це коли бачиш:

subquery-node_1   | 2021-06-06T02:04:25.490Z <fetch> INFO fetch block [1, 100]

що ви знаєте, що вузол SubQuery почав синхронізуватися.

Підсумок

Тепер, коли ви зрозуміли, що відбувається під прикриттям, питання полягає в тому, куди звідси? Якщо ви відчуваєте себе впевнено, ви можете перейти до вивчення того, як створити проект та дізнатися більше про три ключові файли. Файл маніфесту, схема GraphQL та файл відображення.

В іншому випадку продовжуйте наш розділ навчальних посібників, де ми дивимось, як ми можемо запустити цей приклад Hello World на розміщеній інфраструктурі SubQuery, ми розглянемо модифікацію стартового блоку, і ми глибше зануримось у виконання проектів SubQuery, запустивши легко доступні та відкриті проекти.