Skip to content

PostgreSQL - 环境设置

搭建一个合适的开发环境是使用 PostgreSQL 的第一步。创建一致、隔离和跨平台开发环境的现代标准是使用容器。我们强烈推荐为此目的使用 Docker。

Docker 允许你在轻量级、隔离的容器中运行 PostgreSQL,而不影响你的宿主机。Docker Compose 让你可以在一个简单的配置文件中定义此设置。这种方法在 Windows、macOS 和 Linux 上工作方式相同。

步骤 1:安装 Docker Desktop。

从官方 Docker 网站下载并安装适用于你操作系统的 Docker Desktop。

步骤 2:创建 docker-compose.yml 文件。

在你的项目目录中,创建一个名为 docker-compose.yml 的文件,内容如下:

version: '3.8'
services:
db:
image: postgres:15 # 指定一个最新且稳定的版本
restart: always
environment:
- POSTGRES_USER=myuser
- POSTGRES_PASSWORD=mypassword
- POSTGRES_DB=mydb
ports:
- '5432:5432' # 将容器端口 5432 映射到宿主机端口 5432
volumes:
- postgres_data:/var/lib/postgresql/data
volumes:
postgres_data:
# 这会创建一个命名卷,以便在容器重启后数据仍然持久化

步骤 3:启动 PostgreSQL 容器。

在与 docker-compose.yml 文件相同的目录中打开终端并运行:

# 这将下载镜像(如果需要)并在后台启动容器。
docker-compose up -d

你的 PostgreSQL 服务器现在正在运行!它正在监听 localhost:5432。

步骤 4:连接到数据库。

你可以使用任何 PostgreSQL 客户端进行连接,例如命令行工具 psql 或像 DBeaver、pgAdmin 这样的图形工具。连接字符串或参数将是:

  • 主机: localhost
  • 端口: 5432
  • 数据库: mydb
  • 用户: myuser
  • 密码: mypassword

要从容器内部使用 psql(如果你本地没有安装):

docker exec -it <container_name_or_id> psql -U myuser -d mydb

替代方案:通过包管理器进行原生安装

Section titled “替代方案:通过包管理器进行原生安装”

如果你更喜欢原生安装,使用操作系统的包管理器是最佳方法。

sudo apt update
sudo apt install postgresql postgresql-client
brew install postgresql

对于 Windows,EDB 提供的官方安装程序是推荐的原生方法。你可以在 PostgreSQL 官方下载页面上找到它。安装程序将指导你设置 postgres 超级用户的密码并初始化数据库。

  • psql: PostgreSQL 的标准命令行界面。它功能强大、可脚本化,是任何 PostgreSQL 开发者都必须学习的重要工具。
  • pgAdmin: 一个流行的开源图形用户界面(GUI),用于管理 PostgreSQL。它提供了一种可视化方式来查看数据、管理对象和运行查询。它通常与原生安装程序捆绑在一起。
  • DBeaver: 另一个出色、免费且多平台的数据库工具,支持 PostgreSQL 以及许多其他数据库。

环境设置完成后,你现在可以开始创建表并与你的 PostgreSQL 数据库进行交互了。