PostgreSQL 示例数据库 - Pagila安装与使用指南

PostgreSQL 示例数据库 - Pagila安装与使用指南

pagila PostgreSQL Sample Database 项目地址: https://gitcode.com/gh_mirrors/pa/pagila

1. 项目目录结构及介绍

Pagila 是一个专为 PostgreSQL 设计的示例数据库，它源自MySQL的Sakila数据库移植版本。以下是该仓库的基本目录结构及其内容概述：

.
├── LICENSE.txt            # 许可证文件
├── README.md               # 项目的主要说明文档
├── docker-compose.yml      # Docker Compose 配置文件，用于一键部署环境
├── pagila-data.sql         # 数据库数据的SQL脚本（COPY命令导入）
├── pagila-insert-data.sql  # 另一方式导入数据的SQL脚本（INSERT命令）
├── pagila-data-*.sql       # 包含JSONB数据的备份文件，需通过pg_restore加载
├── pagila-schema.sql       # 数据库模式定义，包括表、视图等
├── pagila-schema-jsonb.sql # 使用JSONB的数据模式
└── pagila-schema-diagram.png # 数据库模式的图表展示

• LICENSE.txt 提供了该项目使用的许可协议。
• README.md 包含了项目简介、安装步骤、查询示例以及各种功能点说明。
• docker-compose.yml 用于基于Docker快速搭建测试环境。
• 两个数据导入脚本(pagila-data.sql, pagila-insert-data.sql)提供了不同的数据加载选项。
• JSONB相关.sql文件用于处理含有JSONB字段的数据导入。
• pagila-schema.sql 和 pagila-schema-jsonb.sql 分别包含了数据库的架构定义和JSONB特性的模式。

2. 项目的启动文件介绍

Docker Compose 启动

启动文件主要是 docker-compose.yml，此文件简化了本地部署过程。执行以下命令即可启动包含PostgreSQL的容器，预先配置好的数据库环境会立即可用：

docker-compose up -d

这将后台启动所需的服务，并自动创建包含Pagila数据库的环境。默认情况下，你可以通过访问 http://localhost:5050 来使用pgAdmin（用户名：admin@admin.com，密码：root）来管理数据库。

手动启动（非Docker环境）

若不使用Docker，你需要手动执行SQL脚本来创建数据库并插入数据。首先，确保你已经安装了PostgreSQL，然后通过psql工具执行类似命令：

psql -U postgres -d postgres -f pagila-schema.sql

之后，选择其中一个数据导入脚本进行数据初始化。

3. 项目的配置文件介绍

在Docker环境中，主要的配置是通过docker-compose.yml文件完成的。它定义了一个PostgreSQL服务，其中包含了环境变量如POSTGRES_PASSWORD来设置初始密码。对于数据库本身的配置调整，可以通过启动容器后直接编辑其配置文件（位于容器内的特定路径），但常规用户操作通常不需要直接触及这些配置。

对于非Docker环境，PostgreSQL的配置位于其安装目录下的postgresql.conf文件中，具体位置依系统而异。但是，使用Pagila通常不需要修改这些高级配置，除非有特殊需求或性能调优。

---

此文档为简化的安装与快速入门指南，详细的使用和深入配置请参考项目中的官方文档。

pagila PostgreSQL Sample Database 项目地址: https://gitcode.com/gh_mirrors/pa/pagila