Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
taosdata
TDengine
提交
a17b3c91
TDengine
项目概览
taosdata
/
TDengine
1 年多 前同步成功
通知
1185
Star
22016
Fork
4786
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
1
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
TDengine
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
1
Issue
1
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
a17b3c91
编写于
8月 19, 2021
作者:
E
Elias Soong
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
[TD-4181] <docs>: move intro part to be the beginning of Java doc.
上级
f0280f42
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
81 addition
and
77 deletion
+81
-77
documentation20/cn/08.connector/01.java/docs.md
documentation20/cn/08.connector/01.java/docs.md
+81
-77
未找到文件。
documentation20/cn/08.connector/01.java/docs.md
浏览文件 @
a17b3c91
# Java Connector
# Java Connector
## 安装
## 总体介绍
Java连接器支持的系统有: Linux 64/Windows x64/Windows x86。
**安装前准备:**
-
已安装TDengine服务器端
-
已安装好TDengine应用驱动,具体请参照
[
安装连接器驱动步骤
](
https://www.taosdata.com/cn/documentation/connector#driver
)
章节
TDengine 为了方便 Java 应用使用,提供了遵循 JDBC 标准(3.0)API 规范的
`taos-jdbcdriver`
实现。目前可以通过
[
Sonatype Repository
](
https://search.maven.org/artifact/com.taosdata.jdbc/taos-jdbcdriver
)
搜索并下载。
由于 TDengine 的应用驱动是使用C语言开发的,使用 taos-jdbcdriver 驱动包时需要依赖系统对应的本地函数库。
-
libtaos.so 在 Linux 系统中成功安装 TDengine 后,依赖的本地函数库 libtaos.so 文件会被自动拷贝至 /usr/lib/libtaos.so,该目录包含在 Linux 自动扫描路径上,无需单独指定。
-
taos.dll 在 Windows 系统中安装完客户端之后,驱动包依赖的 taos.dll 文件会自动拷贝到系统默认搜索路径 C:/Windows/System32 下,同样无需要单独指定。
注意:在 Windows 环境开发时需要安装 TDengine 对应的
[
windows 客户端
](
https://www.taosdata.com/cn/all-downloads/#TDengine-Windows-Client
)
,Linux 服务器安装完 TDengine 之后默认已安装 client,也可以单独安装
[
Linux 客户端
](
https://www.taosdata.com/cn/getting-started/#快速上手
)
连接远程 TDengine Server。
### 如何获取 TAOS-JDBCDriver
**maven仓库**
目前 taos-jdbcdriver 已经发布到
[
Sonatype Repository
](
https://search.maven.org/artifact/com.taosdata.jdbc/taos-jdbcdriver
)
仓库,且各大仓库都已同步。
-
[
sonatype
](
https://search.maven.org/artifact/com.taosdata.jdbc/taos-jdbcdriver
)
-
[
mvnrepository
](
https://mvnrepository.com/artifact/com.taosdata.jdbc/taos-jdbcdriver
)
-
[
maven.aliyun
](
https://maven.aliyun.com/mvn/search
)
maven 项目中使用如下 pom.xml 配置即可:
```
xml-dtd
<dependency>
<groupId>com.taosdata.jdbc</groupId>
<artifactId>taos-jdbcdriver</artifactId>
<version>2.0.18</version>
</dependency>
```
**源码编译打包**
下载 TDengine 源码之后,进入 taos-jdbcdriver 源码目录
`src/connector/jdbc`
执行
`mvn clean package -Dmaven.test.skip=true`
即可生成相应 jar 包。
### 示例程序
示例程序源码位于install_directory/examples/JDBC,有如下目录:
JDBCDemo JDBC示例源程序
JDBCConnectorChecker JDBC安装校验源程序及jar包
Springbootdemo springboot示例源程序
SpringJdbcTemplate SpringJDBC模板
### 安装验证
运行如下指令:
```
Bash
cd {install_directory}/examples/JDBC/JDBCConnectorChecker
java -jar JDBCConnectorChecker.jar -host <fqdn>
```
验证通过将打印出成功信息。
TDengine 提供了遵循 JDBC 标准(3.0)API 规范的
`taos-jdbcdriver`
实现,可在 maven 的中央仓库
[
Sonatype Repository
](
https://search.maven.org/artifact/com.taosdata.jdbc/taos-jdbcdriver
)
搜索下载。
## Java连接器的使用
`taos-jdbcdriver`
的实现包括 2 种形式: JDBC-JNI 和 JDBC-RESTful(taos-jdbcdriver-2.0.18 开始支持 JDBC-RESTful)。 JDBC-JNI 通过调用客户端 libtaos.so(或 taos.dll )的本地方法实现, JDBC-RESTful 则在内部封装了 RESTful 接口实现。
`taos-jdbcdriver`
的实现包括 2 种形式: JDBC-JNI 和 JDBC-RESTful(taos-jdbcdriver-2.0.18 开始支持 JDBC-RESTful)。 JDBC-JNI 通过调用客户端 libtaos.so(或 taos.dll )的本地方法实现, JDBC-RESTful 则在内部封装了 RESTful 接口实现。
...
@@ -143,6 +81,72 @@ TDengine 目前支持时间戳、数字、字符、布尔类型,与 Java 对
...
@@ -143,6 +81,72 @@ TDengine 目前支持时间戳、数字、字符、布尔类型,与 Java 对
| BINARY | byte array |
| BINARY | byte array |
| NCHAR | java.lang.String |
| NCHAR | java.lang.String |
## 安装
Java连接器支持的系统有: Linux 64/Windows x64/Windows x86。
**安装前准备:**
-
已安装TDengine服务器端
-
已安装好TDengine应用驱动,具体请参照
[
安装连接器驱动步骤
](
https://www.taosdata.com/cn/documentation/connector#driver
)
章节
TDengine 为了方便 Java 应用使用,遵循 JDBC 标准(3.0)API 规范提供了
`taos-jdbcdriver`
实现。可以通过
[
Sonatype Repository
](
https://search.maven.org/artifact/com.taosdata.jdbc/taos-jdbcdriver
)
搜索并下载。
由于 TDengine 的应用驱动是使用C语言开发的,使用 taos-jdbcdriver 驱动包时需要依赖系统对应的本地函数库。
-
libtaos.so 在 Linux 系统中成功安装 TDengine 后,依赖的本地函数库 libtaos.so 文件会被自动拷贝至 /usr/lib/libtaos.so,该目录包含在 Linux 自动扫描路径上,无需单独指定。
-
taos.dll 在 Windows 系统中安装完客户端之后,驱动包依赖的 taos.dll 文件会自动拷贝到系统默认搜索路径 C:/Windows/System32 下,同样无需要单独指定。
注意:在 Windows 环境开发时需要安装 TDengine 对应的
[
windows 客户端
](
https://www.taosdata.com/cn/all-downloads/#TDengine-Windows-Client
)
,Linux 服务器安装完 TDengine 之后默认已安装 client,也可以单独安装
[
Linux 客户端
](
https://www.taosdata.com/cn/getting-started/#快速上手
)
连接远程 TDengine Server。
### 如何获取 TAOS-JDBCDriver
**maven仓库**
目前 taos-jdbcdriver 已经发布到
[
Sonatype Repository
](
https://search.maven.org/artifact/com.taosdata.jdbc/taos-jdbcdriver
)
仓库,且各大仓库都已同步。
-
[
sonatype
](
https://search.maven.org/artifact/com.taosdata.jdbc/taos-jdbcdriver
)
-
[
mvnrepository
](
https://mvnrepository.com/artifact/com.taosdata.jdbc/taos-jdbcdriver
)
-
[
maven.aliyun
](
https://maven.aliyun.com/mvn/search
)
maven 项目中使用如下 pom.xml 配置即可:
```
xml-dtd
<dependency>
<groupId>com.taosdata.jdbc</groupId>
<artifactId>taos-jdbcdriver</artifactId>
<version>2.0.18</version>
</dependency>
```
**源码编译打包**
下载 TDengine 源码之后,进入 taos-jdbcdriver 源码目录
`src/connector/jdbc`
执行
`mvn clean package -Dmaven.test.skip=true`
即可生成相应 jar 包。
### 示例程序
示例程序源码位于install_directory/examples/JDBC,有如下目录:
JDBCDemo JDBC示例源程序
JDBCConnectorChecker JDBC安装校验源程序及jar包
Springbootdemo springboot示例源程序
SpringJdbcTemplate SpringJDBC模板
### 安装验证
运行如下指令:
```
Bash
cd {install_directory}/examples/JDBC/JDBCConnectorChecker
java -jar JDBCConnectorChecker.jar -host <fqdn>
```
验证通过将打印出成功信息。
## Java连接器的使用
### 获取连接
### 获取连接
#### 指定URL获取连接
#### 指定URL获取连接
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录