Skip to content
SubQuery

Работа с ноутбуками

Ноутбук в SubQuery — это рабочее пространство, где вы пишете код по шагам, сразу видите результат и можете быстро проверять гипотезы на данных.

Как это работает

  • Ноутбук состоит из ячеек, которые выполняются последовательно.
  • Состояние между ячейками сохраняется: переменные, импортированные модули и загруженные пакеты доступны в следующих шагах.
  • Последнее выражение ячейки отображается автоматически, а print(...) и ошибки попадают в текстовый вывод.
  • Доступны ячейки на Python, SQL, DuckDB и Markdown.

Важная особенность: WASM-сессия в браузере

Python и DuckDB ячейки работают в WASM-рантайме браузера. Это означает:

  • выполнение кода происходит на вашем компьютере (кроме запросов к СУБД);
  • сессия ограничена текущей вкладкой браузера;
  • при перезагрузке страницы или закрытии вкладки состояние kernel-сессии сбрасывается;
  • выполнение первой ячейки в сессии будет дольше, так как запускается wasm, последующие будут быстрее;

Автосохранение

В ноутбуках автоматически сохраняются:

  • контент ячеек (код, тип ячейки, выбранное подключение);
  • результаты выполнения ячеек.

Практически это значит, что после возврата в ноутбук вы видите не только код, но и последние сохраненные результаты.

Что вы увидите в результате ячейки

  • текстовый вывод;
  • таблицы;
  • изображения и графики.

Куда идти дальше