適合新手的!在 Ubuntu 上安裝 PostgreSQL 的方法與基本設定

1. 介紹

PostgreSQL 是一款穩定性和效能優異的關聯式資料庫,在 Ubuntu 環境中也被許多應用程式和系統廣泛使用。本文將以易懂的方式說明在 Ubuntu 上安裝 PostgreSQL 並進行基本設定的步驟。以初學者也能理解的方式逐步說明,並包含安裝後的確認以及連線錯誤的處理方法,讓您能夠安心建置環境。

侍エンジニア塾

2. 前提條件與準備

首先,確認 Ubuntu 的版本為 20.04 或 22.04。在安裝 PostgreSQL 之前,取得最新的套件資訊並更新套件清單。

sudo apt update

這將使後續的安裝步驟順利進行。

3. PostgreSQL 的安裝步驟

3.1 新增 PostgreSQL 儲存庫

Ubuntu 的預設儲存庫可能不包含最新的 PostgreSQL,因此新增官方儲存庫。透過此方式,即可安裝最新版本。

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
sudo wget -qO- https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo tee /etc/apt/trusted.gpg.d/pgdg.asc

3.2 安裝 PostgreSQL

新增儲存庫後,使用以下指令安裝 PostgreSQL 及附加工具。

sudo apt update
sudo apt install postgresql postgresql-contrib

3.3 確認安裝

安裝後,使用下列指令確認 PostgreSQL 的版本,並檢查是否正常安裝。

postgres --version

 

4. 初始設定

4.1 PostgreSQL 使用者的設定

PostgreSQL 安裝時會建立名為「postgres」的系統使用者。使用以下指令切換至「postgres」使用者,並進行資料庫操作。

sudo -i -u postgres

4.2 本地連線設定的編輯

編輯「pg_hba.conf」檔案,並設定認證方式。預設僅允許本地連線,若要啟用遠端連線,需變更以下檔案的設定。

sudo nano /etc/postgresql/14/main/pg_hba.conf

例如,可以如以下指定「md5」認證,以強化安全性設定。

local   all             postgres                                md5
host    all             all             127.0.0.1/32            md5

變更設定後,請重新啟動 PostgreSQL 服務以套用設定。

sudo systemctl restart postgresql

5. 簡單的動作確認

5.1 PostgreSQL 的啟動與停止

PostgreSQL 在安裝時會自動啟動,但也可以使用以下指令手動啟動・停止。也可以確認服務的狀態。

sudo systemctl status postgresql
sudo systemctl start postgresql
sudo systemctl stop postgresql

5.2 資料庫的確認

使用「psql」指令連接到 PostgreSQL,並確認資料庫清單。

sudo -u postgres psql

在命令提示字元中輸入「l」即可顯示目前的資料庫清單。

6. pgAdmin 的安裝與設定(選用)

PostgreSQL 的管理可以使用 pgAdmin 這個 GUI 工具,非常方便。可以使用以下指令進行安裝,並透過瀏覽器輕鬆操作。

sudo apt install pgadmin4

安裝後,透過瀏覽器存取「http://localhost/pgadmin」,即可進行 PostgreSQL 的管理操作。

7. 疑難排解與常見錯誤的處理方法

7.1 安裝錯誤與儲存庫錯誤

在安裝過程中,如果發生「依賴關係錯誤」或「儲存庫錯誤」,請確認儲存庫的 URL 是否正確,並重新更新套件清單。

sudo apt update

7.2 連接錯誤的處理方法

連接到 PostgreSQL 時,如果發生「密碼驗證失敗」等錯誤,請確認「pg_hba.conf」設定和密碼是否正確,並嘗試重新啟動服務。

sudo systemctl restart postgresql

7.3 網路錯誤的解決方法

從遠端連接時發生問題,可能是 postgresql.conf 檔案中的「listen_addresses」設定為「localhost」。要啟用遠端連接,請按以下方式變更。

sudo nano /etc/postgresql/14/main/postgresql.conf

請按以下方式設定,以允許遠端連接。

listen_addresses = '*'

設定後,請重新啟動服務以套用變更。

sudo systemctl restart postgresql

 

8. 總結

本篇文章說明了在 Ubuntu 環境中安裝 PostgreSQL,以及進行初始設定和動作確認的步驟。由於也包含了 pgAdmin 的使用、遠端連線設定,以及常見錯誤的對應方法,因此即使是初學者也能順利進行設定。

MySQL & MariaDBの世界

目次 1 1. はじめに2 2. MySQLとPostgreSQLの基本的な違い2.1 MySQLの概要2.2 Post…