Sử dụng extension được hỗ trợ trên FPT PostgreSQL
Với các PostgreSQL Extension được tích hợp sẵn, FPT Database Engine giúp bạn mở rộng khả năng của database để đáp ứng đa dạng nhu cầu vận hành và xử lý dữ liệu, từ lập lịch tác vụ, kiểm toán, đồng bộ dữ liệu đến tìm kiếm vector và xử lý dữ liệu không gian. Các extension được cài đặt sẵn ở cấp Database Engine, bạn chủ động kích hoạt extension cần dùng bằng câu lệnh SQL.
Phạm vi áp dụng
- Các PostgreSQL cluster được tạo từ ngày 20/11/2026 trở đi được cài đặt sẵn các extension theo danh sách hỗ trợ.
- Các PostgreSQL cluster được tạo trước ngày 20/11/2026 không thuộc phạm vi cài đặt sẵn extension. Nếu cần sử dụng các extension này trên cluster cũ, hãy liên hệ FPT Support để được kiểm tra và tư vấn phương án phù hợp.
- Extension được cài đặt sẵn không đồng nghĩa đã được kích hoạt. Bạn vẫn cần thực hiện
CREATE EXTENSIONtrong database muốn sử dụng.
Danh sách extension được hỗ trợ
| Extension | Mô tả | PostgreSQL 17 | PostgreSQL 16 | PostgreSQL 15 | PostgreSQL 14 |
|---|---|---|---|---|---|
pg_cron | Job scheduler cho phép lập lịch và thực thi các câu lệnh SQL định kỳ trong PostgreSQL. | 1.6.8 | 1.6.8 | 1.6.8 | 1.6.8 |
pg_partman | Quản lý partition theo thời gian hoặc ID, hỗ trợ tự động hóa việc tạo và duy trì partition. | 5.5.0 | 5.5.0 | 5.5.0 | 5.5.0 |
pg_partman_bgw | Background worker hỗ trợ thực thi tác vụ quản lý partition tự động của pg_partman. | 5.5.0 | 5.5.0 | 5.5.0 | 5.5.0 |
pgaudit | Ghi nhận hoạt động truy cập và thao tác trên database phục vụ audit và compliance. | 17.1 | 16.1 | 1.7.1 | 1.6.3 |
pglogical | Hỗ trợ logical replication giữa các PostgreSQL database. | 2.4.8 | 2.4.8 | 2.4.8 | 2.4.8 |
pgvector (vector) | Lưu trữ vector và hỗ trợ truy vấn similarity search, phục vụ các ứng dụng AI/RAG. | 0.8.7 | 0.8.7 | 0.8.7 | 0.8.7 |
PostGIS (postgis) | Mở rộng PostgreSQL để lưu trữ, xử lý và truy vấn dữ liệu địa lý (spatial data). | 3.6.4 | 3.6.4 | 3.6.4 | 3.6.4 |
postgis_raster | Hỗ trợ lưu trữ và xử lý dữ liệu raster trong hệ thống GIS. | 3.6.4 | 3.6.4 | 3.6.4 | 3.6.4 |
postgis_tiger_geocoder | Hỗ trợ geocoding và reverse geocoding dựa trên dữ liệu TIGER của Mỹ. | 3.6.4 | 3.6.4 | 3.6.4 | 3.6.4 |
postgis_topology | Hỗ trợ quản lý và xử lý topology của dữ liệu không gian. | 3.6.4 | 3.6.4 | 3.6.4 | 3.6.4 |
pgrouting | Bổ sung chức năng tính toán tuyến đường và phân tích mạng lưới địa lý trên dữ liệu PostGIS. | 4.0.2 | 4.0.2 | 4.0.2 | 4.0.2 |
Tên viết dạng code là tên dùng trong lệnh CREATE EXTENSION. Với pgvector, tên là vector, không phải pgvector.
Yêu cầu trước khi bắt đầu
- PostgreSQL cluster được tạo từ ngày 20/11/2026 trở đi.
- Kết nối đến database cần sử dụng extension qua
psql, pgAdmin hoặc PostgreSQL client tương thích. Xem Kết nối tới database qua Floating IP. - Tài khoản kết nối database đã được cấp quyền tạo extension.
- Extension nằm trong danh sách hỗ trợ của phiên bản PostgreSQL đang sử dụng.
Kiểm tra extension có thể sử dụng
Chạy truy vấn sau trong database cần dùng. Các extension được hỗ trợ hiển thị kèm default_version. Nếu cột installed_version có giá trị, extension đã được kích hoạt trong database này.
SELECT name, default_version, installed_version, comment
FROM pg_available_extensions
ORDER BY name;
Kích hoạt extension
Thay EXTENSION_NAME bằng tên extension trong danh sách hỗ trợ.
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
Ví dụ kích hoạt pgvector và PostGIS:
CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION IF NOT EXISTS postgis;
Một số extension cần kích hoạt extension khác hoặc cấu hình parameter trước. Xem Extension có dependency trước khi kích hoạt.
Kiểm tra extension đã kích hoạt
SELECT extname, extversion
FROM pg_extension
ORDER BY extname;
Hoặc dùng lệnh \dx trong psql.
Extension chỉ được kích hoạt trong database hiện tại. Nếu muốn sử dụng ở database khác, bạn cần kết nối vào database đó và chạy lại CREATE EXTENSION.
Gỡ bỏ extension
Khi không còn nhu cầu sử dụng, bạn có thể gỡ bỏ extension bằng lệnh:
DROP EXTENSION IF EXISTS EXTENSION_NAME;
Việc gỡ bỏ extension có thể ảnh hưởng đến các đối tượng database phụ thuộc, ví dụ cột kiểu vector hoặc geometry. Kiểm tra dependency trước khi chạy DROP EXTENSION.
Extension có dependency
Một số extension phụ thuộc vào extension khác hoặc parameter của engine. Bạn cần kích hoạt extension phụ thuộc hoặc cấu hình parameter phù hợp trước khi kích hoạt extension cần sử dụng.
| Extension | Dependency | Lưu ý |
|---|---|---|
pg_partman_bgw | pg_partman | pg_partman_bgw là background worker của pg_partman, không phải một extension SQL độc lập. Chỉ cần chạy CREATE EXTENSION pg_partman là có thể sử dụng, không cần CREATE EXTENSION riêng. |
pglogical | Parameter wal_level = logical | Điều chỉnh wal_level trong tab Parameters, xem Cấu hình parameter. Thay đổi này yêu cầu PostgreSQL restart để áp dụng, nên thực hiện vào giờ thấp điểm để hạn chế ảnh hưởng. |
postgis_raster, postgis_tiger_geocoder, postgis_topology, pgrouting | postgis | Kích hoạt PostGIS trước, sau đó mới kích hoạt các extension phụ thuộc PostGIS. |
Xử lý lỗi thường gặp
| Tình huống | Nguyên nhân có thể | Hướng xử lý |
|---|---|---|
Extension không xuất hiện trong pg_available_extensions | Cluster được tạo trước ngày 20/11/2026, hoặc extension không hỗ trợ phiên bản PostgreSQL đang sử dụng | Kiểm tra ngày tạo và phiên bản cluster, sau đó liên hệ FPT Support |
permission denied to create extension | Tài khoản không có quyền tạo extension | Kiểm tra quyền database của tài khoản đang kết nối |
must be loaded via shared_preload_libraries | Extension yêu cầu cấu hình ở cấp Database Engine | Liên hệ FPT Support để kiểm tra cấu hình |
extension already exists | Extension đã được kích hoạt trong database | Kiểm tra bằng truy vấn trong Kiểm tra extension đã kích hoạt |
Bước tiếp theo
- Cấu hình parameter để đặt
wal_level = logicaltrước khi dùngpglogical - Tổng quan Backup & Restore để có bản backup trước khi gỡ extension mà dữ liệu đang phụ thuộc