Apache Derby

维基百科，自由的百科全书
跳转到导航 跳转到搜索
Apache Derby
原作者Cloudscape Inc (Later IBM)
开发者Apache软件基金会
当前版本
    Module:EditAtWikidata第29行Lua错误：attempt to index field 'wikibase' (a nil value)
    源代码库
    • {{URL|example.com|可选的显示文本}}
    Module:EditAtWikidata第29行Lua错误：attempt to index field 'wikibase' (a nil value)
    编程语言Java
    引擎
      Module:EditAtWikidata第29行Lua错误：attempt to index field 'wikibase' (a nil value)
      操作系统跨平台
      类型关系数据库管理系统
      许可协议Apache许可证 2.0
      网站db.apache.org/derby/

      Apache Derby是Apache软件基金会所研发的开放源码数据库管理系统；由于Derby是一个纯Java程序，因此只需要操作系统支持Java虚拟机，Derby便可执行。

      特性[编辑]

      Derby是特别地为Java环境进行优化，Derby本身不仅是一个纯Java程序，而且Derby在执行用户的SQL程序时，能够把SQL编译成Java bytecode并以系统的Java虚拟机执行。由于SQL程序转成的Java bytecode能被JIT动态翻译，因此Derby可能比传统的数据库管理系统更佳的性能。

      其他特性包括：

      商业的版本[编辑]

      • Cloudscape － IBM的Derby版本。
      • Java DB － Sun微系统自Java 6把Derby包括于JDK。

      安装[编辑]

      下载解压后，只需要配置好相关的环境变量：

      1. 建立DERBY_HOME，值例：D:\db-derby-10.10.2.0-bin
      2. 在Path加入：%DERBY_HOME%\bin
      3. 在CLASSPATH加入：%DERBY_HOME%\lib\derby.jar;%DERBY_HOME%\lib\derbyclient.jar;%DERBY_HOME%\lib\derbytools.jar;%DERBY_HOME%\lib\derbynet.jar
      • derby.jar 是引擎库。对嵌入式是必须的；对客户/服务器模式，服务器端必须此库
      • derbytools.jar 是Derby工具库，如ij, dblook, import/export
      • derbyoptionaltools.jar
      • derbynet.jar 通过网络服务器连接Derby（非嵌入方式）
      • derbyclient.jar: 网络客户端启动程序
      • derbyrun.jar: 执行jar文件用于简便地启动Derby工具或服务器。需要与其他jar文件在同一目录下
        • java -jar %DERBY_HOME%\lib\derbyrun.jar ij [-p propertiesfile] [sql_script]
        • java -jar %DERBY_HOME%\lib\derbyrun.jar sysinfo [-cp ...] [-cp help]
        • java -jar %DERBY_HOME%\lib\derbyrun.jar dblook [arg]* (or no arguments for usage)
        • java -jar %DERBY_HOME%\lib\derbyrun.jar server [arg]* (or no arguments for usage)

      使用[编辑]

      sysinfo或java org.apache.derby.tools.sysinfo 查看安装信息版本

      启动derby的网络服务器，默认监听127.0.0.1的1527端口，可以修改监听的IP和PORT 

         java org.apache.derby.drda.NetworkServerControl start -p 1388  #指定端口

      或者 

         startNetworkServer -h myhost -p 1388   #指定ip和端口

      或者 

      java -jar derby/lib/derbyrun.jar server start

      dblook工具是一个Data Definition Language (DDL)生成工具，可以卸载（dump）所有或部分用户指定的DDL到一个文件或控制台。

      启动JDBC客户端工具ij，可以执行SQL脚本或者交互式查询： 

       ij或java org.apache.derby.tools.ij 或 java -jar derby/lib/derbyrun.jar ij -p ij.properties

      ij命令行参数： 

       ij -Dij.connection.mynetconnection=jdbc:derby://myserver:1527/mydb -Dij.user=me -Dij.password=nocansay

      也可以创建一个名为ij.properties，用于默认连接数据库： 

       ij.driver=org.apache.derby.jdbc.ClientDriver
 ij.protocol=jdbc:derby://localhost:1527/
 ij.database=COREJAVA;create=true

      或者先设置环境变量： 

       set DERBY_OPTS=-Dij.protocol=jdbc:derby://localhost/ （页面存档备份，存于互联网档案馆）

      在ij客户端工具内部，不区分大小写，每条命令都应以分号结尾。

      连接数据库并在必要时创建数据库： 

         connect 'jdbc:derby:mydb;create=true;user=test;password=test';   //创建/连接嵌入式数据库,
                                                                    //如果只写数据库名则会在当前目录下创建数据库目录
            //也可以指定其他位置进行创建"jdbc:derby:d:/a/b/userDB;create=true;user=test;password=test"
   connect 'jdbc:derby://host:1527/dbname;create=true';    //创建/链接网络数据库

      查看ij的命令： 

         help;

      运行sql文件： 

         run 'D:/derby/demo/ToursDB_schema.sql'  [RunResultOutput.txt]；

      断开数据库连接（并停止内嵌模式数据库） 

         disconnect;

      退出客户端： 

         exit ;

      关闭数据库服务器： 

      java -jar derby/lib/derbyrun.jar server shutdown

      命令行当前目录中derby.log日志文件，derby在其中记录的数据库启动、关闭的信息。

      Java程序访问Derby数据库： 

      package test;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.Statement;

public class EmbeddedDerbyTester {
    public static void main(String[] args) {
        String driver = "org.apache.derby.jdbc.EmbeddedDriver";//在derby.jar里面
        String dbName="EmbeddedDB";
        String dbURL = "jdbc:derby:"+dbName+";create=true";//create=true表示当数据库不存在时就创建它
        try {            
            Class.forName(driver);
            Connection conn = DriverManager.getConnection(dbURL);//启动/连接嵌入式数据库
            Statement st = conn.createStatement();
            st.execute("create table foo (FOOID INT NOT NULL,FOONAME VARCHAR(30) NOT NULL)");//创建foo表
            st.executeUpdate("insert into foo(FOOID,FOONAME) values (1,'chinajash')");//插入一条数据
            ResultSet rs = st.executeQuery("select * from foo");//读取刚插入的数据
            while(rs.next()){
                int id = rs.getInt(1);
                String name = rs.getString(2);
                System.out.println("id="+id+";name="+name);
            }
        } catch(Exception e){
            e.printStackTrace();
        }
    }
}

      启动Derby网络服务器的Java程序： 

      package test;
import java.io.PrintWriter;
import java.sql.DriverManager;
import org.apache.derby.drda.NetworkServerControl;

public class NetworkServerDerbyTester {
    public static void main(String[] args) {
        String driver = "org.apache.derby.jdbc.ClientDriver";//在derbyclient.jar里面
        String dbName="NetworkDB";
        String connectionURL = "jdbc:derby://localhost:1527/" + dbName + ";create=true";
        try {
            /*
                启动Derby网络服务器,默认端口是1527,也可以通过运行
                        <Derby_Home>/frameworks/NetworkServer/bin/startNetworkServer.bat
                来启动Derby网络服务器；如果是Unix,用startNetworkServer
            */

            NetworkServerControl derbyServer = new NetworkServerControl();//NetworkServerControl类在derbynet.jar里面
            PrintWriter pw = new PrintWriter(System.out);//用系统输出作为Derby数据库的输出
            derbyServer.start(pw);//启动Derby服务器
            Class.forName(driver);
            DriverManager.getConnection(connectionURL);
            //do something here..........
            derbyServer.shutdown();//关闭Derby服务器
        } catch (Exception ex) {
            ex.printStackTrace();
        }
    }
}

      Schema实现[编辑]

      Apache Derby数据库（即Java DB）的任何connection的当前schema，默认是对应于该用户名的一个schema。如果无用户名被提供，那么当前用户名与当前schema缺省是APP。

      但即使当前schema被设置为用户名，这个schema仍然可能不存在。一个schema只能被创建：通过CREATE SCHEMA语句显式创建或者创建一个对象（例如表等）来隐式创建。

      APP schema总是存在，不需要创建。

      如果你的程序试图访问当前schema但该schema下没有创建任何对象，就会遇到“schema not exists”错误。[2]

      注释[编辑]

      1. ^ Compressing Apache Derby w/ Pack200. 昇阳. [2008-06-08]. （原始内容存档于2007-10-21）. 
      2. ^ Apache Derby数据库（即Java DB） Frequently Asked Questions 5.3. Why do I get the error 'schema does not exist'?. [2018-08-03]. （原始内容存档于2020-08-25）. 

      参见[编辑]

      外部链接[编辑]

      检索自“https://arolstar52-zhtest.hf.space/index.php?title=Apache_Derby&oldid=369322”