Подключите проект Atoms к Supabase, если хотите, чтобы приложение использовало базу данных Supabase, аутентификацию, файловое хранилище или серверные функции.

Это руководство проведет вас по всему процессу: подготовка учетной записи и проекта Supabase, авторизация нужной организации, подключение проекта, проверка успешности подключения и его отключение при необходимости.

Как работает подключение

Каждый проект Supabase принадлежит организации, которая определяет, кто может получать доступ к проектам внутри нее и управлять ими. Когда вы подключаете Supabase к Atoms, сначала вы авторизуете Atoms для доступа к организации, которую хотите использовать, а затем выбираете проект из этой организации для подключения.

Каждый проект Atoms может быть подключен только к одному проекту Supabase одновременно. Однако один и тот же проект Supabase может быть подключен более чем к одному проекту Atoms.

Supabase и Atoms Cloud — это альтернативные варианты серверной части. Вы не можете подключить оба к одному и тому же проекту Atoms одновременно.

Перед началом

Перед подключением Supabase убедитесь, что:

• Вы являетесь владельцем рабочего пространства Atoms, в котором находится проект. Только владелец рабочего пространства может авторизовать, подключать или отключать Supabase.
• У вас есть учетная запись Supabase или вы готовы создать ее во время настройки.
• У вас есть разрешение на авторизацию организации Supabase и доступ к проекту, который вы хотите подключить.
• Agent завершил текущую задачу, и Гоночный режим выключен.
• Ваш браузер разрешает всплывающие окна от Atoms.
• Ваш проект Atoms еще не подключен к Atoms Cloud.

Если вы пробуете это подключение впервые, подумайте об использовании тестового проекта, пока изучаете процесс.

Никогда не вставляйте пароль Supabase, API-ключ, токен доступа или другие учетные данные в Chat.

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

Откройте коннектор Supabase

1. Откройте проект, который хотите подключить.
2. Нажмите на имя проекта в правом верхнем углу панели чата.
3. Выберите Connectors в появившемся выпадающем меню.
4. Найдите Supabase в списке доступных коннекторов и нажмите connect.

Вы также можете открыть Settings → Connectors → Supabase и выбрать Connect.

Откройте Settings → Connectors и выберите Connect для Supabase.

Авторизация Atoms в Supabase

Если в разделе Organizations уже отображается нужная вам организация Supabase, значит, она уже авторизована. Вы можете перейти к разделу Выберите проект Supabase.

1. Atoms откроет окно авторизации Supabase. Войдите в учетную запись Supabase, которую хотите подключить, или при необходимости создайте новую учетную запись.
2. Убедитесь, что вы вошли в правильную учетную запись Supabase, затем выберите организацию, к которой Atoms должен получить доступ.
3. Просмотрите разрешения, которые запрашивает Atoms. Чтобы увидеть все разрешения, выберите Show detailed permissions. Если вы согласны, выберите Authorize Atoms.
4. Вернитесь в Atoms и дождитесь сообщения Connect success.
5. В Atoms откройте Connectors → Supabase и убедитесь, что организация отображается в разделе Organizations.

Atoms запрашивает доступ на чтение и запись к База данных, Secrets, Auth, Edge Functions, Environment, Projects, PostgREST и Storage. Он также запрашивает доступ на чтение к Organizations и Domains. Эти разрешения позволяют Atoms подключать и управлять поддерживаемыми сервисами Supabase, используемыми вашим проектом.

Эта авторизация применяется к выбранной организации Supabase и не ограничивается проектом Supabase, который вы позже подключите к текущему проекту Atoms. Atoms не может получить доступ к организациям или проектам, к которым сама подключенная учетная запись Supabase не имеет доступа, а разрешения Supabase могут накладывать дополнительные ограничения.

Проверьте организацию и разрешения перед авторизацией Atoms.

Выберите проект Supabase

1. В разделе Organizations разверните организацию, которую вы авторизовали.
2. В разделе Projects найдите активный проект Supabase, который хотите подключить.
3. Если нужная вам организация не указана в списке, выберите New Organization и авторизуйте ее. Это не создает новую организацию Supabase; это позволяет вам авторизовать другую организацию, которая уже существует в вашей учетной записи Supabase.
4. Если у вас еще нет проекта, выберите Create Project и создайте его в Supabase. Подождите, пока проект станет активным и готовым к использованию, затем вернитесь в Atoms и выберите Update, чтобы обновить список проектов.
5. Рядом с проектом, который хотите использовать, выберите Connect.

Выберите проект Supabase из авторизованной организации.

Подтвердите проект

1. В окне подтверждения проверьте организацию и проект, указанные в разделе Supabase Project.
2. При необходимости используйте Supabase Dashboard или View Tables, чтобы убедиться, что вы выбрали правильный проект.
3. Выберите Connect.
4. Atoms добавит элемент подключения Supabase в Chat проекта. Оставьте страницу открытой и дождитесь завершения процесса, прежде чем просить Agent создать базу данных, аутентификацию, хранилище или серверную функцию.

Подтвердите выбранный проект Supabase перед подключением.

Проверьте, что подключение работает

1. Откройте Settings → Connectors → Supabase.
2. Убедитесь, что правильные организация и проект Supabase отображаются как подключенные.
3. Выберите Dashboard или Tables и проверьте, что открывается тот же проект в Supabase.

Панель подключенного проекта также может содержать ссылки на Manage Users, SQL Editor, Edge Functions и Manage Secrets. Вам нужно использовать только те разделы, которые относятся к функциям, которые вы создаете.

Проверьте подключенный проект Supabase и его ссылки для управления.

Проверьте, что ваше приложение может сохранять данные

Подключение Supabase само по себе не добавляет в приложение функцию базы данных. В Chat попросите Agent создать нужную вам функцию и использовать подключенный проект Supabase для хранения ее данных. После завершения работы Agent протестируйте весь сценарий целиком.

1. В Chat опишите нужную вам функцию, какую информацию она должна сохранять и где пользователи должны снова видеть эту информацию. Скажите Agent использовать подключенный проект Supabase.
2. Дождитесь, пока Agent завершит создание функции.
3. В Просмотр приложений используйте функцию так, как это сделал бы пользователь, и введите безопасные тестовые данные. Не используйте личную, конфиденциальную или чувствительную информацию.
4. Обновите Просмотр приложений или снова откройте функцию. Убедитесь, что сохраненная информация остается и отображается в правильном месте.
5. Откройте Settings → Connectors → Supabase, выберите Tables и убедитесь, что соответствующая запись появилась в правильной таблице.

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

Отключение Supabase

Отключите Supabase, если вы больше не хотите, чтобы текущий проект Atoms использовал подключенный проект Supabase.

1. Откройте Settings → Connectors → Supabase.
2. Убедитесь, что вы просматриваете подключение для правильного проекта Atoms.
3. Выберите Disconnect Project.
4. Дождитесь завершения элемента отключения Supabase в Chat.
5. Снова откройте Connectors → Supabase и убедитесь, что проект больше не отображается как подключенный.

Отключение удаляет подключение из текущего проекта Atoms. Оно не удаляет проект Supabase или его данные и не отменяет авторизацию для организации Supabase.

Любые функции в вашем проекте Atoms, зависящие от Supabase, могут перестать работать после его отключения. Если ваше приложение уже опубликовано, возможно, вам потребуется обновить опубликованную версию, прежде чем изменения вступят в силу. После отключения протестируйте и ваш проект, и опубликованное приложение.

Отключение Supabase от одного проекта Atoms не влияет на другие проекты Atoms, подключенные к тому же проекту Supabase.

FAQ

Почему мое подключение Supabase перестало работать?

1. Откройте Supabase Dashboard и проверьте статус затронутого проекта. Проект с низкой активностью на Бесплатный тариф может быть приостановлен после семидневного периода.
2. Если он приостановлен, выберите Resume project и дождитесь, пока Supabase сообщит, что он снова активен.
3. Вернитесь в Atoms, откройте панель Connectors проекта и проверьте подключение Supabase. Повторите неудавшееся действие один раз.
4. Если Supabase уже активен, зафиксируйте точную ошибку Atoms или Supabase и проверьте, отображается ли подключение как отключенное или истекшее. Повторно подключайте его только тогда, когда статус указывает, что это необходимо.

Не меняйте ключи и не создавайте заменяющий проект, пока не выясните причину и не защитите существующие данные. Если сбой продолжается, свяжитесь со службой поддержки и предоставьте Chat Link, время и часовой пояс, статус подключения и очищенный от чувствительных данных скриншот ошибки.

Внешняя ссылка: Supabase — Приостановка проекта

Как повторно подключить проект Supabase, который был приостановлен?

1. Войдите в правильную организацию Supabase и откройте приостановленный проект.
2. Выберите Resume project и дождитесь, пока его статус станет активным. Согласно текущим рекомендациям Supabase, проекты на Бесплатный тариф с низкой активностью могут быть приостановлены после семидневного периода низкой активности.
3. Вернитесь в Atoms и откройте панель Connectors проекта. Убедитесь, что Supabase подключен, затем повторите затронутую операцию.
4. Если Atoms по-прежнему показывает коннектор как отключенный или истекший, подключите его снова и завершите запрошенную авторизацию.

Не создавайте новый проект Supabase и не меняйте учетные данные, пока существующие данные не будут защищены. Если повторное подключение не удается, предоставьте службе поддержки Chat Link, статус проекта Supabase, время и часовой пояс, а также очищенный от чувствительных данных скриншот ошибки.

Внешняя ссылка: Supabase — Приостановка проекта