本文假定您已经根据在unixlinux平台上应用berkeley db 11gr2sql成功编译了DBSQL.

最后,需要特别强调的是,在做存储引擎转换和数据迁移前,必须做好用户数据的备份,以防操作不慎或其它意外造成的数据损坏.

Firefox 3.6 on Linux

Firefox distributions do not link to external/system sqlite3 lib. So we have to rebuild firefox from source code to force it to link system sqlite3 by “–enable-system-sqlite”

1. Install sqlite-3.6.22
We need original sqlite3 because we have to migrate existing database.

Download http://www.sqlite.org/sqlite-3.6.22.tar.gz

tar zxf sqlite-3.6.22.tar.gz
env CFLAGS="-DSQLITE_SECURE_DELETE=1" ./configure --prefix=/usr
make
sudo make install

2. Build Firefox 3.6
Note:This step may replace your system Firefox. Please backup your ~/.mozilla at first.
Get source code

mkdir $HOME/src/firefox-3.6
hg clone http://hg.mozilla.org/mozilla-central/ src
cd $HOME/src/firefox-3.6

Create a file “mozconfig” in current directory. Content of file “mozconfig”:

mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/objdir-ff-release
ac_add_options --enable-system-sqlite
ac_add_options --disable-ogg
ac_add_options --disable-wave
ac_add_options --disable-crashreporter
ac_add_options --disable-necko-wifi

Build

make -f client.mk
sudo make -f client.mk install

3. Buid BDB SQL
Place up-to-date db source code on $HOME/hg/db_x86

cd $HOME/hg/db_x86/build_unix
env CFLAGS="-O3" ../dist/configure --enable-sql_compat --enable-sql
make dbsql && make install

4. Modify Firefox linking

cd /usr/local/lib/firefox-3.7a2pre
sudo ln -sf $HOME/install/lib/libdb_sql-5.0.so libsqlite3.so.0

5. Data Migration
(The directory name on my computer is “yezkdh8w.default”. It may be different in your platform)
Here is an example for data migration. Here we just take downloads.sqlite as example. You may need to go through all *.sqlite files:

cd ~/.mozilla/firefox/
cp yezkdh8w.default yezkdh8w.default.bak -r # backup
cd yezkdh8w.default
bash ../firefox_convert.sh /usr/bin/sqlite3 /home/rucong/install/bin/dbsql
$ sqlite3 downloads.sqlite
SQLite version 3.6.22
Enter ".help" for instructions
sqlite> .echo ON
sqlite> .output dump
.output dump
sqlite> .dump
.dump
sqlite> .quit
.quit
$ mv downloads.sqlite downloads.sqlite.bak
$ ~/hg/db_x86/build_unix/dbsql downloads.sqlite
Berkeley DB 11g Release 2, library version 11.2.5.0.21: (March 30, 2010)
Enter ".help" for instructions
Enter SQL statements terminated with a ";"
dbsql> .read dump
dbsql> .quit
$ rm dump

6. End
That’s all. Execute the new Firefox to see how it works.

SQLite Manager

1. Install SQLite Manager
Use above Firefox to visit SQLite Manager Plugin and install it.
Restart Firefox. We can start SQLite Manager by Menu->Tools->SQLite Manager now.

2. Open a BDB SQL Database

Generate database
Note: The version of BDB SQL has to be the same as the one we applied in Firefox.

cd db/build_unix
make ex_sql_binding
./ex_sql_binding

Now we get BDB SQL database ex_sql_binding.db.

Use SQLite Manager to open the generated db

Start SQLite Manager to open database db/build_unix/ex_sql_binding.db:

This guide describes how to apply DBSQL JDBC Driver in integrated development environment ADF/JDeveloper step by step.
Environment:

• OS: Windows XP 32bit
• ADF Business Components: 11.1.1.56.60
• Java(TM) Platform: 1.6.0_18
• JDeveloper: 11g Release 1(11.1.1.3.0)

1. Installing the Berkeley DB

• Make sure that the Java environment you apply in the building should be the same as ADF/JDeveloper’s.
• Refer to http://www.oracle.com/technology/documentation/berkeley-db/db/installation/build_win_sql.html for instructions about building JDBC Driver on Windows platform. The Release build option is recommended.
• Add the dll path into system PATHenvironment variable, e.g. add D:\jdbc\db-5.0.21\build_windows\Win32\Release to your %PATH%

2. Create JDBC Connection in JDeveloper

2.1 Select File->new->General->Connections->Database Connection and fill in the form like Figure 1. Select button “new” to create new driver SQLiteJDBCDriver(see following Figure 2).
Figure 1

2.2 Create a new driver SQLiteJDBCDriver. You should back to Figure 1 after clicking button “OK”.
Figure 2

2.3 You can use button “Test Connection” to test the setting in Figure 1. If you encounter NullPointerException, please refer following section “Troubleshooting 4.1″

2.4 Create an empty project(or open an existing project). Select Edit->properties->Libraries Classpath to add the registered DBSQL_JDBC:
Figure 3

3. Running the JDBC Sample Code

This chapter only shows how to run the JDBC samples downloaded from Sun (now belongs to Oracle) Developer Network. You can skip this chapter if you already have a test environment.

3.1 Downloading JDBC sample code from Sun
You can download the JDBC sample code from Sun Developer Network. See “JDBC programming examples from all three editions (ZIP format)” at http://java.sun.com/products/jdbc/reference/codesamples/index.html.

3.2 Modifications Needed
Create an empty project and add all JDBC sample code into it. You will definitely need to:

• Replace Class.forName(“myDriver.ClassName”) in all sample code files with Class.forName(“SQLite.JDBCDriver”)
• Replace “jdbc:mySubprotocol:myDataSource” in all sample code files with jdbc:sqlite:/D:\\example.db
• Change the variable name “enum” in OutputApplet.java to “enum1″, since as “enum” is a keyword in some Java environment, and may not be used as an identifier. Otherwise, you may encounter “Error(87,31): as of release 5, ‘enum’ is a keyword, and may not be used as an identifier”

3.3 Running examples

Other examples does not work because BDSQL JDBC driver does not support User-defined type or something like that.

Take SQLStatement.java for example, since it depends on “InsertCoffees(or BatchUpdate) and InsertSuppliers”, further more, “InsertCoffees(or BatchUpdate)” again depends on “CreateCoffees”, and “InsertSuppliers” depends on “CreateSuppliers”, so one reasonable sequence to run the SQLStatement example looks like this:

Execute CreateCoffee.java
Execute CreateSuppliers.java
Execute InsertCoffee.java
Execute InsertSuppliers.java
Execute SQLStatement.java

Finally, we can get result like below:

Row 1:
   Column 1:  Acme, Inc.
   Column 2:  Colombian

Row 2:
   Column 1:  Acme, Inc.
   Column 2:  Colombian_Decaf

Process exited with exit code 0.

Here is a screenshot of the execution result of the SQLStatement
Figure 4

4. Troubleshooting

4.1 Edit db_sql_jdbc.vsproj for different JDK environemt
If you encounter one of following issues:

• Encounter NullPointerException in JDeveloper JDBCconnection testing(figure 1)
• Hits “ClassNotFoundException: SQLite.JDBC2x.JDBCConnection” when executing Java programs.

That means that your Java environment requires JDBC2x.* instead of JDBC2z.*. So you need to edit build_windows/ex_sql_jdbc.vcproj, replace all JDBC2z with JDBC2x and rebuild the project (ex_sql_jdbc.vcproj).

本文介绍了如何在Linux环境下应用Berkeley DB SQL(DBSQL)作为PHP PDO数据库引擎.考虑到会有许多SQLite用户迁移到DBSQL以获得更高的并发性和性能,本文创建了一个SQLite3数据库并展示了如何将已有SQLite3数据库迁移到DBSQL上来.

1. 安装PDO SQLite

本文假定您已经有了一个可工作的Apache+PHP 5.x环境.此外,如果你没有一个可工作的PDO SQLite, 那么需要安装一个.以Ubuntu机器为例,我们只需要使用aptitude安装php5-sqlite即可.其它环境请Google/Baidu一下适用的安装步骤.

安装完成后,应该检查一下/usr/lib/php5/20060613+lfs目录下(该目录可能根据环境有所不同,以下一律以本机环境/usr/lib/php5/20060613+lfs为例)是否有pdo.so和pdo_sqlite.so文件:

debian:/usr/lib/php5/20060613+lfs# ls
pdo.so  pdo_sqlite.so

2. 数据库迁移

(是为了模拟SQLite3用户的迁移场景，本步骤准备了一个SQLite3数据库,并将其迁移到DBSQL数据上来)
创建SQLite3数据库/tmp/test.db,将以下文本保存为/tmp/create.sql:

CREATE TABLE Friends
([id] integer,
 [LastName] text,
 [FirstName] text,
 [Phone] text,
 CONSTRAINT [Index1] PRIMARY KEY ([id]));
INSERT INTO Friends (id, LastName, FirstName, Phone)
VALUES (1, 'Zhang', 'San', '1234-0000');
INSERT INTO Friends (id, LastName, FirstName, Phone)
VALUES (2, 'Li', 'Si', '1234-0001');
INSERT INTO Friends (id, LastName, FirstName, Phone)
VALUES (3, 'Wang', 'Wu', '1234-0002');

使用sqlite3 shell创建一个test.db:

/tmp$ cat create.sql | sqlite3 test.db

到现在为止,我们已经模拟了现实场景:我们有一个可工作的PDO(SQLite)和数据库文件.接下来我们将它迁移到DBSQL上来:
a) 按照http://www.bdbchina.com/2010/04/在unixlinux平台上应用berkeley-db-11gr2-sql/,编译得到库libdb_sql-5.0.so(路径:$HOME/db-5.0.21/build_unix/.libs/libdb_sql-5.0.so)
b) 按照以下步骤dump SQLite3数据库到test.dump文件:

/tmp$ sqlite3 test.db
SQLite version 3.6.22
Enter ".help" for instructions
Enter SQL statements terminated with a ";"
sqlite> .output test.dump
sqlite> .dump
sqlite> .quit

c) 使用DBSQL shell加载dump文件.加载完成后在/tmp目录下生成新的test.db及test.db-journal:

/tmp$ mv test.db test.db.bak
/tmp$ $HOME/db-5.0.21/build_unix/dbsql test.db
Berkeley DB 11g Release 2, library version 11.2.5.0.21: (March 30, 2010)
Enter ".help" for instructions
Enter SQL statements terminated with a ";"
dbsql> .read test.dump
dbsql> .quit
/tmp$ ls
create.sql  test.db  test.db-journal  test.dump  test.db.bak

3. 安装PDO DBSQL

本步骤需要root权限.具体做法如下:
a)复制libdb_sql-5.0.so到php lib目录下并改名为libdb_sql-50.so:

    cp /build_unix/.libs/libdb_sql-5.0.so /usr/lib/php5/20060613+lfs/libdb_sql-50.so

b)使用vi编辑usr/lib/php5/20060613+lfs/pdo_sqlite.so(这是一个二进制文件),并将文件中的libsqlite3.so.0替换为libdb_sql-50.so(只有一处替换).这使得pdo_sqlite.so连接到DBSQL,而不是SQLite3.
c)把usr/lib/php5/20060613+lfs/增加到HTTP Server的LD_LIBRARY_PATH环境变量中.否则Web Server无法找到libdb_sql-50.so. 不同的HTTP Server的具体做法不同.以Apache2为例,编辑/etc/apache2/envvars,增加一行:

    export LD_LIBRARY_PATH=/usr/lib/php5/20060613+lfs/

d)重启HTTP Server,仍以Apache2为例:

    /etc/init.d/apache2 restart

4. 使用PDO DBSQL

创建好数据库后,我们用PDO接口来访问它:将以下PHP程序保存到HTTP服务器的根目录(如htdoc/)目录下并命名为pdo_dbsql.php:

<?php
try {
    $db = new PDO("sqlite:/tmp/test.db");

    /*** The SQL SELECT statement ***/
    $sql = "SELECT * FROM Friends";
    $db->exec($sql);

    /*** Print Query Results ***/
    echo "<table><tr><th>ID</th><th>Last Name</th>";
    echo "<th>First Name</th><th>Phone</th></tr>";
    foreach ($db->query($sql) as $row) {
        echo "<tr>";
        echo "<td>".$row["id"]."</td>";
        echo "<td>".$row["LastName"]."</td>";
        echo "<td>".$row["FirstName"]."</td>";
        echo "<td>".$row["Phone"]."</td>";
        echo "</tr>";
    }
    echo "</table>";

    /*** close the database connection ***/
    $db = null;
} catch(PDOException $e) {
    echo $e->getMessage();
}
?>

使用Web浏览器访问我们编写好的pdo_dbsql.php(如http://192.168.1.131/pdo_dbsql.php),即可看到使用PDO的运行结果:

5. 结束语

本文我们介绍了如何将PDO数据引擎从SQLite迁移到DBSQL上来.对于直接采用DBSQL的用户而言,数据迁移一步可直接跳过,直接创建新的DBSQL数据库就好了.DBSQL与SQLite相比具有更高的并发性和性能,是值得PHP开发者尝试的全新SQL数据库引擎.

下载安装包

从官方网站下载db-5.0.21.tar.gz并解压缩获得db-5.0.21目录。

配置

cd db-5.0.21/build_unix
../dist/configure --enable-sql --enable-sql_compact

选项说明：

• --enable-sql_compact：
  • 使dbsql库(libdb_sql-5.0.so)包含db库(libdb-5.0.so)，这样libdb_sql-5.0.so就不依赖于db库，其中dbsql提供了SQL API，db库包含原有的BDB功能，这样应用程序不需要链接两个库，方便使用。编译得到的库与sqlite 3.6.22版本对应。方便使用。编译得到的库与sqlite 3.6.22版本对应。

其它常用配置选项：

• 只编译静态库：
  • 加上"--disable-shared"。
• 编译最小库：
  • 加上"--enable-smallbuild --enable-statistics"。
  • 这里的--enable-statistics是必须搭配--enable-smallbuild使用的。因为默认的smallbuild不包含dbsql所需要的statistics组件。
  • 常规编译获得的DBSQL动态库大小为2.2M，而最小方式编译得到的库大小为1.1M。话说回来，对于UNIX/Linux大多数应用来说，多个1M大小不是问题，而且smallbuild会采用Os编译器优化选项(尺寸优先)取代O3选项(速度优先)，性能会有所下降。

编译

make dbsql

对于动态编译方式，实际库文件在build_unix/.libs目录下，文件：

.libs/libdb_sql-5.0.so (动态库文件)
.libs/dbsql (交互式命令行工具)

而对于静态编译方式，库文件在build_unix/目录下，文件：

libdb_sql-5.0.a (静态库文件)
dbsql (交互式命令行工具)

如果你需要使用各种BDB工具(如db_dump, db_load等)，进一步执行编译指令make，你将能够得到BDB所提供的所有的库文件和工具，包括之前make dbsql得到的库，以及除了上述db_dump, db_load之外的其他所有BDB提供的工具，熟悉BDB的用户一定对此不陌生。

最后，如果你需要清除包括Makefile在内的所有编译文件，可执行make distclean。Makefile是由configure生成的，单纯的”make clean”不能清除这部分记录。

编译并运行范例

DBSQL的C API完全沿用SQLite的C API，这里是SQLite3 C API列表。sql/examples/目录下有多个参考范例。以下我们以C语言范例sql/examples/c/ex_sql_index.c为例：

make ex_sql_index
./ex_sql_index

程序做了以下几件事情：

• 1. 把表格university加载到数据库
• 2. 打印以下SQL语句的Query Plan。我们可以看到Query Plan中的VDBE指令有32条。并且有两条向前跳转的Next指令，表示出现了两次循环迭代。

          SELECT rank, country, name
          from university
          WHERE region = 'Europe'
          ORDER BY country;
  

• 3. 增加关于region, country的索引
• 4. 再次打印Query Plan。我们可以看到Query Plan中的VDBE指令简化到了21条。并且只有一次向前跳转的Next指令，表示只(在索引上)出现了一次循环迭代。
• 5. 删除关于region, country的索引

以下是程序输出：

================================================================================
Load data source ../sql/examples/data/university.csv into database.
Load done.
================================================================================
STEP1. Explain a query expression
SQL:    EXPLAIN
        SELECT rank, country, name
        from university
        WHERE region = 'Europe'
        ORDER BY country;
  0     Trace   0       0       0               00      (null)
  1     OpenEphemeral   1       3       0       keyinfo(1,BINARY)       00      (null)
  2     String8 0       1       0       Europe  00      (null)
  3     Goto    0       29      0               00      (null)
  4     OpenRead        0       3       0       5       00      (null)
  5     Rewind  0       18      0               00      (null)
  6     Column  0       4       2               00      (null)
  7     Ne      1       17      2       collseq(BINARY) 69      (null)
  8     Column  0       0       4               00      (null)
  9     Column  0       3       5               00      (null)
  10    Column  0       1       6               00      (null)
  11    MakeRecord      4       3       2               00      (null)
  12    Column  0       3       7               00      (null)
  13    Sequence        1       8       0               00      (null)
  14    Move    2       9       1               00      (null)
  15    MakeRecord      7       3       3               00      (null)
  16    IdxInsert       1       3       0               00      (null)
  17    Next    0       6       0               01      (null)
  18    Close   0       0       0               00      (null)
  19    OpenPseudo      2       2       3               00      (null)
  20    Sort    1       27      0               00      (null)
  21    Column  1       2       2               00      (null)
  22    Column  2       0       4               20      (null)
  23    Column  2       1       5               00      (null)
  24    Column  2       2       6               00      (null)
  25    ResultRow       4       3       0               00      (null)
  26    Next    1       21      0               00      (null)
  27    Close   2       0       0               00      (null)
  28    Halt    0       0       0               00      (null)
  29    Transaction     0       0       0               00      (null)
  30    VerifyCookie    0       5       0               00      (null)
  31    TableLock       0       3       0       university      00      (null)
  32    Goto    0       4       0               00      (null)
================================================================================
STEP2. Create an index on university(region, country)
SQL:    CREATE INDEX university_geo
        ON university (region, country);
================================================================================
STEP3. Explain the query again, we can see the difference
SQL:    EXPLAIN
        SELECT rank, country, name
        from university
        WHERE region = 'Europe'
        ORDER BY country;
  0     Trace   0       0       0               00      (null)
  1     Noop    0       0       0               00      (null)
  2     String8 0       1       0       Europe  00      (null)
  3     Goto    0       18      0               00      (null)
  4     OpenRead        0       3       0       5       00      (null)
  5     OpenRead        2       4       0       keyinfo(2,BINARY,BINARY)        00      (null)
  6     SeekGe  2       15      1       1       00      (null)
  7     IdxGE   2       15      1       1       01      (null)
  8     IdxRowid        2       2       0               00      (null)
  9     Seek    0       2       0               00      (null)
  10    Column  0       0       3               00      (null)
  11    Column  2       1       4               00      (null)
  12    Column  0       1       5               00      (null)
  13    ResultRow       3       3       0               00      (null)
  14    Next    2       7       0               00      (null)
  15    Close   0       0       0               00      (null)
  16    Close   2       0       0               00      (null)
  17    Halt    0       0       0               00      (null)
  18    Transaction     0       0       0               00      (null)
  19    VerifyCookie    0       6       0               00      (null)
  20    TableLock       0       3       0       university      00      (null)
  21    Goto    0       4       0               00      (null)
================================================================================
STEP4. Drop the index
SQL: DROP INDEX university_geo;
DONE.

使用dbsql shell

范例运行完后，我们还可以用dbsql shell来查看/操作生成的数据库文件：

build_unix$ ./dbsql ex_sql_index.db
Berkeley DB 11g Release 2, library version 11.2.5.0.21: (March 30, 2010)
Enter ".help" for instructions
Enter SQL statements terminated with a ";"
dbsql> .tables
university
dbsql> select * from university;
1|Massachusetts Institute of Technology|mit.edu|us|North America|2|1|1|7
2|Harvard University|harvard.edu|us|North America|7|2|12|1
3|Stanford University|stanford.edu|us|North America|4|4|2|24
4|University of California Berkeley|berkeley.edu|us|North America|8|3|5|32
5|Cornell University|cornell.edu|us|North America|1|5|9|37
6|University of Wisconsin Madison|wisc.edu|us|North America|3|10|6|71
7|University of Minnesota|umn.edu|us|North America|6|15|7|22
8|California Institute of Technology|caltech.edu|us|North America|18|6|20|30
9|University of Illinois Urbana Champaign|uiuc.edu|us|North America|17|7|13|51
10|University of Michigan|umich.edu|us|North America|10|8|18|55
11|University of Texas Austin|utexas.edu|us|North America|12|11|8|44
12|University of Washington|washington.edu|us|North America|22|9|4|94
13|University of Chicago|uchicago.edu|us|North America|42|16|44|2
14|Carnegie Mellon University|cmu.edu|us|North America|5|24|3|93
15|University of Pennsylvania|upenn.edu|us|North America|16|14|33|26
16|Columbia University New York|columbia.edu|us|North America|19|12|21|95
17|Texas A&M University|tamu.edu|us|North America|31|31|11|17
18|University of Maryland|umd.edu|us|North America|37|22|17|52
19|University of California Los Angeles|ucla.edu|us|North America|13|17|26|110
20|Purdue University|purdue.edu|us|North America|14|34|14|46
21|Johns Hopkins University|jhu.edu|us|North America|59|27|49|3
22|University of Cambridge|cam.ac.uk|uk|Europe|26|13|70|86
23|Pennsylvania State University|psu.edu|us|North America|27|29|16|102
24|University of Tokyo|u-tokyo.ac.jp|jp|Asia|32|26|65|31
25|University of Arizona|arizona.edu|us|North America|20|36|19|134
dbsql> .quit

结束语

以上我们介绍了如何在UNIX/Linux环境下编译DBSQL并运行范例。在这一版本开发中，我们为新增SQL部分增加了十个范例，可作为快速参考:

1.ex_sql_load:          create table, insert, load csv files
2.ex_sql_query:         select, order by, group by, subquery, SQL function
3.ex_sql_index:         index, query explain
4.ex_sql_statment:      prepare, iterate results, callback function
5.ex_sql_transaction:   transaction, commit, rollback
6.ex_sql_savepoint:     savepoint
7.ex_sql_multi_thread:  multi-thread, transaction, lock/busy handle
8.ex_sql_binding:       prepare, variable binding, transaction, bulk insert
9.ex_sql_fts3:          full-text search features
10.ex_sql_rtree:        create, maintain, and query r-tree index

如果您有什么问题和建议，欢迎与我联系。

本文将展示如何在Ubuntu Linux x32平台上使用完整的Android源代码来编译构建我们的全新Android系统镜像，而Android源代码包中包含了交叉编译器，因此我们不需要事先安装NDK。

1. 编译Android代码

从Android官方网站获取一份Android源代码，这份源代码有2~3G之巨。

在Linux平台上，把源代码解压到$HOME/android/android_src

安装java 1.5版本，(1.6不行)，并设置JAVA_HOME和PATH:

$ export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun
$ export PATH=$JAVA_HOME/bin:$PATH

先把原始的Android代码完全编译成功(这过程可能要花2~3小时)：

$ cd $HOME/android/android_src
$ . build/envsetup.sh
$ make

可看到生成三个镜像：

Install system fs image: out/target/product/generic/system.img
Target ram disk: out/target/product/generic/ramdisk.img
Target userdata fs image: out/target/product/generic/userdata.img

2. 安装Android SDK并测试镜像

安装Android SDK: http://developer.android.com/sdk/installing.html, 安装目录：$HOME/android/android-sdk-linux_86
安装Android SDK组件: http://developer.android.com/sdk/adding-components.html,选择安装SDK Platform Android 2.1 API 7和Google APIs by Google Inc., Android API 7

用我们编译得到的镜像替换系统的默认镜像。如果需要替换Windows环境下的sdk，那么以下目录”android-sdk-linux_86″相应应该改成 “android-sdk-windows”。

$ cd $HOME/android/android-sdk-linux_86/platforms/android-2.1
$ cp -r images images.bak
$ cp $HOME/android/android_src/out/target/product/generic/*.img images

创建并运行一个新的设备:

$ cd $HOME/android/android-sdk-linux_86/tools/
$ ./android

(如图)使用图形界面工具创建一个Android 2.1的设备BDBSQL,并点击”start”启动。新的设备第一次启动的时间会非常长，这是正常现象。等到Android界面出现，就说明我们的镜像编译基本没问题了。接下来我们进一步把SQLite库替换为BDB。

3. 编译DBSQL

从http://www.oracle.com/technology/software/products/berkeley-db/index.html下载BDB 11gR2源文件(db-5.0.x.tar.gz)，然后

$ cd $HOME/android/android_src/external/sqlite/dist
$ tar zxvf db-5.0.x.tar.gz
$ cp Android.mk Android.mk.bak
$ cp db-5.0.x/build_android/Android.mk .

编辑Android.mk，默认的BDB Log和Region文件大小总和可达到十几兆，因此我们有必要修改Android.mk来减小它(可能需要为Android.mk去掉只读属性)。修改第一处LOCAL_CFLAGS如下所示(相对于默认配置，我们删除了-DSQLITE_OMIT_TRUNCATE_OPTIMIZATION，新增了-DSQLITE_DEFAULT_CACHE_SIZE=256 -DBDBSQL_MAX_LOCKS=1000 -DBDBSQL_MAX_LOCK_OBJECTS=1000)：

LOCAL_CFLAGS += -Wall -DHAVE_USLEEP=1 \
        -DSQLITE_DEFAULT_JOURNAL_SIZE_LIMIT=1048576 \
        -DSQLITE_THREADSAFE=1 -DNDEBUG=1 -DSQLITE_TEMP_STORE=3 \
        -DSQLITE_OS_UNIX=1 \
        -D_HAVE_SQLITE_CONFIG_H -DSQLITE_THREAD_OVERRIDE_LOCK=-1 \
        -DSQLITE_ENABLE_FTS3 -DSQLITE_ENABLE_FTS3_BACKWARDS -Dfdatasync=fsync \
        -DSQLITE_DEFAULT_CACHE_SIZE=256 \
        -DBDBSQL_MAX_LOCKS=1000 \
        -DBDBSQL_MAX_LOCK_OBJECTS=1000

如果确定不会在多进程间共享数据库，还可以在上述LOCAL_CFLAGS中加入”-DBDBSQL_OMIT_SHARING”，这样日志文件不会被写入文件系统，进一步节省了设备空间。

编译系统镜像中的SQLite部分:

$ cd $HOME/android/android_src
$ . build/envsetup.sh
$ make clean-libsqlite
$ mmm -B external/sqlite/dist
$ make snod

编译好了，再来一次镜像替换：

$ cp $HOME/android/android_src/out/target/product/generic/*.img $HOME/android/android-sdk-linux_86/platforms/android-2.1/images

使用图形界面工具删除先前的设备BDBSQL，重创建一个新的Android 2.1设备BDBSQL,并点击”start”启动。这里一定要创建新的设备，因为启动过的设备，其数据库文件已被SQLite生成，DBSQL无法访问。

4. 使用DBSQL

现在Android里所有应用程序的SQL存储引擎都已被替换为DBSQL了。我们使用”联系人”来试用一下我们的新设备吧，在Setting里面把Locate设置为中文简体，安装一个中文输入法(比如搜狗)，然后打开“联系人”，随便增加一条记录：

在主机上我们可以使用adb shell来查看并操作程序所生成的数据库。请留意sqlite3 shell输出的版本信息是Berkeley DB 11gR，同时shell的提示符是dbsql>，这说明我们已经把SQLite成功替换为DBSQL引擎：

$ adb shell
# cd /data/data/com.android.providers.contacts/databases/
# sqlite3 contacts2.db
Berkeley DB 11g Release 2, library version 11.2.5.0.21: (March 30, 2010)
Enter ".help" for instructions
Enter SQL statements terminated with a ";"
dbsql> .tables
_sync_state                       status_updates
_sync_state_metadata              v1_settings
activities                        view_contacts
agg_exceptions                    view_contacts_restricted
android_metadata                  view_data
calls                             view_data_restricted
contact_entities_view             view_groups
contact_entities_view_restricted  view_raw_contacts
contacts                          view_raw_contacts_restricted
data                              view_v1_contact_methods
groups                            view_v1_extensions
mimetypes                         view_v1_group_membership
name_lookup                       view_v1_groups
nickname_lookup                   view_v1_organizations
packages                          view_v1_people
phone_lookup                      view_v1_phones
raw_contacts                      view_v1_photos
settings
dbsql> select * from contacts;
2|逍遥 李|||0|0|0|0|1|1|0nE08B4A8BFA37D4||0
dbsql> select * from data;
1||4|1|0|0|0|li|li|||||||||||||||||
2||6|2|0|0|0|66666666|1||66666666|||||||||||||||
3||6|2|0|0|0|88888888|2||88888888|||||||||||||||
4||8|2|0|0|0|蜀山|1|||||||||||||||||
5||4|2|0|0|0|逍遥 李|逍遥|李||||||||||||||||
dbsql>

5. 结束语

关于DBSQL库在Android平台上的编译和使用的介绍到这里就结束了。我们用两篇博文分别介绍了side-by-side(并存)和Drop-in(替换)这两种使用方式。在Drop-in模式下，现有的应用程序无修改就可以直接使用DBSQL引擎。

DBSQL在开发过程中始终给予Android平台高度重视，在开发过程中投入了多位资深工程师致力于将DBSQL移植到Android平台上，并将Android列为产品周期测试的主流平台。OARDC的工程师Zengfa.Dou和Stephen.Tang给予了我这个初学者极大帮助。在此一并致谢！

本文介绍在Linux平台上如何编译得到适用于Android的DBSQL库，依本文方法编译得到的BDB库将和Android自带的SQLite库并存，我们称其为side-by-side(并存)模式。在这种模式下，Android平台上已有的应用程序还是基于原始的SQLite库，而我们自己编译的应用程序则链接到DBSQL库以获取更高的存储和并发性能。

1. 安装开发环境

(本文假定读者已具备初步的Android Emulator使用经验)
安装SDK
从http://developer.android.com/sdk/index.html下载Android SDK并解压缩得到$HOME/android/android-sdk-linux_86/目录。

安装NDK
从http://developer.android.com/intl/zh-TW/sdk/ndk/index.html下载Linux版Android NDK(android-ndk-r3-linux-x86.zip)并解压缩得到$HOME/android/android-ndk-1.6_r3/目录。

$ cd android-ndk-1.6_r3
$ build/host-setup.sh

安装NDK Wapper
从开心网共享文件夹下载ndk-wrappers.tgz到$HOME/android

$ tar zxvf ndk-wrappers.tgz

ndk-wrapper需要以下变量，因此我们需要把以下变量增加到$HOME/.bashrc并使之生效：

export PATH=$HOME/android/ndk-wrappers/bin:$PATH
$ export NDK_DIR=$HOME/android/android-ndk-1.6_r3
$ export PATH=$HOME/android/android-sdk-linux_86/tools:$PATH
$ . $HOME/.bashrc

(NDK-Wrapper默认使用arm-eabi-gcc 4.2.1, 如果你想使用ndk里面的arm-eabi-gcc 4.4.0，把scripts/env-utils.sh 和setup.sh里面的4.2.1改为4.4.0)

开始安装ndk-wrapper：

$ cd ndk-wrappers
$ ./setup.sh

修改Ndk-Wrapper
修改ndk-wrappers/bin/arm-linux-gcc:

1. 在LINK_FLAGS中增加"-ldl"
2. 删除-fvisibility=hidden

试验Ndk-Wrapper是否可工作

$ arm-linux-gcc --version
arm-eabi-gcc (GCC) 4.4.0
Copyright (C) 2009 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

2. 编译DBSQL

以下我们使用上面搭建的NDK编译环境来编译适用于Android平台上的DBSQL库。首先从Oracle官网上下载Berkeley DB 11gR2(.tar.gz), 解压并改名为db/

设置CFLAGS

$ export CFLAGS="-DHAVE_USLEEP=1 -DSQLITE_DEFAULT_JOURNAL_SIZE_LIMIT=1048576 \
-DNDEBUG=1 -DSQLITE_TEMP_STORE=3 -DSQLITE_OS_UNIX=1 -D_HAVE_SQLITE_CONFIG_H \
-DSQLITE_THREAD_OVERRIDE_LOCK=-1 -Dfdatasync=fsync -DNO_ANDROID_FUNCS \
-DSQLITE_THREADSAFE=1"

设置为动态编译方式

$ cd db/build_unix
$ ../dist/configure --prefix=$HOME/android/install_db_arm --target=arm-linux \
--host=arm-linux --enable-smallbuild --enable-sql --enable-sql_compat \
--enable-statistics --enable-amalgamation

修改build_unix/db_config.h
每次configure完成后，切记都要编辑build_unix/db_config.h，删除以下两行：

#define HAVE_PREAD 1
#define HAVE_PWRITE 1

开始编译

$ make dbsql

生成的动态库文件为.libs/libdb_sql-5.0.so，Shell文件为.libs/dbsql。

3. 使用DBSQL库

我们使用现成的DBSQL范例来演示如何在自己的程序中使用DBSQL库

编译范例

$ cd  build_unix
$ make ex_sql_query

编译完成后生成范例程序.libs/ex_sql_query /data/bdb

运行范例
启动Android Emulator，上传，并运行DBSQL库和范例

$ adb shell mkdir /data/bdb
$ adb shell mkdir /data/sql/examples/data
$ adb shell mkdir /data/sql
$ adb shell mkdir /data/sql/examples
$ adb shell mkdir /data/sql/examples/data
$ adb push .libs/libdb_sql-5.0.so /data/bdb
$ adb push .libs/ex_sql_query /data/bdb
$ adb push ../sql/examples/data/ /data/sql/examples/data
$ adb shell "cd /data/bdb; export LD_LIBRARY_PATH=/data/bdb; ./ex_sql_query"

现在终端应该已经输出query范例的运行结果了。以下是GUI终端的输出截图：

4. 结束语

至此，关于BDB 11gR2 SQL库的side-by-side编译模式的介绍就结束了。我们可将编译得到的库应用到自己的程序中去。side-by-side模式的优点不改动Android系统底层库和镜像，使用简单。缺点是只能用C/JNI方式调用，无法用Android自带的SQL接口直接调用。而与此对应的是Drop-in模式，Drop-in模式可将Android系统的SQLite层整个替换为BDB 11gR2 SQL，应用程序无修改就可以直接使用，是一种更为强大彻底的应用模式。我们将在后续文章中介绍Drop-in模式的编译方式。

BDB XML是Oracle推出的一款开源原生XML数据库。与传统数据库相比，原生XML数据库的优势有：
1. 可以直接操作XML文件，XML数据无损–在某些场合，无损的数据源意味着法律效力。
2. 原生检索方式，支持XQuery和XPath，符合XML习惯。
3. 性能优化：原生XML数据库会针对XML特点进行各种优化，如插入文档索引、建立节点ID等。
4. 支持相同数据的不同视图。

和其它原生XML数据库相比，BDB XML优势有：
1. 完整的ACID 事务处理、自动恢复、热备份、用于分布式事务的HA支持。
2. 支持XQuery(含XQuery Update)和XPATH。
3. 可以利用其特有的二进制元数据存取大容量二进制对象(非XML数据)。
4. 支持全Unicode字符集，中文存储、查询都不成问题。
5. 提供一套容器和迭代器接口访问和操作查询结果。
6. 提供交互式命令行工具。

以上第三点是一个非常实用的特性，某种程度上它补足了XML应用的”最后一公里“：比方说，你正在为教育部门开发一个考生管理数据库，需要将考生的资料存成XML文档，那么存取照片(二进制数据)就相当麻烦。一般来讲传统的选择有两种：一是转换为Base64Binary格式嵌入到XML文档中，这意味着存取两端都需要转换大量图片数据，效率就很低下;二是为每个照片生成一个引用再另存它处，只在XML文档中保留一个引用，这种方法不但复杂，而且把数据从文档中分割了出来，损失了ACID特性，管理不便。而使用BDB XML就可以将照片数据直接以二进制元数据的形式嵌入到XML文档中，存取都非常方便，还可以基于数据库实现图像/视频检索。

下面，介绍一下BDB XML PHP的安装过程：

安装Apache+PHP环境

好吧，这是一个烂大街的话题，网上一抓一大把。下面以Debian 5.0和apache2为例：
用aptitude安装以下软件包：

apache2
libapache2-mod-php5
php5
php5-dev
php5-cgi

安装完毕。启动Apache服务器：

sudo /etc/init.d/apache2 start

测试一下是否安装成功，首先找到http的根目录(本机环境是/var/www)，在该目录下生成php测试文件test.php(内容如下)：

<?phpinfo();?>

用浏览器打开网页服务器的test.php，如果安装成功，会打开php信息页。

安装BDB XML PHP

移步http://www.oracle.com/technology/software/products/berkeley-db/xml/index.html下载源码包dbxml-2.5.13.tar.gz，并放置在$HOME目录下。下面以Linux上的安装为例：

cd $HOME
tar zxf dbxml-2.5.13.tar.gz
cd dbxml-2.5.13
./buildall
cd db-4.8.24/php_db4
phpize
./configure --with-db4=$PWD/../../install
make
sudo make install
cd ../../dbxml/src/php/
phpize
./configure --with-dbxml=$PWD/../../../install
make
sudo make install

接下来编辑/etc/php5/apache2/php.ini和/etc/php5/cgi/php.ini文件(可能路径略有不同)，把以下两行加到Dynamic Extensions段：

extension=db4.so
extension=dbxml.so

大功告成，为保安全，最好重启一下Apache服务器。到此BDB XML PHP全部安装成功。在实际应用中，需要特别注意帐户和权限问题：要保证Apache的运行帐户对容器(Container)文件及其所在目录有读写权限。

范例

从开心网的群共享页面http://www.kaixin001.com/group/file.php?gid=627784&fid=450163&start=0下载附件xmlData.tar.gz，解压后，将xmlData目录下的所有文件拷贝到http根目录下，然后执行：

./gen_cont.sh $HOME/dbxml-2.5.13/install/bin/dbxml

脚本即会生成一个容器：simple.dbxml。该容器内包含三百多个xml文档，形如：

<?xml version="1.0"?>
<产品>
    <种类>fruits</种类>
    <商品>Avocado</商品>
    <存货>
        <库存量单位>AvocfruijfHs18</库存量单位>
        <价格>0.24</价格>
        <存货>393</存货>
    </存货>
    <厂家>Simply Fresh</厂家>
</产品>

使用浏览器访问服务器上的simple.php页面，即可看到转换后输出的数据表。simple.php的内容如下：

<html>
<body>
<?
$contName = 'simple.dbxml'; // Container名字

// 创建Manager和Context
$mgr = new XmlManager();
$qc = $mgr->createQueryContext(); // Query Context
$qc->setDefaultCollection($contName); // 设置默认Container

// 打开Container
$cont = $mgr->openContainer($contName);

// 创建XQuery查询表达式，将数据提取出来并转换为html表格
$query = 'for $产品 in collection()/产品';
$query .= ' return <tr>';
$query .= '<td>{$产品/种类/string()}</td>';
$query .= '<td>{$产品/商品/string()}</td>';
$query .= '<td>{$产品/存货/价格/string()}</td>';
$query .= '<td>{$产品/存货/存货/string()}</td>';
$query .= '<td>{$产品/厂家/string()}</td>';
$query .= '</tr>';

// 输出表格头
?><table width='100%' border='frame'>
<tr><td>种类</td><td>商品</td><td>价格</td><td>存货</td><td>厂家</td></tr><?

// 查询并遍历结果，输出到表格
$results = $mgr->query($query, $qc);
while ($results->hasNext())
echo $results->next()->asString();

// 输出表格尾
?></table><?
?>
</body>
</html>

可见，只需30余行的代码就能完成xml数据库到网页表格的转换。例图：

总结

至此，我们已经介绍了BDB XML PHP的安装和使用。至于更多BDB XML功能，如二进制元数据、环境、事务、排序、索引等，请关注后续文章。

Berkeley DB Xml Shell(以下简称DbXml Shell)是包含在发行包里的工具，可运行于UNIX家族平台(Linux, Solaris, HP-UX, Mac OS, Cygwin, AIX, FreeBSD…)和Windows平台上。DbXml Shell包含Berkeley DB XML的绝大多数常用功能，可以让我们在不编写一行代码的情况下，通过指令快速完成多种常用操作如创建/删除容器、插入/删除文档、查询、验证Query Plan等等，实为居家旅行必备佳品。要是在周五下午遭受紧急任务袭击，就更得靠它来拯救周末了。有时为了解决开发中遇到的问题，只要写一个非常简短的DbXml Shell脚本就可以实现预期功能或是重现环境，极大地提高了劳动生产率。

在使用DbXML shell之前，应当正确编译好Berkeley DB Xml库。具体编译过程请参考博客上的相关文章：

Berkeley DB Xml 入门系列之二： 在Linux下编译和使用Berkeley DB Xml

使用Visual C++ 2008 Express Edition 编译Oracle Berkeley DB XML

2. 运行

UNIX下的可执行文件为<dbxml>/install/bin/dbxml，Windows环境下为<dbxml>/bin/dbxml.exe。钻进DbXml Shell以前，先瞄一眼说明(中文是翻译的，发行版是E文的)

rucong@debian:~/dbxml/install/bin$ ./dbxml –?

选项:

-c 在-h选项所指定的路径中创建一个新的Berkeley DB环境。

-h <home> 使用指定的路径作为Berkeley DB环境(默认为当前路径)。

-P <password> 设置数据库的密码

-s <script> 执行一个或多个脚本文件

-t 打开事务功能(transaction mode)

-V 打印版本号

-v verbose模式，连用两次进入更详细的verbose模式.

-x 安全模式–禁止在XQuery中直接访问本地文件和网络

-z <size> 设置环境Cache大小为<size>Mb (默认: 64)

-? 本说明

3. 指令说明

进入shell:

rucong@debian:~/dbxml/install/bin$./dbxml

嗯，已经进入DbXml Shell环境了。还是请help为我们向导一下(嗯…中文是翻译的，发行版是E文的。排序是按名称的，名词是不译的。列出的是常用的，实际还有更多的)

接下来让我们小试牛刀，运行几个常用命令试试：

创建一个空Container

dbxml> createcontainer ""

Creating node storage container

插入一个文档test.xml：

dbxml> putdocument test.xml ‘<root><a><b/></a></root>’

Document added, name = test.xml

看看文档插入了没：

dbxml> getdocuments

1 documents found

检查文档名称：

dbxml> printname

test.xml

检查文档内容：

dbxml> print

<root><a><b/></a></root>

做个简单查询，并计时：

dbxml> time query collection()/root/a

1 objects returned for eager expression ‘collection()/root/a’

Time in seconds for command ‘query’: 0.04848

输出查询结果：

dbxml> print

<a><b/></a>

退出

dbxml> print

<a><b/></a>

4.范例

上一节我们在DbXml Shell里做了一些简单的交互式操作，实际上我们采用DbXml Shell脚本更方便。下面是一个简单的DbXml Shell脚本，高级内容参见源代码包里的dbxml/docs/intro_xml/BerkeleyDBXML-Intro.pdf

createContainer "" #创建一个空Container

#插入一个文档

putdocument apples.xml ‘

<product>

<category>fruits</category>

<item>Apples</item>

<inventory>

<sku>Applfrui1q6lpq</sku>

<price>1.10</price>

<inventory>535</inventory>

</inventory>

<vendor>Off the Vine</vendor>

</product>

‘

getdocuments #获得所有文档

printnames #输出文档名

print #输出文档内容

#使用XQuery查询价格,并计量查询时间

time query ‘collection()/product/inventory/price/string()’

echo "Price is:"

print

exit #退出

执行并输出结果：

rucong@debian:~/dbxml/install/bin$ ./dbxml -s example1.script

apples.xml

<product>

<category>fruits</category>

<item>Apples</item>

<inventory>

<sku>Applfrui1q6lpq</sku>

<price>1.10</price>

<inventory>535</inventory>

</inventory>

<vendor>Off the Vine</vendor>

</product>

Time in seconds for command ‘query’: 0.008049

Price is:

1.10

5.使用技巧

rlwrap是个好东西

UNIX用户初用DbXml Shell时，会悲愤地发现bash标配的命令行历史和左右箭头键居然统统废掉。呃…这意味着键入命令的过程中不能犯错，还不能重复历史指令，极不人道。因此该问题也凭借强大的怨念名列FAQ。其实只要使用rlwrap这个小工具便可以完美地解决这一问题(没有就装一个吧)，rlwrap程序可以添加命令历史和命令编辑功能。用法：rlwrap ./dbxml。这体现了UNIX世界的哲学：把工具们连接在一起，而不是重复实现。

下面这条是OTN上荣列BestPractices的一条经验(作者是Greg Fausak)：

/usr/bin/rlwrap -m -c -H ~/.rlhistory -l ~/dbxml.log -r -m -P ‘openC customer.dbxml \ adda L \ setN "test" "http://mytest.com/"’ /usr/local/bin/dbxml -h ~/sn/db

-H : 把命令执行历史存储在文件.rlhistory

-l : 把产生的所有的输入和输出存储在文件~/dbxml.log’

-m : 使能多行命令，和下面的-P选项连用。 -P "…" 里面的反斜杠\就是分行标识，用来分隔多个命令。

-P : 在执行操作前，自动输入一批指令。由于DbXml Shell可以执行脚本文件，所以总的说来rlwrap的"-m"和"-P"选项对我们用处不大，可以无视。

-h 这个是DbXml Shell的参数，指定Berkeley DB环境路径

创建一个临时Container

如果只是做个临时实验，不想大费周章地创建Container文件和DB环境，那么只需要创建一个名字为空的Container就行了。DbXml会在内存中创建一个临时的Container，有需要的话还可以用addAlias为这个空名Container增加别名。

不用输入完整指令

Shell会自动补完符合唯一性的指令：比如createc=createContainer，listi=listIndex…

修改Shell代码

Shell不是万能的，如果发现Shell的功能比实际需求就恰巧少了那么一点点，又不想从头编写一套C++/Java程序，那么就Open Source精神来武装头脑指导实践推动工作 — 杀进DbXml Shell源代码里面修改吧！Shell的源程序在dbxml/src/util/shell目录下，组织得非常规范，只要有初步DbXml编程经验就可以对Shell进行修改和增强。修改之后进入dbxml/build_unix，重新"make; make install"即可。Visual Studio环境下就更方便，重新编译Shell的Project就行了。比如OTN上曾有用户问如何用Shell获得整个Container的MetaData(Shell的getMetaData只能获得一个Document的MetaData)，解决办法就是修改dbxml/src/utils/shell/GetMetaDataCommand.cpp，增加一条循环调用就行了。

用这么一台老古董，无非是玩玩DOS游戏，看看电子小说。老DOS用户都熟悉知名程序员云风写的一个牛掰的电子小说阅读软件C-View，支持N多的功能。唯一的遗憾就是全屏分行，按行滚动。阅读时眼睛或脖子需要不停地左右往复，实是累坏吾等老汉。

总而言之，看小说还是要那种仿书页样式的，这样才有看书的感觉。看的时候左一页，右一页，看完左页看右页，看完前页看后页…  可惜寻觅半天，在DOS下还是找不到合适的阅读器。那就只好自己写一个吧，所幸不难。猛蹲一阵图书馆和宿舍，炮制出来一个能工作的程序，从此终于可以用它来安详地看书了。

在华军上的简介(http://www.newhua.com/soft/22394.htm)：

唯一的DOS仿真书页样式阅读器,模拟左右翻页的书页样式。自带中文GB字库，无需汉字系统支持，无需EMS或XMS。硬件级的色彩调整,可由用户设定2 万多种颜色.可设定背景、 字体、页码等页面所有元素颜色。并提供四种调色方案的设定、保存和快速切换。文件选择采用磁盘目录列表选择，并配有预览功能。能打开任意大小的文本文件。

DOS仿真阅读器在电脑里保存了两年，直至05年本科毕业。至于陪伴了我三年的486笔记本，在毕业前夕转让给了师弟，也许现在这个老机器早已停止运转了吧。用它打穿的DOS游戏早已不计其数：大航海时代II、英杰传、炎龙骑士团、波斯王子、三国志IV、轩辕剑II……嗯，又想起了扛着一盒软盘去学校机房拷游戏的时光。

echo 2> tmp.txt

stderr没有任何输出，自然产生一个空白文本文件。整个世界清静了…