Skip to Content

Database

Hai công cụ db_query và db_exec để agent đọc và ghi database SQLite riêng của app bằng một câu SQL mỗi lần gọi; đây là dữ liệu thật của app đang chạy và không có bản sao lưu.

Database được tạo ở lần deploy đầu. Schema nằm trong các file app/**/*.table.ts. Tab Cơ sở dữ liệu trong dashboard hiện cùng dữ liệu này.

Tham số chung

  • project.
  • sql: một câu SQLite, giá trị truyền qua dấu ?. Cú pháp xem ở sqlite.org/lang.html .
  • args: giá trị cho từng dấu ?, theo thứ tự (chuỗi, số, boolean hoặc null).

db_query

Chạy một câu chỉ đọc: SELECT, WITH … SELECT, EXPLAIN hoặc PRAGMA đọc.

  • Trả về: rows, tối đa 200 dòng. Ô chữ dài hơn 2 KB bị cắt và kết quả báo cellsClipped; muốn xem thêm thì dùng LIMIT / OFFSET hoặc chọn ít cột hơn. Project chưa deploy trả danh sách trống kèm ghi chú.
  • Khi nào gọi: sau deploy, để kiểm tra một luồng đã ghi đúng dữ liệu chưa, hoặc trước một câu ghi để xem câu đó sẽ chạm những dòng nào.

db_exec

Chạy một câu ghi: INSERT, UPDATE, DELETE, REPLACE, CREATE, ALTER, DROP. Chỉ có ở bộ công cụ đầy đủ.

  • Trả về: affected_row_count, last_insert_rowid, và rows nếu câu lệnh trả dòng.
  • Khi nào gọi: sửa một vài dòng dữ liệu, chép dữ liệu khi đổi tên cột.

Mỗi lần gọi một câu. Câu đọc gửi qua db_exec bị trả NOT_A_WRITE; câu ghi gửi qua db_query bị trả READ_ONLY. Bảng nội bộ của manh.run (ft_*, sqlite_*) không ghi được.

Không đổi vai của người dùng bằng SQL. Quản trị viên đầu tiên là bạn: bạn đăng ký từ bản xem trước trong dashboard và tự thành quản trị viên. Agent thử từng vai bằng tài khoản thử, xem Kiểm thử.

db_exec không có bản sao lưu và không hoàn tác được. Trước UPDATE hay DELETE, agent đọc các dòng mà WHERE chạm tới và đếm chúng. Không bao giờ ghi mà thiếu WHERE. Xoá hay đổi tên bảng, cột đang có dữ liệu, hoặc sửa nhiều dòng một lúc, cần bạn đồng ý trước.

Ở địa chỉ /directory không có db_exec. Dữ liệu được sửa qua API của app hoặc tab Cơ sở dữ liệu.

Bước tiếp theo

  • Database: bảng, repository và schema.
  • Deploy app: schema thay đổi thế nào khi deploy.
  • Log: xem request đã làm gì với dữ liệu.
Cập nhật