ServBay 数据库文件管理与迁移指南

ServBay 作为一款强大的本地 Web 开发环境，集成了多种常用的数据库管理系统，并对其数据文件进行了规范化管理。理解 ServBay 默认的数据库文件存放结构对于开发者进行数据备份、恢复和迁移至关重要。

本文将详细介绍 ServBay 默认的数据库文件存放结构，并提供使用标准命令行工具进行数据库文件管理及不同环境间迁移的指导。

TIP

ServBay 提供了数据备份和恢复功能，您可以自动或者手动对 MySQL、MariaDB、PostgreSQL数据库进行备份。请参考备份与恢复以获取更多信息。

ServBay 默认的数据库文件存放结构

为了便于管理和隔离不同数据库版本的数据，ServBay 将所有数据库的数据文件统一存放在 /Applications/ServBay/db 目录下。该目录按照数据库类型进行分类，然后在类型目录下根据数据库的主要版本号（major version）进一步组织。

以下是 /Applications/ServBay/db 目录的一个典型结构示例：

/Applications/ServBay/db
├── mysql
│   ├── 8.0
│   └── 8.1
├── mariadb
│   ├── 10.10
│   ├── 10.11
│   ├── 10.5
│   ├── 10.6
│   ├── 10.7
│   ├── 10.8
│   ├── 10.9
│   ├── 11.0
│   ├── 11.1
│   ├── 11.2
│   └── 11.3
├── postgresql
│   ├── 10
│   ├── 11
│   ├── 12
│   ├── 13
│   ├── 14
│   ├── 15
│   └── 16
└── redis

目录结构说明

• /Applications/ServBay/db: 这是 ServBay 存放所有数据库文件的主目录。
• mysql: 存放 MySQL 数据库的数据文件。子目录按主要版本号（如 8.0, 8.1）划分。
• mariadb: 存放 MariaDB 数据库的数据文件。子目录按主要版本号（如 10.11, 11.3）划分。
• postgresql: 存放 PostgreSQL 数据库的数据文件。子目录按主要版本号（如 15, 16）划分。
• redis: 存放 Redis 的持久化文件，通常是 dump.rdb 文件。

这种结构的好处在于，您可以在 ServBay 中同时安装和运行同一数据库的多个主要版本，它们的数据文件相互隔离，互不影响。

数据库文件管理

在本地开发过程中，您经常需要对数据库进行备份、恢复或迁移操作。以下是使用各数据库标准命令行工具进行这些操作的方法。请注意，这些操作通常需要通过 ServBay 提供的终端环境或确保环境变量正确配置，以便能够直接调用相应的数据库客户端和工具。

备份数据库

定期备份是保障数据安全的关键步骤。以下是如何备份 ServBay 中不同数据库类型的示例。

备份 MySQL

使用 mysqldump 工具是备份 MySQL 数据库的标准方法。

# 切换到 ServBay 提供的终端环境，或确保 PATH 环境变量包含 ServBay 的 bin 目录
# 例如：export PATH="/Applications/ServBay/bin:$PATH"

mysqldump -u your_username -p your_database > /Applications/ServBay/backup/your_database.sql

• your_username: 替换为您的数据库用户名。
• your_database: 替换为您要备份的数据库名称。
• /Applications/ServBay/backup/your_database.sql: 替换为您希望保存备份文件的路径和文件名。建议将备份文件存放在 ServBay 目录以外的位置，例如您的用户目录下。

备份 MariaDB

备份 MariaDB 的方法与 MySQL 类似，同样使用 mysqldump 工具。

# 切换到 ServBay 提供的终端环境，或确保 PATH 环境变量包含 ServBay 的 bin 目录

mysqldump -u your_username -p your_database > /Applications/ServBay/backup/your_database.sql

• 参数说明同上。

备份 PostgreSQL

使用 pg_dump 工具来备份 PostgreSQL 数据库。请注意，在 ServBay 环境下，PostgreSQL 通常配置为使用 Unix Domain Socket 连接，其默认路径为 /Applications/ServBay/tmp，因此在命令中需要指定 -h /Applications/ServBay/tmp。

# 切换到 ServBay 提供的终端环境，或确保 PATH 环境变量包含 ServBay 的 bin 目录

pg_dump -h /Applications/ServBay/tmp -U your_username -d your_database -F c -b -v -f /Applications/ServBay/backup/your_database.dump

• -h /Applications/ServBay/tmp: 指定 PostgreSQL 服务器的 socket 文件路径。
• -U your_username: 替换为您的数据库用户名。
• -d your_database: 替换为您要备份的数据库名称。
• -F c: 指定输出格式为自定义归档格式（推荐）。
• -b: 包含大对象（blobs）。
• -v: 输出详细信息。
• -f /Applications/ServBay/backup/your_database.dump: 替换为您希望保存备份文件的路径和文件名。

备份 Redis

Redis 的备份通常涉及复制其持久化文件 dump.rdb。

# 切换到 ServBay 提供的终端环境
# 确保 Redis 服务正在运行，或者配置了自动保存（BGSAVE）

cp /Applications/ServBay/db/redis/dump.rdb /Applications/ServBay/backup/dump.rdb

• /Applications/ServBay/db/redis/dump.rdb: Redis 默认的持久化文件路径。
• /Applications/ServBay/backup/dump.rdb: 替换为您希望保存备份文件的路径和文件名。

恢复数据库

在数据丢失或需要回滚到之前状态时，可以使用备份文件进行恢复。

恢复 MySQL

使用 mysql 客户端工具来恢复 MySQL 备份文件。

# 切换到 ServBay 提供的终端环境

mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql

• your_username: 替换为您的数据库用户名。
• your_database: 替换为您要恢复到的数据库名称。该数据库通常需要提前创建好。
• /Applications/ServBay/backup/your_database.sql: 替换为您的备份文件路径。

恢复 MariaDB

恢复 MariaDB 的方法与 MySQL 相同，使用 mysql 客户端工具。

# 切换到 ServBay 提供的终端环境

mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql

• 参数说明同上。

恢复 PostgreSQL

使用 pg_restore 工具来恢复 PostgreSQL 的自定义格式备份文件。同样需要指定 socket 文件路径 -h /Applications/ServBay/tmp。

# 切换到 ServBay 提供的终端环境

pg_restore -h /Applications/ServBay/tmp -U your_username -d your_database -v /Applications/ServBay/backup/your_database.dump

• -h /Applications/ServBay/tmp: 指定 PostgreSQL 服务器的 socket 文件路径。
• -U your_username: 替换为您的数据库用户名。
• -d your_database: 替换为您要恢复到的数据库名称。该数据库通常需要提前创建好。
• -v: 输出详细信息。
• /Applications/ServBay/backup/your_database.dump: 替换为您的备份文件路径。

恢复 Redis

恢复 Redis 通常是将备份的 dump.rdb 文件复制回 Redis 的数据目录。重要：在执行此操作前，请确保 Redis 服务已经停止。

# 切换到 ServBay 提供的终端环境
# 停止 ServBay 中的 Redis 服务
# 复制备份文件
cp /Applications/ServBay/backup/dump.rdb /Applications/ServBay/db/redis/dump.rdb
# 启动 ServBay 中的 Redis 服务

• /Applications/ServBay/backup/dump.rdb: 替换为您的备份文件路径。
• /Applications/ServBay/db/redis/dump.rdb: Redis 默认的持久化文件路径。

迁移数据库

数据库迁移是将数据库从一个环境（可能是另一个 ServBay 实例、远程服务器或其他本地环境）移动到另一个环境的过程。这通常涉及在源环境导出数据，然后在目标环境导入数据。

迁移 MySQL

迁移 MySQL 是日常开发中会碰到的场景

1. 在源环境导出数据库：

   # 在源环境的终端中执行
   mysqldump -u your_source_username -p your_database > your_database.sql

   • your_source_username: 源环境的数据库用户名。
   • your_database: 要迁移的数据库名称。
   • your_database.sql: 导出的 SQL 文件名。

2. 将导出的 SQL 文件传输到目标环境： 使用 scp 或其他文件传输工具将 your_database.sql 文件传输到目标 ServBay 环境可访问的位置（例如 /Applications/ServBay/backup/）。

3. 在目标 ServBay 环境中创建数据库：

   # 在目标 ServBay 终端中执行
   mysql -u your_target_username -p -e "CREATE DATABASE your_database;"

   • your_target_username: 目标 ServBay 环境的数据库用户名。
   • your_database: 要创建的数据库名称（应与源数据库名称一致）。

4. 在目标 ServBay 环境中导入数据库：

   # 在目标 ServBay 终端中执行
   mysql -u your_target_username -p your_database < /path/to/your_database.sql

   • /path/to/your_database.sql: 替换为 SQL 文件在目标环境中的实际路径。

迁移 MariaDB

迁移 MariaDB 的步骤与 MySQL 完全相同，因为它们使用相同的命令行工具和文件格式。

1. 在源环境导出数据库：

   # 在源环境的终端中执行
   mysqldump -u your_source_username -p your_database > your_database.sql

2. 将导出的 SQL 文件传输到目标环境。
3. 在目标 ServBay 环境中创建数据库：

   # 在目标 ServBay 终端中执行
   mysql -u your_target_username -p -e "CREATE DATABASE your_database;"

4. 在目标 ServBay 环境中导入数据库：

   # 在目标 ServBay 终端中执行
   mysql -u your_target_username -p your_database < /path/to/your_database.sql

迁移 PostgreSQL

迁移 PostgreSQL 使用 pg_dump 和 pg_restore 工具。同样需要注意 ServBay 环境下的 socket 文件路径。

1. 在源环境导出数据库：

   # 在源环境的终端中执行
   # 如果源环境是 ServBay
   pg_dump -h /Applications/ServBay/tmp -U your_source_username -d your_database -F c -b -v -f your_database.dump
   # 如果源环境是其他系统，请根据其配置调整连接参数

   • your_source_username: 源环境的数据库用户名。
   • your_database: 要迁移的数据库名称。
   • your_database.dump: 导出的备份文件名称。

2. 将导出的备份文件传输到目标 ServBay 环境： 使用 scp 或其他文件传输工具将 your_database.dump 文件传输到目标 ServBay 环境可访问的位置。

3. 在目标 ServBay 环境中创建数据库：

   # 在目标 ServBay 终端中执行
   # 连接到默认的 postgres 数据库来创建新的数据库
   psql -h /Applications/ServBay/tmp -U your_target_username -d postgres -c "CREATE DATABASE your_database;"

   • your_target_username: 目标 ServBay 环境的数据库用户名。
   • your_database: 要创建的数据库名称。

4. 在目标 ServBay 环境中导入数据库：

   # 在目标 ServBay 终端中执行
   pg_restore -h /Applications/ServBay/tmp -U your_target_username -d your_database -v /path/to/your_database.dump

   • /path/to/your_database.dump: 替换为备份文件在目标环境中的实际路径。

迁移 Redis

迁移 Redis 通常涉及直接复制 dump.rdb 文件。

1. 在源环境获取 dump.rdb 文件：

   # 在源环境的终端中执行
   # 确保 Redis 服务已停止，或者等待 BGSAVE 完成
   cp /path/to/source/redis/dump.rdb ./dump.rdb

2. 将 dump.rdb 文件传输到目标 ServBay 环境的 Redis 数据目录：

   # 在源环境或中间服务器执行
   scp ./dump.rdb your_target_server:/Applications/ServBay/db/redis/dump.rdb

   • your_target_server: 目标 ServBay 服务器的地址或主机名。
   • 重要：在复制到目标 ServBay 的 /Applications/ServBay/db/redis/ 目录前，请确保目标 ServBay 的 Redis 服务已经停止。

3. 在目标 ServBay 环境中启动 Redis 服务： 启动 Redis 服务后，它将自动加载新的 dump.rdb 文件。

注意事项

• 停止服务: 在直接复制或移动数据库文件（特别是 MySQL/MariaDB/PostgreSQL 的数据目录）之前，务必通过 ServBay GUI 或命令行工具停止相应的数据库服务。对正在运行的数据库文件进行直接复制可能导致数据不一致或损坏。Redis 在使用 dump.rdb 文件进行恢复时也需要停止服务。
• 权限问题: 确保执行文件复制、移动或导入操作的用户具有足够的权限访问和修改相关目录和文件。
• 文件路径: 仔细核对 ServBay 的安装路径（默认为 /Applications/ServBay）以及数据库文件的具体路径，特别是不同数据库版本下的子目录。
• 用户和权限: 迁移后，请检查数据库中的用户、权限和配置文件是否需要更新，以适应新的环境。
• ServBay 内置备份: ServBay 也提供了便捷的内置备份和恢复功能，可以通过 GUI 进行操作，支持对设置、网站文件、数据库和 SSL 证书进行备份，可以作为手动文件管理方式的补充或替代。

总结

ServBay 通过规范化的文件结构，为开发者提供了清晰的数据库文件管理基础。本文详细介绍了 MySQL、MariaDB、PostgreSQL 和 Redis 在 ServBay 中的文件存放位置，并提供了使用标准命令行工具进行备份、恢复和迁移的实用指南。掌握这些技能，可以帮助您更好地管理本地开发环境中的数据库数据，确保数据安全，并在不同环境间高效地迁移项目。结合 ServBay 提供的其他便利功能（如内置备份），可以极大地提升您的开发效率和数据管理能力。