如何使用 DBeaver 管理 ServBay 数据库

ServBay 是一款功能全面的本地 Web 开发环境，为开发者提供了多种常用的数据库服务。虽然 ServBay 自带了如 phpMyAdmin (针对 MySQL/MariaDB)、pgAdmin (针对 PostgreSQL) 和 Redis Commander (针对 Redis) 等 Web 界面的数据库管理工具，但许多开发者更倾向于使用功能更强大、界面更统一的桌面客户端进行数据库管理。DBeaver 就是这样一款广受欢迎的跨平台数据库工具。

本文将指导您如何使用 DBeaver 连接并管理 ServBay 中集成的数据库，包括 MariaDB/MySQL、PostgreSQL、SQLite 和 Redis。

什么是 DBeaver？

DBeaver 是一款免费开源的通用数据库工具，面向开发者、SQL 程序员、数据库管理员和分析师。它支持几乎所有主流的数据库系统，包括关系型数据库（如 MySQL, PostgreSQL, Oracle, SQL Server, SQLite 等）和 NoSQL 数据库（如 MongoDB, Redis, Cassandra 等）。

DBeaver 的主要特点包括：

• 广泛的数据库支持: 通过统一的界面管理多种不同类型的数据库。
• 用户友好的界面: 提供直观的图形界面，简化复杂的数据库操作。
• 强大的功能: 包含 SQL 编辑器、数据编辑器、元数据浏览器、ER 图生成、数据导入/导出等多种高级功能。
• 跨平台: 支持 Windows, macOS, 和 Linux 操作系统。
• 活跃的社区和持续更新: 保证了工具的稳定性和功能扩展。

对于 ServBay 用户而言，结合使用 DBeaver 可以提供一个更加专业和统一的数据库管理体验，尤其是在需要同时管理多种数据库类型或执行复杂查询和操作时。

使用 DBeaver 管理 ServBay 自带的 MariaDB/MySQL 数据库

ServBay 默认集成了 MariaDB，它与 MySQL 高度兼容。以下是使用 DBeaver 连接和管理 ServBay 中 MariaDB/MySQL 数据库的步骤。

前提条件

• ServBay 已安装并运行。
• MariaDB/MySQL 软件包已在 ServBay 中启动。
• DBeaver 客户端已下载并安装。您可以从 DBeaver 官方网站 获取最新版本。

连接到 MariaDB/MySQL

1. 打开 DBeaver。
2. 点击左上角的 "新建数据库连接" 按钮 (通常是一个插头图标)。
3. 在数据库类型列表中，搜索并选择 "MariaDB" 或 "MySQL"。点击 "下一步"。
4. 输入连接信息：
   • 主机 (Host): 127.0.0.1 (或 localhost)
   • 端口 (Port): 3306
   • 用户名 (Username): 默认为 root。
   • 密码 (Password): 您可以在 ServBay 应用程序界面的 数据库 选项卡中找到 MariaDB/MySQL 的 root 用户密码。
   • 数据库 (Database): 可以先留空，连接成功后再选择或创建数据库。
   • 连接方式 (可选): 除了使用 TCP/IP (主机+端口) 连接，您也可以选择使用 Socket 连接，这在本地连接时通常更高效。在 驱动属性 (Driver properties) 中查找 connectUsing 并设置为 socket，然后查找 socket 属性，将其值设置为 ServBay MariaDB/MySQL 的 Socket 文件路径，默认为 /Applications/ServBay/tmp/mysql.sock。注意：使用 Socket 连接时，通常不需要填写主机和端口。
5. 点击 "测试连接" 按钮，确保连接信息正确。如果测试失败，请检查 ServBay 中 MariaDB 服务是否正在运行，以及用户名和密码是否正确。如果忘记密码，可以在 ServBay 的 数据库 选项卡中重置 MariaDB/MySQL 的 root 密码。
6. 测试连接成功后，点击 "完成" 保存连接。

基本数据库操作

连接成功后，您可以在 DBeaver 的数据库导航器中看到 ServBay 中的 MariaDB/MySQL 数据库实例。您可以执行以下基本操作：

• 创建数据库: 右键点击连接名，选择 "SQL 编辑器" -> "新建 SQL 脚本"。输入 CREATE DATABASE mydatabase_servbay; (将 mydatabase_servbay 替换为您想要的数据库名)，然后点击执行按钮 (绿色三角形)。
• 使用 SQL 编辑器查询数据: 右键点击连接名或特定的数据库/表，选择 "SQL 编辑器" -> "新建 SQL 脚本"。输入您的 SQL 查询语句，例如 SELECT * FROM your_table_name;，然后执行。
• 浏览和编辑数据: 在数据库导航器中展开数据库和表，双击表名即可在新标签页中查看和编辑表数据。DBeaver 提供了直观的数据编辑界面。
• 创建、修改和删除表: 右键点击数据库下的 "表" 节点，选择 "创建新表"。您也可以右键点击现有表进行修改或删除。
• 导入/导出数据: DBeaver 支持多种格式的数据导入和导出功能，方便您迁移数据。

这些操作通常通过 DBeaver 的图形界面或内置的 SQL 编辑器完成，流程与管理其他数据库类似。

使用 DBeaver 管理 ServBay 自带的 PostgreSQL 数据库

ServBay 也集成了 PostgreSQL 数据库。以下是使用 DBeaver 连接和管理 ServBay 中 PostgreSQL 数据库的步骤。

前提条件

• ServBay 已安装并运行。
• PostgreSQL 软件包已在 ServBay 中启动。
• DBeaver 客户端已安装。

连接到 PostgreSQL

1. 打开 DBeaver。
2. 点击左上角的 "新建数据库连接" 按钮。
3. 在数据库类型列表中，搜索并选择 "PostgreSQL"。点击 "下一步"。
4. 输入连接信息：
   • 主机 (Host): 127.0.0.1 (或 localhost)
   • 端口 (Port): 5432 (PostgreSQL 的默认端口)
   • 数据库 (Database): 默认为 postgres。您也可以连接到 ServBay 中创建的其他 PostgreSQL 数据库。
   • 用户名 (Username): 默认为 servbay。
   • 密码 (Password): 您可以在 ServBay 应用程序界面的 数据库 选项卡中找到 PostgreSQL 的用户密码。
   • 连接方式 (可选): 与 MariaDB/MySQL 类似，您也可以选择使用 Socket 连接。在 驱动属性 (Driver properties) 中查找 socketFactory 或类似的属性，并配置 Socket 文件路径，默认为 /Applications/ServBay/tmp/.s.PGSQL.5432（如果连接失败，请改为使用/Applications/ServBay/tmp）。具体配置方式可能因 DBeaver 版本略有差异，通常在连接属性的高级设置中查找。使用 Socket 连接时，通常不需要填写主机和端口。
5. 点击 "测试连接" 按钮。如果测试失败，请检查 ServBay 中 PostgreSQL 服务是否正在运行，以及用户名和密码是否正确。如果忘记密码，可以在 ServBay 的 数据库 选项卡中重置 PostgreSQL 的密码。
6. 测试连接成功后，点击 "完成" 保存连接。

基本数据库操作

连接成功后，您可以在 DBeaver 的数据库导航器中看到 ServBay 中的 PostgreSQL 数据库实例。大多数关系型数据库的基本操作（如创建数据库、创建表、查询、编辑数据、导入/导出）在 DBeaver 中的流程与 MariaDB/MySQL 类似，您可以通过 SQL 编辑器或图形界面完成。

使用 DBeaver 管理 ServBay 自带的 SQLite 3 数据库

ServBay 也提供了 SQLite 3 支持，SQLite 是一种轻量级的、基于文件的数据库引擎，无需独立的数据库服务器进程。

前提条件

• ServBay 已安装并运行。
• DBeaver 客户端已安装。
• 您需要一个 SQLite 数据库文件（.db, .sqlite, .sqlite3 等）。如果还没有，DBeaver 可以在新建连接时为您创建一个。

连接到 SQLite

1. 打开 DBeaver。
2. 点击左上角的 "新建数据库连接" 按钮。
3. 在数据库类型列表中，搜索并选择 "SQLite"。点击 "下一步"。
4. 输入连接信息：
   • 数据库文件路径 (Database File): 点击右侧的文件夹图标，选择或输入您的 SQLite 数据库文件的完整路径。ServBay 建议将这类数据文件存放在 /Applications/ServBay/db/sqlite/ 目录下，以便于管理和可能的备份。
   • 如果您要连接的数据库文件尚不存在，输入您希望创建的文件路径和名称，DBeaver 会在连接时自动创建。
5. 点击 "测试连接" 按钮。如果文件路径正确且可访问，连接应该会成功。
6. 测试连接成功后，点击 "完成" 保存连接。

基本数据库操作 (SQLite)

连接到 SQLite 文件后，您可以在 DBeaver 中像管理其他数据库一样管理它，尽管 SQLite 的功能集相对简单。

• 创建表: 右键点击数据库连接名，选择 "创建新表"。
• 使用 SQL 编辑器: 右键点击连接名，选择 "SQL 编辑器" -> "新建 SQL 脚本"，输入 SQL 语句并执行。
• 浏览和编辑数据: 双击表名查看和编辑数据。
• 删除表: 右键点击表名，选择 "删除"。
• 删除数据库: SQLite 数据库就是一个文件。要删除数据库，只需在文件系统中删除对应的 .db 文件即可。

使用 DBeaver 管理 ServBay 自带的 Redis 数据库

Redis 是一个开源的内存数据结构存储，可用作数据库、缓存和消息代理。ServBay 也集成了 Redis。

前提条件

• ServBay 已安装并运行。
• Redis 软件包已在 ServBay 中启动。
• DBeaver 客户端已安装。

连接到 Redis

1. 打开 DBeaver。
2. 点击左上角的 "新建数据库连接" 按钮。
3. 在数据库类型列表中，搜索并选择 "Redis"。点击 "下一步"。
4. 输入连接信息：
   • 主机 (Host): 127.0.0.1 (或 localhost)
   • 端口 (Port): 6379 (Redis 的默认端口)
   • 密码 (Password): ServBay 默认安装的 Redis 没有设置密码，通常留空。如果您的 ServBay 配置了 Redis 密码，请在此处输入。
5. 点击 "测试连接" 按钮。如果测试失败，请检查 ServBay 中 Redis 服务是否正在运行，以及端口和密码是否正确。
6. 测试连接成功后，点击 "完成" 保存连接。

基本数据管理 (Redis)

连接到 Redis 后，DBeaver 提供了一个图形界面来浏览和管理 Redis 中的键值对。

• 查看键: 在数据库导航器中展开连接，选择数据库 (通常是 DB 0)，您将看到一个键列表。
• 添加键: 右键点击数据库节点或键列表空白处，选择 "新建键"。输入键名、选择键类型 (String, List, Set, Hash, ZSet 等) 并输入值。
• 编辑键: 双击或右键点击现有键，选择 "编辑键"，修改值或 TTL (Time To Live)。
• 删除键: 右键点击键名，选择 "删除键"。
• 使用 Redis 控制台: 右键点击连接名或数据库，选择 "SQL 编辑器" -> "新建 Redis 控制台"，可以直接输入 Redis 命令并执行。

常见问题与故障排除 (FAQ)

• 连接失败，提示连接被拒绝 (Connection Refused):
  • 确保 ServBay 应用程序正在运行。
  • 确保您尝试连接的数据库服务 (MariaDB/MySQL, PostgreSQL, Redis) 已在 ServBay 中启动并显示为绿色运行状态。
  • 检查连接信息中的主机 (Host) 和端口 (Port) 是否正确。对于本地连接，通常是 127.0.0.1 和对应的默认端口 (MariaDB/MySQL: 3306, PostgreSQL: 5432, Redis: 6379)。
  • 如果使用 Socket 连接，确保 Socket 文件路径正确且数据库服务配置为使用该 Socket。
  • 检查您的防火墙设置，确保没有阻止 DBeaver 客户端与本地端口通信。
• 连接成功但认证失败 (Authentication Failed):
  • 检查您输入的用户名和密码是否正确。您可以在 ServBay 的 数据库 选项卡中找到或重置数据库的 root/默认用户密码。
• SQLite 连接时文件路径错误:
  • 确保您输入的文件路径是完整且正确的。
  • 确保 DBeaver 对该文件路径有读写权限。
• DBeaver 显示不全或界面异常:
  • 尝试重启 DBeaver。
  • 确保您的 Java 环境 (DBeaver 依赖 Java) 没有问题。

总结

DBeaver 是一款功能强大的通用数据库管理工具，与 ServBay 本地开发环境结合使用，可以极大地提升您管理各类数据库的效率。通过本文的指引，您可以轻松地将 DBeaver 连接到 ServBay 自带的 MariaDB/MySQL、PostgreSQL、SQLite 和 Redis 数据库，并进行日常的开发和管理操作。无论是进行数据浏览、编辑、执行 SQL 查询，还是进行更高级的数据库维护，DBeaver 都能为您提供统一且高效的体验。结合 ServBay 提供的便捷环境管理能力，您的本地开发工作流程将更加流畅。