Подключение S3
Содержание
S3 подключается в SubQuery по статическим ключам доступа: сервис работает с любым S3-совместимым хранилищем, включая Yandex Object Storage. Подключённый бакет используется файловым менеджером и dbt-проектом.
Что понадобится
- эндпоинт хранилища, например
https://storage.yandexcloud.net; - пара ключей доступа:
accessKey(публичный) иsecretKey(секретный); - название бакета;
- регион — для Yandex Object Storage это
ru-central-1.
Ключи создаются в консоли вашего хранилища. Рекомендуем создать отдельный сервисный аккаунт с доступом только к нужному бакету.
Создание подключения
- Откройте проект → Подключения → Создать.
- Выберите тип S3.
- Заполните поля:
| Поле | Значение |
|---|---|
| Название | произвольное имя подключения в проекте |
| Эндпоинт | адрес S3-совместимого хранилища |
| accessKey | публичный ключ доступа |
| secretKey | секретный ключ доступа |
| Регион | регион хранилища, по умолчанию ru-central-1 |
| Бакет S3 | название бакета |
| Путь | необязательная папка внутри бакета для ограничения области |
- Нажмите Сохранить — SubQuery проверит бакет и, если указан путь, наличие папки.
Права доступа
Минимально достаточные права для сервисного аккаунта:
- чтение списка объектов и скачивание — для работы файлового менеджера;
- запись — если файлы будут загружаться в бакет или хранить результаты dbt.
Если указан путь (папка), у ключей должен быть доступ к этой папке; иначе проверка вернёт ошибку «папка не найдена или нет доступа».
Где использовать подключение
- Файловый менеджер — загрузка, скачивание и организация файлов в бакете.
- dbt — S3-подключение хранит артефакты dbt-проекта.
Безопасность
- Секретный ключ хранится в зашифрованном виде и не отображается повторно.
- При редактировании подключения ключ можно не вводить заново.
- Для отзывов доступа достаточно перевыпустить ключи в хранилище и обновить подключение.