提交 c18296cc 编写于 作者: X xieyinglin

edit the title

上级 6f69f07e
### TAOS-JDBCDriver 概述 ## TAOS-JDBCDriver 概述
------
TDengine 为了方便 Java 应用使用,提供了遵循 JDBC 标准(3.0)API 规范的 `taos-jdbcdriver` 实现。目前可以通过 [Sonatype Repository][1] 搜索并下载。 TDengine 为了方便 Java 应用使用,提供了遵循 JDBC 标准(3.0)API 规范的 `taos-jdbcdriver` 实现。目前可以通过 [Sonatype Repository][1] 搜索并下载。
...@@ -22,8 +21,7 @@ TDengine 的 JDBC 驱动实现尽可能的与关系型数据库驱动保持一 ...@@ -22,8 +21,7 @@ TDengine 的 JDBC 驱动实现尽可能的与关系型数据库驱动保持一
* 目前不支持嵌套查询(nested query),对每个 Connection 的实例,至多只能有一个打开的 ResultSet 实例;如果在 ResultSet还没关闭的情况下执行了新的查询,TSDBJDBCDriver 则会自动关闭上一个 ResultSet。 * 目前不支持嵌套查询(nested query),对每个 Connection 的实例,至多只能有一个打开的 ResultSet 实例;如果在 ResultSet还没关闭的情况下执行了新的查询,TSDBJDBCDriver 则会自动关闭上一个 ResultSet。
### TAOS-JDBCDriver 版本以及支持的 TDengine 版本和 JDK 版本 ## TAOS-JDBCDriver 版本以及支持的 TDengine 版本和 JDK 版本
------
| taos-jdbcdriver 版本 | TDengine 版本 | JDK 版本 | | taos-jdbcdriver 版本 | TDengine 版本 | JDK 版本 |
| --- | --- | --- | | --- | --- | --- |
...@@ -31,8 +29,7 @@ TDengine 的 JDBC 驱动实现尽可能的与关系型数据库驱动保持一 ...@@ -31,8 +29,7 @@ TDengine 的 JDBC 驱动实现尽可能的与关系型数据库驱动保持一
| 1.0.2 | 1.6.4.x,1.6.3.x,1.6.2.x,1.6.1.x | 1.8.x | | 1.0.2 | 1.6.4.x,1.6.3.x,1.6.2.x,1.6.1.x | 1.8.x |
| 1.0.1 | 1.6.4.x,1.6.3.x,1.6.2.x,1.6.1.x | 1.8.x | | 1.0.1 | 1.6.4.x,1.6.3.x,1.6.2.x,1.6.1.x | 1.8.x |
### TDengine DataType 和 Java DataType ## TDengine DataType 和 Java DataType
------
TDengine 目前支持时间戳、数字、字符、布尔类型,与 Java 对应类型转换如下: TDengine 目前支持时间戳、数字、字符、布尔类型,与 Java 对应类型转换如下:
...@@ -47,10 +44,9 @@ TDengine 目前支持时间戳、数字、字符、布尔类型,与 Java 对 ...@@ -47,10 +44,9 @@ TDengine 目前支持时间戳、数字、字符、布尔类型,与 Java 对
| BOOL | java.lang.Boolean | | BOOL | java.lang.Boolean |
| BINARY, NCHAR | java.lang.String | | BINARY, NCHAR | java.lang.String |
### 如何获取 TAOS-JDBCDriver ## 如何获取 TAOS-JDBCDriver
------
#### maven 仓库 ### maven 仓库
目前 taos-jdbcdriver 已经发布到 [Sonatype Repository][1] 仓库,且各大仓库都已同步。 目前 taos-jdbcdriver 已经发布到 [Sonatype Repository][1] 仓库,且各大仓库都已同步。
* [sonatype][8] * [sonatype][8]
...@@ -69,15 +65,14 @@ maven 项目中使用如下 pom.xml 配置即可: ...@@ -69,15 +65,14 @@ maven 项目中使用如下 pom.xml 配置即可:
</dependencies> </dependencies>
``` ```
#### 源码编译打包 ### 源码编译打包
下载 [TDengine][3] 源码之后,进入 taos-jdbcdriver 源码目录 `src/connector/jdbc` 执行 `mvn clean package` 即可生成相应 jar 包。 下载 [TDengine][3] 源码之后,进入 taos-jdbcdriver 源码目录 `src/connector/jdbc` 执行 `mvn clean package` 即可生成相应 jar 包。
### 使用说明 ## 使用说明
------
#### 获取连接 ### 获取连接
如下所示配置即可获取 TDengine Connection: 如下所示配置即可获取 TDengine Connection:
```java ```java
...@@ -136,7 +131,7 @@ TDengine 的 JDBC URL 规范格式为: ...@@ -136,7 +131,7 @@ TDengine 的 JDBC URL 规范格式为:
# locale en_US.UTF-8 # locale en_US.UTF-8
``` ```
#### 创建数据库和表 ### 创建数据库和表
```java ```java
Statement stmt = conn.createStatement(); Statement stmt = conn.createStatement();
...@@ -152,7 +147,7 @@ stmt.executeUpdate("create table if not exists tb (ts timestamp, temperature int ...@@ -152,7 +147,7 @@ stmt.executeUpdate("create table if not exists tb (ts timestamp, temperature int
``` ```
> 注意:如果不使用 `use db` 指定数据库,则后续对表的操作都需要增加数据库名称作为前缀,如 db.tb。 > 注意:如果不使用 `use db` 指定数据库,则后续对表的操作都需要增加数据库名称作为前缀,如 db.tb。
#### 插入数据 ### 插入数据
```java ```java
// insert data // insert data
...@@ -163,7 +158,7 @@ System.out.println("insert " + affectedRows + " rows."); ...@@ -163,7 +158,7 @@ System.out.println("insert " + affectedRows + " rows.");
> now 为系统内部函数,默认为服务器当前时间。 > now 为系统内部函数,默认为服务器当前时间。
> `now + 1s` 代表服务器当前时间往后加 1 秒,数字后面代表时间单位:a(毫秒), s(秒), m(分), h(小时), d(天),w(周), n(月), y(年)。 > `now + 1s` 代表服务器当前时间往后加 1 秒,数字后面代表时间单位:a(毫秒), s(秒), m(分), h(小时), d(天),w(周), n(月), y(年)。
#### 查询数据 ### 查询数据
```java ```java
// query data // query data
...@@ -184,7 +179,7 @@ while(resultSet.next()){ ...@@ -184,7 +179,7 @@ while(resultSet.next()){
> 查询和操作关系型数据库一致,使用下标获取返回字段内容时从 1 开始,建议使用字段名称获取。 > 查询和操作关系型数据库一致,使用下标获取返回字段内容时从 1 开始,建议使用字段名称获取。
#### 关闭资源 ### 关闭资源
```java ```java
resultSet.close(); resultSet.close();
...@@ -192,8 +187,7 @@ stmt.close(); ...@@ -192,8 +187,7 @@ stmt.close();
conn.close(); conn.close();
``` ```
### 与连接池使用 ## 与连接池使用
------
**HikariCP** **HikariCP**
...@@ -285,14 +279,12 @@ public static void main(String[] args) throws Exception { ...@@ -285,14 +279,12 @@ public static void main(String[] args) throws Exception {
> 更多 druid 使用问题请查看[官方说明][6] > 更多 druid 使用问题请查看[官方说明][6]
### 与框架使用 ## 与框架使用
------
* Spring JdbcTemplate 中使用 taos-jdbcdriver,可参考 [SpringJdbcTemplate][11] * Spring JdbcTemplate 中使用 taos-jdbcdriver,可参考 [SpringJdbcTemplate][11]
* Springboot + Mybatis 中使用,可参考 [springbootdemo][12] * Springboot + Mybatis 中使用,可参考 [springbootdemo][12]
### 常见问题 ## 常见问题
------
* java.lang.UnsatisfiedLinkError: no taos in java.library.path * java.lang.UnsatisfiedLinkError: no taos in java.library.path
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册