Хранилища S3 и SFTP

Подключение хранилища открывает QueryLane доступ к файлам в S3-совместимом объектном хранилище, например AWS S3, Yandex Object Storage, Cloud.ru или MinIO, или на SFTP-сервере. В нём можно просматривать папки, скачивать и загружать файлы, открывать табличные файлы как таблицы и писать к ним SQL. Задачи читают и записывают те же файлы шагами Записать файл и Перенести файлы.

Добавить подключение хранилища

1. Нажмите Подключения на левой панели.
2. В секции Источники данных нажмите + (Добавить источник).
3. В группе Файловые хранилища выберите S3-совместимое хранилище или SFTP.
4. Введите Название подключения и заполните поля, описанные ниже.
5. Нажмите Тестировать, затем Создать.

Подключения хранилищ показываются в секции Источники данных под заголовком Хранилища. Ключи и пароли лежат в зашифрованном хранилище секретов профиля, как и пароли баз, подробнее в разделе Где хранятся пароли.

S3-совместимое хранилище

• Адрес: адрес сервиса, например https://storage.yandexcloud.net
• Регион: регион для подписи запросов, по умолчанию us-east-1
• Бакет: необязательно. Без него подключение покажет все бакеты, доступные ключу
• Папка: необязательная папка в бакете, с которой начинается просмотр, например exports/
• Идентификатор ключа и Секретный ключ
• Адресация по пути: бакет указывается в пути, а не в имени хоста. Она нужна большинству своих хранилищ и MinIO, поэтому включена по умолчанию

Токен сессии нужен только для временных ключей. Не проверять сертификат TLS включайте только для сервера с самоподписанным сертификатом, которому вы доверяете.

С Бакетом подключение видит только этот бакет, а с Папкой только эту папку в нём. В этих границах остаются проводник, запросы, шаги задач и агенты. Папка без Бакета не принимается.

SFTP

• Хост, Порт (по умолчанию 22) и Пользователь
• Вход: Пароль, Приватный ключ с Паролем ключа или SSH-агент
• Начальная папка: с какой папки на сервере начинается просмотр, по умолчанию /. Подключение видит только эту папку и то, что в ней
• Отпечаток ключа хоста: отпечаток SHA256, который должен предъявить сервер. Если поле пустое, QueryLane сверяет сервер с Файлом known_hosts

Просмотр файлов

Нажмите на подключение хранилища, чтобы раскрыть его. В S3 сначала идут бакеты, затем папки и файлы, в SFTP — папки Начальной папки. Большие папки подгружаются постранично, в конце списка есть Показать ещё.

Двойной клик по папке открывает её во вкладке со столбцами Имя, Размер и Изменён и путём, по которому можно подняться выше. Правый клик по файлу или папке показывает действия:

• Открыть и Открыть папку
• Скачать: сохраняет файлы в выбранную папку. Если там уже есть файлы с такими именами, QueryLane сначала спросит
• Загрузить: отправляет один или несколько файлов в папку и спрашивает, прежде чем заменить уже лежащие там файлы
• Новая папка и Обновить
• Запрос: открывает вкладку запроса к табличному файлу, подробнее в разделе SQL по файлам
• Скопировать адрес: копирует адрес файла, например s3://reports/2026/10/orders.csv
• Удалить: сначала спрашивает. Папка удаляется вместе со всем содержимым

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

У файла в S3 есть ещё Ссылка для скачивания: она действует 1 час, 1 день или 7 дней. Пока ссылка действует, скачать файл может любой, у кого она есть.

Файлы как таблицы

Файлы CSV, TSV, JSON, JSONL, Parquet, Excel (XLSX и XLS) и XML открываются во вкладке таблицы, как таблица базы. Постраничный просмотр, сортировка, фильтры, виды Таблица, JSON и Дерево и Экспорт работают так же, подробнее в разделе Результаты и правка. Сжатые gzip файлы CSV, TSV, JSON, JSONL и Parquet тоже открываются. Данные доступны только для чтения.

Панель над таблицей показывает размер и дату файла и кнопки, чтобы скачать его, скопировать адрес или ссылку для скачивания и удалить. Если бакет S3 хранит версии, кнопка Версий на панели показывает их список, и каждую версию можно скачать или удалить кнопкой Удалить эту версию. У книги Excel выберите Лист и Строку заголовка, в которой лежат названия колонок.

Большой файл подготавливается один раз: QueryLane пишет Файл ещё не подготовлен к просмотру, а кнопка Подготовить делает локальную копию, ход виден в правом нижнем углу. Дальше страницы, подсчёт, сортировка и фильтры работают быстро. Подготовленные копии хранятся 7 дней после последнего использования, всего до 4 ГБ.

Текстовые файлы открываются как текст с подписью Начало файла. Для остальных показывается Для этого типа файлов превью нет, их можно скачать.

SQL по файлам

Вкладка запроса на подключении хранилища выполняет SQL DuckDB, а файл в нём называется как таблица, по адресу в двойных кавычках:

SELECT status, count(*) AS orders
FROM "s3://reports/2026/10/orders.parquet"
GROUP BY status
ORDER BY orders DESC;

В SFTP адрес начинается с sftp:// и абсолютного пути на сервере, например "sftp:///exchange/partners.csv". Для книги Excel лист и строка заголовка пишутся после #: "s3://reports/budget.xlsx#sheet=Plan&header=3".

Запрос в меню файла открывает вкладку с первым запросом к нему, а Скопировать адрес даёт адрес, который можно вставить в запрос. SQL-шаги задач так же могут брать подключение хранилища в Источник данных.

Агенты и хранилища

У подключений хранилищ такой же блок Агенты, как у баз, подробнее в разделе Доступ агентов. С Только чтение агенты могут смотреть папки, читать файлы и писать к ним SQL. С Чтение и запись они могут ещё записывать и удалять файлы, а Подтверждение изменений решает, ждёт ли это вашего ответа. Загрузка файла с вашего компьютера всегда сначала спрашивает.

Агенты работают только в пределах бакета, папки или начальной папки подключения, а ссылки для скачивания создаются только в приложении. Подробнее в разделе Подключение агента.