Частые вопросы

Собрали ответы на вопросы, которые чаще всего задают пользователи SubQuery. Если ответа нет — напишите в поддержку.

Регистрация и команды

Как начать работу? Зарегистрируйтесь, создайте команду и проект, пригласите коллег и подключите первый источник данных. Пошаговый план — в С чего начать.

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

Что такое рабочее место и чем оно отличается от роли? Роль — права на действия, рабочее место — доступ к модулю. Без рабочего места модуль не откроется даже с нужной ролью (Понятия и сущности).

Оплата

Как считается стоимость? По рабочим местам: дни занятости делятся на дни месяца и умножаются на цену тарифа. Периоды короче 30 минут не считаются (Как устроен биллинг).

Что будет после пробного периода? Команда автоматически переходит на бесплатный тариф. Блокировки не происходит.

Команду заблокировали — данные пропали? Нет. Блокировка приостанавливает работу, но данные сохраняются; после оплаты счетов доступ возвращается (Блокировка команды).

Можно ли платить по счёту? Да, для тарифа Enterprise оплата идёт по договору. Обратитесь в поддержку.

Подключения

Безопасно ли хранить реквизиты баз в SubQuery? Реквизиты хранятся в зашифрованном виде, пароли не отображаются повторно. Для S3 рекомендуем отдельный сервисный аккаунт (Подключение S3).

База не подключается, что проверить? Чаще всего закрыт доступ извне: разрешите подключения с серверов SubQuery по IP и проверьте порт (Подключение ClickHouse).

Какие СУБД поддерживаются? ClickHouse, PostgreSQL, Greenplum, Trino, MySQL, а также Озеро через DuckDB (Подключения).

Потоки и данные

Данные потока дублируются, что делать? Используйте метод вставки Delete + Insert с ключом по дате вместо Insert (Расписание и окно данных).

Как выгрузить историю за год? За один запуск окно не превышает 3 дней: выгружайте историю блоками с фиксированным окном (Поток Яндекс Метрики).

Где искать таблицы потока? В Озере проекта: в дереве схемы dbt и в панели «Схема БД» ноутбука (Озеро).

dbt

Нужно ли устанавливать dbt локально? Нет, dbt-IDE работает в браузере: модели, запуски и расписание без локального окружения (Что такое dbt).

Что такое рабочая область? Ветка проекта для изменений. Эксперименты делаются в рабочей области, а в основную публикуются после проверки.

Как поставить модели на расписание? Создайте задачу dbt: она запускается по расписанию, пишет логи и уведомляет об ошибках.

Ноутбуки

Где выполняется код ноутбука? Python и DuckDB — в браузере (WASM), SQL к подключённым СУБД — на сервере (Ограничения ноутбуков).

Что произойдёт с переменными после перезагрузки вкладки? Сессия сбросится: текст и результаты сохранятся, переменные и пакеты — нет.

Коллега не видит мои ноутбуки? Ноутбуки видны участникам проекта: добавьте человека в проект и проверьте рабочее место (Доступ к ноутбукам).

Озеро

Что такое Озеро и чем оно отличается от S3? Это хранилище на Apache Iceberg: таблицы с транзакциями, схемой и историей версий, а не «просто файлы» (Что такое Озеро).

Как запросить данные Озера? Через DuckDB: каталог sq доступен в ноутбуках и dbt (Озеро и DuckDB).

Поддержка

Куда писать о проблеме? На join@subquery.ru или в Telegram-чате: приложите email аккаунта, название проекта, время проблемы и текст ошибки — подробности в Поддержке.