homework-jianmu/docs/zh/07-develop/05-stmt.md

title	sidebar_label	toc_max_heading_level
参数绑定写入	参数绑定	4

import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem";

通过参数绑定方式写入数据时，能避免 SQL 语法解析的资源消耗，从而显著提升写入性能。参数绑定能提高写入效率的原因主要有以下几点：

• 减少解析时间：通过参数绑定，SQL 语句的结构在第一次执行时就已经确定，后续的执行只需要替换参数值，这样可以避免每次执行时都进行语法解析，从而减少解析时间。
• 预编译：当使用参数绑定时，SQL 语句可以被预编译并缓存，后续使用不同的参数值执行时，可以直接使用预编译的版本，提高执行效率。
• 减少网络开销：参数绑定还可以减少发送到数据库的数据量，因为只需要发送参数值而不是完整的 SQL 语句，特别是在执行大量相似的插入或更新操作时，这种差异尤为明显。

Tips: 数据写入推荐使用参数绑定方式

:::note 我们只推荐使用下面两种形式的 SQL 进行参数绑定写入：

```sql
一、确定子表存在
   1. INSERT INTO meters (tbname, ts, current, voltage, phase) VALUES(?, ?, ?, ?, ?)  
二、自动建表
   1. INSERT INTO meters (tbname, ts, current, voltage, phase, location, group_id) VALUES(?, ?, ?, ?, ?, ?, ?)   
   2. INSERT INTO ? USING meters TAGS (?, ?) VALUES (?, ?, ?, ?)
```

:::

下面我们继续以智能电表为例，展示各语言连接器使用参数绑定高效写入的功能：

1. 准备一个参数化的 SQL 插入语句，用于向超级表 meters 中插入数据。这个语句允许动态地指定子表名、标签和列值。
2. 循环生成多个子表及其对应的数据行。对于每个子表：
   • 设置子表的名称和标签值（分组 ID 和位置）。
   • 生成多行数据，每行包括一个时间戳、随机生成的电流、电压和相位值。
   • 执行批量插入操作，将这些数据行插入到对应的子表中。
3. 最后打印实际插入表中的行数。

WebSocket 连接

参数绑定有两种接口使用方式，一种是 JDBC 标准接口，一种是扩展接口，扩展接口性能更好一些。

{{#include docs/examples/java/src/main/java/com/taos/example/WSParameterBindingStdInterfaceDemo.java:para_bind}}

{{#include docs/examples/java/src/main/java/com/taos/example/WSParameterBindingExtendInterfaceDemo.java:para_bind}}

这是一个 更详细的参数绑定示例

{{#include docs/examples/python/stmt_ws.py}}

```go {{#include docs/examples/go/stmt/ws/main.go}} ```

{{#include docs/examples/rust/restexample/examples/stmt.rs}}

    {{#include docs/examples/node/websocketexample/stmt_example.js:createConnect}}

```csharp {{#include docs/examples/csharp/wsStmt/Program.cs:main}} ``` ```c {{#include docs/examples/c-ws/stmt_insert_demo.c}} ``` 不支持

原生连接

{{#include docs/examples/java/src/main/java/com/taos/example/ParameterBindingBasicDemo.java:para_bind}}

这是一个 更详细的参数绑定示例

{{#include docs/examples/python/stmt2_native.py}}

stmt2 绑定参数的示例代码如下（go 连接器 v3.6.0 及以上，TDengine v3.3.5.0 及以上）：

{{#include docs/examples/go/stmt2/native/main.go}}

stmt 绑定参数的示例代码如下：

{{#include docs/examples/go/stmt/native/main.go}}

{{#include docs/examples/rust/nativeexample/examples/stmt.rs}}

不支持 ```csharp {{#include docs/examples/csharp/stmtInsert/Program.cs:main}} ```

stmt2 绑定参数的示例代码如下（需要 TDengine v3.3.5.0 及以上）：

{{#include docs/examples/c/stmt2_insert_demo.c}}

stmt 绑定参数的示例代码如下：

{{#include docs/examples/c/stmt_insert_demo.c}}

不支持