Apache Derby Bài 05: Khám phá thư mục cài đặt Derby và các công cụ dòng lệnh đi kèm

1. Cấu trúc cây thư mục của bản phân phối Apache Derby

Sau khi giải nén tệp lưu trữ nhị phân (db-derby-X.Y.Z-bin), cấu trúc thư mục tiêu chuẩn của Derby được bố trí trực quan theo từng phân vùng chức năng:

Plaintext

db-derby-X.Y.Z-bin/
├── bin/          # Các script dòng lệnh thực thi trên Windows (.bat) và Linux/Unix (.sh / không đuôi)
├── lib/          # Toàn bộ các gói thư viện Java Archive (.jar) của engine, client, server, tools
├── demo/         # Mã nguồn ví dụ mẫu bằng Java minh họa các kịch bản sử dụng
├── javadoc/      # Tài liệu API dạng HTML dành cho nhà phát triển
├── test/         # Các kịch bản kiểm thử (test suite) của Derby
├── docs/         # Tài liệu hướng dẫn sử dụng chi tiết (User Guides, Reference Manuals)
├── LICENSE       # Giấy phép mã nguồn mở Apache 2.0
├── NOTICE        # Thông báo bản quyền và xuất xứ nguồn gốc
└── README-FIRST  # Hướng dẫn nhanh cho người dùng mới

2. Giải mã các file thư viện trong thư mục lib/

Thư mục lib/ là "trái tim" của Apache Derby. Để tối ưu dung lượng phân phối khi tích hợp vào ứng dụng Java, bạn chỉ cần chọn lọc đúng các file JAR tương ứng với kiến trúc mong muốn thay vì nạp toàn bộ.

3. Bộ công cụ dòng lệnh (CLI Tools) trong thư mục bin/

Trong thư mục bin/, mỗi công cụ thường đi kèm 2 phiên bản: script file chạy trên nền tảng Unix/Linux (như ij, sysinfo) và tệp batch chạy trên Windows (như ij.bat, sysinfo.bat).

+-------------------------------------------------------------------------+
|                       Các công cụ CLI trong bin/                        |
+-------------------+--------------------+--------------------------------+
|  Công cụ quản trị |  Công cụ truy vấn  |     Công cụ máy chủ mạng       |
|    & Chuẩn đoán   |    & Trích xuất    |                                |
|  - sysinfo        |    - ij            |     - startNetworkServer       |
|                   |    - dblook        |     - stopNetworkServer        |
+-------------------+--------------------+--------------------------------+

1. ij (Interactive SQL Tool)

• Chức năng: Trình thông dịch lệnh SQL tương tác qua Terminal, tương đương với psql của PostgreSQL hoặc mysql client của MySQL.

• Tác vụ hỗ trợ: Kết nối database qua JDBC URL, tạo bảng, chèn/xóa/sửa dữ liệu, quản lý giao dịch, và thực thi các file kịch bản SQL hàng loạt (run 'script.sql';).

2. sysinfo (System Information)

• Chức năng: Tiện ích kiểm tra môi trường chạy của JVM và tình trạng của các thư viện Derby.

• Tác dụng: Giúp phát hiện nhanh xung đột phiên bản JDK, thiếu file JAR trong biến CLASSPATH, hoặc đường dẫn DERBY_HOME trỏ sai thư mục.

3. dblook (Schema DDL Dumper)

• Chức năng: Trích xuất cấu trúc định nghĩa dữ liệu (DDL - Data Definition Language) từ một database Derby sẵn có ra file văn bản hoặc màn hình console.

• Cú pháp sử dụng:

  Bash

  dblook -d "jdbc:derby:ten_csdl" -o schema_backup.sql
  
  

• Kết quả: Sinh ra toàn bộ các câu lệnh CREATE TABLE, CREATE INDEX, CREATE TRIGGER, ALTER TABLE cần thiết để tái tạo lại bộ khung database.

4. startNetworkServer & stopNetworkServer

• startNetworkServer: Khởi chạy một tiến trình JVM chạy nền đóng vai trò là Derby Network Server lắng nghe trên IP và cổng mạng mặc định (localhost:1527). Có thể truyền thêm tham số -h <host> -p <port>.

• stopNetworkServer: Gửi tín hiệu ngắt an toàn đến máy chủ Derby đang chạy để đóng các tệp dữ liệu, giải phóng file lock db.lck và kết thúc tiến trình sạch sẽ.

4. Tóm tắt

• Việc hiểu rõ vai trò của từng tệp trong thư mục lib/ giúp bạn cấu hình tệp pom.xml (Maven) hoặc build.gradle chuẩn xác: chỉ cần kéo derby.jar cho ứng dụng nhúng hoặc derbyclient.jar cho ứng dụng kết nối từ xa.

• Thư mục bin/ cung cấp đầy đủ các tiện ích độc lập mà không cần phải cài thêm bất kỳ phần mềm bên thứ ba nào.

Trong bài kế tiếp, chúng ta sẽ bắt tay thực hành trực tiếp với công cụ quan trọng nhất: Apache Derby Bài 06: Thực hành công cụ ij: Kết nối và tạo cơ sở dữ liệu đầu tiên.