Derby的开始之旅

Getting start with Derby

version 10.2
来自http://db.apache.org/derby
翻译by wonderer http://blog.matrix.org.cn/page/wonderer

内容

   版权收有
   Derby的介绍
     部署选项
     系统要求
     Derby的库
   安装并且用Derby来工作
     安装Derby
     设置你的环境变量
     使用Derby工具和启动系列工具
        使用工具 sysinfo
        运行 ij
        设置类路径(classpath)
  有经验的JDBC用户的快速指南
      Derby能运行的环境
        嵌入式的环境
        客户/服务端的环境
      能用的驱动器
      数据库连接URL
  文档协定
      术语
      SQL语法
      技术协定

  Derby的库和脚本:全部参考目录
      Derby提供的库
      不是由Derby提供的库
      Derby已有的脚本

  商标

版权所有
   我翻译技术文档,这个就不翻译了, ^<>^

  Derby的介绍
      欢迎来到Derby的世界,Derby是一个基于Java(TM)和SQL的关系数据库管理系统(RDBMS),这一部分是介绍Derby的.
  部署选项
      你可以用很多不同的方法来部署Derby
      你部署的选项包括:
         -单用户嵌入式的java应用程序.因为不需要管理并同时可以工作跟应用程序工作在同一个虚拟机上,Derby对于最终用户可以说是几乎透明的.
         -多用户的嵌入式程序,例如网络服务器,一个应用程序服务器,或一个共享的开放环境.
         -服务器框架的嵌入式.你可以用网络客户端驱动器或者服务端驱动器,以使用网络服务.

  系统要求
      Derby是一个完全用java开发的数据库引擎.它可以运行在任意一个Java虚拟机里(JVM).

  Derby的库
      Derby的库包括了Derby指南和API参考
      Derby开发者指南
      描述了Derby对所有部署的共同的功能和特征,例如Derby的JDBC和SQL的细节,部署Derby应用程序,安全,

     和其他高级特性.

      Derby参考指南
      指明了Derby是集成了SQL语言的.同时也提供了Derby的JDBC和JTA执行,关键字,系统表,属性,和SQL异常的参考信息.
      调较Derby
      介绍了怎样通过属性来配置和调较Derby,并提供了属性的参考信息.同时也提供了性能提示,一个性能的 深入讨论,一个Derby最优化的信息.

      Derby工具指南
      一个用derby工具(例如ij,和其他一些如import/export更高级的工具,和数据库类装载器)来工作的指Derby服务器和管理指南
      这个指南的第一部分讨论了配置服务器,怎样来编客户端程序,和数据库的管理.
      另外,一些系统可能需要例如备份数据库这样的管理.这些任务依赖于一些服务器框架,但也是单独的多用户的大型系统.

      指南的第二部分讨论了如备份和调试死锁的管理问题.

      Derby API 文档
      有所有Derby公开类文件自动产生.(没有提供JDBC的API). 如果要更详细的信息,请参考Derby参考指南.

安装并且用Derby来工作
      如果你是一个Derby和JDBC的新手,这一部分会帮助你使用这个产品.如果你是一个有经验的JDBC程序员,请看有经验的JDBC用户的快速指南.

安装Derby
      要安装Derby,你必须先从Derby的网站下载Derby的zip或者tar包.
      用你的浏览器输入以下网址http://db.apache.org/derby/derby_downloads.html 这个下载页面提供了若干个Derby的发行版本,包括了版本快照和稳定版本二进制发行版本.你也可以找到教你用subversion来获得最新源码的信息.

发行版本有:
  --二进制发行版包括了代码,示例程序和文档.已经优化了的jar文档在lib目录下
  --lib发行版本包括了优化程序,部署Derby的最小jar的集合.
  --lib-debug发行版本包括了调试Derby和报告问题的有用的最大集合.
  --src发行版本包括了要来产生上面三个发行版的源文件.

 这个指南假定你会下载二进制发行版的.
 解压下载的包,之后有以下几个子目录:
  --demo包括了示例程序
  --bin包括了运行和设置环境的代码
  --javadoc包括了有源代码生产的aip文档
  --doc包括了Derby文档
  --lib包括了Derby的jar文件

设置你的环境变量

       你需要设置环境变量来是Derby二进制发行版的代码能够正常地运行.设置如下: 

 1.把DERBY_HOME设成你解压Derby二进制发行包的路径.如你把Derby安装在 c:\Derby_10 目录下,使用以下命令来设置环境变量

set DERBY_HOME=c:\Derby_10

2. 设置环境变量JAVA_HOME.JAVA_HOME是本地JVM和java应用程序要用到的环境变量.

UNIX

export JAVA_HOME=/usr/j2se

Windows

set JAVA_HOME=C:\Program Files\Java\j2se1.4.2_05

3.为了能在每个目录下都能运行Derby的代码,把DERBY_HOME/bin加到PATH变量下

UNIX

export PATH="$DERBY_HOME/bin:$PATH"

Windows

set PATH=%DERBY_HOME\bin;%PATH%

4.验证DERBY_HOME和JAVA_HOME是否设置成功,$DERBY_HOME/bin是否有正确加到PATH路径下,使用下面的命令:

sysinfo

如果环境变量设置成功,,命令sysinfo会显示你的JVM的信息和你安装的Derby的版本.

使用Derby工具和启动工具

在你开始用Derby工作是,有很多个工具供你使用.这些工具包括了dblook,ij,和sysinfo.你可以用Derby代码来启动Derby的工具.

有很多Derby的工具是系统的程序,你可以从ij那儿来呼出他们.例如,有系统程序要来导入或者导出外部文件的.在Derby参考指南了专门介绍了如何使用这些工具.

DERBY_HOME里的代码是设置来运行嵌入式模式的.如果要运行服务器形式,使用下面命令:

• 对于dblook,运行代码,用参数-d指定服务器的完整URL.例如,                                                                                     dblook -d 'jdbc:derby://localhost/myDB;user=usr;'
• 对于ij工具,运行命令 set DERBY_OPTS=-Dij.protocol=jdbc:derby://localhost/ ,然后启动ij.
• 对于工具sysinfo,运行命令 NetworkServerControl sysinfo

使用工具sysinfo

Derby的sysinfo工具,会显示你java的信息和Derby版本号.

在你把DERBY_HOME/bin加到PATH后,运行工具sysinfo.sysinfo会把环境变量配好的.包括classpath.你可以在命令行下运行命令

sysinfo

运行ij

你可以用ij工具连接你的Derby数据库.

在你运行ij之前,你必须要把DERBY_HOME/bin加到PATH变量里.

• 你可以通过以下命令运行ij工具

                  ij

                  这个命令会启动ij工具和设置向CLASSPATH这样的环境变量

• 用ij工具来创建数据库,可以用以下命令

                 ij> connect 'jdbc:derby:testdb;create=true';

                 这个命令会在当前目录下创建一个叫testdb的数据库,自动创建系统表,并连接到数据库.然后你就可以从ij命令行力来执行你要的数据库操作.

• 当你准备关闭ij工具时,可以用以下命令:

                ij>exit

设置classpath

你可以在你的操作系统临时的,或者设置一个永久的classpath环境变量,或者在你启动java应用程序的时候才设置.

在大多数开发环境中,最好是在命令行里临时设置classpath.在DERBY_HOME里,有很多工具可以帮助你很快地设置环境变量.

• setEmbeddedCP  当数据库引擎工作在嵌入式时,这个命令会把derby.jar和derbytool.jar加到classpath中
• setNetworkServerCP  把derby.jar和derbynet.jar加到classpath中
• setNetworkClientCP   把derby.jar和derbyclient.jar加到classpath中