База данных Atoms Cloud хранит и управляет структурированными данными, на которые опирается ваше приложение, включая товары, бронирования, заказы, отправки форм и пользовательский контент. В модуле База данных вы можете просматривать среды и таблицы, искать и редактировать записи, проверять структуры таблиц, а также импортировать или экспортировать данные с помощью CSV-файлов.

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

Открытие базы данных

Перед открытием базы данных подключите ваш проект к Atoms Cloud. Если он еще не подключен, выполните шаги подключения в Atoms Cloud.

1. Откройте ваш проект на настольном устройстве.
2. На той же панели инструментов рабочего пространства, где находится Просмотр приложений , выберите Atoms Cloud.
3. Выберите База данных на боковой панели Atoms Cloud.
4. В разделе Databases выберите базу данных, которую хотите проверить. Карточки баз данных Development и Production появляются, когда они доступны для проекта.

На каждой карточке базы данных показано, сколько хранилища используется и какой общий объем доступен. Используйте Development при создании и тестировании приложения. Изменения, внесенные в Production, могут повлиять на данные работающего приложения, поэтому перед внесением изменений всегда проверяйте, в какой среде вы находитесь.

Выберите базу данных Development или Production.

Просмотр и фильтрация данных таблицы

1. Выберите карточку базы данных Development или Production в зависимости от среды, в которой вы хотите работать.
2. Используйте Search tables, чтобы найти таблицу, или выберите ее напрямую из списка. На каждой карточке таблицы показано количество строк и то, является ли она доступной только для чтения.
3. Используйте Search rows, чтобы искать в текущей таблице, или выберите Filter, чтобы сузить результаты с помощью одного или нескольких полей.
4. Используйте элементы управления со стрелками страниц под таблицей, чтобы просматривать дополнительные строки.
5. Чтобы проверить структуру таблицы, откройте меню ••• и выберите Schema.

В представлении Schema показаны имя каждого поля, тип данных, статус ключа, требования, ограничения и значение по умолчанию. Выберите Copy, чтобы скопировать отображаемую схему.

Добавление, редактирование или удаление строк

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

Операция	Как это сделать
Добавить строку	Откройте ... и выберите Add Row. Введите значения, соответствующие доступным полям, затем отправьте строку.
Редактировать строку	Дважды щелкните по ячейке и введите новое значение. Выберите Commit Changes, чтобы сохранить все ожидающие изменения, или Discard, чтобы удалить их.
Удалить строки	Выберите одну или несколько строк, выберите Delete, затем подтвердите действие. Удаление строк нельзя отменить.

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

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

Проверьте ожидающее редактирование строки, затем зафиксируйте или отмените изменение.

Создание таблиц или изменение схемы

Откройте среду базы данных, которую хотите обновить, затем следуйте инструкциям для нужного изменения:

Операция	Как это сделать
Создать таблицу	В списке таблиц нажмите ... и выберите Create table. Введите допустимое имя таблицы и начальные поля, затем отправьте запрос. Дождитесь, пока Agent завершит работу, снова откройте База данных и проверьте таблицу.
Изменить схему	Нажмите на таблицу, в которую хотите внести изменения, затем нажмите ... и выберите Schema. Используйте Add Field, чтобы создать поле, или выберите подходящее поле, чтобы отредактировать его. Вы можете изменить его имя, тип, значение по умолчанию, обязательность или уникальность. Вы также можете пометить неключевые поля для удаления. Выберите Submit Changes, чтобы отправить запрос Agent, или Discard, чтобы очистить ожидающие изменения.

Только владелец рабочего пространства может создавать таблицы или изменять схему таблицы.

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

Введите сведения о новом поле в Add Field.

Проверьте ожидающие изменения схемы перед выбором Submit Changes.

Импорт или экспорт данных CSV

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

Операция	Как это сделать
Импорт CSV	Нажмите ... и выберите Import CSV. Выберите файл .csv размером не более 10 МБ, затем перед подтверждением проверьте имя файла, предполагаемое количество строк, выбранную таблицу и среду. Столбцы CSV должны соответствовать схеме таблицы. Импортированные строки добавляются сразу и не могут быть автоматически отменены, поэтому сначала стоит рассмотреть экспорт существующих данных.
Экспорт CSV	Нажмите ... и выберите Export CSV. Если активен поиск или фильтр, будут экспортированы только соответствующие строки. В противном случае будут экспортированы все данные из текущей таблицы.

Только владелец рабочего пространства может импортировать или экспортировать CSV-файлы. Для таблиц только для чтения Export CSV — единственный доступный вариант.

Разрешения и защищенные таблицы

Действие	Кто может это выполнять	Дополнительные требования
Добавление, редактирование или удаление строк	Editor или владелец рабочего пространства	Таблица должна быть доступна для записи. Для редактирования и удаления строк также требуется информация о первичном ключе.
Создание таблиц или изменение схем	Владелец рабочего пространства	Поля первичного ключа и таблицы только для чтения нельзя изменять.
Импорт или экспорт CSV-файлов	Владелец рабочего пространства	CSV-файлы нельзя импортировать в таблицы только для чтения.

Защищенные системные или пользовательские таблицы могут отображать значок Read-only. Вы можете просматривать их данные и проверять их схему, если она доступна, но не можете изменять их строки или структуру с этой страницы.

Устранение распространенных проблем с базой данных

«Базы данных не найдены» или «Таблицы не найдены»

Убедитесь, что Atoms Cloud подключен к проекту. Если он уже подключен, убедитесь, что ваше приложение включает функцию, которая хранит постоянные данные. При необходимости попросите Agent добавить функцию, работающую на базе данных. Когда Agent завершит работу, снова откройте База данных или выберите Refresh.

Действие с базой данных отсутствует или недоступно

Проверьте, есть ли у таблицы значок Read-only, затем просмотрите разрешения выше, чтобы убедиться, что ваша роль в рабочем пространстве позволяет выполнять это действие. Для редактирования и удаления строк также требуется информация о первичном ключе.

Ожидающие изменения строк могут блокировать другие действия. Выберите Commit Changes или Discard перед добавлением строки, импортом или экспортом CSV-файла, изменением поиска или фильтров либо переходом на другую страницу.

Если действие по-прежнему недоступно после этих проверок, свяжитесь со Support и укажите ссылку на проект или Chat, среду, таблицу, роль в рабочем пространстве, предпринятое действие и точный текст ошибки.

CSV-файл не удается импортировать

Только владелец рабочего пространства может импортировать данные, и целевая таблица должна быть доступна для записи. Убедитесь, что:

• Файл использует формат .csv.
• Размер файла не превышает 10 МБ.
• Его столбцы и данные совместимы со схемой целевой таблицы.
• Вы зафиксировали или отменили все ожидающие изменения строк.

Если импорт по-прежнему не удается, свяжитесь со Support и укажите ссылку на проект или Chat, среду, целевую таблицу, роль в рабочем пространстве, имя и размер файла, предпринятое действие и точный текст ошибки.

FAQ

Моя production database не синхронизируется. Что делать?

Если Development работает нормально, но на рабочем сайте (Production) отсутствуют таблицы, столбцы или возникают ошибки миграции:

Важно: не пересоздавайте и не перезаписывайте production database самостоятельно.

Необходимая информация:

• Ссылка на Chat и live URL
• Полное сообщение об ошибке SQL
• Имена отсутствующих таблиц/столбцов
• Последнее изменение схемы базы данных
• Последняя рабочая live-версия
• Нужно ли сохранить production data
• Хотите ли вы полностью синхронизировать данные Development или только заполнить отсутствующие структуры

Свяжитесь с поддержкой и предоставьте эти сведения, чтобы мы могли сравнить версии Development/Production, статус миграции и различия схем перед внесением изменений.

Почему мои данные development отличаются от данных production?

Если вы публиковали несколько раз, но Production по-прежнему показывает старые данные, в то время как обновления кода работают нормально:

Перед обращением в поддержку подтвердите:

1. Нужно ли сохранить текущие данные production?

2. Хотите ли вы полностью перезаписать их текущими данными Development или только заполнить отсутствующие записи?

3. Есть ли у вас уже резервная копия?

4. Какое окно обслуживания для вас приемлемо?

Мы не будем перезаписывать или пересоздавать данные production, пока не будет подтверждена цель обработки данных. Предоставьте URL-адреса Development/Production и примеры ID записей или количества записей, показывающие различие.