PointBase 嵌入式資料庫配置與管理完整手冊

核心三大 JAR 包

• `pbclient.jar` — JDBC Client 驅動 (網路連線模式)
• `pbembedded.jar` — 嵌入式引擎 (同進程、無網路開銷)
• `pbtools.jar` — 管理工具 (Console/Commander)

環境變數設定腳本 (setPBEnv.bat / .sh)

# Windows: setPBEnv.bat
set PB_HOME=D:\Devs\pointbase
set OLDCP=%CLASSPATH%
set CLASSPATH=%PB_HOME%\lib\pbclient.jar
set CLASSPATH=%CLASSPATH%;%PB_HOME%\lib\pbembedded.jar
set CLASSPATH=%CLASSPATH%;%PB_HOME%\lib\pbtools.jar
set CLASSPATH=%CLASSPATH%;%OLDCP%

# Linux/Unix: setPBEnv.sh
export PB_HOME=/opt/pointbase
export CLASSPATH=$PB_HOME/lib/pbclient.jar:$PB_HOME/lib/pbembedded.jar:$PB_HOME/lib/pbtools.jar:$CLASSPATH

啟動 PointBase Server

java com.pointbase.net.NetServer [參數]

# 關鍵參數
/win          : 視窗模式啟動 (Windows)
/d:0-3        : JDBC 訊息詳細等級 (3 最詳細)
/database:name: 開啟指定資料庫
/port:N       : 監聽埠 (預設 9092)
/file:path    : Log 檔路徑
/pointbase.ini: 指定 ini 檔路徑
/help         : 顯示說明

啟動腳本範例 (startServer.bat)

call setPBEnv.bat
java com.pointbase.net.NetServer /port:9999 /d:3

兩大管理工具 (需 Server 先啟動)

1. PointBase Console — GUI 工具

功能：建立資料庫、執行/除錯 SQL、結果顯示、匯入匯出、建立文字過濾器

# startConsole.bat
call setPBEnv.bat
java -Ddatabase.home="%PB_HOME%\databases" ^
     -Dpointbase.ini="%PB_HOME%\databases\pointbase.ini" ^
     com.pointbase.tools.toolsConsole

2. PointBase Commander — 命令列工具

功能：建表、執行 SQL 腳本、批次操作、自動化部署腳本整合

# startCommander.bat
call setPBEnv.bat
java -Ddatabase.home="%PB_HOME%\databases" ^
     -Dpointbase.ini="%PB_HOME%\databases\pointbase.ini" ^
     com.pointbase.tools.toolsCommander

JDBC 連線字串

pointbase.ini 關鍵配置

# pointbase.ini 範例
database.home=databases
database.pagesize=8192
database.cache.size=2000
database.buffers=100
database.transaction.log=transaction.log
database.backup.directory=backup

整合到 J2EE / WebLogic / JBoss

# DataSource 配置要點
Driver: com.pointbase.jdbc.jdbcUniversalDriver
URL: jdbc:pointbase:server://localhost:9092/mydb
User: PBPUBLIC
Password: PBPUBLIC

# 連線池建議
Initial: 5, Max: 20, Timeout: 30s
Test Query: SELECT 1 FROM SYSTABLES

常見操作指令 (Commander 模式)

# 連線
CONNECT 'jdbc:pointbase:server://localhost:9092/mydb' USER 'PBPUBLIC' PASSWORD 'PBPUBLIC';

# 執行 SQL 檔
RUN 'schema.sql';

# 匯出資料
UNLOAD TABLE mytable TO 'mytable.csv' FORMAT CSV;

# 備份資料庫
BACKUP DATABASE TO 'backup.zip';

# 離開
QUIT;

效能調優建議

• 頁面大小 `pagesize`：8KB 標準，大物件 (BLOB/CLOB) 考慮 16/32KB
• 快取大小 `cache.size`：依記憶體給予，嵌入模式可佔用較大
• 交易日誌同步：高寫入場景考慮 `SYNC=FALSE` (風險：崩潰可能丟資料)
• 索引策略：外鍵欄位必建索引、複合索引符合查詢順序

遷移提醒：PointBase 已停止維護

PointBase 於 2010 年代停止更新。現代替代方案：