Thiết kế bảng không gian PostGIS
Tài liệu tham chiếu giúp Claude thiết kế bảng dữ liệu vị trí trên PostGIS với đúng kiểu hình học, hệ tọa độ và chỉ mục.
Lập trìnhTrung cấp★ 1,809⑂ 104Điểm AI 8/10Cập nhật lần cuối: 26 thg 6, 2026
Skill này làm gì
Cung cấp cho Claude bộ tiêu chí thiết kế bảng dữ liệu không gian trên PostgreSQL + PostGIS.
- Chọn GEOMETRY hay GEOGRAPHY: bảng so sánh về đơn vị, độ chính xác, hiệu năng, số hàm hỗ trợ
- Hệ tọa độ (SRID): khi nào dùng 4326 (WGS84), 3857 (Web Mercator), các múi UTM
- Chiến lược chỉ mục: GiST mặc định, BRIN cho bảng cực lớn chỉ ghi thêm, SP-GiST cho dữ liệu điểm
- Mẫu tối ưu hiệu năng: dùng
ST_DWithinthayST_Distance, tiền lọc bằng toán tử&&, cột GENERATED thay vì gọi hàm trên cột đã đánh chỉ mục - Kiểm tra dữ liệu: ràng buộc
ST_IsValid, kiểm tra SRID đồng nhất, giới hạn tọa độ hợp lệ - Cảnh báo thường gặp: thứ tự (kinh độ, vĩ độ), tránh trộn SRID, chống SQL injection bằng tham số hóa
Phù hợp với ai
- Lập trình viên backend xây dịch vụ giao hàng, gọi xe, bất động sản, IoT cần lưu tọa độ
- Đội đã dùng PostGIS nhưng truy vấn không ăn chỉ mục hoặc nhầm đơn vị khoảng cách
- Kỹ sư dữ liệu muốn rà soát lại schema không gian hiện có
Ví dụ sử dụng
- "Tạo bảng POI cửa hàng, truy vấn chính là tìm trong bán kính 1km" → sinh cột
GEOGRAPHY(POINT, 4326), chỉ mục GiST và câu truy vấnST_DWithinhoàn chỉnh - "Bảng thửa đất cần tự tính diện tích và tâm điểm" → gợi ý cột
GENERATED ALWAYS AS (...) STOREDcùng ràng buộc kiểm tra tính hợp lệ hình học - "Log GPS xe 100 triệu dòng, truy vấn chậm" → đề xuất chỉ mục kép (device_id, thời gian), lý do chọn GiST hay BRIN, và cách dựng lộ trình bằng
ST_MakeLine
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/design-postgis-tables từ repo GitHub timescale/pg-aiguide vào ~/.claude/skills/design-postgis-tables/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/timescale/pg-aiguide.git && mkdir -p ~/.claude/skills && cp -r pg-aiguide/skills/design-postgis-tables ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở Terminal.
- Tải kho chứa skill:
git clone https://github.com/timescale/pg-aiguide.git - Tạo thư mục skill nếu chưa có:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r pg-aiguide/skills/design-postgis-tables ~/.claude/skills/ - Khởi động lại Claude Code và gõ
/skillsđể kiểm tra skill đã xuất hiện. - Chuẩn bị cơ sở dữ liệu: cần PostgreSQL 15 trở lên, chạy
CREATE EXTENSION IF NOT EXISTS postgis; - Thử yêu cầu: "Thiết kế bảng lưu vị trí cửa hàng bằng PostGIS".
Xem mã nguồn trên GitHub ↗Giấy phép: Apache-2.0