derby ij命令

ij工具的目的是什么？

Apache Derby数据库（及其商业堂兄弟IBM®Cloudscape™）的位置非常适合嵌入到应用程序中。 它体积小巧，同时兼容Java™数据库连接（JDBC）和开放数据库连接（ODBC），并且建立在Java平台上，因此可在多种操作系统上使用。 但是，这种多功能性掩盖了其最强大的工具之一。

ij工具为完成诸如创建数据库和执行SQL语句之类的简单任务提供了一种简便的方法。 例如，您可以创建两个简单的数据库-一个用于保存项目，一个用于保存开发人员（请参见清单1 ）。

清单1.创建数据库和表

ij> connect 'jdbc:derby:projectDB;create=true;';
ij> create table projects (id integer,project_name varchar(75),status integer,comments varchar(255)
);
0 rows inserted/updated/deleted
ij> insert into projects values (1, 'Wheel O Fish', 0, 'Waiting forcontract');
1 row inserted/updated/deleted
ij> insert into projects values (2, 'Bass O Matic', 1, 'In production');
1 row inserted/updated/deleted
ij> insert into projects values (3, 'Patty O Furniture', -1, 'Needclarification
.  Does anybody know what this is?');
1 row inserted/updated/deleted
ij> connect 'jdbc:derby:developerDB;create=true;';
ij(CONNECTION1)> create table developers (id integer,developer_name varchar(75),availability varchar(255)
);
0 rows inserted/updated/deleted
ij(CONNECTION1)> insert into developers values (1, 'Jim Bacon', 'Open');
1 row inserted/updated/deleted
ij(CONNECTION1)> insert into developers values (2, 'Brady James', 'Open');
1 row inserted/updated/deleted
ij(CONNECTION1)> insert into developers values (3, 'Michelle Rappaport','Busy u
ntil October');
1 row inserted/updated/deleted
ij(CONNECTION1)> insert into developers values (4, 'Aaron Templeton', 'Ajoy every time we use him.  Hire him.');
1 row inserted/updated/deleted
ij(CONNECTION1)>

（是的，通常我们会将这些表放入同一个数据库中。为了演示概念，请纵容我。）

如果创建数据库，表和数据只是ij所能做的，那么它仍然会很有用。 但是事实并非如此。 ij使您能够执行许多您可能认为只能使用成熟的JDBC应用程序才能完成的任务，例如，操纵游标以及创建和执行准备好的语句。

但是首先，请注意在创建第二个数据库时ij是如何创建第二个连接的。 到projectDB的第一个连接仍处于活动状态，但是您需要明确告诉ij您要使用它。

让我们看看它是如何工作的。

连接和隔离级别

ij使您可以做的一件事就是控制整个数据库系统以及与数据库的连接。 例如，现在我们有两个数据库连接，我们可以使用SET CONNECTION命令在它们之间进行选择（参见清单2 ）。

清单2.在数据库连接之间进行选择

ij(CONNECTION1)> select * from projects;
ERROR 42X05: Table 'PROJECTS' does not exist.
ij(CONNECTION1)> show connections;
CONNECTION0 -   jdbc:derby:projectDB
CONNECTION1* -  jdbc:derby:developerDB
* = current connection
ij(CONNECTION1)> set connection connection0;
ij(CONNECTION0)> select * from projects;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
-----------------------------------------------------------------
1          |Wheel O Fish       |0          |Waiting for contract2          |Bass O Matic       |1          |In production3          |Patty O Furniture  |-1         |Need clarification.
Does anybody know what this is?3 rows selected

请注意，如果首先尝试从项目表中进行选择，那么即使该连接仍处于打开状态，也会收到错误消息，因为您当前正在使用与developerDB数据库的连接。 您可以通过发出show connections命令来查看。 要更改连接，请使用set connection命令，后跟数据库名称，如show connections所示。

ij还使您可以设置总体数据库属性。 例如，您可以为数据库设置derby.database.propertiesOnly属性，如下所示：

CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(
'derby.database.propertiesOnly', 'true');

此命令确保在此数据库上专门设置的任何属性（例如身份验证要求）都不会被整个系统配置中的其他值所覆盖。

Derby可以识别几十个系统属性，例如derby.database.defaultConnectionMode ， derby.authentication.ldap.searchAuthDN ， derby.authentication.ldap.searchAuthPW和derby.user.UserName 。

现在让我们看一下处理数据的一些方法。

使用游标

从数据库的一个或多个表中选择一组数据时，返回的数据称为游标。 （流行的传说认为这是“当前行集”的缩写。）有关隔离级别的文档始终都提到游标，但是您很少看到直接通过ij操作游标的讨论。 事实是，许多似乎需要操纵Java RecordSet的操作都可以使用游标直接在ij中完成。

只进游标

游标最简单的类型是firehose或仅向前游标。 该游标包含所有数据，使您可以在游标中的每个记录之间移动，但不能向后移动。 例如，参见清单3 。

清单3.只进游标

ij(CONNECTION0)> get cursor projectCursor as 'select * from projects';ij(CONNECTION0)> next projectCursor;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
---------------------------------------------------------------------
1          |Wheel O Fish       |0          |Waiting for contractij(CONNECTION0)> next projectCursor;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
---------------------------------------------------------------------
2          |Bass O Matic       |1          |In productionij(CONNECTION0)> next projectCursor;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
---------------------------------------------------------------------
3          |Patty O Furniture  |-1         |Need clarification.  Does
anybody know what this is?ij(CONNECTION0)> next projectCursor;
No current rowij(CONNECTION0)> previous projectCursor;

IJ ERROR: PREVIOUS仅向前的游标上不允许上一个。 在这里，您可以使用get cursor命令创建一个游标，并向它提供一个SQL语句，该语句代表您要包含的数据。 请注意，这里我只是从单个表中提取数据，但是您会变得像Derby在这些SQL语句中所允许的那样复杂。

有了光标后，您可以告诉它给您下一条记录，在这种情况下，它会按照SQL语句指定的顺序在记录列表中向下移动。 一旦到达最低点，ij就会告诉您不再有记录。 请注意，虽然您可以向下移动列表，但不能后退； 正如我之前所说，标准光标只能向前移动。 但这并不意味着您注定要始终朝一个方向前进。

滚动不敏感游标

有时仅向前的光标不够好，因为您想在记录之间移动。 为此，您可以创建一个对滚动不敏感的游标，如清单4所示 。

清单4.不滚动的游标

ij(CONNECTION0)> get scroll insensitive cursor projectScroll as
'select * from projects';
ij(CONNECTION0)> absolute 2 projectScroll;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
--------------------------------------------------------------------
2          |Bass O Matic       |1          |In productionij(CONNECTION0)> relative -1 projectScroll;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
--------------------------------------------------------------------
1          |Wheel O Fish       |0          |Waiting for contractij(CONNECTION0)> relative 2 projectScroll;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
--------------------------------------------------------------------
3          |Patty O Furniture  |-1         |Need clarification.  Does
anybody know what this is?ij(CONNECTION0)> previous projectScroll;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
--------------------------------------------------------------------
2          |Bass O Matic       |1          |In productionij(CONNECTION0)> before first projectScroll;
No current row
ij(CONNECTION0)> next projectScroll;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
--------------------------------------------------------------------
1          |Wheel O Fish       |0          |Waiting for contract

请注意，必须关闭自动提交才能使用对滚动不敏感的光标。

在这里，您可以使用get scroll insensitive光标命令，再次指定要包含的数据SQL语句。 有了对滚动不敏感的光标后，您将拥有更大的移动自由度。 您可以使用absolute命令跳至第二行，使用relative命令向前或向后移动指定的行数，移至上一行或下一行，或使用before first和after last命令将光标置于顶部或数据的底部。

可更新的游标

所有这些都很好，但是直接操作游标的真正价值在于能够在特定位置更新数据库。 例如，您可以遍历项目并根据当前光标位置更新其状态（请参见清单5 ）。

清单5.一个可更新的游标

ij(CONNECTION0)> autocommit off;
ij(CONNECTION0)> get cursor updateProjects as 'select * from projects for update';
ij(CONNECTION0)> next updateProjects;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
--------------------------------------------------------------------
1          |Wheel O Fish       |0          |Waiting for contractij(CONNECTION0)> update projects set status = 1, comments =
'Contract received, starting work.' where current of updateProjects;
1 row inserted/updated/deletedij(CONNECTION0)> next updateProjects;
ID         |PROJECT_NAME       |STATUS     |COMMENTS--------------------------------------------------------------------
2          |Bass O Matic       |1          |In productionij(CONNECTION0)> next updateProjects;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
--------------------------------------------------------------------
3          |Patty O Furniture  |-1         |Need clarification.  Does
anybody know what this is?ij(CONNECTION0)> delete from projects where current of updateProjects;
1 row inserted/updated/deleted
ij(CONNECTION0)> select * from projects;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
--------------------------------------------------------------------
1          |Wheel O Fish       |1          |Contract received,
starting work.
2          |Bass O Matic       |1          |In production2 rows selected
ij(CONNECTION0)> commit;
ij(CONNECTION0)> close updateProjects;

首先，在创建可更新的游标之前，必须绝对确定已关闭自动提交功能。 其次，可更新游标必须仅向前，并且必须在select语句中包含for update子句。

从那里开始，您可以像以前一样操作游标，但是您也可以执行update和delete语句，这些语句将游标的当前位置（而不是任何特定的数据要求）作为where子句。

最后，完成操作后，关闭光标以释放资源。

使用准备好的语句

通常不与命令行关联的另一个任务是使用准备好的语句。 重新编译准备好的语句以提高性能，并且在您需要一遍又一遍地执行相同操作时很方便。 例如，您可以创建一条语句，将所有当前开发人员设置为可用状态，如清单6所示 。

清单6.准备一条语句

ij(CONNECTION0)> set connection connection1;
ij(CONNECTION1)> prepare allDevelopersOpen as 'update developers set availability = ''open''';
ij(CONNECTION1)> execute allDevelopersOpen;
4 rows inserted/updated/deleted
ij(CONNECTION1)> select * from developers;
ID         |DEVELOPER_NAME       |AVAILABILITY
--------------------------------------------------------
1          |Jim Bacon            |open2          |Brady James          |open3          |Michelle Rappaport   |open4          |Aaron Templeton      |open4 rows selected
=

在这里，您可以切换回另一个连接，并使用特定的硬编码SQL语句创建一个准备好的语句，然后执行它。

但是，更有用的是创建一个可用于不同行和不同值的语句，如清单7所示。

清单7.具有值的准备好的语句

ij(CONNECTION1)> prepare updateOneDeveloper as 'update developers set availability = ? where id = ?';
ij(CONNECTION1)> execute updateOneDeveloper using 'VALUES (''Im really serious here.  Hire this guy!'', 4)';
1 row inserted/updated/deleted
ij(CONNECTION1)> commit;
ij(CONNECTION1)> select * from developers;
ID         |DEVELOPER_NAME       |AVAILABILITY
--------------------------------------------------------
1          |Jim Bacon            |open2          |Brady James          |open3          |Michelle Rappaport   |open4          |Aaron Templeton      |Im really serious here.  Hire this
guy!4 rows selected

与JDBC应用程序中的预处理语句一样，值将按语句中出现的顺序替换为每个占位符。

您甚至可以创建可与多组数据一起使用的准备好的语句（请参见清单8 ）。

清单8.具有多组值的准备好的语句

ij(CONNECTION1)> prepare addDeveloper as 'insert into developers values (?, ?, ?)';
ij(CONNECTION1)> execute addDeveloper using 'VALUES (5, ''Corben Deeto'', ''Available this summer''), (6, ''Seetha Pio'', ''Open'')';
1 row inserted/updated/deleted
1 row inserted/updated/deleted
ij(CONNECTION1)> select * from developers;
ID         |DEVELOPER_NAME       |AVAILABILITY
--------------------------------------------------------------------
1          |Jim Bacon            |open2          |Brady James          |open3          |Michelle Rappaport   |open4          |Aaron Templeton      |Im really serious here.  HIRE this
guy!5          |Corben Deeto         |Available this summer6          |Seetha Pio           |Open6 rows selected

将准备好的语句与游标一起使用

也许最有用的预处理语句是那些不仅接受输入值，而且还对游标的当前行进行操作的语句。 例如，您可以创建一条仅影响当前开发人员的语句（请参见清单9 ）。

清单9.具有可更新游标的准备好的语句

ij(CONNECTION1)> get cursor updateDevelopers as 'select * from developers for update';
ij(CONNECTION1)> prepare busyDeveloper as 'update developers set availability = ''Busy'' where current of updateDevelopers';
ij(CONNECTION1)> next updateDevelopers;
ID         |DEVELOPER_NAME       |AVAILABILITY
--------------------------------------------------------
1          |Jim Bacon            |openij(CONNECTION1)> next updateDevelopers;
ID         |DEVELOPER_NAME       |AVAILABILITY
--------------------------------------------------------
2          |Brady James          |openij(CONNECTION1)> execute busyDeveloper;
1 row inserted/updated/deleted
ij(CONNECTION1)> next updateDevelopers;
ID         |DEVELOPER_NAME       |AVAILABILITY
--------------------------------------------------------
3          |Michelle Rappaport   |openij(CONNECTION1)> next updateDevelopers;
ID         |DEVELOPER_NAME       |AVAILABILITY
--------------------------------------------------------
4          |Aaron Templeton      |Im really serious here.  HIRE
this guy!ij(CONNECTION1)> execute busyDeveloper;
1 row inserted/updated/deleted
ij(CONNECTION1)> select * from developers;
ID         |DEVELOPER_NAME       |AVAILABILITY
--------------------------------------------------------
1          |Jim Bacon            |open
2          |Brady James          |Busy
3          |Michelle Rappaport   |open
4          |Aaron Templeton      |Busy
5          |Corben Deeto         |Available this summer
6          |Seetha Pio           |Open6 rows selected
ij(CONNECTION1)>

从技术上讲，您在这里没有做任何不同的事情。 您创建可更新的游标和准备好的语句。 关键在于，prepared语句中SQL语句引用游标的当前位置，因此您可以多次执行游标并更新不同的行。 这里的任务可能微不足道，但这就像跨多个表，执行触发器等SQL语句一样容易。

运行ij脚本

如果不实际讨论ij脚本的运行，那么关于ij脚本的文章是不完整的。 ij脚本本质上是文件中ij命令的编译，然后您可以将其馈送到ij应用程序。 例如，您可以创建一个脚本，以添加许多新的开发人员和项目（请参见清单10 ）：

清单10.添加新开发人员和项目的脚本

connect 'jdbc:derby:projectDB;';insert into projects values (4, 'Movie Addict', 0, 'Waiting for contract');
insert into projects values (5, 'Tree Huggers Anonymous', 0,
'Waiting for contract');select * from projects;connect 'jdbc:derby:developerDB;';insert into developers values (7, 'Frank Stein', 'Busy');
insert into developers values (8, 'Wolff Mann', 'Open');select * from developers;

脚本本身非常简单，只需执行您可能从命令行访问的相同类型的命令即可。

要运行脚本，您有几种选择。 首先是从ij应用程序本身运行它（请参见清单11 ）。

清单11.从ij应用程序中运行ij脚本

ij> run 'C:\myScripts\derbyscript.sql';
ij> connect 'jdbc:derby:projectDB;';
ij> insert into projects values (4, 'Movie Addict', 0,
'Waiting for contract');
1 row inserted/updated/deleted
ij> insert into projects values (5, 'Tree Huggers Anonymous', 0,
'Waiting for contract');
1 row inserted/updated/deleted
ij> select * from projects;
ID         |PROJECT_NAME          |STATUS     |COMMENTS
--------------------------------------------------------------------
1          |Wheel O Fish          |1          |Contract received,
starting work.2          |Bass O Matic          |1          |In production4          |Movie Addict          |0          |Waiting for contract5          |Tree Huggers Anonymous|0          |Waiting for contract4 rows selected
ij> connect 'jdbc:derby:developerDB;';
ij(CONNECTION1)> insert into developers values (7, 'Frank Stein',
'Busy');
1 row inserted/updated/deleted

注意，ij回显每个命令。

另一个替代方法是在首次启动ij应用程序时引用脚本，实际上是用文件内容替换stdin （请参见清单12 ）：

清单12.将ij脚本提供给ij应用程序

C:\SW\db-derby-10.1.2.1-bin\frameworks\embedded\bin>java
-Djdbc.drivers=org.apache.derby.jdbc.EmbeddedDriverorg.apache.derby.tools.ij derbyscript.sql
ij version 10.1
ij> connect 'jdbc:derby:projectDB;';
ij> insert into projects values (4, 'Movie Addict', 0,
'Waiting for contract');
1 row inserted/updated/deleted
ij> insert into projects values (5, 'Tree Huggers Anonymous', 0,
'Waiting for contract');
1 row inserted/updated/deleted
ij> select * from projects;
ID         |PROJECT_NAME       |STATUS     |COMMENTS
--------------------------------------------------------------------
1          |Wheel O Fish       |1          |Contract received, starting work.2          |Bass O Matic       |1          |In production

脚本完成后，ij应用程序退出。 从ij本身运行脚本时，情况并非如此。

在这种情况下，程序将继续正常运行，直到有人键入exit为止。

在某些情况下，您需要保存在ij中运行的脚本的输出。 为此，只需将输出重定向到文件，或使用ij.outputfile属性（请参见清单13 ）：

清单13.将ij脚本的输出保存到文件中

java -Djdbc.drivers=org.apache.derby.jdbc.EmbeddedDriver
-Dij.outfile=results.txt org.apache.derby.tools.ij
derbyscript.sql

请注意，如果将输出重定向到文件，则不会在命令行上看到它。

摘要

在本文中，您了解了Apache Derby项目随附的ij管理工具的一些较少使用的功能。 除了创建数据库和执行屏幕捕获的常规功能外，ij还使您可以创建和操作仅向前和对滚动不敏感的游标以及对其进行更新。 您可以创建和执行准备好的语句，也可以创建和运行外部脚本。 所有这些功能都可以组合在一起，以在ij中创建一个功能相当实用的应用程序权限，而无需构建任何外部基础结构。

翻译自: https://www.ibm.com/developerworks/opensource/library/os-ad-ij/index.html

derby ij命令