Atoms 클라우드 데이터베이스는 제품, 예약, 주문, 양식 제출, 사용자 생성 콘텐츠를 포함해 앱이 의존하는 구조화된 데이터를 저장하고 관리합니다. 데이터베이스 모듈에서는 환경과 테이블을 보고, 레코드를 검색하고 편집하며, 테이블 구조를 확인하고, CSV 파일을 사용해 데이터를 가져오거나 내보낼 수 있습니다.

이 가이드는 Atoms 클라우드에 내장된 데이터베이스를 다룹니다. 프로젝트에서 Supabase를 사용하는 경우에는 대신 Supabase 연동을 참조하세요.

데이터베이스 열기

데이터베이스를 열기 전에 프로젝트를 Atoms 클라우드에 연결하세요. 아직 연결되지 않았다면 Atoms 클라우드의 연결 단계를 따르세요.

1. 데스크톱 기기에서 프로젝트를 엽니다.
2. App 뷰어 가 있는 동일한 워크스페이스 도구 모음에서 Atoms 클라우드를 선택합니다.
3. Atoms 클라우드 사이드바에서 데이터베이스를 선택합니다.
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와 workspace owner만 편집할 수 있습니다. Atoms가 테이블의 기본 키를 감지할 수 없으면 개별 레코드를 안정적으로 식별할 수 없기 때문에 해당 행을 편집하거나 삭제할 수 없습니다.

보류 중인 행 편집을 검토한 다음 변경 사항을 커밋하거나 취소합니다.

테이블 생성 또는 스키마 변경

업데이트하려는 데이터베이스 환경을 연 다음, 원하는 변경 사항에 대한 안내를 따르세요.

작업	방법
테이블 생성	테이블 목록에서 ...을 클릭하고 Create table을 선택합니다. 유효한 테이블 이름과 초기 필드를 입력한 다음 요청을 제출합니다. 에이전트가 완료될 때까지 기다린 후 데이터베이스를 다시 열고 테이블을 확인합니다.
스키마 변경	변경하려는 테이블을 클릭한 다음 ...을 클릭하고 Schema. 를 선택합니다. Add Field를 사용해 필드를 만들거나, 편집 가능한 필드를 선택해 수정합니다. 이름, 유형, 기본값, 필수 여부 또는 고유성을 변경할 수 있습니다. 키가 아닌 필드는 삭제 대상으로 표시할 수도 있습니다. 요청을 에이전트에 보내려면 Submit Changes를 선택하고, 보류 중인 변경 사항을 지우려면 Discard를 선택합니다.

테이블을 생성하거나 테이블의 스키마를 변경할 수 있는 사람은 workspace owner뿐입니다.

스키마 요청을 제출했다고 해서 마이그레이션이 완료된 것은 아닙니다. 에이전트가 완료될 때까지 기다리고, 데이터베이스에서 결과를 확인한 후 앱을 테스트하세요. 기본 키 필드와 읽기 전용 테이블은 이 방법으로 수정할 수 없습니다.

Add Field에 새 필드의 세부 정보를 입력합니다.

Submit Changes를 선택하기 전에 보류 중인 스키마 변경 사항을 검토합니다.

CSV 데이터 가져오기 또는 내보내기

작업하려는 테이블을 선택한 다음, 해당 작업에 대한 안내를 따르세요.

작업	방법
CSV 가져오기	...을 클릭하고 Import CSV를 선택합니다. 10MB 이하의 .csv 파일을 선택한 다음, 확인 전에 파일 이름, 예상 행 수, 선택한 테이블, 환경을 검토합니다. CSV 열은 테이블 스키마와 일치해야 합니다. 가져온 행은 즉시 추가되며 자동으로 되돌릴 수 없으므로, 먼저 기존 데이터를 내보내는 것을 고려하세요.
CSV 내보내기	...을 클릭하고 Export CSV를 선택합니다. 검색 또는 필터가 활성화되어 있으면 일치하는 행만 내보내집니다. 그렇지 않으면 현재 테이블의 모든 데이터가 내보내집니다.

CSV 파일을 가져오거나 내보낼 수 있는 사람은 workspace owner뿐입니다. 읽기 전용 테이블에서는 Export CSV만 사용할 수 있습니다.

권한 및 보호된 테이블

작업	수행할 수 있는 사람	추가 요구 사항
행 추가, 편집 또는 삭제	Editor 또는 workspace owner	테이블은 쓰기 가능해야 합니다. 행 편집 및 삭제에는 기본 키 정보도 필요합니다.
테이블 생성 또는 스키마 변경	Workspace owner	기본 키 필드와 읽기 전용 테이블은 수정할 수 없습니다.
CSV 파일 가져오기 또는 내보내기	Workspace owner	CSV 파일은 읽기 전용 테이블로 가져올 수 없습니다.

보호된 시스템 또는 사용자 테이블에는 Read-only 배지가 표시될 수 있습니다. 사용 가능한 경우 해당 데이터와 스키마를 확인할 수는 있지만, 이 페이지에서 행이나 구조를 수정할 수는 없습니다.

일반적인 데이터베이스 문제 해결

“No databases found” 또는 “No tables found”

Atoms 클라우드가 프로젝트에 연결되어 있는지 확인하세요. 이미 연결되어 있다면 앱에 영구 데이터를 저장하는 기능이 포함되어 있는지 확인하세요. 필요한 경우 에이전트에게 데이터베이스 기반 기능을 추가해 달라고 요청하세요. 에이전트가 완료되면 데이터베이스를 다시 열거나 Refresh를 선택하세요.

데이터베이스 작업이 없거나 사용할 수 없음

테이블에 Read-only 배지가 있는지 확인한 다음, 위 권한 정보를 검토하여 워크스페이스 역할이 해당 작업을 허용하는지 확인하세요. 행 편집 및 삭제에는 기본 키 정보도 필요합니다.

보류 중인 행 편집은 다른 작업을 막을 수 있습니다. 행을 추가하거나, CSV 파일을 가져오거나 내보내거나, 검색 또는 필터를 변경하거나, 다른 페이지로 이동하기 전에 Commit Changes 또는 Discard를 선택하세요.

이러한 확인 후에도 작업을 사용할 수 없다면 Support에 문의하고 프로젝트 또는 Chat 링크, 환경, 테이블, 워크스페이스 역할, 시도한 작업, 정확한 오류 텍스트를 포함하세요.

CSV 파일을 가져올 수 없음

데이터를 가져올 수 있는 사람은 workspace owner뿐이며, 대상 테이블은 쓰기 가능해야 합니다. 다음 사항을 확인하세요.

• 파일이 .csv 형식을 사용합니다.
• 파일 크기가 10MB를 초과하지 않습니다.
• 열과 데이터가 대상 테이블의 스키마와 호환됩니다.
• 보류 중인 행 편집을 커밋하거나 취소했습니다.

가져오기가 계속 실패하면 Support에 문의하고 프로젝트 또는 Chat 링크, 환경, 대상 테이블, 워크스페이스 역할, 파일 이름과 크기, 시도한 작업, 정확한 오류 텍스트를 포함하세요.

FAQ

프로덕션 데이터베이스가 동기화되지 않습니다. 어떻게 해야 하나요?

Development는 정상적으로 작동하지만 라이브 사이트(Production)에 누락된 테이블, 열 또는 마이그레이션 오류가 표시되는 경우:

중요: 프로덕션 데이터베이스를 직접 다시 빌드하거나 덮어쓰지 마세요.

필요한 정보:

• Chat 링크 및 라이브 URL
• 전체 SQL 오류 메시지
• 누락된 테이블/열 이름
• 마지막 데이터베이스 스키마 변경 사항
• 마지막으로 정상 작동한 라이브 버전
• 프로덕션 데이터를 보존해야 하는지 여부
• Development 데이터를 완전히 동기화할지, 아니면 누락된 구조만 채울지 여부

변경하기 전에 Development/Production 버전, 마이그레이션 상태, 스키마 차이를 비교할 수 있도록 이러한 세부 정보와 함께 지원팀에 문의하세요.

개발 데이터가 프로덕션 데이터와 다른 이유는 무엇인가요?

여러 번 게시했는데도 Production에는 여전히 이전 데이터가 표시되고 코드 업데이트는 정상적으로 작동하는 경우:

지원팀에 문의하기 전에 다음을 확인하세요.

1. 현재 프로덕션 데이터를 보존해야 하나요?

2. 현재 Development 데이터로 완전히 덮어쓰기를 원하나요, 아니면 누락된 레코드만 채우기를 원하나요?

3. 이미 백업이 있나요?

4. 허용 가능한 유지 관리 시간은 어느 정도인가요?

데이터 처리 목표가 확인되기 전까지는 프로덕션 데이터를 덮어쓰거나 다시 빌드하지 않습니다. 차이를 보여주는 Development/Production URL과 예시 레코드 ID 또는 개수를 제공하세요.