连接到 Db2 数据库

NoSQL JSON API 使用 JDBC 连接来执行各种数据库操作。

要使用数据库，必须获取 DB 对象的实例。可以使用 Connection JDBC 连接或 DataSource或数据库 URL ，用户名和密码来初始化此对象。

Java™ 程序中的以下片段演示了如何连接到 Db2 数据库。

 //Create a context and a dataSource 
 Context initialContext = new InitialContext(); 
 DataSource dataSource = (DataSource)initialContext.lookup("jdbc/myDB2");
 //The dataSource instance becomes a cache key for metadata for the target database 
 DB db = NoSQLClient.getDB(dataSource);

有一些重载方法可用于获取 DB 实例:

```
NoSQLClient.getDB(java.sql.Connection)
```

NoSQLClient.getDB(javax.sql.DataSource)

```
NoSQLClient.getDB(String, String, String)
```
getDB 方法的第三个实例的三个字符串自变量采用以下自变量:

jdbcUrl

指定可用于与 JDBC 连接进行连接的 URL。

用户

指定可用于连接数据库的用户名。

密码

指定密码。

注: 此 DB 实例不得在线程之间共享。每个线程都必须进行自己的 NoSQLClient.getDB() 方法调用。

表 1. `DB` 上用于控制事务行为的方法
方法	描述
`public void startTransaction()`	获取连接 (如果需要) ，将 auto-commit 设置为 false。如果正在使用连接池或数据源，那么会将 `DB` 置于单一连接方式，直到将来的 `commitTransaction()` 或 `rollbackTransaction()`。
`public void commitTransaction()`	落实由 `startTransaction()`启动的事务。
`public void rollbackTransaction()`	回滚由 `startTransaction()`启动的事务。
`public void setAutoCommit(boolean autoCommit)`	如果 Db2 服务器正在使用单连接方式，那么设置自动落实。在 `DataSource` 方式下调用此方法是错误的。

注: 此表中描述的事务 API 不适用于触发和忘记方式。

在使用事务 API 时获取单方式连接，以避免发生启动事务将连接池方式强制更改为单方式的情况。

如果发生错误，那么不会插入文档。使用这些 API 时，将插入所有文档或不插入任何文档。