Apache Derby 数据库 - 教程

「爱情、让人受尽委屈。」 2023-09-30 11:45 44阅读 0赞

> 阿帕奇德比。本文介绍如何安装 Apache Derby 数据库、如何启动 Derby 服务器、如何通过 Java 连接到 Derby 以及如何使用 Derby 命令行工具发出 SQL 语句。还解释了将 Apache Derby 安装为 Windows 服务。

### **[1. 阿帕奇德比][1.]** ###

#### **[1.1。概述][1.1]** ####

Apache Derby 是一个用 Java 编写的开源数据库。它是免费的并且性能良好。Apache Derby 在 JDK 中使用，称为 Java DB。Apache Derby 和 Java DB 本质上是相同的。Apache Derby 是 JDBC 4.0 的参考实现，与 ANSI-SQL 兼容。JDBC 是连接数据库的 Java 接口。

#### **[1.2. 服务器与嵌入式模式][1.2.]** ####

Derby 可用于*服务器模式*和所谓的*嵌入式模式*。如果 Derby 在*服务器模式下*运行，您将启动负责处理数据库请求的 Derby 网络服务器。在*嵌入式模式下*，Derby 在应用程序的 JVM（Java 虚拟机）中运行。在这种模式下，只有应用程序可以访问数据库，例如另一个用户/应用程序将无法访问数据库。

### **[2. 德比的安装][2.]** ###

[从 Apache 网站http://db.apache.org/derby/][Apache _http_db.apache.org_derby]下载最新的 Derby 版本。选择 bin 分发并将此 zip 解压缩到您选择的目录。

还要使 Derby 工具在您的路径中可用：

*  将环境变量 DERBY\_HOME 设置为 Derby 安装目录
 *  将 DERBY\_HOME/bin 添加到“路径”环境变量

### **[3.服务器模式][3.]** ###

#### **[3.1。以服务器模式启动 Derby][3.1_ Derby]** ####

在命令行中使用以下命令启动 Derby 网络服务器（位于 Derby 安装目录/bin 中）。在 Microsoft Windows 上，可以使用 .bat 版本。

startNetworkServer

这将启动可以为无限数量的数据库提供服务的网络服务器。默认情况下，服务器将侦听端口 1527，但这可以通过`-p`选项进行更改。

startNetworkServer -p 3301

默认情况下，Derby 将只接受来自 localhost 的连接。要使 Derby 服务器也接受来自其他主机的连接，请使用以下启动命令。将“sampleserver.sampledomain.com”替换为服务器的名称或 IP。然后，服务器将只接受来自其他服务器的连接作为本地主机。

startNetworkServer -h sampleserver.sampledomain.com

如果应允许来自 localhost 和任何其他服务器的连接，请使用以下内容。

startNetworkServer -h 0.0.0.0

#### **[3.2. 通过 Java 连接到 Derby 服务器][3.2. _ Java _ Derby]** ####

要通过 Java 代码连接到网络服务器，您需要在类路径中包含 derbyclient.jar。此数据库的网络连接字符串是服务器的 IP 地址：端口号。例如，对于在 localhost 上运行的服务器，您可以通过以下字符串创建一个新数据库。

jdbc:derby://localhost:1527/dbname;create=true

如果要连接到现有数据库，可以使用以下字符串。

jdbc:derby://localhost:1527/c:\temp\mydatabase

例如，一个小型 Java 客户端可能如下所示。这假设您已经创建了一个名为表 users 的模式，其中包含“name”和“number”列。

import java.sql.Connection;
    import java.sql.DriverManager;
    import java.sql.PreparedStatement;
    import java.sql.ResultSet;
    import java.sql.Statement;
    
    public class DerbyTest {
        private Connection connect = null;
        private Statement statement = null;
        private ResultSet resultSet = null;
    
        public DerbyTest() throws Exception {
            try {
    
                Class.forName("org.apache.derby.jdbc.ClientDriver").newInstance();
                connect = DriverManager
                        .getConnection("jdbc:derby://localhost/c:/temp/db/FAQ/db");
                PreparedStatement statement = connect
                        .prepareStatement("SELECT * from USERS");
    
                resultSet = statement.executeQuery();
                while (resultSet.next()) {
                    String user = resultSet.getString("name");
                    String number = resultSet.getString("number");
                    System.out.println("User: " + user);
                    System.out.println("ID: " + number);
                }
            } catch (Exception e) {
                throw e;
            } finally {
                close();
            }
    
        }
    
        private void close() {
            try {
                if (resultSet != null) {
                    resultSet.close();
                }
                if (statement != null) {
                    statement.close();
                }
                if (connect != null) {
                    connect.close();
                }
            } catch (Exception e) {
    
            }
        }
    
        public static void main(String[] args) throws Exception {
            DerbyTest dao = new DerbyTest();
        }
    
    }

### **[4. 德比工具][4.]** ###

#### **[4.1。从命令行使用 Derby (ij)][4.1_ Derby _ij]** ####

ij 是 Derby 的交互式 JDBC 脚本工具。它是一个简单的实用程序，用于针对 Derby 数据库运行脚本或交互式查询。要启动该工具，请打开命令外壳并输入“ij”。这将启动一个 shell 程序，它可以连接到您的数据库并执行 SQL 命令。输入“exit;”停止此工具 并按下**进入**. 在 ij 中，每一行都需要以`;`.

如果要连接到 Derby 数据库，`embedded mode`可以使用以下命令。在此示例中，数据库位于 c:\\temp\\db\\FAQ\\db。

connect 'jdbc:derby:c:\temp\db\FAQ\db';

如果要连接到正在运行的 Derby 数据库，`server mode`则可以使用以下命令。

connect 'jdbc:derby://localhost:1527/c:\temp\db\FAQ\db;create=true';

断开与数据库的连接。

disconnect;

要从 ij 运行 SQL 脚本，请使用以下命令。

run 'sqlscript.sql'

您也可以直接使用 SQL，例如

select * from SCHEMA1.USERS where NUMBER='lars'

#### **[4.2. 数据库模式的 SQL 转储][4.2. _ SQL]** ####

使用工具 dblook。在控制台输入 dblook 查看选项，该工具非常好用。例如将模式“myschema”写入文件“lars.sql”。

dblook -d 'jdbc:derby:c:\temp\db\FAQ\db' -z myschema -o lars.sql

[ⓘ][Link 1]

### **[5. 将 Derby Server 作为 Windows 服务运行][5. _ Derby Server _ Windows]** ###

Derby Server 通过批处理程序启动。在服务器环境中，如果服务器重新启动/启动，该批处理程序应该会自动启动。Windows 程序“srvmgr”可用于此目的。工具详情请查看官方文档；下面将描述如何为 Apache Derby 完成此操作。安装“srvmgr”并记住安装路径。

我们将调用我们的服务“ApacheDerby”，批处理文件位于“C:\\db-derby\\bin\\startNetworkServer.bat”下。在命令行中通过以下方式注册服务：

# This assumes the "srvmgr" tools are installed in c:\Windows\system32\
    instsrv ApacheDerby c:\Windows\system32\srvany.exe

您应该会收到一条成功消息。

<table style="width:690.297px;"> 
 <tbody> 
  <tr> 
   <td style="text-align:center;width:80px;"></td> 
   <td> 
    <div style="margin-left:0;"> 
     <p style="margin-left:0;"><span style="color:#4a4a4a;"><span style="background-color:#ffffff;"><span style="color:rgba(0,0,0,.6);">如果出现问题并且您想删除已安装的服务，您可以使用：</span></span></span></p> 
    </div> 
    <div style="margin-left:0;"> 
     <div style="margin-left:0;"> 
      <pre style="margin-left:0;"><code># This will remove a service installed with the name ApacheDerby
instsrv ApacheDerby REMOVE</code></pre> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

运行 Regedt32.exe 并找到以下子项 HKEY\_LOCAL\_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\ApacheDerby。

从编辑菜单中，选择**新建** **键**并添加一个名为`Parameters`.

选择`Parameters`您刚刚创建的密钥。从编辑菜单中，选择**新建** **字符串值**并维护以下值。

Value Name: Application
    Data Type : REG_SZ
    String : C:\db-derby\bin\startNetworkServer.bat
    
    Value Name: AppDirectory
    Data Type : REG_SZ
    String : C:\db-derby\bin\
    
    Value Name: AppParameters
    Data Type : REG_SZ
    String : -h 0.0.0.0

现在在 Windows 服务控制面板中启动/调整服务。

### **[6.链接和文献][6.]** ###

[Apache Derby 主页][Apache _http_db.apache.org_derby]

[1.]: https://www.vogella.com/tutorials/ApacheDerby/article.html#derby
[1.1]: https://www.vogella.com/tutorials/ApacheDerby/article.html#derby_overview
[1.2.]: https://www.vogella.com/tutorials/ApacheDerby/article.html#derby_modes
[2.]: https://www.vogella.com/tutorials/ApacheDerby/article.html#installation
[Apache _http_db.apache.org_derby]: http://db.apache.org/derby/
[3.]: https://www.vogella.com/tutorials/ApacheDerby/article.html#servermode
[3.1_ Derby]: https://www.vogella.com/tutorials/ApacheDerby/article.html#servermode_start
[3.2. _ Java _ Derby]: https://www.vogella.com/tutorials/ApacheDerby/article.html#servermode_java
[4.]: https://www.vogella.com/tutorials/ApacheDerby/article.html#tools
[4.1_ Derby _ij]: https://www.vogella.com/tutorials/ApacheDerby/article.html#tools_commandline
[4.2. _ SQL]: https://www.vogella.com/tutorials/ApacheDerby/article.html#usage_sqldump
[Link 1]: https://www.pixfuture.com/advertisers/?id0348293521d
[5. _ Derby Server _ Windows]: https://www.vogella.com/tutorials/ApacheDerby/article.html#service
[6.]: https://www.vogella.com/tutorials/ApacheDerby/article.html#resources