Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
taosdata
TDengine
提交
38b520b7
T
TDengine
项目概览
taosdata
/
TDengine
1 年多 前同步成功
通知
1185
Star
22016
Fork
4786
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
1
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
T
TDengine
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
1
Issue
1
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
38b520b7
编写于
4月 22, 2022
作者:
D
dingbo
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: replace RESTful API with REST API
上级
74f6eead
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
6 addition
and
6 deletion
+6
-6
docs-cn/04-connect/index.md
docs-cn/04-connect/index.md
+2
-2
docs-cn/14-reference/02-restful-api/02-restful-api.mdx
docs-cn/14-reference/02-restful-api/02-restful-api.mdx
+3
-3
docs-cn/14-reference/02-restful-api/_category_.yml
docs-cn/14-reference/02-restful-api/_category_.yml
+1
-1
未找到文件。
docs-cn/04-connect/index.md
浏览文件 @
38b520b7
...
@@ -17,12 +17,12 @@ import InstallOnLinux from "../14-reference/03-connector/_windows_install.mdx";
...
@@ -17,12 +17,12 @@ import InstallOnLinux from "../14-reference/03-connector/_windows_install.mdx";
import VerifyLinux from "../14-reference/03-connector/_verify_linux.mdx";
import VerifyLinux from "../14-reference/03-connector/_verify_linux.mdx";
import VerifyWindows from "../14-reference/03-connector/_verify_windows.mdx";
import VerifyWindows from "../14-reference/03-connector/_verify_windows.mdx";
TDengine 提供
RESTful接口,容许在任何平台的任何应用程序通过它访问TDengine运行实例,详细介绍请看
[
RESTful API
](
https://docs.taosdata.com/reference/restful-api/
)
。除 RESTful 之外,TDengine 还提供多种编程语言的连接器方便用户开发应用程序,其中包括 C/C++、Java、Python、Go、Node.js、C# 、RESTful
等。 本节介绍如何使用连接器建立与 TDengine 的连接,给出连接器安装、连接的简单说明。关于各连接器的详细功能说明,请查看
[
连接器
](
https://docs.taosdata.com/reference/connector/
)
TDengine 提供
RESTful 接口,容许在任何平台的任何应用程序通过它访问TDengine运行实例,详细介绍请看
[
REST API
](
https://docs.taosdata.com/reference/restful-api/
)
。除 REST API 之外,TDengine 还提供多种编程语言的连接器方便用户开发应用程序,其中包括 C/C++、Java、Python、Go、Node.js、C#
等。 本节介绍如何使用连接器建立与 TDengine 的连接,给出连接器安装、连接的简单说明。关于各连接器的详细功能说明,请查看
[
连接器
](
https://docs.taosdata.com/reference/connector/
)
## 连接器建立连接的方式
## 连接器建立连接的方式
连接器建立连接的方式,TDengine提供两种:
连接器建立连接的方式,TDengine提供两种:
1.
通过 taosAdapter 组件提供的 REST
ful
API 建立与 taosd 的连接,这种连接方式下文中简称"RESTful 连接“
1.
通过 taosAdapter 组件提供的 REST API 建立与 taosd 的连接,这种连接方式下文中简称"RESTful 连接“
2.
通过客户端驱动程序 taosc 直接与服务端程序 taosd 建立连接,这种连接方式下文中简称“本地连接”。
2.
通过客户端驱动程序 taosc 直接与服务端程序 taosd 建立连接,这种连接方式下文中简称“本地连接”。
无论使用何种方式建立连接,连接器都提供了相同或相似的 API 操作数据库,都可以执行 SQL 语句,只是初始化连接的方式稍有不同,用户在使用上不会感到什么差别。
无论使用何种方式建立连接,连接器都提供了相同或相似的 API 操作数据库,都可以执行 SQL 语句,只是初始化连接的方式稍有不同,用户在使用上不会感到什么差别。
...
...
docs-cn/14-reference/02-restful-api/02-restful-api.mdx
浏览文件 @
38b520b7
---
---
title: REST
ful
API
title: REST API
---
---
为支持各种不同类型平台的开发,TDengine 提供符合 REST 设计标准的 API,即 REST
ful API。为最大程度降低学习成本,不同于其他数据库 RESTful
API 的设计方法,TDengine 直接通过 HTTP POST 请求 BODY 中包含的 SQL 语句来操作数据库,仅需要一个 URL。RESTful 连接器的使用参见[视频教程](https://www.taosdata.com/blog/2020/11/11/1965.html)。
为支持各种不同类型平台的开发,TDengine 提供符合 REST 设计标准的 API,即 REST
API。为最大程度降低学习成本,不同于其他数据库 REST
API 的设计方法,TDengine 直接通过 HTTP POST 请求 BODY 中包含的 SQL 语句来操作数据库,仅需要一个 URL。RESTful 连接器的使用参见[视频教程](https://www.taosdata.com/blog/2020/11/11/1965.html)。
注意:与原生连接器的一个区别是,RESTful 接口是无状态的,因此 `USE db_name` 指令没有效果,所有对表名、超级表名的引用都需要指定数据库名前缀。(从 2.2.0.0 版本开始,支持在 RESTful url 中指定 db_name,这时如果 SQL 语句中没有指定数据库名前缀的话,会使用 url 中指定的这个 db_name。从 2.4.0.0 版本开始,RESTful 默认由 taosAdapter 提供,要求必须在 url 中指定 db_name。)
注意:与原生连接器的一个区别是,RESTful 接口是无状态的,因此 `USE db_name` 指令没有效果,所有对表名、超级表名的引用都需要指定数据库名前缀。(从 2.2.0.0 版本开始,支持在 RESTful url 中指定 db_name,这时如果 SQL 语句中没有指定数据库名前缀的话,会使用 url 中指定的这个 db_name。从 2.4.0.0 版本开始,RESTful 默认由 taosAdapter 提供,要求必须在 url 中指定 db_name。)
...
@@ -302,6 +302,6 @@ HTTP 请求 URL 采用 `sqlutc` 时,返回结果集的时间戳将采用 UTC
...
@@ -302,6 +302,6 @@ HTTP 请求 URL 采用 `sqlutc` 时,返回结果集的时间戳将采用 UTC
- httpDbNameMandatory: 是否必须在 RESTful url 中指定默认的数据库名。默认为 0,即关闭此检查。如果设置为 1,那么每个 RESTful url 中都必须设置一个默认数据库名,否则无论此时执行的 SQL 语句是否需要指定数据库,都会返回一个执行错误,拒绝执行此 SQL 语句。
- httpDbNameMandatory: 是否必须在 RESTful url 中指定默认的数据库名。默认为 0,即关闭此检查。如果设置为 1,那么每个 RESTful url 中都必须设置一个默认数据库名,否则无论此时执行的 SQL 语句是否需要指定数据库,都会返回一个执行错误,拒绝执行此 SQL 语句。
:::note
:::note
如果使用 taosd 提供的 REST
ful API, 那么以上配置需要写在 taosd 的配置文件 taos.cfg 中。如果使用 taosAdaper 提供的 RESTful
API, 那么需要参考 taosAdaper [对应的配置方法](/reference/taosadapter/)。
如果使用 taosd 提供的 REST
API, 那么以上配置需要写在 taosd 的配置文件 taos.cfg 中。如果使用 taosAdaper 提供的 REST
API, 那么需要参考 taosAdaper [对应的配置方法](/reference/taosadapter/)。
:::
:::
docs-cn/14-reference/02-restful-api/_category_.yml
浏览文件 @
38b520b7
label
:
REST
ful
API
label
:
REST API
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录