Cơ sở dữ liệu Atoms Cloud lưu trữ và quản lý dữ liệu có cấu trúc mà app của bạn phụ thuộc vào, bao gồm sản phẩm, lượt đặt chỗ, đơn hàng, nội dung gửi qua biểu mẫu và nội dung do người dùng tạo. Trong mô-đun Cơ sở dữ liệu, bạn có thể xem các môi trường và bảng, tìm kiếm và chỉnh sửa bản ghi, kiểm tra cấu trúc bảng, đồng thời nhập hoặc xuất dữ liệu bằng tệp CSV.

Hướng dẫn này đề cập đến cơ sở dữ liệu được tích hợp sẵn trong Atoms Cloud. Nếu dự án của bạn sử dụng Supabase, hãy xem Kết nối Supabase thay thế.

Mở cơ sở dữ liệu

Trước khi mở cơ sở dữ liệu, hãy kết nối dự án của bạn với Atoms Cloud. Nếu chưa được kết nối, hãy làm theo các bước kết nối trong Atoms Cloud.

1. Mở dự án của bạn trên thiết bị desktop.
2. Trong cùng thanh công cụ của không gian làm việc nơi có Trình xem App , hãy chọn Atoms Cloud.
3. Chọn Cơ sở dữ liệu trong thanh bên của Atoms Cloud.
4. Trong mục Databases, chọn cơ sở dữ liệu bạn muốn kiểm tra. Các thẻ cơ sở dữ liệu Development và Production sẽ xuất hiện khi chúng khả dụng cho dự án.

Mỗi thẻ cơ sở dữ liệu hiển thị dung lượng lưu trữ đang được sử dụng và tổng dung lượng khả dụng. Hãy dùng Development trong khi xây dựng và kiểm thử app của bạn. Các thay đổi được thực hiện trong Production có thể ảnh hưởng đến dữ liệu của app đang hoạt động, vì vậy hãy luôn kiểm tra bạn đang ở môi trường nào trước khi thực hiện thay đổi.

Chọn cơ sở dữ liệu Development hoặc Production.

Duyệt và lọc dữ liệu bảng

1. Chọn thẻ cơ sở dữ liệu Development hoặc Production, tùy theo môi trường bạn muốn làm việc.
2. Dùng Search tables để tìm một bảng hoặc chọn trực tiếp từ danh sách. Mỗi thẻ bảng hiển thị số hàng và liệu bảng đó có ở chế độ chỉ đọc hay không.
3. Dùng Search rows để tìm kiếm trong bảng hiện tại hoặc chọn Filter để thu hẹp kết quả bằng một hoặc nhiều trường.
4. Dùng các nút mũi tên phân trang bên dưới bảng để xem thêm các hàng.
5. Để kiểm tra cấu trúc của bảng, mở menu ••• và chọn Schema.

Chế độ xem Schema hiển thị tên, kiểu dữ liệu, trạng thái khóa, yêu cầu, ràng buộc và giá trị mặc định của từng trường. Chọn Copy để sao chép schema đang hiển thị.

Thêm, chỉnh sửa hoặc xóa hàng

Khi bạn đã tìm thấy cơ sở dữ liệu muốn thay đổi, bạn có thể dùng các thao tác sau để thực hiện:

Thao tác	Cách thực hiện
Thêm một hàng	Mở ... và chọn Add Row. Nhập các giá trị khớp với những trường hiện có, sau đó gửi hàng đó.
Chỉnh sửa một hàng	Nhấp đúp vào một ô và nhập giá trị mới. Chọn Commit Changes để lưu tất cả chỉnh sửa đang chờ hoặc Discard để loại bỏ chúng.
Xóa hàng	Chọn một hoặc nhiều hàng, chọn Delete, rồi xác nhận. Việc xóa hàng không thể hoàn tác.

Việc thêm một hàng hoặc xác nhận xóa sẽ áp dụng thay đổi ngay lập tức vào cơ sở dữ liệu đã chọn. Chỉ các chỉnh sửa ô nội tuyến mới yêu cầu bạn chọn Commit Changes hoặc Discard. Nếu bạn có bất kỳ chỉnh sửa nào đang chờ, hãy commit hoặc discard chúng trước khi thêm hàng, nhập hoặc xuất tệp CSV, thay đổi tìm kiếm hoặc bộ lọc, hoặc chuyển sang trang khác.

Nếu dự án nằm trong một không gian làm việc, chỉ Editors và workspace owner mới có thể chỉnh sửa hàng trong các bảng có thể ghi. Nếu Atoms không thể phát hiện khóa chính cho một bảng, bạn sẽ không thể chỉnh sửa hoặc xóa các hàng của bảng đó vì Atoms không thể xác định đáng tin cậy từng bản ghi riêng lẻ.

Xem lại một chỉnh sửa hàng đang chờ, sau đó commit hoặc discard thay đổi.

Tạo bảng hoặc thay đổi schema

Mở môi trường cơ sở dữ liệu bạn muốn cập nhật, sau đó làm theo hướng dẫn cho thay đổi bạn muốn thực hiện:

Thao tác	Cách thực hiện
Tạo một bảng	Trong danh sách bảng, nhấp vào ... và chọn Create table. Nhập tên bảng hợp lệ và các trường ban đầu, sau đó gửi yêu cầu. Chờ Agent hoàn tất, mở lại Cơ sở dữ liệu và xác minh bảng.
Thay đổi schema	Nhấp vào bảng bạn muốn thay đổi, sau đó nhấp vào ... và chọn Schema. Dùng Add Field để tạo một trường hoặc chọn một trường đủ điều kiện để chỉnh sửa. Bạn có thể thay đổi tên, kiểu, giá trị mặc định, trạng thái bắt buộc hoặc tính duy nhất của trường đó. Bạn cũng có thể đánh dấu các trường không phải khóa để xóa. Chọn Submit Changes để gửi yêu cầu đến Agent hoặc Discard để xóa các thay đổi đang chờ.

Chỉ workspace owner mới có thể tạo bảng hoặc thay đổi schema của bảng.

Việc gửi yêu cầu schema không có nghĩa là quá trình migration đã hoàn tất. Hãy chờ Agent hoàn tất, xác minh kết quả trong Cơ sở dữ liệu và kiểm thử app của bạn sau đó. Các trường khóa chính và bảng chỉ đọc không thể được sửa đổi theo cách này.

Nhập thông tin chi tiết của trường mới trong Add Field.

Xem lại các thay đổi schema đang chờ trước khi chọn Submit Changes.

Nhập hoặc xuất dữ liệu CSV

Chọn bảng bạn muốn làm việc, sau đó làm theo hướng dẫn cho thao tác tương ứng:

Thao tác	Cách thực hiện
Import CSV	Nhấp vào ... và chọn Import CSV. Chọn một tệp .csv không lớn hơn 10 MB, sau đó xem lại tên tệp, số hàng ước tính, bảng đã chọn và môi trường trước khi xác nhận. Các cột trong CSV phải khớp với schema của bảng. Các hàng được nhập sẽ được thêm ngay lập tức và không thể tự động hoàn tác, vì vậy hãy cân nhắc xuất dữ liệu hiện có trước.
Export CSV	Nhấp vào ... và chọn Export CSV. Nếu một tìm kiếm hoặc bộ lọc đang hoạt động, chỉ các hàng khớp mới được xuất. Nếu không, toàn bộ dữ liệu từ bảng hiện tại sẽ được xuất.

Chỉ workspace owner mới có thể nhập hoặc xuất tệp CSV. Đối với các bảng chỉ đọc, Export CSV là tùy chọn duy nhất khả dụng.

Quyền và bảng được bảo vệ

Hành động	Ai có thể thực hiện	Yêu cầu bổ sung
Thêm, chỉnh sửa hoặc xóa hàng	Editor hoặc workspace owner	Bảng phải có thể ghi. Việc chỉnh sửa và xóa hàng cũng yêu cầu thông tin khóa chính.
Tạo bảng hoặc thay đổi schema	Không gian làm việc owner	Các trường khóa chính và bảng chỉ đọc không thể được sửa đổi.
Nhập hoặc xuất tệp CSV	Không gian làm việc owner	Không thể nhập tệp CSV vào các bảng chỉ đọc.

Các bảng hệ thống hoặc bảng người dùng được bảo vệ có thể hiển thị huy hiệu Read-only. Bạn có thể xem dữ liệu của chúng và kiểm tra schema khi khả dụng, nhưng bạn không thể sửa đổi các hàng hoặc cấu trúc của chúng từ trang này.

Khắc phục các sự cố cơ sở dữ liệu thường gặp

“No databases found” hoặc “No tables found”

Hãy đảm bảo Atoms Cloud đã được kết nối với dự án. Nếu đã được kết nối, hãy xác nhận rằng app của bạn có một tính năng lưu trữ dữ liệu bền vững. Nếu cần, hãy yêu cầu Agent thêm tính năng được hỗ trợ bởi cơ sở dữ liệu. Sau khi Agent hoàn tất, hãy mở lại Cơ sở dữ liệu hoặc chọn Refresh.

Thiếu thao tác cơ sở dữ liệu hoặc thao tác không khả dụng

Kiểm tra xem bảng có huy hiệu Read-only hay không, sau đó xem lại các quyền ở trên để xác nhận rằng vai trò của bạn trong không gian làm việc cho phép thao tác đó. Việc chỉnh sửa và xóa hàng cũng yêu cầu thông tin khóa chính.

Các chỉnh sửa hàng đang chờ có thể ngăn các thao tác khác. Hãy chọn Commit Changes hoặc Discard trước khi thêm hàng, nhập hoặc xuất tệp CSV, thay đổi tìm kiếm hoặc bộ lọc, hoặc chuyển sang trang khác.

Nếu thao tác vẫn không khả dụng sau các bước kiểm tra này, hãy liên hệ Support và bao gồm liên kết dự án hoặc Chat, môi trường, bảng, vai trò trong không gian làm việc, thao tác đã thử và nội dung lỗi chính xác.

Không thể nhập tệp CSV

Chỉ workspace owner mới có thể nhập dữ liệu và bảng đích phải có thể ghi. Hãy đảm bảo rằng:

• Tệp sử dụng định dạng .csv.
• Tệp không lớn hơn 10 MB.
• Các cột và dữ liệu của tệp tương thích với schema của bảng đích.
• Bạn đã commit hoặc discard mọi chỉnh sửa hàng đang chờ.

Nếu việc nhập vẫn thất bại, hãy liên hệ Support và bao gồm liên kết dự án hoặc Chat, môi trường, bảng đích, vai trò trong không gian làm việc, tên và kích thước tệp, thao tác đã thử và nội dung lỗi chính xác.

Câu hỏi thường gặp

Cơ sở dữ liệu production của tôi không đồng bộ. Tôi nên làm gì?

Nếu Development hoạt động bình thường nhưng trang web đang hoạt động (Production) hiển thị thiếu bảng, cột hoặc lỗi migration:

Quan trọng: Không tự ý xây dựng lại hoặc ghi đè cơ sở dữ liệu production.

Thông tin cần thiết:

• Liên kết Chat và URL đang hoạt động
• Thông báo lỗi SQL đầy đủ
• Tên bảng/cột bị thiếu
• Lần thay đổi schema cơ sở dữ liệu gần nhất
• Phiên bản live gần nhất hoạt động bình thường
• Liệu dữ liệu production có cần được giữ nguyên hay không
• Liệu bạn muốn đồng bộ hoàn toàn dữ liệu Development hay chỉ bổ sung các cấu trúc còn thiếu

Hãy liên hệ bộ phận hỗ trợ với các thông tin này để chúng tôi có thể so sánh các phiên bản Development/Production, trạng thái migration và khác biệt về schema trước khi thực hiện thay đổi.

Tại sao dữ liệu development của tôi khác với dữ liệu production?

Nếu bạn đã publish nhiều lần nhưng Production vẫn hiển thị dữ liệu cũ trong khi các bản cập nhật code vẫn hoạt động bình thường:

Trước khi liên hệ bộ phận hỗ trợ, hãy xác nhận:

1. Dữ liệu production hiện tại có cần được giữ nguyên không?

2. Bạn muốn ghi đè hoàn toàn bằng dữ liệu Development hiện tại hay chỉ bổ sung các bản ghi còn thiếu?

3. Bạn đã có bản sao lưu chưa?

4. Khoảng thời gian bảo trì mà bạn có thể chấp nhận là bao lâu?

Chúng tôi sẽ không ghi đè hoặc xây dựng lại dữ liệu production cho đến khi mục tiêu xử lý dữ liệu được xác nhận. Hãy cung cấp các URL Development/Production và ví dụ về ID bản ghi hoặc số lượng cho thấy sự khác biệt.