База данных
База данных Atoms Cloud хранит и управляет структурированными данными, на которые опирается ваше приложение, включая товары, бронирования, заказы, отправки форм и пользовательский контент. В модуле **База данных** вы можете просматривать среды и таблицы, искать и редактировать записи, проверять структуры таблиц, а также импортировать или экспортировать данные с помощью CSV-файлов.
Это руководство описывает базу данных, встроенную в Atoms Cloud. Если в вашем проекте используется Supabase, вместо этого см. Подключение Supabase.
Открытие базы данных
Перед открытием базы данных подключите ваш проект к Atoms Cloud. Если он еще не подключен, выполните шаги подключения в Atoms Cloud.
- Откройте ваш проект на настольном устройстве.
- На той же панели инструментов рабочего пространства, где находится Просмотр приложений, выберите Atoms Cloud.
- Выберите База данных на боковой панели Atoms Cloud.
- В разделе Databases выберите базу данных, которую хотите проверить. Карточки баз данных Development и Production появляются, когда они доступны для проекта.
На каждой карточке базы данных показано, сколько хранилища используется и какой общий объем доступен. Используйте Development при создании и тестировании вашего приложения. Изменения, внесенные в Production, могут повлиять на данные работающего приложения, поэтому перед внесением изменений всегда проверяйте, в какой среде вы находитесь.
Выберите базу данных Development или Production.
Просмотр и фильтрация данных таблицы
- Выберите карточку базы данных Development или Production в зависимости от среды, в которой вы хотите работать.
- Используйте Search tables, чтобы найти таблицу, или выберите ее напрямую из списка. На каждой карточке таблицы показано количество строк и то, доступна ли она только для чтения.
- Используйте Search rows для поиска в текущей таблице или выберите Filter, чтобы сузить результаты с помощью одного или нескольких полей.
- Используйте элементы управления со стрелками страниц под таблицей, чтобы просмотреть дополнительные строки.
- Чтобы проверить структуру таблицы, откройте меню ••• и выберите Schema.
В представлении Schema отображаются имя каждого поля, тип данных, статус ключа, требования, ограничения и значение по умолчанию. Выберите Copy, чтобы скопировать отображаемую схему.
Добавление, редактирование или удаление строк
Когда вы найдете базу данных, в которую хотите внести изменения, вы можете использовать для этого следующие действия:
| Operation | How to do it |
|---|---|
| Добавить строку | Откройте... и выберите Add Row. Введите значения, соответствующие доступным полям, затем отправьте строку. |
| Редактировать строку | Дважды щелкните ячейку и введите новое значение. ВыберитеCommit Changes, чтобы сохранить все ожидающие изменения, или Discard, чтобы удалить их. |
| Удалить строки | Выберите одну или несколько строк, выберитеDelete, затем подтвердите. Удаление строк нельзя отменить. |
Добавление строки или подтверждение удаления немедленно применяет изменение к выбранной базе данных. Только встроенное редактирование ячеек требует выбора Commit Changes или Discard. Если у вас есть ожидающие изменения, подтвердите или отмените их перед добавлением строки, импортом или экспортом CSV-файла, изменением поиска или фильтров либо переходом на другую страницу.
Если проект находится в рабочем пространстве, только Editors и workspace owner могут редактировать строки в таблицах с возможностью записи. Если Atoms не может определить первичный ключ для таблицы, вы не сможете редактировать или удалять ее строки, потому что Atoms не может надежно идентифицировать отдельные записи.
Проверьте ожидающее изменение строки, затем подтвердите или отмените изменение.
Создание таблиц или изменение схемы
Откройте среду базы данных, которую хотите обновить, затем следуйте инструкциям для нужного изменения:
| Operation | How to do it |
|---|---|
| Создать таблицу | В списке таблиц нажмите... и выберите Create table. Введите допустимое имя таблицы и начальные поля, затем отправьте запрос. Дождитесь, пока Agent завершит работу, снова откройте База данных и проверьте таблицу. |
| Изменить схему | Щелкните таблицу, в которую хотите внести изменения, затем нажмите... и выберите Schema. Используйте Add Field, чтобы создать поле, или выберите подходящее поле, чтобы отредактировать его. Вы можете изменить его имя, тип, значение по умолчанию, обязательность или уникальность. Вы также можете пометить неключевые поля для удаления. Выберите Submit Changes, чтобы отправить запрос Agent, или Discard, чтобы очистить ожидающие изменения. |
Только workspace owner может создавать таблицы или изменять схему таблицы.
Отправка запроса на изменение схемы не означает, что миграция завершена. Дождитесь, пока Agent завершит работу, проверьте результат в База данных и после этого протестируйте ваше приложение. Поля первичного ключа и таблицы только для чтения нельзя изменить таким способом.
Введите сведения о новом поле в Add Field.
Проверьте ожидающие изменения схемы перед выбором Submit Changes.
Импорт или экспорт данных CSV
Выберите таблицу, с которой хотите работать, затем следуйте инструкциям для соответствующей операции:
| Operation | How to do it |
|---|---|
| Импорт CSV | Нажмите... и выберите Import CSV. Выберите файл .csv размером не более 10 МБ, затем перед подтверждением проверьте имя файла, предполагаемое количество строк, выбранную таблицу и среду. Столбцы CSV должны соответствовать схеме таблицы. Импортированные строки добавляются сразу и не могут быть автоматически отменены, поэтому сначала рекомендуется экспортировать существующие данные. |
| Экспорт CSV | Нажмите... и выберите Export CSV. Если активен поиск или фильтр, будут экспортированы только соответствующие строки. В противном случае экспортируются все данные из текущей таблицы. |
Только workspace owner может импортировать или экспортировать CSV-файлы. Для таблиц только для чтения единственным доступным вариантом является Export CSV.
Разрешения и защищенные таблицы
| Action | Who can perform it | Additional requirements |
|---|---|---|
| Добавлять, редактировать или удалять строки | Editor или workspace owner | Таблица должна быть доступна для записи. Для редактирования и удаления строк также требуется информация о первичном ключе. |
| Создавать таблицы или изменять схемы | Рабочее пространство owner | Поля первичного ключа и таблицы только для чтения нельзя изменять. |
| Импортировать или экспортировать CSV-файлы | Рабочее пространство owner | CSV-файлы нельзя импортировать в таблицы только для чтения. |
Защищенные системные или пользовательские таблицы могут отображать метку Read-only. Вы можете просматривать их данные и, если доступно, проверять их схему, но не можете изменять их строки или структуру с этой страницы.
Решение распространенных проблем с базой данных
«Базы данных не найдены» или «Таблицы не найдены»
Убедитесь, что Atoms Cloud подключен к проекту. Если он уже подключен, проверьте, что ваше приложение включает функцию, которая хранит постоянные данные. При необходимости попросите Agent добавить функцию, работающую с базой данных. Когда Agent завершит работу, снова откройте База данных или выберите Refresh.
Действие с базой данных отсутствует или недоступно
Проверьте, есть ли у таблицы метка Read-only, затем просмотрите разрешения выше, чтобы убедиться, что ваша роль в рабочем пространстве позволяет выполнить это действие. Для редактирования и удаления строк также требуется информация о первичном ключе.
Ожидающие изменения строк могут блокировать другие действия. Выберите Commit Changes или Discard перед добавлением строки, импортом или экспортом CSV-файла, изменением поиска или фильтров либо переходом на другую страницу.
Если после этих проверок действие все еще недоступно, свяжитесь с Support и укажите ссылку на проект или Chat, среду, таблицу, роль в рабочем пространстве, предпринятое действие и точный текст ошибки.
Не удается импортировать CSV-файл
Импортировать данные может только workspace owner, а целевая таблица должна быть доступна для записи. Убедитесь, что:
- Файл использует формат
.csv. - Размер файла не превышает 10 МБ.
- Его столбцы и данные совместимы со схемой целевой таблицы.
- Вы подтвердили или отменили все ожидающие изменения строк.
Если импорт по-прежнему не удается, свяжитесь с Support и укажите ссылку на проект или Chat, среду, целевую таблицу, роль в рабочем пространстве, имя и размер файла, предпринятое действие и точный текст ошибки.
FAQ
Моя база данных production не синхронизируется. Что делать?
Если Development работает нормально, но на работающем сайте (Production) отсутствуют таблицы, столбцы или возникают ошибки миграции:
Важно: не пересобирайте и не перезаписывайте production-базу данных самостоятельно.
Необходимая информация:
- Ссылка на Chat и live URL
- Полное сообщение об ошибке SQL
- Имена отсутствующих таблиц/столбцов
- Последнее изменение схемы базы данных
- Последняя рабочая live-версия
- Нужно ли сохранить данные production
- Хотите ли вы полностью синхронизировать данные Development или только заполнить отсутствующие структуры
Свяжитесь с поддержкой и предоставьте эти сведения, чтобы мы могли сравнить версии Development/Production, статус миграции и различия в схеме перед внесением изменений.
Почему мои данные development отличаются от данных production?
Если вы публиковали несколько раз, но Production по-прежнему показывает старые данные, тогда как обновления кода работают нормально:
Перед обращением в поддержку уточните:
1. Нужно ли сохранить текущие данные production?
2. Хотите ли вы полностью перезаписать их текущими данными Development или только заполнить отсутствующие записи?
3. Есть ли у вас уже резервная копия?
4. Какое окно обслуживания для вас приемлемо?
Мы не будем перезаписывать или пересобирать данные production, пока не будет подтверждена цель обработки данных. Предоставьте URL Development/Production и примеры ID записей или количества записей, показывающие различие.
Могу ли я перенести базу данных из одного проекта Atoms в другой без потери данных?
В настоящее время Atoms не поддерживает автоматическую миграцию базы данных между проектами без потерь. Создание нового проекта или разделение существующего проекта не приведет к автоматическому копированию существующих учетных записей пользователей или записей базы данных в новый проект.
Перед продолжением:
- Не сбрасывайте, не заменяйте, не мигрируйте и не удаляйте существующую базу данных или ресурсы проекта.
- Сохраните исходный проект без изменений как источник существующих данных.
- Свяжитесь с Atoms Support и укажите исходный проект, целевой проект, провайдера базы данных и данные, которые необходимо сохранить.
В некоторых случаях команда может помочь с разовым ручным копированием из исходной базы данных в целевую. Это не непрерывная синхронизация: любые новые данные, записанные в источник после начала копирования, не появятся автоматически в целевом проекте.
Чтобы минимизировать различия в данных, приостановите запись в исходную базу данных на время окна миграции и проверьте скопированные данные в целевом проекте перед переключением на него. Полностью безошибочная миграция без потерь в настоящее время не может быть гарантирована.