Cài đặt PostgreSQL: hướng dẫn từng bước cho Windows, macOS, Linux

Giới thiệu

Hy vọng là bạn đã thích SQL và sẵn sàng chiến đấu nghiêm túc. Đã đến lúc tìm hiểu PostgreSQL là gì và cài nó lên máy tính của bạn. Làm vậy bạn sẽ hiểu rõ hơn về mọi ngóc ngách khi làm việc với PostgreSQL, phát hiện ra đủ thứ bất ngờ và chắc chắn sẽ vấp phải vài lỗi đau đầu. Đó là con đường phải đi thôi 😎

Hệ quản trị cơ sở dữ liệu PostgreSQL (thường gọi tắt là Postgres) — là một hệ quản trị cơ sở dữ liệu quan hệ mã nguồn mở cực mạnh, mở rộng tốt và siêu ổn định. Nó xuất hiện từ rất lâu rồi, năm 1986, như một dự án nghiên cứu của Đại học California ở Berkeley. Và suốt mấy chục năm qua, PostgreSQL vẫn làm devs mê mẩn vì độ tin cậy, linh hoạt và nhiều tính năng bá đạo 🥰

Dưới đây là vài lý do tại sao PostgreSQL được devs và các công ty trên toàn thế giới yêu thích:

• Hỗ trợ ACID: PostgreSQL tuân thủ các nguyên tắc atomicity, consistency, isolation và durability (ACID), nên nó không thể thiếu khi làm việc với dữ liệu quan trọng.
• Có thể mở rộng: bạn có thể thêm function, kiểu dữ liệu và thậm chí cả index của riêng mình.
• JSONB: hỗ trợ sẵn làm việc với JSON, cực kỳ tiện cho các web app hiện đại.
• Mã nguồn mở: được cộng đồng và nhiều tổ chức hỗ trợ nhiệt tình. Không có phí ẩn hay license gì cả.
• Khả năng mở rộng: PostgreSQL phù hợp từ dự án nhỏ đến hệ thống doanh nghiệp khổng lồ.

Khác với MySQL, PostgreSQL luôn bắt kịp thời đại. Nó tích hợp nhiều tính năng hay ho của NoSQL, nhưng vẫn giữ được mọi ưu điểm của database quan hệ. Và quan trọng là nó miễn phí, bạn chắc chắn sẽ thích nó luôn ❤️

Cài đặt PostgreSQL

Nếu cài PostgreSQL không đúng cách thì sẽ gặp đủ thứ rắc rối: server không khởi động, client không kết nối được, và thay vì tạo database, bạn lại phải Google kiểu như “Tại sao PostgreSQL không chạy trên Linux?” Làm theo hướng dẫn từng bước của mình, bạn sẽ tránh được mấy vụ này và bước vào thế giới PostgreSQL-expert không lo nghĩ.

Cài đặt PostgreSQL trên Windows

1. Tải file cài đặt

   • Vào trang chính thức của PostgreSQL.
   • Chọn nền tảng Windows. Click vào link "Download the installer certified by EDB" để tải về.
   • Tải bản PostgreSQL mới nhất (ở đây là version 17.5)

2. Chạy file cài đặt

   • Chạy file .exe vừa tải về.
   • Chọn đường dẫn thư mục cài đặt (nên để mặc định).

3. Chọn thành phần cài đặt

   • Để mặc định hết: server PostgreSQL, pgAdmin, Stack Builder (không biết nó là gì cũng không sao đâu).
   • Đảm bảo đường dẫn thư mục data dễ nhớ và dễ truy cập. Ví dụ: C:\Program Files\PostgreSQL\17.

4. Cài đặt port và mật khẩu

   • Đặt mật khẩu cho user postgres. Đây là user chính của database, nên nhớ kỹ hoặc ghi ra giấy (ai cũng biết vụ giấy note mà 😅).
   • Chọn port cho server (thường là 5432). Nếu port này bị chiếm, chọn port khác (5433, 5434, v.v.).

5. Cài đặt locale và bắt đầu cài

   • Sau đó bạn sẽ được hỏi chọn locale cho database. Cứ để mặc định là ổn
   • Và giờ PostgreSQL đã sẵn sàng để cài lên Windows của bạn rồi đó.

6. Finish

   Gần cuối quá trình cài, bạn sẽ được hỏi có muốn chạy StackBuilder không. Có thể bỏ tick và nhấn “Finish”. Chúc mừng, bạn đã cài xong PostgreSQL! 🎉 Server PostgreSQL sẽ tự động chạy nền luôn.

   StackBuilder — là tiện ích đi kèm installer PostgreSQL của EDB (EnterpriseDB). Nó dùng để tải và cài thêm các tool, driver và app bổ sung cho PostgreSQL của bạn.

7. Kiểm tra cài đặt

   • Mở command line (cmd) và chạy:

     psql -U postgres
     

     Nhập mật khẩu bạn đã đặt lúc cài. Nếu kết nối thành công, chúc mừng: bạn đã kết nối với server rồi đó!

Cài đặt PostgreSQL trên macOS

Nếu bạn là fan của macOS, để cài PostgreSQL thì dùng Homebrew là tiện nhất (cách này ngon nhất cho macOS).

1. Kiểm tra Homebrew

   Mở terminal và chạy:

   brew --version
   

   Nếu Homebrew đã cài, sẽ hiện version. Nếu chưa, sửa ngay bằng lệnh này:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. Cài PostgreSQL

   Chạy lệnh:

   brew install postgresql
   

3. Khởi động server

   Sau khi cài xong, khởi động server PostgreSQL bằng lệnh:

   brew services start postgresql
   

4. Kiểm tra cài đặt

   Đảm bảo server đang chạy:

   psql -U postgres
   

   Lần đầu chạy có thể sẽ yêu cầu tạo user. Dùng createuser để tạo:

   createuser --interactive
   

5. Cài đặt port (tùy chọn)

   PostgreSQL trên macOS thường dùng port 5432 mặc định. Nếu muốn đổi port, sửa file config:

   nano /usr/local/var/postgres/postgresql.conf
   

   Tìm tham số port và đổi giá trị.

Cài đặt PostgreSQL trên Linux

Linux và PostgreSQL là cặp bài trùng. Nhưng mỗi distro lại có cách cài hơi khác nhau chút.

Cho Ubuntu/Debian

1. Cập nhật repo hệ thống

   Chạy lệnh:

   sudo apt update
   

2. Cài PostgreSQL

   Cài server và client PostgreSQL:

   sudo apt install postgresql postgresql-contrib
   

3. Khởi động server

   Đảm bảo server đã chạy:

   sudo systemctl start postgresql
   

4. Thêm PostgreSQL vào khởi động cùng hệ thống

   Để server tự động chạy khi khởi động:

   sudo systemctl enable postgresql
   

5. Kiểm tra cài đặt

   Chuyển sang user postgres:

   sudo -i -u postgres
   

   Kết nối tới server:

   psql
   

   Nếu bạn thấy prompt postgres=#, chúc mừng, server đã chạy ngon lành!

Cho CentOS/RedHat

1. Thêm repo PostgreSQL

   Tải file RPM repo từ trang PostgreSQL:

   sudo yum install https://download.postgresql.org/pub/repos/yum/reporpms/EL-$(rpm -E %rhel)-x86_64/pgdg-redhat-repo-latest.noarch.rpm
   

2. Cài PostgreSQL

   Cài server và client:

   sudo yum install postgresql17-server postgresql17
   

3. Khởi tạo database

   Chạy lệnh:

   sudo /usr/pgsql-17/bin/postgresql-17-setup initdb
   

4. Khởi động server

   Bật và khởi động server:

   sudo systemctl enable postgresql-17
   sudo systemctl start postgresql-17
   

5. Kiểm tra cài đặt

   Kết nối tới server với user postgres:

   sudo -u postgres psql
   

Hy vọng bạn đã cài và chạy được ngay lần đầu. Nếu chưa được - qua bài tiếp theo, mình sẽ giải thích các lỗi thường gặp.