Giới thiệu

Nếu bạn đang tìm kiếm một giao diện nhẹ để khám phá dữ liệu Cloudflare D1 mà không cần sử dụng các công cụ quản trị nặng nề hoặc viết mã thủ công mỗi lần, thì dự án này chính là dành cho bạn. Đây là một UI sử dụng Express và JavaScript thuần túy, kết nối với API Cloudflare v4 và chỉ cho phép thực hiện các truy vấn đọc để đảm bảo an toàn.

Tại sao lại chọn cách tiếp cận này?

• Không cần framework phía client hay bước xây dựng: Dễ dàng chạy và điều chỉnh.
• Đọc chỉ theo thiết kế: Chỉ cho phép các câu lệnh SELECT/WITH đơn.
• Trải nghiệm người dùng chuyên nghiệp: Bố cục phản hồi, danh sách bảng bên, kết quả có thể sắp xếp, và chế độ sáng/tối.
• Trạng thái chia sẻ: Giao diện đồng bộ với tham số URL để bạn có thể làm mới hoặc gửi liên kết đến chế độ xem chính xác.

Những điểm nổi bật

• Danh sách bảng bên với chức năng tìm kiếm (không bao gồm các bảng nội bộ/bảng có dấu gạch dưới như _cf_*).
• Bảng duyệt để chọn cột, thêm bộ lọc, thiết lập sắp xếp/giới hạn/bỏ qua.
• Nhấp vào bất kỳ tiêu đề nào để chuyển đổi giữa sắp xếp ASC/DESC.
• Trình soạn thảo SQL cho các truy vấn đơn tùy chỉnh.
• Cửa sổ cài đặt để quản lý thông tin xác thực .env từ giao diện.
• Chuyển đổi chế độ sáng/tối với khả năng lưu trữ.

Hướng dẫn bắt đầu

Bước 1: Clone repository và cài đặt các phụ thuộc

git clone https://github.com/mohamedrayenbouzaabia-axelites/cloudflare_d1_interface.git
npm install

Bước 2: Chạy ứng dụng

npm run dev   # nodemon
# hoặc
npm start

Bước 3: Mở trình duyệt tại http://localhost:3000 và thiết lập thông tin xác thực Cloudflare trong bảng Cài đặt (nó sẽ tự động viết tệp .env cho bạn).

Cấu hình

Tệp .env hỗ trợ:

• CF_ACCOUNT_ID
• CF_D1_DATABASE_ID
• CF_API_TOKEN (Chỉ cần quyền truy cập dữ liệu D1)
• CF_API_BASE (tùy chọn)

Bảo mật

• Máy chủ sẽ loại bỏ các nhận xét, từ chối các câu lệnh SQL nhiều dòng và chỉ chấp nhận các truy vấn SELECT/WITH đơn.
• Các token không bao giờ rời khỏi máy chủ.

Cách thức hoạt động

• Express phục vụ /public và cung cấp các API:
  • POST /api/query (bảo vệ đọc chỉ)
  • GET /api/tables, GET /api/columns?table=...
  • GET/POST /api/env-config để quản lý .env
• Giao diện sử dụng JavaScript thuần túy và đồng bộ hầu hết trạng thái vào các tham số URL.

Những gì tiếp theo?

• Xuất CSV
• Điều hướng và phím tắt bằng bàn phím
• Lưu trạng thái xem

Nếu bạn muốn thử nghiệm hoặc đóng góp, hãy lấy repository và cho tôi biết điều gì sẽ làm cho nó hữu ích hơn cho nhóm của bạn!

Thực hành tốt nhất

• Thực hiện các truy vấn đơn giản: Đảm bảo rằng bạn chỉ sử dụng các câu lệnh SQL đơn giản để không vi phạm quy tắc bảo mật.
• Kiểm tra kết quả: Luôn kiểm tra kết quả truy vấn để xác minh rằng dữ liệu bạn nhận được là chính xác và đáng tin cậy.

Những cạm bẫy phổ biến

• Sử dụng câu lệnh SQL phức tạp: Tránh sử dụng các câu lệnh SQL phức tạp có thể dẫn đến lỗi hoặc vi phạm bảo mật.
• Bỏ qua thông tin xác thực: Đảm bảo rằng bạn đã cấu hình chính xác thông tin xác thực trong tệp .env để tránh lỗi kết nối.

Mẹo tối ưu hóa hiệu suất

• Giảm thiểu số lượng truy vấn: Cố gắng sử dụng các truy vấn có thể lấy được nhiều dữ liệu trong một lần thay vì thực hiện nhiều truy vấn nhỏ.
• Sử dụng bộ nhớ cache: Xem xét việc sử dụng bộ nhớ cache cho các truy vấn thường xuyên để cải thiện tốc độ truy xuất dữ liệu.

Khắc phục sự cố

• Máy chủ không phản hồi: Kiểm tra xem máy chủ có đang chạy không và đã được cấu hình chính xác chưa.
• Lỗi truy vấn SQL: Đảm bảo rằng bạn chỉ sử dụng các câu lệnh đơn giản và kiểm tra cú pháp để tránh lỗi.

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

• Làm thế nào để cài đặt ứng dụng?
  • Bạn chỉ cần làm theo các bước hướng dẫn trong phần Hướng dẫn bắt đầu.
• Có cần kiến thức lập trình để sử dụng không?
  • Không, giao diện này được thiết kế để dễ sử dụng cho mọi người.

Tài nguyên và đọc thêm

• Tài liệu chính thức của Cloudflare API
• Hướng dẫn về Express.js
• Hướng dẫn JavaScript cơ bản