Kết nối PostgreSQL

Hướng dẫn chi tiết kết nối PostgreSQL với Data Explorer, bao gồm cấu hình SSL, Docker và cách khắc phục lỗi thường gặp.

🐘Engine

PostgreSQL

Cổng mặc định

5432

Giao thức

postgresql://

Chiến lược

Pooled Adapter

Cách kết nối

Để kết nối với PostgreSQL, bạn có hai cách: sử dụng Connection URI hoặc điền vào form kết nối có cấu trúc.

Cách 1: Connection URI

Cách nhanh nhất là dán trực tiếp chuỗi URI kết nối. Data Explorer sẽ tự động phân tích host, port, username, password và database name từ URI.

Định dạng URI

# Cấu trúc chung

postgresql://admin:password@localhost:5432/mydb?sslmode=require

Cách 2: Form kết nối

Mở sidebar Connection Explorer (thanh bên trái), nhấn biểu tượng dấu cộng (+), chọn PostgreSQL. Điền các trường sau:

HostlocalhostĐịa chỉ IP hoặc hostname của server database

Port5432Cổng mặc định: 5432

UsernameadminTên đăng nhập với quyền truy cập database

Password••••••Mật khẩu (được mã hóa AES-256 trước khi lưu)

DatabasemydbTên database bạn muốn khám phá

Connection Guardrails

Mỗi kết nối có thể đi kèm với một bộ chính sách bảo vệ (Guardrails) để hạn chế rủi ro thao tác sai trên dữ liệu thật.

Read Only

Chỉ cho phép SELECT. Chặn mọi thay đổi dữ liệu.

Block Schema

Ngăn chặn các lệnh ALTER, DROP hoặc RENAME bảng.

Safe Guard

Kích hoạt bộ lọc SQL Guard chuyên sâu của backend.

Restricted IO

Cấm các thao tác Import/Export dữ liệu thô.

SSH Tunneling (Bảo mật)

Nếu database của bạn nằm sau firewall, bạn có thể sử dụng SSH Tunnel. Data Explorer hiện tích hợp SSRF Guard để chặn các kết nối tới IP nội bộ nguy hiểm thông qua tunnel.

Hỗ trợ xác thực bằng mật khẩu hoặc Private Key (OpenSSH format).
Tự động kiểm tra IP đích (SSRF Protection).
Kiểm tra sức khỏe tunnel định kỳ để duy trì kết nối.

Tính năng được hỗ trợ

Dưới đây là danh sách đầy đủ các tính năng introspection mà Data Explorer hỗ trợ cho PostgreSQL:

Phân tích lược đồ đầy đủ qua pg_catalog
Phát hiện quan hệ khóa ngoại
Phân tích index và gợi ý tối ưu
Hỗ trợ cột JSONB
Liệt kê materialized views
Phát hiện kiểu ENUM
Hỗ trợ dữ liệu không gian PostGIS

Truy vấn Introspection nội bộ

Khi bạn kết nối thành công, Data Explorer tự động chạy các truy vấn introspection để phân tích cấu trúc database. Dưới đây là truy vấn cơ bản mà hệ thống thực thi phía sau cho PostgreSQL:

PostgreSQL Introspection

# Truy vấn phân tích cấu trúc bảng

SELECT table_name, column_name, data_type, is_nullable

FROM information_schema.columns

WHERE table_schema = 'public'

ORDER BY table_name, ordinal_position;

Docker Quick Start

Nếu bạn chưa có PostgreSQL trên máy, cách nhanh nhất là dùng Docker để tạo một instance thử nghiệm:

Terminal

# Khởi tạo PostgreSQL container

docker run -d \

--name data-explorer-postgres \

-e POSTGRES_USER=admin \

-e POSTGRES_PASSWORD=secret123 \

-e POSTGRES_DB=dev_database \

-p 5432:5432 \

postgres:16-alpine

Cấu hình Nâng cao (Advanced Tuning)

Connection Pooling

Mặc định, hệ thống duy trì bộ đệm kết nối để tối ưu tốc độ phản hồi. Đối với các database có giới hạn session (như Supabase Free Tier), hãy cân nhắc giảm thời gian chờ timeout để giải phóng kết nối nhanh hơn.

SSL/TLS Handshake

Hệ thống hỗ trợ SSL Mode "prefer" và "require". Đối với các kết nối yêu cầu chứng chỉ CA tùy chỉnh, bạn cần mount file certificate vào thư mục /certs của backend server.

Ghi chú Bảo mật

Với các nhà cung cấp cloud như Neon, Supabase hoặc AWS RDS, SSL là bắt buộc. Thêm ?sslmode=require vào chuỗi kết nối hoặc bật toggle SSL trong form kết nối.

Trước đóBiến môi trường Tiếp theo MySQL

Sẵn sàng khám phá dữ liệu?

Tham gia cộng đồng trên GitHub để đóng góp cho IDE cơ sở dữ liệu địa phương thông minh nhất.

Mở Ứng dụng