Ограничения ноутбуков

Ноутбуки SubQuery выполняют Python и DuckDB прямо в браузере, поэтому на них действуют ограничения клиентской среды: объём результатов, время жизни сессии и поведение при перезапуске. SQL-запросы к подключённым СУБД выполняются на сервере и от ресурсов устройства не зависят.

Вычисления в браузере

Python и DuckDB работают в WASM-сессии внутри вашего браузера:

  • производительность зависит от мощности устройства и свободной памяти;
  • перезагрузка вкладки или закрытие ноутбука завершает сессию вычислений;
  • переменные Python и временные таблицы DuckDB живут до перезапуска ядра.

Тяжёлые трансформации больших объёмов делайте в dbt или на подключённой СУБД, а в ноутбуках — агрегацию, визуализацию и проверку гипотез.

Размер результатов

Результат ячейки сохраняется вместе с ноутбуком и ограничен 70 МБ:

  • большие выборки просматривайте постранично или агрегируйте;
  • если результат превысил лимит, сохраняется метаданные запуска, но полные данные не восстановятся;
  • графики и текстовые выводы занимают заметно меньше места, чем таблицы.

Состояние при перезапуске

Что происходит Перезагрузка вкладки Перезапуск ядра
Переменные Python сбрасываются сбрасываются
Установленные пакеты сбрасываются сбрасываются
Текст и структура ячеек сохраняются сохраняются
Результаты прошлых запусков сохраняются сохраняются
Подключённые файлы восстанавливаются восстанавливаются
Файлы, созданные Python-кодом не сохраняются не сохраняются

Перед перезапуском ядра сохраните нужные результаты в файл или в ячейку с выводом.

Файлы

  • Файлы, добавленные через панель Файлы, восстанавливаются при следующем открытии ноутбука: SubQuery помнит их между сессиями.
  • Файлы, созданные Python-кодом в сессии, живут только до перезапуска ядра — скачайте или сохраните их в подключение S3 (Работа с файлами).
  • Ограничения на размер загружаемых файлов зависят от браузера и доступной памяти устройства.

SQL и подключения

  • SQL-ячейки с подключениями к ClickHouse, PostgreSQL, Greenplum, Trino и MySQL выполняются на сервере: лимиты и производительность задаёт сама СУБД и тариф (Работа с СУБД).
  • Запросы к Озеру через DuckDB выполняются в браузере и подчиняются ограничениям клиентской сессии (Озеро и DuckDB).

Что делать, если ноутбук «завис»

  1. Проверьте очередь выполнения: ячейки выполняются по очереди.
  2. Перезапустите ядро — переменные сбросятся, но текст и результаты сохранятся.
  3. Если вкладка перестала отвечать, перезагрузите её: несохранённых правок текста не потеряется, автосохранение работает постоянно.