Ограничения ноутбуков
Содержание
Ноутбуки 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).
Что делать, если ноутбук «завис»
- Проверьте очередь выполнения: ячейки выполняются по очереди.
- Перезапустите ядро — переменные сбросятся, но текст и результаты сохранятся.
- Если вкладка перестала отвечать, перезагрузите её: несохранённых правок текста не потеряется, автосохранение работает постоянно.