Cơ sở dữ liệu
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 dựa 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, cũng như 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.
- Mở dự án của bạn trên thiết bị desktop.
- Trong thanh công cụ của cùng không gian làm việc nơi có Trình xem App, hãy chọn Atoms Cloud.
- Chọn Cơ sở dữ liệu trong thanh bên của Atoms Cloud.
- Trong mục Databases, hãy chọn cơ sở dữ liệu mà 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 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
- 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.
- Sử dụng Search tables để tìm một bảng, hoặc chọn trực tiếp một bảng 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.
- Sử 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.
- Sử 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.
- Để kiểm tra cấu trúc của bảng, hãy 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 mà mình muốn thay đổi, bạn có thể dùng các thao tác sau để thực hiện:
| Operation | How to do it |
|---|---|
| Add a row | 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. |
| Edit a row | 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. |
| Delete rows | 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 lưu hoặc hủy chúng trước khi thêm một hàng, nhập hoặc xuất tệp CSV, thay đổi tìm kiếm hoặc bộ lọc, hoặc điều hướng 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 các hàng trong những 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 đó lưu hoặc hủy thay đổi.
Tạo bảng hoặc thay đổi schema
Mở môi trường cơ sở dữ liệu mà 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:
| Operation | How to do it |
|---|---|
| Create a table | Trong danh sách bảng, nhấp vào ..., rồi 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, rồi xác minh bảng. |
| Change the schema | Nhấp vào bảng mà bạn muốn thay đổi, sau đó nhấp vào ..., rồi 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 một 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, rồi kiểm thử app của bạn sau đó. Các trường khóa chính và các bảng chỉ đọc không thể được sửa đổi theo cách này.
Nhập 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 mà bạn muốn làm việc, sau đó làm theo hướng dẫn cho thao tác tương ứng:
| Operation | How to do it |
|---|---|
| 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 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 đang có tìm kiếm hoặc bộ lọc 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. Với các bảng chỉ đọc, Export CSV là tùy chọn duy nhất khả dụng.
Quyền hạn và bảng được bảo vệ
| Action | Who can perform it | Additional requirements |
|---|---|---|
| Add, edit, or delete rows | 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. |
| Create tables or change schemas | 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. |
| Import or export CSV files | 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 của chúng 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.
Một thao tác cơ sở dữ liệu bị thiếu hoặ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 một 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 đã lưu hoặc hủy 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 chạy (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 cung cấp:
- Liên kết Chat và URL đang chạy
- Toàn bộ thông báo lỗi SQL
- 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ữ lại hay không
- 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 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 đã xuất bản 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 mã 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ữ lại 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à các ID bản ghi mẫu hoặc số lượng cho thấy sự khác biệt.