База данных
База данных 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 |
|---|---|
| Import CSV | Нажмите ... и выберите Import CSV. Выберите файл .csv размером не более 10 МБ, затем перед подтверждением проверьте имя файла, предполагаемое количество строк, выбранную таблицу и среду. Столбцы CSV должны соответствовать схеме таблицы. Импортированные строки добавляются сразу и не могут быть автоматически отменены, поэтому сначала рекомендуется экспортировать существующие данные. |
| Export 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
Моя производственная база данных не синхронизируется. Что делать?
Если Development работает нормально, но на рабочем сайте (Production) отсутствуют таблицы, столбцы или возникают ошибки миграции:
Важно: не перестраивайте и не перезаписывайте производственную базу данных самостоятельно.
Необходимая информация:
- Ссылка на Chat и live URL
- Полное сообщение об ошибке SQL
- Имена отсутствующих таблиц/столбцов
- Последнее изменение схемы базы данных
- Последняя рабочая live-версия
- Нужно ли сохранить данные production
- Хотите ли вы полностью синхронизировать данные Development или только заполнить отсутствующие структуры
Свяжитесь с поддержкой и предоставьте эти сведения, чтобы мы могли сравнить версии Development/Production, статус миграции и различия схем перед внесением изменений.
Почему мои данные development отличаются от данных production?
Если вы публиковали несколько раз, но в Production по-прежнему отображаются старые данные, тогда как обновления кода работают нормально:
Перед обращением в поддержку уточните:
1. Нужно ли сохранить текущие данные production?
2. Хотите ли вы полностью перезаписать их текущими данными Development или только заполнить отсутствующие записи?
3. Есть ли у вас уже резервная копия?
4. Какое окно обслуживания для вас приемлемо?
Мы не будем перезаписывать или перестраивать данные production, пока не будет подтверждена цель обработки данных. Предоставьте URL-адреса Development/Production и примеры ID записей или количества записей, показывающие различие.