Подключение S3

S3 подключается в SubQuery по статическим ключам доступа: сервис работает с любым S3-совместимым хранилищем, включая Yandex Object Storage. Подключённый бакет используется файловым менеджером и dbt-проектом.

Что понадобится

  • эндпоинт хранилища, например https://storage.yandexcloud.net;
  • пара ключей доступа: accessKey (публичный) и secretKey (секретный);
  • название бакета;
  • регион — для Yandex Object Storage это ru-central-1.

Ключи создаются в консоли вашего хранилища. Рекомендуем создать отдельный сервисный аккаунт с доступом только к нужному бакету.

Создание подключения

  1. Откройте проект → Подключения → Создать.
  2. Выберите тип S3.
  3. Заполните поля:
Поле Значение
Название произвольное имя подключения в проекте
Эндпоинт адрес S3-совместимого хранилища
accessKey публичный ключ доступа
secretKey секретный ключ доступа
Регион регион хранилища, по умолчанию ru-central-1
Бакет S3 название бакета
Путь необязательная папка внутри бакета для ограничения области
  1. Нажмите Сохранить — SubQuery проверит бакет и, если указан путь, наличие папки.

Права доступа

Минимально достаточные права для сервисного аккаунта:

  • чтение списка объектов и скачивание — для работы файлового менеджера;
  • запись — если файлы будут загружаться в бакет или хранить результаты dbt.

Если указан путь (папка), у ключей должен быть доступ к этой папке; иначе проверка вернёт ошибку «папка не найдена или нет доступа».

Где использовать подключение

  • Файловый менеджер — загрузка, скачивание и организация файлов в бакете.
  • dbt — S3-подключение хранит артефакты dbt-проекта.

Безопасность

  • Секретный ключ хранится в зашифрованном виде и не отображается повторно.
  • При редактировании подключения ключ можно не вводить заново.
  • Для отзывов доступа достаточно перевыпустить ключи в хранилище и обновить подключение.