diff --git a/documentation20/cn/09.connections/docs.md b/documentation20/cn/09.connections/docs.md index d79d07661b95f8a807bff226185d3804e0ce0f4d..69825e655940045669fedeafdc9ab709c7ed15d9 100644 --- a/documentation20/cn/09.connections/docs.md +++ b/documentation20/cn/09.connections/docs.md @@ -94,78 +94,3 @@ GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=tdengine-datasource 在 2.3.3.0 及以上版本,您可以导入 TDinsight Dashboard (Grafana Dashboard ID: [15167](https://grafana.com/grafana/dashboards/15167)) 作为 TDengine 集群的监控可视化工具。安装和使用说明请见 [TDinsight 用户手册](https://www.taosdata.com/cn/documentation/tools/insight)。 -## MATLAB - -MATLAB 可以通过安装包内提供的 JDBC Driver 直接连接到 TDengine 获取数据到本地工作空间。 - -### MATLAB 的 JDBC 接口适配 - -MATLAB 的适配有下面几个步骤,下面以 Windows 10 上适配 MATLAB2021a 为例: - -- 将 TDengine 客户端安装路径下的 `\TDengine\connector\jdbc的驱动程序taos-jdbcdriver-2.0.25-dist.jar` 拷贝到 `${matlab_root}\MATLAB\R2021a\java\jar\toolbox`。 -- 将 TDengine 安装包内的 `taos.lib` 文件拷贝至 `${matlab_root_dir}\MATLAB\R2021\lib\win64`。 -- 将新添加的驱动 jar 包加入 MATLAB 的 classpath。在 `${matlab_root_dir}\MATLAB\R2021a\toolbox\local\classpath.txt` 文件中添加下面一行: -``` -$matlabroot/java/jar/toolbox/taos-jdbcdriver-2.0.25-dist.jar -``` -- 在 `${user_home}\AppData\Roaming\MathWorks\MATLAB\R2021a\` 下添加一个文件 `javalibrarypath.txt`,并在该文件中添加 taos.dll 的路径,比如您的 taos.dll 是在安装时拷贝到了 `C:\Windows\System32` 下,那么就应该在 `javalibrarypath.txt` 中添加如下一行: -``` -C:\Windows\System32 -``` - -### 在 MATLAB 中连接 TDengine 获取数据 - -在成功进行了上述配置后,打开 MATLAB。 - -- 创建一个连接: -```matlab -conn = database(‘test’, ‘root’, ‘taosdata’, ‘com.taosdata.jdbc.TSDBDriver’, ‘jdbc:TSDB://192.168.1.94:6030/’) -``` -- 执行一次查询: -```matlab -sql0 = [‘select * from tb’] -data = select(conn, sql0); -``` -- 插入一条记录: -```matlab -sql1 = [‘insert into tb values (now, 1)’] -exec(conn, sql1) -``` - -更多例子细节请参考安装包内 `examples\Matlab\TDengineDemo.m` 文件。 - -## R - -R语言支持通过JDBC接口来连接TDengine数据库。首先需要安装R语言的JDBC包。启动R语言环境,然后执行以下命令安装R语言的JDBC支持库: - -```R -install.packages('RJDBC', repos='http://cran.us.r-project.org') -``` - -安装完成以后,通过执行`library('RJDBC')`命令加载 _RJDBC_ 包: - -然后加载TDengine的JDBC驱动: - -```R -drv<-JDBC("com.taosdata.jdbc.TSDBDriver","JDBCDriver-2.0.0-dist.jar", identifier.quote="\"") -``` -如果执行成功,不会出现任何错误信息。之后通过以下命令尝试连接数据库: - -```R -conn<-dbConnect(drv,"jdbc:TSDB://192.168.0.1:0/?user=root&password=taosdata","root","taosdata") -``` - -注意将上述命令中的IP地址替换成正确的IP地址。如果没有任务错误的信息,则连接数据库成功,否则需要根据错误提示调整连接的命令。TDengine支持以下的 _RJDBC_ 包中函数: - - -- dbWriteTable(conn, "test", iris, overwrite=FALSE, append=TRUE):将数据框iris写入表test中,overwrite必须设置为false,append必须设为TRUE,且数据框iris要与表test的结构一致。 -- dbGetQuery(conn, "select count(*) from test"):查询语句。 -- dbSendUpdate(conn, "use db"):执行任何非查询sql语句。例如dbSendUpdate(conn, "use db"), 写入数据dbSendUpdate(conn, "insert into t1 values(now, 99)")等。 -- dbReadTable(conn, "test"):读取表test中数据。 -- dbDisconnect(conn):关闭连接。 -- dbRemoveTable(conn, "test"):删除表test。 - -TDengine客户端暂不支持如下函数: -- dbExistsTable(conn, "test"):是否存在表test。 -- dbListTables(conn):显示连接中的所有表。 -