Connector PostgreSQL
1. Tổng quan
- Định nghĩa: Bài viết cung cấp các thông số mạng (Network) và quy tắc giới hạn giá trị biên (Validation rules) bắt buộc để hệ thống Mobio có thể kết nối với Database PostgreSQL.
- Đối tượng sử dụng: Quản trị viên hệ thống (Admin), Kỹ sư dữ liệu (Data Engineer).
2. Giải thích Thuật ngữ & Thông số
- PostgreSQL: Một hệ quản trị CSDL quan hệ đa nền tảng.
- Port tiêu chuẩn: 5432.
3. Điều kiện tiên quyết (Prerequisite)
- Bài viết trước: Khởi tạo Connector: Dạng Database
- Phân quyền kết nối mạng: Server DB của doanh nghiệp phải cấu hình Inbound Rules cho phép hệ thống Mobio truy cập.
4. Các bước cấu hình & Giới hạn giá trị nhập
Dưới đây là các ràng buộc tối thiểu bạn phải tuân thủ để giao diện cho phép “Lưu” kết nối:
- Tên Database (Database Name):
- Giới hạn: Tối đa 63 ký tự.
- KHÔNG được chứa khoảng trắng.
- Lưu ý phân biệt chữ Hoa/Thường (Case-sensitive): Nhập chính xác tên DB. Mặc dù hệ thống PostgreSQL sẽ nhận dạng là chữ thường nếu không có ngoặc kép, nhưng quá trình kết nối của Mobio bắt buộc phải có độ chính xác tuyệt đối. (Ví dụ: DB trên server là db01 nhưng bạn nhập DB01 → kết nối thất bại.)
- Máy chủ (Hostname/IP):
- Giới hạn: Max 253 ký tự. Chấp nhận IPv4 (Ví dụ: 127.0.0.1) hoặc FQDN (Domain name). Chưa hỗ trợ IPv6.
- Quy tắc: Loại bỏ tiền tố
http://hoặc dấu gạch chéo/ở cuối. Tuyệt đối KHÔNG có khoảng trắng ở hai đầu (Hệ thống Mobio bắt buộc Trim).
- Cổng kết nối (Port):
- Chỉ chấp nhận số nguyên dương (1 – 65535). Port mặc định thường dùng là
5432. Cấm nhập bất kỳ dấu chấm thập phân hay ký tự nào khác.
- Chỉ chấp nhận số nguyên dương (1 – 65535). Port mặc định thường dùng là
- Tên đăng nhập (Username):
- Giới hạn: Tối đa 63 ký tự.
- Hệ thống Mobio CHẤP NHẬN khoảng trắng trong username. Hệ thống KHÔNG tự động xóa khoảng trắng do thao tác nhầm của bạn, nên hãy cực kỳ cẩn thận. (Nếu chuỗi có khoảng trắng theo chuẩn DB yêu cầu phải đặt trong ngoặc kép ” ” thì bạn phải điền chính xác.)
- Mật khẩu (Password):
- Giới hạn: Không giới hạn. Tuyệt đối KHÔNG chứa các ký tự điều khiển như
\0, \n, \r, \t. Cấm các ký tự phá vỡ câu lệnh như',",;,--,/*. - Hệ thống Mobio CHẤP NHẬN khoảng trắng (không tự động trim).
- Giới hạn: Không giới hạn. Tuyệt đối KHÔNG chứa các ký tự điều khiển như
5. Quy tắc bảo mật
- Phòng chống SQL Injection: Không thiết lập Mật khẩu hoặc User chứa ký hiệu comment (
/* */hoặc--) hay ngoặc kép để đề phòng lỗi Driver của Mobio.
6. Các câu hỏi thường gặp (FAQ)
- Hỏi: Nếu chứng thực hệ thống của tôi là Trust authentication thì sao
- Trả lời: Ở chế độ Trust, bạn có thể không cần cung cấp password khai báo cho Mobio. Mật khẩu lưu thành công sẽ hiển thị chuỗi 15 ký tự
*****.
- Trả lời: Ở chế độ Trust, bạn có thể không cần cung cấp password khai báo cho Mobio. Mật khẩu lưu thành công sẽ hiển thị chuỗi 15 ký tự
7. Bước tiếp theo
Quay lại bài tổng quan Khởi tạo Connector: Dạng Database