理解Derby数据库的创建与存储机制
Apache Derby数据库以文件目录的形式存储在文件系统中。当我们在Java应用程序中通过JDBC连接字符串并指定create=true来创建数据库时，Derby会默认在Java应用程序的当前工作目录下创建一个与数据库同名的文件夹，其中包含数据库的所有文件。
考虑以下Java代码片段，它尝试创建一个名为javaDb的Derby数据库：
import java.sql.DriverManager;
import java.sql.SQLException;
public class Main {
public static void main(String[] args) {
try {
// 连接到名为javaDb的数据库，如果不存在则创建
DriverManager.getConnection("jdbc:derby:javaDb;create=true");
System.out.println("Derby数据库 'javaDb' 已成功创建或连接。");
} catch (SQLException e) {
System.err.println("数据库连接或创建失败：" + e.getMessage());
e.printStackTrace();
}
}
}当上述Java程序执行时，它会在程序运行的目录下（例如，如果您的IDE项目根目录是C:\Users\YourUser\Documents\JavaDerbyDemo，那么javaDb文件夹就会出现在这里）创建一个名为javaDb的目录，其中包含数据库的物理文件。
ij工具连接问题分析
ij是Derby提供的一个交互式SQL脚本工具，常用于数据库的管理和查询。当用户尝试使用ij连接到上述Java程序创建的数据库时，常常会遇到“数据库未找到”的错误，即使数据库已经存在。
立即学习“Java免费学习笔记（深入）”；
例如，从Derby安装目录的lib文件夹下启动ij，然后尝试连接：
# 从Derby安装目录的lib文件夹执行 java -jar derbyrun.jar ij
在ij提示符下：
ij version 10.15 ij> connect 'jdbc:derby:javaDb'; ERROR XJ004: Database 'javaDb' not found. ij> show connections; No connection available.
这个错误ERROR XJ004: Database 'javaDb' not found.的根本原因在于工作目录不匹配。当您在Derby安装目录的lib文件夹下运行java -jar derbyrun.jar ij时，ij的当前工作目录就是那个lib文件夹。因此，当您在ij中尝试连接jdbc:derby:javaDb时，ij会尝试在lib文件夹内部查找javaDb数据库。然而，您的Java程序是在其自己的项目根目录创建的javaDb数据库，这两个位置是不同的。
解决方案一：从正确的目录启动ij
要让ij工具能够找到Java程序创建的数据库，最直接的方法是确保ij在与数据库相同的父目录下启动。这意味着您需要从Java项目根目录（即javaDb文件夹所在的目录）执行derbyrun.jar ij命令。
操作步骤：
确定数据库位置： 找到您的Java应用程序创建javaDb文件夹的实际路径。例如，如果您的Java项目位于C:\Users\me\Documents\JavaDerbyDemo，并且javaDb文件夹就在其中，那么这个目录就是您需要的工作目录。
-
切换到该目录： 在命令行（CMD、PowerShell、Bash等）中，使用cd命令切换到上述目录。
cd C:\Users\me\Documents\JavaDerbyDemo
-
启动ij工具： 从当前目录启动derbyrun.jar ij。您需要提供derbyrun.jar的完整路径，或者确保DERBY_HOME环境变量已正确设置。
-
使用DERBY_HOME环境变量（推荐）： 如果已设置DERBY_HOME指向Derby安装根目录，则可以这样启动：
java -jar %DERBY_HOME%\lib\derbyrun.jar ij
(对于Linux/macOS: java -jar $DERBY_HOME/lib/derbyrun.jar ij)
-
使用derbyrun.jar的完整路径： 如果未设置DERBY_HOME，请直接指定derbyrun.jar的完整路径。
java -jar C:\derbydb\db-derby-10.16.1.1-bin\lib\derbyrun.jar ij
(请将路径替换为您的实际Derby安装路径)
-
-
在ij中连接数据库： 成功启动ij后，在ij>提示符下尝试连接数据库。
ij> connect 'jdbc:derby:javaDb';
此时，ij会在其当前工作目录（即您的Java项目根目录）中找到javaDb文件夹，并成功建立连接。
解决方案二：使用ij直接创建并连接数据库
如果您希望通过ij工具来管理数据库的创建和连接，可以直接在ij的连接字符串中指定create=true。这种方式会在ij的当前工作目录下创建数据库。
操作步骤：
-
启动ij工具： 可以从任何位置启动ij，但请注意，数据库将创建在您执行java -jar derbyrun.jar ij命令的当前目录下。
# 例如，从Derby安装目录的lib文件夹启动 java -jar derbyrun.jar ij
-
在ij中创建并连接数据库： 在ij>提示符下，使用create=true参数连接。
ij> connect 'jdbc:derby:javaDbTwo;create=true';
执行此命令后，ij会在其当前工作目录（例如，derbyrun.jar所在的lib文件夹）中创建一个名为javaDbTwo的新数据库文件夹，并立即连接到它。这样可以确保ij能够找到并管理它自己创建的数据库。
注意事项与最佳实践
- 工作目录的重要性： 始终明确Java应用程序和ij工具的当前工作目录。这是理解Derby数据库查找行为的关键。
- 避免污染Derby安装目录： 尽量不要将应用程序创建的数据库文件夹复制到Derby的lib目录中。lib目录应保持纯净，主要用于存放Derby的核心库文件。
- 一致性： 在开发和生产环境中，保持数据库创建和访问的工作目录策略一致，可以避免许多不必要的路径问题。
- 环境变量： 设置DERBY_HOME环境变量可以极大地简化命令行操作，提高效率。
- 完整路径： 如果对当前工作目录不确定，或者需要将数据库放置在特定位置，可以在连接字符串中提供数据库的完整文件路径，例如jdbc:derby:/path/to/your/database/javaDb;create=true。
总结
Derby数据库“未找到”的问题通常源于Java应用程序与ij工具之间对数据库文件路径的理解差异。通过理解数据库的创建机制和工具的工作目录，我们可以采取两种主要策略来解决此问题：一是确保ij在数据库所在的正确父目录中启动；二是直接利用ij工具的create=true选项在其当前工作目录中创建和连接数据库。掌握这些方法将有助于您更高效、更顺畅地管理和使用Apache Derby数据库。
