Derby 工具 · ZetCode 中文系列教程

# Derby 工具 > 原文： [http://zetcode.com/db/apachederbytutorial/tools/](http://zetcode.com/db/apachederbytutorial/tools/) 在本章中，我們提到了 Derby 工具。 Derby 工具和工具是 Derby 隨附的一組腳本。它們通常用于創建，檢查和更新 Derby 數據庫。在此頁面中，我們將提及`sysinfo`，`dblook`，`ij`，`startNetworkServer`和`stopNetworkServer`工具。 ## 啟動 Derby 工具 Derby 工具可以兩種方式運行。我們使用位于 Derby 安裝目錄的 bin 目錄中的腳本名稱，也可以使用`derbyrun.jar`文件啟動它們。 ```java $ $DERBY_HOME/bin/ij $ java -jar $DERBY_HOME/lib/derbyrun.jar ij ``` 我們可以通過在終端中指定腳本名稱來啟動`ij`工具。第二行使用`derbyrun.jar`文件運行`ij`。 ## 系統信息 `sysinfo`工具提供有關操作系統，Java 和 Derby 的信息。它將打印 Java 版本，Java 主目錄，操作系統版本，Java 運行時版本，Derby 版本，當前和支持的語言環境。該工具對于跟蹤 Derby 的某些安裝或配置問題很有用。 ```java $ $DERBY_HOME/bin/sysinfo ------------------ Java Information ------------------ Java Version: 1.8.0_111 Java Vendor: Oracle Corporation Java home: /home/janbodnar/bin/jdk1.8.0_111/jre Java classpath: /home/janbodnar/bin/jdk1.8.0_111/db/lib/derby.jar:/home/janbodnar/bin/jdk1.8.0_111/db/lib/derbynet.jar:/home/janbodnar/bin/jdk1.8.0_111/db/lib/derbytools.jar:/home/janbodnar/bin/jdk1.8.0_111/db/lib/derbyoptionaltools.jar:/home/janbodnar/bin/jdk1.8.0_111/db/lib/derbyclient.jar OS name: Linux OS architecture: amd64 OS version: 4.4.0-66-generic ... ``` 這是特定系統上提供的信息的摘錄。 ## ij `ij`是一個交互式腳本工具。它用于對 Derby 數據庫運行腳本或交互式查詢。 ```java $ cat cars.sql SET SCHEMA USER12; CREATE TABLE CARS(ID BIGINT NOT NULL PRIMARY KEY GENERATED ALWAYS AS IDENTITY (START WITH 1, INCREMENT BY 1), NAME VARCHAR(30), PRICE INT); INSERT INTO CARS(Name, Price) VALUES('Audi', 52642); INSERT INTO CARS(Name, Price) VALUES('Mercedes', 57127); INSERT INTO CARS(Name, Price) VALUES('Skoda', 9000); INSERT INTO CARS(Name, Price) VALUES('Volvo', 29000); INSERT INTO CARS(Name, Price) VALUES('Bentley', 350000); INSERT INTO CARS(Name, Price) VALUES('Citroen', 21000); INSERT INTO CARS(Name, Price) VALUES('Hummer', 41400); INSERT INTO CARS(Name, Price) VALUES('Volkswagen', 21600); ``` 我們有一個`cars.sql`文件，它創建一個數據庫模式和一個`CARS`表。 ```java $ $DERBY_HOME/bin/ij ij version 10.11 ij> CONNECT 'jdbc:derby:testdb;user=user12;create=true'; ``` 我們啟動`ij`工具。我們創建一個`testdb`數據庫并建立連接。 ```java ij> SHOW CONNECTIONS; CONNECTION0* - jdbc:derby:testdb * = current connection ``` `SHOW CONNECTIONS`語句顯示與 Derby 數據庫的打開的連接。 ```java ij> RUN 'cars.sql'; ij> CREATE SCHEMA USER12; 0 rows inserted/updated/deleted ij> CREATE TABLE CARS(ID INT PRIMARY KEY, NAME VARCHAR(30), PRICE INT); 0 rows inserted/updated/deleted ij> INSERT INTO CARS VALUES(1, 'Audi', 52642); 1 row inserted/updated/deleted ij> INSERT INTO CARS VALUES(2, 'Mercedes', 57127); 1 row inserted/updated/deleted ij> INSERT INTO CARS VALUES(3, 'Skoda', 9000); ... ``` 我們加載并執行`cars.sql`網站。我們被告知正在進行的操作。 ```java ij> SELECT * FROM CARS; ID |NAME |PRICE ------------------------------------------------------ 1 |Audi |52642 2 |Mercedes |57127 3 |Skoda |9000 4 |Volvo |29000 5 |Bentley |350000 6 |Citroen |21000 7 |Hummer |41400 8 |Volkswagen |21600 8 rows selected ``` 我們從`CARS`表中選擇所有行。 ```java ij> CONNECT 'jdbc:derby:testdb;shutdown=true'; ERROR 08006: Database 'testdb' shutdown. ``` 在 Derby 中關閉數據庫會導致異常。預期錯誤 08006。 ```java ij> SHOW CONNECTIONS; No current connection ``` 連接已關閉。 ```java ij> EXIT; ``` 我們使用`EXIT`命令退出`ij`工具。請注意，每個命令后都有分號。 ## dblook `dblook`工具用于保存數據庫對象的數據定義語言，包括表，視圖，索引和觸發器。 ```java $DERBY_HOME/bin/dblook -d jdbc:derby:testdb -- Timestamp: 2017-03-13 20:05:43.281 -- Source database is: testdb -- Connection URL is: jdbc:derby:testdb -- appendLogs: false -- ---------------------------------------------- -- DDL Statements for schemas -- ---------------------------------------------- CREATE SCHEMA "USER12"; -- ---------------------------------------------- -- DDL Statements for tables -- ---------------------------------------------- CREATE TABLE "USER12"."CARS" ("ID" INTEGER NOT NULL, "NAME" VARCHAR(30), "PRICE" INTEGER); CREATE TABLE "APP"."CARS" ("ID" BIGINT NOT NULL GENERATED ALWAYS AS IDENTITY (START WITH 1, INCREMENT BY 1), "NAME" VARCHAR(30), "PRICE" INTEGER); -- ---------------------------------------------- -- DDL Statements for keys -- ---------------------------------------------- -- PRIMARY/UNIQUE ALTER TABLE "APP"."CARS" ADD CONSTRAINT "SQL170313140819740" PRIMARY KEY ("ID"); ALTER TABLE "USER12"."CARS" ADD CONSTRAINT "SQL170313200304680" PRIMARY KEY ("ID"); ``` 在上面的示例中，我們已從`testdb`數據庫中轉儲了對象。使用`-d`選項，我們提供了數據庫的連接 URL。在我們的案例中，`dblook`工具保存了一個數據庫架構和一個表。使用`-o`選項，可以將輸出重定向到文件。 ## `startNetworkServer`和`stopNetworkServer` 這些腳本啟動和停止 Derby Network 服務器。如果是聯網服務器，則可以創建到 Derby 數據庫的多個連接。 ```java $ $DERBY_HOME/bin/startNetworkServer & [1] 12421 $ Mon Mar 13 20:12:39 CET 2017 : Security manager installed using the Basic server security policy. Mon Mar 13 20:12:40 CET 2017 : Apache Derby Network Server - 10.11.1.2 - (1629631) started and ready to accept connections ``` 在這里，我們使用`startNetworkServer`腳本啟動 Derby Network Server。 ```java ij> CONNECT 'jdbc:derby://localhost:1527/testdb'; ``` 在這里，我們通過 Derby Network Server 連接到`testdb`數據庫。網絡連接的連接 URL 是不同的。 ```java ij> SELECT * FROM USER12.CARS; ID |NAME |PRICE ------------------------------------------------------ 1 |Audi |52642 2 |Mercedes |57127 3 |Skoda |9000 4 |Volvo |29000 5 |Bentley |350000 6 |Citroen |21000 7 |Hummer |41400 8 |Volkswagen |21600 8 rows selected ``` 我們從`CARS`表中選擇所有汽車。由于我們沒有在連接 URL 中提供數據庫模式，因此我們現在必須指定它。數據庫模式是用戶名；在我們的情況下`USER12`。 ```java $ $DERBY_HOME/bin/stopNetworkServer Mon Mar 13 20:15:42 CET 2017 : Apache Derby Network Server - 10.11.1.2 - (1629631) shutdown $ Mon Mar 13 20:15:42 CET 2017 : Apache Derby Network Server - 10.11.1.2 - (1629631) shutdown ``` 我們已經使用`stopNetworkServer`腳本停止了服務器。 ## `NetworkServerControl` `NetworkServerControl`是一個系統工具，可以啟動和停止 Derby 網絡服務器并配置或檢索診斷信息。除`ping`以外，所有命令只能從運行服務器的計算機上執行。 ```java $ $DERBY_HOME/bin/NetworkServerControl start & ``` 使用`start`命令，我們啟動 Derby 服務器。 ```java $ $DERBY_HOME/bin/NetworkServerControl ping Tue Mar 21 15:53:29 CET 2017 : Connection obtained for host: localhost, port number 1527. ``` `ping`命令測試 Derby 服務器是否已啟動。 ```java $ $DERBY_HOME/bin/NetworkServerControl sysinfo --------- Derby Network Server Information -------- Version: CSS10110/10.11.1.2 - (1629631) Build: 1629631 DRDA Product Id: CSS10110 -- listing properties -- derby.drda.traceDirectory=/home/janbodnar/.derby/ derby.drda.maxThreads=0 derby.drda.sslMode=off derby.drda.keepAlive=true ... ``` `sysinfo`命令提供系統信息。 ```java $ $DERBY_HOME/bin/NetworkServerControl runtimeinfo --- Derby Network Server Runtime Information --- ---------- Session Information --------------- Session # :3 ------------------------------------------------------------- # Connection Threads : 1 # Active Sessions : 1 # Waiting Sessions : 0 Total Memory : 78643200 Free Memory : 75359512 ``` `runtimeinfo`命令提供有關正在運行的網絡服務器的會話，線程，預備語句以及內存使用的大量調試信息。 ```java $ $DERBY_HOME/bin/NetworkServerControl shutdown Tue Mar 21 15:56:43 CET 2017 : Apache Derby Network Server - 10.11.1.2 - (1629631) shutdown Tue Mar 21 15:56:44 CET 2017 : Apache Derby Network Server - 10.11.1.2 - (1629631) shutdown ``` `shutdown`命令停止 Derby 服務器。在本章中，我們寫了有關 Derby 工具的文章。