Chuyển tới nội dung chính

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 EXTENSION trong database muốn sử dụng.

Danh sách extension được hỗ trợ​

ExtensionMô tảPostgreSQL 17PostgreSQL 16PostgreSQL 15PostgreSQL 14
pg_cronJob 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.81.6.81.6.81.6.8
pg_partmanQuả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.05.5.05.5.05.5.0
pg_partman_bgwBackground worker hỗ trợ thực thi tác vụ quản lý partition tự động của pg_partman.5.5.05.5.05.5.05.5.0
pgauditGhi nhận hoạt động truy cập và thao tác trên database phục vụ audit và compliance.17.116.11.7.11.6.3
pglogicalHỗ trợ logical replication giữa các PostgreSQL database.2.4.82.4.82.4.82.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.70.8.70.8.70.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.43.6.43.6.43.6.4
postgis_rasterHỗ trợ lưu trữ và xử lý dữ liệu raster trong hệ thống GIS.3.6.43.6.43.6.43.6.4
postgis_tiger_geocoderHỗ trợ geocoding và reverse geocoding dựa trên dữ liệu TIGER của Mỹ.3.6.43.6.43.6.43.6.4
postgis_topologyHỗ trợ quản lý và xử lý topology của dữ liệu không gian.3.6.43.6.43.6.43.6.4
pgroutingBổ 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.24.0.24.0.24.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.

ghi chú

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;
cảnh báo

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.

ExtensionDependencyLưu ý
pg_partman_bgwpg_partmanpg_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.
pglogicalParameter 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, pgroutingpostgisKí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ốngNguyên nhân có thểHướng xử lý
Extension không xuất hiện trong pg_available_extensionsCluster đượ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ụngKiểm tra ngày tạo và phiên bản cluster, sau đó liên hệ FPT Support
permission denied to create extensionTài khoản không có quyền tạo extensionKiểm tra quyền database của tài khoản đang kết nối
must be loaded via shared_preload_librariesExtension yêu cầu cấu hình ở cấp Database EngineLiên hệ FPT Support để kiểm tra cấu hình
extension already existsExtension đã được kích hoạt trong databaseKiểm tra bằng truy vấn trong Kiểm tra extension đã kích hoạt

Bước tiếp theo​

Tài liệu tham khảo​