supabase-postgres-best-practices

Tổng quan

supabase-postgres-best-practices là gì?

supabase-postgres-best-practices là một kỹ năng được tuyển chọn nhằm giúp các nhà phát triển và kỹ sư cơ sở dữ liệu tối ưu hiệu suất Postgres. Được duy trì bởi Supabase, kỹ năng này cung cấp các quy tắc và ví dụ cụ thể để viết truy vấn SQL hiệu quả, thiết kế schema vững chắc, quản lý kết nối và thực hiện các phương pháp bảo mật tốt nhất. Nó bao gồm tám nhóm chủ đề quan trọng, bao gồm hiệu suất truy vấn, quản lý kết nối, bảo mật (bao gồm Row-Level Security), thiết kế schema, đồng thời, mô hình truy cập dữ liệu, giám sát và các tính năng nâng cao của Postgres.

Ai nên sử dụng kỹ năng này?

• Các nhà phát triển backend làm việc với Postgres hoặc Supabase
• Kỹ sư cơ sở dữ liệu muốn cải thiện độ tin cậy và tốc độ
• Các nhóm rà soát hoặc tái cấu trúc truy vấn SQL và schema cơ sở dữ liệu
• Bất kỳ ai cấu hình Postgres cho môi trường có độ đồng thời cao hoặc serverless

Những vấn đề kỹ năng này giải quyết

• Nhận diện và sửa các mẫu thiết kế sai phổ biến trong Postgres
• Cung cấp các ví dụ SQL cụ thể và số liệu hiệu suất
• Giúp ngăn chặn truy vấn chậm, tắc nghẽn kết nối và cấu hình bảo mật sai
• Đưa ra hướng dẫn ưu tiên cho cả cải tiến quan trọng và từng bước

Cách sử dụng

Các bước cài đặt

1. Thêm kỹ năng vào agent hoặc dự án của bạn:

   npx skills add https://github.com/supabase/agent-skills --skill supabase-postgres-best-practices
   

2. Bắt đầu với tài liệu chính:
   • Mở SKILL.md để xem tổng quan về tất cả các phương pháp và nhóm quy tắc.
   • Xem AGENTS.md để có danh sách tham khảo tổng hợp, dễ điều hướng.
3. Khám phá các chủ đề chi tiết:
   • Duyệt thư mục references/ để xem các hướng dẫn chuyên sâu về các chủ đề như tìm kiếm toàn văn, lập chỉ mục JSONB, quản lý kết nối, và tối ưu truy vấn.
   • Sử dụng file references/_sections.md để hiểu tác động và mức độ ưu tiên của từng nhóm quy tắc.
4. Điều chỉnh theo quy trình làm việc của bạn:
   • Tích hợp các quy tắc và ví dụ SQL phù hợp vào quá trình rà soát mã, di chuyển dữ liệu hoặc kiểm tra tự động.
   • Tham khảo README.md để biết hướng dẫn đóng góp và xác thực nếu bạn muốn mở rộng hoặc tùy chỉnh kỹ năng.

Các file và thư mục chính

• SKILL.md: Tập tin chính mô tả kỹ năng và tổng quan (đọc trước)
• AGENTS.md: Tài liệu tổng hợp dành cho agent
• references/: Các hướng dẫn thực hành tốt riêng lẻ (ví dụ: query-missing-indexes.md, conn-pooling.md)
• README.md: Hướng dẫn đóng góp và xác thực

Ví dụ sử dụng

• Tái cấu trúc các truy vấn chậm dựa trên quy tắc hiệu suất truy vấn
• Thiết kế bảng mới theo các phương pháp tốt nhất về schema
• Thiết lập quản lý kết nối cho ứng dụng serverless
• Thực thi Row-Level Security với các mẫu rõ ràng, có thể áp dụng

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

Khi nào tôi nên dùng supabase-postgres-best-practices?

Bạn nên sử dụng kỹ năng này khi viết, rà soát hoặc tối ưu truy vấn Postgres, thiết kế schema, cấu hình kết nối hoặc thực hiện các chính sách bảo mật. Nó đặc biệt hữu ích trong các đợt rà soát mã, di chuyển cơ sở dữ liệu và xử lý sự cố hiệu suất.

Kỹ năng này khác gì so với các hướng dẫn Postgres chung?

Kỹ năng này được Supabase tuyển chọn và ưu tiên các quy tắc cụ thể, có thể áp dụng với ví dụ SQL trước và sau, đánh giá tác động hiệu suất rõ ràng, và cấu trúc thân thiện với agent. Nó được thiết kế để sử dụng thực tế trong các dự án Postgres và Supabase.

Làm sao để tìm các phương pháp phù hợp nhất với trường hợp của tôi?

Bắt đầu với SKILL.md để xem tất cả các nhóm và mức độ ưu tiên. Với các chủ đề cụ thể, duyệt thư mục references/ hoặc tham khảo AGENTS.md để có danh sách dễ điều hướng. Mỗi tài liệu tham khảo đều có tiêu đề và thẻ rõ ràng để dễ tìm kiếm.

Tôi có thể đóng góp hoặc tùy chỉnh kỹ năng không?

Có. Hãy làm theo hướng dẫn trong references/_contributing.md và README.md để thêm các phương pháp mới hoặc điều chỉnh các phương pháp hiện có phù hợp với môi trường của bạn. Các script xác thực và xây dựng được cung cấp để đảm bảo chất lượng.

Tôi có thể xem ví dụ SQL thực tế ở đâu?

Mỗi tài liệu tham khảo trong thư mục references/ đều bao gồm các mẫu SQL sai và đúng, kèm theo giải thích và liên kết đến tài liệu chính thức khi cần.

Để xem cây thư mục đầy đủ và tất cả các tài liệu tham khảo có sẵn, hãy mở tab Files trong agent hoặc trình duyệt kho lưu trữ của bạn.