sakiladb/postgres

Sakila示例数据库PostgreSQL Docker镜像

镜像概述

本镜像基于官方PostgreSQL镜像构建，预加载了Sakila示例数据库。Sakila是一个标准化的示例数据库，包含电影租赁业务相关的表结构和样本数据，广泛用于数据库教学、功能演示和应用程序测试场景。

核心功能与特性

• 预加载Sakila数据库：镜像启动后自动包含完整的Sakila数据库 schema 和示例数据，无需手动导入
• 基于官方PostgreSQL：继承官方PostgreSQL镜像的全部功能和特性，包括标准SQL支持、事务处理、数据完整性约束等
• 即开即用：无需额外配置即可访问完整的示例数据库环境
• 版本兼容性：支持多种PostgreSQL版本（具体版本可通过镜像标签指定）

使用场景

• 数据库教学：作为SQL学习和数据库设计教学的实践环境
• 应用测试：为依赖数据库的应用程序提供标准化测试数据环境
• 功能演示：快速展示数据库查询、报表生成、数据建模等功能
• 开发调试：为开发人员提供一致的数据库环境，减少环境差异导致的问题

使用方法

基本使用（Docker Run）

通过以下命令启动容器：

bash
docker run -d -p 5432:5432 --name sakila-postgres docker.xuanyuan.run/sakiladb/postgres

参数说明：

• -d：后台运行容器
• -p 5432:5432：将容器的5432端口映射到主机的5432端口
• --name sakila-postgres：指定容器名称
• sakiladb/postgres：镜像名称（可通过标签指定版本，如sakiladb/postgres:14）

连接数据库

容器启动后，可使用PostgreSQL客户端连接：

bash
psql -h localhost -p 5432 -U postgres -d sakila

默认 credentials：

• 用户名：postgres
• 密码：无（如需设置密码，可通过环境变量配置）
• 数据库名：sakila

自定义配置（环境变量）

可通过环境变量自定义数据库配置：

bash
docker run -d -p 5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_DB=sakila \
  --name sakila-postgres docker.xuanyuan.run/sakiladb/postgres

常用环境变量：

• POSTGRES_PASSWORD：设置postgres用户密码
• POSTGRES_USER：创建自定义数据库用户
• POSTGRES_DB：指定默认数据库名（默认为sakila）

Docker Compose 配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  postgres:
    image: docker.xuanyuan.run/sakiladb/postgres
    ports:
      - "5432:5432"
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: myuser
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

启动服务：

bash
docker-compose up -d

数据持久化

为避免容器重启后数据丢失，建议使用数据卷挂载：

bash
docker run -d -p 5432:5432 \
  -v postgres_data:/var/lib/postgresql/data \
  --name sakila-postgres docker.xuanyuan.run/sakiladb/postgres

其中postgres_data为数据卷名称，会持久化存储数据库文件。