diff --git a/docs/zh/06-advanced/05-data-in/index.md b/docs/zh/06-advanced/05-data-in/index.md index cf785eb128..9699455110 100644 --- a/docs/zh/06-advanced/05-data-in/index.md +++ b/docs/zh/06-advanced/05-data-in/index.md @@ -154,8 +154,8 @@ let v3 = data["voltage"].split(","); 如下图所示 -* 对字段`ts`使用 split 规则拆分成日期和时间。split 规则需要设置**分隔符**和**拆分数量**,拆分后的字段命名规则为`{原字段名}_{顺序号}`。 -* 对字段`voltage`使用正则表达式 `^(?[0-9]+)(?[a-zA-Z]+)$` 提取出电压值和电压单位,Regex 规则同解析过程中的一样,使用**命名捕获组**命名提取字段。 +* 对字段 `ts` 使用 split 规则拆分成日期和时间。split 规则需要设置 **分隔符** 和 **拆分数量**,拆分后的字段命名规则为 `{原字段名}_{顺序号}`。 +* 对字段 `voltage` 使用正则表达式 `^(?[0-9]+)(?[a-zA-Z]+)$` 提取出电压值和电压单位,Regex 规则同解析过程中的一样,使用 **命名捕获组** 命名提取字段。 * 对字段 `location` 使用 convert 转换,填写一个 JSON map 对象,其中 key 为字段 `current` 的值,`value` 为转换后的值。如图,`location` 字段的值 `"beijing.chaoyang.datun"` 被转换为 `"beijing.chaoyang.datunludong"`。 ![拆分和提取](./pic/transform-04.png) diff --git a/docs/zh/14-reference/01-components/01-taosd.md b/docs/zh/14-reference/01-components/01-taosd.md index 85f0ccd822..5ae2640541 100644 --- a/docs/zh/14-reference/01-components/01-taosd.md +++ b/docs/zh/14-reference/01-components/01-taosd.md @@ -33,21 +33,21 @@ taosd 命令行参数如下 - 类型:endpoint - 默认值:localhost:6030 - 动态修改:不支持 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### secondEp - 说明:taosd 启动时,如果 firstEp 连接不上,尝试连接集群中第二个 dnode 的 endpoint - 类型:endpoint - 默认值:无 - 动态修改:不支持 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### fqdn - 说明:taosd 监听的服务地址 - 类型:fqdn - 默认值:所在服务器上配置的第一个 hostname - 动态修改:不支持 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### serverPort - 说明:taosd 监听的端口 @@ -56,7 +56,7 @@ taosd 命令行参数如下 - 最小值:1 - 最大值:65056 - 动态修改:不支持 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### compressMsgSize - 说明:是否对 RPC 消息进行压缩 @@ -65,7 +65,7 @@ taosd 命令行参数如下 - 最小值:-1 - 最大值:100000000 - 动态修改:支持通过 SQL 修改,重启后生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### shellActivityTimer - 说明:客户端向 mnode 发送心跳的时长 @@ -75,7 +75,7 @@ taosd 命令行参数如下 - 最小值:1 - 最大值:120 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### numOfRpcSessions - 说明:RPC 支持的最大连接数 @@ -84,7 +84,7 @@ taosd 命令行参数如下 - 最小值:100 - 最大值:100000 - 动态修改:支持通过 SQL 修改,重启后生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### numOfRpcThreads - 说明:RPC 收发数据的线程数目 @@ -93,7 +93,7 @@ taosd 命令行参数如下 - 最小值:1 - 最大值:50 - 动态修改:支持通过 SQL 修改,重启后生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### numOfTaskQueueThreads - 说明:RPC 处理消息的线程数目 @@ -102,7 +102,7 @@ taosd 命令行参数如下 - 最小值:4 - 最大值:16 - 动态修改:支持通过 SQL 修改,重启后生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### rpcQueueMemoryAllowed - 说明:dnode 已经收到并等待处理的 RPC 消息占用内存的最大值 @@ -112,7 +112,7 @@ taosd 命令行参数如下 - 最小值:104857600 - 最大值:INT64_MAX - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### resolveFQDNRetryTime - 说明:FQDN 解析失败时的重试次数 @@ -121,7 +121,7 @@ taosd 命令行参数如下 - 最小值:1 - 最大值:10240 - 动态修改:不支持 -- 支持版本:v3.3.4.0 版本之后取消 +- 支持版本:v3.3.4.0 之后取消 #### timeToGetAvailableConn - 说明:获得可用连接的最长等待时间 @@ -131,7 +131,7 @@ taosd 命令行参数如下 - 最小值:20 - 最大值:1000000 - 动态修改:不支持 -- 支持版本:v3.3.4.0 版本之后取消 +- 支持版本:v3.3.4.0 之后取消 #### maxShellConns - 说明:允许创建的最大链接数 @@ -140,7 +140,7 @@ taosd 命令行参数如下 - 最小值:10 - 最大值:50000000 - 动态修改:不支持 -- 支持版本:v3.3.4.0 版本之后取消 +- 支持版本:v3.3.4.0 之后取消 #### maxRetryWaitTime - 说明:重连最大超时时间,从重试时候开始计算 @@ -150,7 +150,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:86400000 - 动态修改:支持通过 SQL 修改,重启后生效 -- 支持版本:从 v3.3.4.0 版本开始引入 +- 支持版本:v3.3.4.0 引入 #### shareConnLimit - 说明:一个链接可以共享的请求的数目 @@ -159,7 +159,7 @@ taosd 命令行参数如下 - 最小值:1 - 最大值:512 - 动态修改:支持通过 SQL 修改,重启后生效 -- 支持版本:从 v3.3.4.0 版本开始引入 +- 支持版本:v3.3.4.0 引入 #### readTimeout - 说明:单个请求最小超时时间 @@ -169,7 +169,7 @@ taosd 命令行参数如下 - 最小值:64 - 最大值:604800 - 动态修改:支持通过 SQL 修改,重启后生效 -- 支持版本:从 v3.3.4.0 版本开始引入 +- 支持版本:v3.3.4.0 引入 ### 监控相关 @@ -180,14 +180,14 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### monitorFqdn - 说明:taosKeeper 服务所在服务器的地址 - 类型:fqdn - 默认值:无 - 动态修改:支持通过 SQL 修改,重启后生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### monitorPort - 说明:taosKeeper 服务所监听的端口号 @@ -196,7 +196,7 @@ taosd 命令行参数如下 - 最小值:1 - 最大值:65056 - 动态修改:支持通过 SQL 修改,重启后生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### monitorInterval - 说明:监控数据库记录系统参数(CPU/内存)的时间间隔 @@ -206,7 +206,7 @@ taosd 命令行参数如下 - 最小值:1 - 最大值:200000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### monitorMaxLogs - 说明:缓存的待上报日志条数 @@ -215,7 +215,7 @@ taosd 命令行参数如下 - 最小值:1 - 最大值:1000000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### monitorComp - 说明:是否采用压缩方式上报监控日志 @@ -224,7 +224,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,重启后生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### monitorLogProtocol - 说明:是否打印监控日志 @@ -233,7 +233,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.3.0.0 版本开始引入 +- 支持版本:v3.3.0.0 引入 #### monitorForceV2 - 说明:是否使用 V2 版本协议上报日志 @@ -242,7 +242,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.3.0.0 版本开始引入 +- 支持版本:v3.3.0.0 引入 #### telemetryReporting - 说明:是否上传 telemetry @@ -251,14 +251,14 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### telemetryServer - 说明:telemetry 服务器地址 - 类型:fqdn - 默认值:telemetry.taosdata.com - 动态修改:不支持 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### telemetryPort - 说明:telemetry 服务器端口号 @@ -267,7 +267,7 @@ taosd 命令行参数如下 - 最小值:1 - 最大值:65056 - 动态修改:不支持 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### telemetryInterval - 说明:telemetry 上传时间间隔 @@ -277,7 +277,7 @@ taosd 命令行参数如下 - 最小值:1 - 最大值:200000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### crashReporting - 说明:是否使用 V2 版本协议上报日志 @@ -286,7 +286,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 ### 查询相关 @@ -297,7 +297,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.0.0.0 版本开始引入 +- 支持版本:v3.0.0.0 引入 #### tagFilterCache - 说明:是否缓存标签过滤结果 @@ -306,7 +306,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### queryBufferSize - 说明:查询可用的缓存大小 @@ -325,7 +325,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### queryUseMemoryPool - 说明:查询是否使用内存池管理内存 @@ -334,7 +334,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:不支持 -- 支持版本:从 v3.3.5.0 版本开始引入 +- 支持版本:v3.3.5.0 引入 #### minReservedMemorySize - 说明:最小预留的系统可用内存数量,除预留外的内存都可以被用于查询 @@ -344,7 +344,7 @@ taosd 命令行参数如下 - 最小值:1024 - 最大值:1000000000 - 动态修改:不支持 -- 支持版本:从 v3.3.5.0 版本开始引入 +- 支持版本:v3.3.5.0 引入 #### singleQueryMaxMemorySize - 说明:单个查询在单个节点(dnode)上可以使用的内存上限,超过该上限将返回错 @@ -354,7 +354,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1000000000 - 动态修改:不支持 -- 支持版本:从 v3.3.5.0 版本开始引入 +- 支持版本:v3.3.5.0 引入 #### filterScalarMode - 说明:强制使用标量过滤模式 @@ -363,7 +363,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### queryNoFetchTimeoutSec - 说明:查询中当应用长时间不 FETCH 数据时的超时时间,从最后一次响应起计时,超时自动清除任务 `内部参数` @@ -372,7 +372,7 @@ taosd 命令行参数如下 - 最小值:60 - 最大值:1000000000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### queryPlannerTrace - 说明:查询计划是否输出详细日志 `内部参数` @@ -381,7 +381,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### queryNodeChunkSize - 说明:查询计划的块大小 `内部参数` @@ -391,7 +391,7 @@ taosd 命令行参数如下 - 最小值:1024 - 最大值:128 * 1024 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### queryUseNodeAllocator - 说明:查询计划的分配方法 `内部参数` @@ -400,7 +400,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### queryMaxConcurrentTables - 说明:查询计划的分配方法 `内部参数` @@ -409,7 +409,7 @@ taosd 命令行参数如下 - 最小值:INT64_M - 最大值:INT64_MAX - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### queryRsmaTolerance - 说明:查询计划的分配方法 `内部参数` @@ -418,7 +418,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:900000 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### enableQueryHb - 说明:是否发送查询心跳消息 `内部参数` @@ -427,7 +427,7 @@ taosd 命令行参数如下 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### pqSortMemThreshold - 说明:排序使用的内存阈值 `内部参数` @@ -437,26 +437,26 @@ taosd 命令行参数如下 - 最小值:1 - 最大值:10240 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 ### 区域相关 #### timezone - 说明:时区 - 默认值:从系统中动态获取当前的时区设置 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### locale - 说明:系统区位信息及编码格式 - 默认值:从系统中获取 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### charset - 说明:字符集编码 - 默认值:从系统中获取 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 :::info #### 区域相关参数说明 @@ -541,7 +541,7 @@ charset 的有效值是 UTF-8。 - 类型:字符串 - 默认值:/var/lib/taos - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### diskIDCheckEnabled - 说明:在重启 dnode 时增加了检查 dataDir 所在磁盘 id 是否发生改变 @@ -549,14 +549,14 @@ charset 的有效值是 UTF-8。 - 默认值:1 - 最小值:0 - 最大值:1 -- 支持版本:从 v3.3.5.0 版本开始引入 +- 支持版本:v3.3.5.0 引入 #### tempDir - 说明:指定所有系统运行过程中的临时文件生成的目录 - 类型:字符串 - 默认值:/tmp - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### minimalDataDirGB - 说明:dataDir 指定的时序数据存储目录所需要保留的最小空间 @@ -566,7 +566,7 @@ charset 的有效值是 UTF-8。 - 最小值:0.001f - 最大值:10000000 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### minimalTmpDirGB - 说明:tempDir 所指定的临时文件目录所需要保留的最小空间 @@ -576,7 +576,7 @@ charset 的有效值是 UTF-8。 - 最小值:0.001f - 最大值:10000000 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### minDiskFreeSize - 说明:当某块磁盘上的可用空间小于等于这个阈值时,该磁盘将不再被选择用于生成新的数据文件 `企业版参数` @@ -586,7 +586,7 @@ charset 的有效值是 UTF-8。 - 最小值:52428800 - 最大值:1073741824 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### s3MigrateIntervalSec - 说明:本地数据文件自动上传 S3 的触发周期 `企业版参数` @@ -596,7 +596,7 @@ charset 的有效值是 UTF-8。 - 最小值:600 - 最大值:100000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.3.4.3 版本开始引入 +- 支持版本:v3.3.4.3 引入 #### s3MigrateEnabled - 说明:是否自动进行 S3 迁移 `企业版参数` @@ -605,24 +605,24 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.3.4.3 版本开始引入 +- 支持版本:v3.3.4.3 引入 #### s3Accesskey - 说明:冒号分隔的用户 SecretId:SecretKey `企业版参数` - 示例:AKIDsQmwsfKxTo2A6nGVXZN0UlofKn6JRRSJ:lIdoy99ygEacU7iHfogaN2Xq0yumSm1E - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.3.4.3 版本开始引入 +- 支持版本:v3.3.4.3 引入 #### s3Endpoint - 说明:用户所在地域的 COS 服务域名,支持 http 和 https,bucket 的区域需要与 endpoint 保持一致,否则无法访问 `企业版参数` - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.3.4.3 版本开始引入 +- 支持版本:v3.3.4.3 引入 #### s3BucketName - 说明:存储桶名称,减号后面是用户注册 COS 服务的 AppId,其中 AppId 是 COS 特有,AWS 和阿里云都没有,配置时需要作为 bucket name 的一部分,使用减号分隔;参数值均为字符串类型,但不需要引号 `企业版参数` - 示例:test0711-1309024725 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.3.4.3 版本开始引入 +- 支持版本:v3.3.4.3 引入 #### s3PageCacheSize - 说明:S3 page cache 缓存页数目 `企业版参数` @@ -633,7 +633,7 @@ charset 的有效值是 UTF-8。 - 最大值:1048576 - 示例:test0711-1309024725 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.3.4.3 版本开始引入 +- 支持版本:v3.3.4.3 引入 #### s3UploadDelaySec - 说明:data 文件持续多长时间不再变动后上传至 S3 `企业版参数` @@ -643,7 +643,7 @@ charset 的有效值是 UTF-8。 - 最小值:1 - 最大值:2592000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.3.4.3 版本开始引入 +- 支持版本:v3.3.4.3 引入 #### cacheLazyLoadThreshold - 说明:缓存的装载策略 `内部参数` @@ -652,7 +652,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:100000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 ### 集群相关 @@ -663,7 +663,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:4096 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### numOfCommitThreads - 说明:落盘线程的最大数量 @@ -672,7 +672,7 @@ charset 的有效值是 UTF-8。 - 最小值:1 - 最大值:1024 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### numOfCompactThreads - 说明:合并线程的最大数量 @@ -681,7 +681,7 @@ charset 的有效值是 UTF-8。 - 最小值:1 - 最大值:16 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### numOfMnodeReadThreads - 说明:mnode 的 Read 线程数目 @@ -690,7 +690,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1024 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### numOfVnodeQueryThreads - 说明:vnode 的 Query 线程数目 @@ -699,7 +699,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1024 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### numOfVnodeFetchThreads - 说明:vnode 的 Fetch 线程数目 @@ -708,7 +708,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1024 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### numOfVnodeRsmaThreads - 说明:vnode 的 Rsma 线程数目 @@ -717,7 +717,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1024 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### numOfQnodeQueryThreads - 说明:qnode 的 Query 线程数目 @@ -726,7 +726,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1024 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### numOfSnodeSharedThreads - 说明:snode 的共享线程数目 @@ -735,7 +735,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1024 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### numOfSnodeUniqueThreads - 说明:snode 的独占线程数目 @@ -744,7 +744,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1024 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### ratioOfVnodeStreamThreads - 说明:流计算使用 vnode 线程的比例 @@ -753,7 +753,7 @@ charset 的有效值是 UTF-8。 - 最小值:0.01 - 最大值:4 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### ttlUnit - 说明:ttl 参数的单位 @@ -763,7 +763,7 @@ charset 的有效值是 UTF-8。 - 最小值:1 - 最大值:31572500 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### ttlPushInterval - 说明:ttl 检测超时频率 @@ -773,7 +773,7 @@ charset 的有效值是 UTF-8。 - 最小值:1 - 最大值:100000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### ttlChangeOnWrite - 说明:ttl 到期时间是否伴随表的修改操作改变 @@ -782,7 +782,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### ttlBatchDropNum - 说明:ttl 一批删除子表的数目 @@ -791,7 +791,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:2147483647 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### retentionSpeedLimitMB - 说明:数据在不同级别硬盘上迁移时的速度限制 @@ -801,7 +801,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1024 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### maxTsmaNum - 说明:集群内可创建的TSMA个数 @@ -810,7 +810,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:3 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### tmqMaxTopicNum - 说明:订阅最多可建立的 topic 数量 @@ -819,7 +819,7 @@ charset 的有效值是 UTF-8。 - 最小值:1 - 最大值:10000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### tmqRowSize - 说明:订阅数据块的最大记录条数 @@ -828,7 +828,7 @@ charset 的有效值是 UTF-8。 - 最小值:1 - 最大值:1000000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### audit - 说明:审计功能开关;`企业版参数` @@ -837,7 +837,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### auditInterval - 说明:审计数据上报的时间间隔;`企业版参数` @@ -846,7 +846,7 @@ charset 的有效值是 UTF-8。 - 最小值:500 - 最大值:200000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### auditCreateTable - 说明:是否针对创建子表开启申计功能;`企业版参数` @@ -855,19 +855,19 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### encryptAlgorithm - 说明:数据加密算法;`企业版参数` - 类型:字符串 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### encryptScope - 说明:加密范围;`企业版参数` - 类型:字符串 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### enableWhiteList - 说明:白名单功能开关;`企业版参数` @@ -876,7 +876,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### syncLogBufferMemoryAllowed - 说明:一个 dnode 允许的 sync 日志缓存消息占用的内存最大值 @@ -892,109 +892,109 @@ charset 的有效值是 UTF-8。 - 说明:用于同步模块调试,`内部参数` - 类型:整数 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### syncHeartbeatInterval - 说明:用于同步模块调试,`内部参数` - 类型:整数 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### syncHeartbeatTimeout - 说明:用于同步模块调试,`内部参数` - 类型:整数 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### syncSnapReplMaxWaitN - 说明:用于同步模块调试,`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### arbHeartBeatIntervalSec - 说明:用于同步模块调试,`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### arbCheckSyncIntervalSec - 说明:用于同步模块调试,`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### arbSetAssignedTimeoutSec - 说明:用于同步模块调试,`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### arbSetAssignedTimeoutSec - 说明:用于 mnode 模块调试,`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### mndLogRetention - 说明:用于 mnode 模块调试,`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### skipGrant - 说明:用于授权检查,`内部参数` - 类型:整数 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### trimVDbIntervalSec - 说明:用于删除过期数据,`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### ttlFlushThreshold - 说明:ttl 定时器的频率,`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### compactPullupInterval - 说明:数据重整定时器的频率,`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### walFsyncDataSizeLimit - 说明:WAL 进行 FSYNC 的阈值`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### transPullupInterval - 说明:mnode 执行事务的重试间`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### mqRebalanceInterval - 说明:消费者再平衡的时间间隔`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### uptimeInterval - 说明:用于记录系统启动时间`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### timeseriesThreshold - 说明:用于统计用量`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### udf - 说明:是否启动 UDF 服务 @@ -1003,19 +1003,19 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### udfdResFuncs - 说明:用于统计用量`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### udfdLdLibPath - 说明:用于统计用量`内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 ### 流计算参数 @@ -1026,7 +1026,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### streamBufferSize - 说明:控制内存中窗口状态缓存的大小 @@ -1036,37 +1036,37 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:9223372036854775807 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### streamAggCnt - 说明:并发进行聚合计算的数目 `内部参数` - 类型:整数 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### checkpointInterval - 说明:checkponit 同步间隔 `内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### concurrentCheckpoint - 说明:是否并发检查 checkpoint `内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### maxStreamBackendCache - 说明:流计算使用的最大缓存 `内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### streamSinkDataRate - 说明:用于控制流计算结果的写入速度 `内部参数` - 类型:整数 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### streamNotifyMessageSize - 说明:用于控制事件通知的消息大小 `内部参数` @@ -1076,7 +1076,7 @@ charset 的有效值是 UTF-8。 - 最小值:8 - 最大值:1048576 - 动态修改:不支持 -- 支持版本:从 v3.3.6.0 版本开始引入 +- 支持版本:v3.3.6.0 引入 #### streamNotifyFrameSize - 说明:用于控制事件通知消息发送时底层的帧大小 `内部参数` @@ -1086,7 +1086,7 @@ charset 的有效值是 UTF-8。 - 最小值:8 - 最大值:1048576 - 动态修改:不支持 -- 支持版本:从 v3.3.6.0 版本开始引入 +- 支持版本:v3.3.6.0 引入 ### 日志相关 @@ -1095,7 +1095,7 @@ charset 的有效值是 UTF-8。 - 类型:字符串 - 默认值:/var/log/taos - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### minimalLogDirGB - 说明:日志文件夹所在磁盘可用空间大小小于该值时,停止写日志 @@ -1105,7 +1105,7 @@ charset 的有效值是 UTF-8。 - 最小值:0.001f - 最大值:10000000 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### numOfLogLines - 说明:单个日志文件允许的最大行数 @@ -1114,7 +1114,7 @@ charset 的有效值是 UTF-8。 - 最小值:1000 - 最大值:2000000000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### asyncLog - 说明:日志写入模式 @@ -1123,7 +1123,7 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### logKeepDays - 说明:日志文件的最长保存时间,小于等于0意味着只有两个日志文件相互切换保存日志,超过两个文件保存数量的日志会被删除;当设置为大于 0 的值时,当日志文件大小达到设置的上限时会被重命名为 taosdlog.yyy,其中 yyy 为日志文件最后修改的时间戳,并滚动产生新的日志文件 @@ -1133,7 +1133,7 @@ charset 的有效值是 UTF-8。 - 最小值:-365000 - 最大值:365000 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### slowLogThreshold - 说明:慢查询门限值,大于等于门限值认为是慢查询 @@ -1143,7 +1143,7 @@ charset 的有效值是 UTF-8。 - 最小值:1 - 最大值:2147483647 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.3.0.0 版本开始引入 +- 支持版本:v3.3.0.0 引入 #### slowLogMaxLen - 说明:慢查询日志最大长度 @@ -1152,19 +1152,19 @@ charset 的有效值是 UTF-8。 - 最小值:1 - 最大值:16384 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.3.0.0 版本开始引入 +- 支持版本:v3.3.0.0 引入 #### slowLogScope - 说明:慢查询记录类型 - 取值范围:ALL/QUERY/INSERT/OTHERS/NONE - 默认值:QUERY - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.3.0.0 版本开始引入 +- 支持版本:v3.3.0.0 引入 #### slowLogExceptDb - 说明:指定的数据库不上报慢查询,仅支持配置换一个数据库 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.3.0.0 版本开始引入 +- 支持版本:v3.3.0.0 引入 #### debugFlag - 说明:运行日志开关,该参数的设置会影响所有模块的开关,后设置的参数起效 @@ -1172,7 +1172,7 @@ charset 的有效值是 UTF-8。 - 取值范围:131(输出错误和警告日志),135(输出错误、警告和调试日志),143(输出错误、警告、调试和跟踪日志) - 默认值:131 或 135 (取决于不同模块) - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### tmrDebugFlag - 说明:定时器模块的日志开关 @@ -1180,7 +1180,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### uDebugFlag - 说明:共用功能模块的日志开关 @@ -1188,7 +1188,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### rpcDebugFlag - 说明:rpc 模块的日志开关 @@ -1196,7 +1196,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### qDebugFlag - 说明:query 模块的日志开关 @@ -1204,7 +1204,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### dDebugFlag - 说明:dnode 模块的日志开关 @@ -1212,7 +1212,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### vDebugFlag - 说明:vnode 模块的日志开关 @@ -1220,7 +1220,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### mDebugFlag - 说明:mnode 模块的日志开关 @@ -1228,7 +1228,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### azDebugFlag - 说明:S3 模块的日志开关 @@ -1236,7 +1236,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.3.4.3 版本开始引入 +- 支持版本:v3.3.4.3 引入 #### sDebugFlag - 说明:sync 模块的日志开关 @@ -1244,7 +1244,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### tsdbDebugFlag - 说明:tsdb 模块的日志开关 @@ -1252,7 +1252,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### tqDebugFlag - 说明:tq 模块的日志开关 @@ -1260,7 +1260,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### fsDebugFlag @@ -1269,7 +1269,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### udfDebugFlag - 说明:udf 模块的日志开关 @@ -1277,7 +1277,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### smaDebugFlag - 说明:sma 模块的日志开关 @@ -1285,7 +1285,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### idxDebugFlag - 说明:index 模块的日志开关 @@ -1293,7 +1293,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### tdbDebugFlag - 说明:tdb 模块的日志开关 @@ -1301,7 +1301,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### metaDebugFlag - 说明:meta 模块的日志开关 @@ -1309,7 +1309,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### stDebugFlag - 说明:stream 模块的日志开关 @@ -1317,7 +1317,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### sndDebugFlag - 说明:snode 模块的日志开关 @@ -1325,7 +1325,7 @@ charset 的有效值是 UTF-8。 - 取值范围:同上 - 默认值:131 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 ### 调试相关 @@ -1337,13 +1337,13 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### configDir - 说明:配置文件所在目录 - 类型:字符串 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### forceReadConfig - 说明:配置文件所在目录 @@ -1352,13 +1352,13 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:不支持 -- 支持版本:从 v3.3.5.0 版本开始引入 +- 支持版本:v3.3.5.0 引入 #### scriptDir - 说明:测试工具的脚本目录 `内部参数` - 类型:字符串 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### assert - 说明:断言控制开关 @@ -1367,67 +1367,67 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### randErrorChance - 说明:用于随机失败测试 `内部参数` - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### randErrorDivisor - 说明:用于随机失败测试 `内部参数` - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### randErrorScope - 说明:用于随机失败测试 `内部参数` - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### safetyCheckLevel - 说明:用于随机失败测试 `内部参数` - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### experimental - 说明:用于一些实验特性 `内部参数` - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### simdEnable - 说明:用于测试 SIMD 加速 `内部参数` - 动态修改:不支持 -- 支持版本:从 v3.3.4.3 版本开始引入 +- 支持版本:v3.3.4.3 引入 #### AVX512Enable - 说明:用于测试 AVX512 加速 `内部参数` - 动态修改:不支持 -- 支持版本:从 v3.3.4.3 版本开始引入 +- 支持版本:v3.3.4.3 引入 #### rsyncPort - 说明:用于调试流计算 `内部参数` - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### snodeAddress - 说明:用于调试流计算 `内部参数` - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### checkpointBackupDir - 说明:用于恢复 snode 数据 `内部参数` - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### enableAuditDelete - 说明:用于测试审计功能 `内部参数` - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### slowLogThresholdTest - 说明:用于测试慢日志 `内部参数` - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### bypassFlag - 说明:配置文件所在目录 @@ -1435,7 +1435,7 @@ charset 的有效值是 UTF-8。 - 取值范围:0:正常写入,1:写入消息在 taos 客户端发送 RPC 消息前返回,2:写入消息在 taosd 服务端收到 RPC 消息后返回,4:写入消息在 taosd 服务端写入内存缓存前返回,8:写入消息在 taosd 服务端数据落盘前返回 - 默认值:0 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.3.4.5 版本开始引入 +- 支持版本:v3.3.4.5 引入 ### 压缩参数 @@ -1446,7 +1446,7 @@ charset 的有效值是 UTF-8。 - 最小值:0.00000001 - 最大值:0.1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### dPrecision - 说明:设置 double 类型浮点数压缩精度,小于此值的浮点数尾数部分将被截取 @@ -1455,14 +1455,14 @@ charset 的有效值是 UTF-8。 - 最小值:0.0000000000000001 - 最大值:0.1 - 动态修改:支持通过 SQL 修改,立即生效 -- 支持版本:从 v3.1.0.0 版本开始引入 +- 支持版本:v3.1.0.0 引入 #### lossyColumn - 说明:对 float 和/或 double 类型启用 TSZ 有损压缩 - 取值范围:float/double/none - 默认值:none,表示关闭无损压缩 - 动态修改:不支持 -- 支持版本:从 v3.1.0.0 版本引入,v3.3.0.0 以后废弃 +- 支持版本:v3.1.0.0 引入,v3.3.0.0 以后废弃 #### ifAdtFse - 说明:在启用 TSZ 有损压缩时,使用 FSE 算法替换 HUFFMAN 算法,FSE 算法压缩速度更快,但解压稍慢,追求压缩速度可选用此算法 @@ -1471,26 +1471,26 @@ charset 的有效值是 UTF-8。 - 最小值:0 - 最大值:1 - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本引入,v3.3.0.0 以后废弃 +- 支持版本:v3.1.0.0 引入,v3.3.0.0 以后废弃 #### maxRange - 说明:用于有损压缩设置 `内部参数` - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本引入,v3.3.0.0 以后废弃 +- 支持版本:v3.1.0.0 引入,v3.3.0.0 以后废弃 #### curRange - 说明:用于有损压缩设置 `内部参数` - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本引入,v3.3.0.0 以后废弃 +- 支持版本:v3.1.0.0 引入,v3.3.0.0 以后废弃 #### compressor - 说明:用于有损压缩设置 `内部参数` - 动态修改:支持通过 SQL 修改,重启生效 -- 支持版本:从 v3.1.0.0 版本引入,v3.3.0.0 以后废弃 +- 支持版本:v3.1.0.0 引入,v3.3.0.0 以后废弃 **补充说明** -1. 在 3.3.5.0 之后,所有配置参数都将被持久化到本地存储,重启数据库服务后,将默认使用持久化的配置参数列表;如果您希望继续使用 config 文件中配置的参数,需设置 forceReadConfig 为 1。 -2. 在 3.2.0.0 ~ 3.3.0.0(不包含)版本生效,启用该参数后不能回退到升级前的版本 +1. 在 v3.3.5.0 之后,所有配置参数都将被持久化到本地存储,重启数据库服务后,将默认使用持久化的配置参数列表;如果您希望继续使用 config 文件中配置的参数,需设置 forceReadConfig 为 1。 +2. 在 v3.2.0.0 ~ v3.3.0.0(不包含)生效,启用该参数后不能回退到升级前的版本 3. TSZ 压缩算法是通过数据预测技术完成的压缩,所以更适合有规律变化的数据 4. TSZ 压缩时间会更长一些,如果您的服务器 CPU 空闲多,存储空间小的情况下适合选用 5. 示例:对 float 和 double 类型都启用有损压缩 diff --git a/docs/zh/14-reference/03-taos-sql/10-function.md b/docs/zh/14-reference/03-taos-sql/10-function.md index 0ac0250a29..9c8e2ebb20 100644 --- a/docs/zh/14-reference/03-taos-sql/10-function.md +++ b/docs/zh/14-reference/03-taos-sql/10-function.md @@ -1091,9 +1091,9 @@ CAST(expr AS type_name) - 对于不能支持的类型转换会直接报错。 - 对于类型支持但某些值无法正确转换的情况,对应的转换后的值以转换函数输出为准。目前可能遇到的几种情况: - 1)字符串类型转换数值类型时可能出现的无效字符情况,例如 "a" 可能转为 0,但不会报错。 - 2)转换到数值类型时,数值大于 type_name 可表示的范围时,则会溢出,但不会报错。 - 3)转换到字符串类型时,如果转换后长度超过 type_name 中指定的长度,则会截断,但不会报错。 + - 字符串类型转换数值类型时可能出现的无效字符情况,例如 "a" 可能转为 0,但不会报错。 + - 转换到数值类型时,数值大于 type_name 可表示的范围时,则会溢出,但不会报错。 + - 转换到字符串类型时,如果转换后长度超过 type_name 中指定的长度,则会截断,但不会报错。 #### TO_ISO8601 @@ -1230,7 +1230,7 @@ TO_TIMESTAMP(ts_str_literal, format_str_literal) **功能说明**:将字符串按照指定格式转化为时间戳。 -**使用说明**:ver-3.2.2.0 +**使用说明**:v3.2.2.0 **返回结果数据类型**:TIMESTAMP。 @@ -1568,7 +1568,7 @@ algo_type: { **适用于**:表和超级表。 **说明**: -- p 值范围是 [0,100],当为 0 时等同 于MIN,为 100 时等同于 MAX。 +- p 值范围是 [0,100],当为 0 时等同 于 MIN,为 100 时等同于 MAX。 - algo_type 取值为 "default" 或 "t-digest"。输入为 "default" 时函数使用基于直方图算法进行计算。输入为 "t-digest" 时使用 t-digest 算法计算分位数的近似结果。如果不指定 algo_type 则使用 "default" 算法。 - t-digest 算法的近似结果对于输入数据顺序敏感,对超级表查询时不同的输入排序结果可能会有微小的误差。 @@ -1884,12 +1884,12 @@ ignore_null_values: { - INTERP 根据 FILL 字段来决定在每个符合输出条件的时刻如何进行插值。关于 FILL 子句如何使用请参考 [FILL 子句](../distinguished/#fill-子句) - INTERP 可以在 RANGE 字段中只指定唯一的时间戳对单个时间点进行插值,在这种情况下,EVERY 字段可以省略。例如 SELECT INTERP(col) FROM tb RANGE('2023-01-01 00:00:00') FILL(linear)。 - INTERP 作用于超级表时,会将该超级表下的所有子表数据按照主键列排序后进行插值计算,也可以搭配 PARTITION BY tbname 使用,将结果强制规约到单个时间线。 -- INTERP 可以与伪列 _irowts 一起使用,返回插值点所对应的时间戳(3.0.2.0 版本以后支持)。 -- INTERP 可以与伪列 _isfilled 一起使用,显示返回结果是否为原始记录或插值算法产生的数据(3.0.3.0 版本以后支持)。 +- INTERP 可以与伪列 _irowts 一起使用,返回插值点所对应的时间戳(v3.0.2.0 以后支持)。 +- INTERP 可以与伪列 _isfilled 一起使用,显示返回结果是否为原始记录或插值算法产生的数据(v3.0.3.0 以后支持)。 - INTERP 对于带复合主键的表的查询,若存在相同时间戳的数据,则只有对应的复合主键最小的数据参与运算。 -- INTERP 查询支持 NEAR FILL 模式,即当需要 FILL 时,使用距离当前时间点最近的数据进行插值,当前后时间戳与当前时间断面一样近时,FILL 前一行的值。此模式在流计算中和窗口查询中不支持。例如 SELECT INTERP(col) FROM tb RANGE('2023-01-01 00:00:00', '2023-01-01 00:10:00') FILL(NEAR)(3.3.4.9 版本及以后支持)。 -- INTERP 只有在使用 FILL PREV/NEXT/NEAR 模式时才可以使用伪列 `_irowts_origin`。`_irowts_origin` 在 3.3.4.9 版本及以后支持。 -- INTERP `RANGE`子句从 3.3.4.9 版本开始支持时间范围的扩展,如 `RANGE('2023-01-01 00:00:00', 10s)` 表示只能使用时间点 '2023-01-01 00:00:00' 周边 10s 内的数据进行插值,FILL PREV/NEXT/NEAR 分别表示从时间点开始向前/向后/前后在时间范围内查找数据,若时间点周边在指定时间范围内没有数据,则使用 FILL 指定的默认值进行插值,因此此时 FILL 子句必须同时指定默认值。例如 SELECT INTERP(col) FROM tb RANGE('2023-01-01 00:00:00', 10s) FILL(PREV, 1)。从 3.3.6.0 版本开始支持时间区间和时间范围的组合,对于时间区间内的每个断面进行插值时都需要满足时间范围的要求,在此之前的版本仅支持时间点和时间范围的组合。时间范围的值域规则与 EVERY 类似,单位不能是年或月,值必须大于 0,不能带引号。使用该扩展时,不支持除 FILL PREV/NEXT/NEAR 外的其他 FILL 模式。 +- INTERP 查询支持 NEAR FILL 模式,即当需要 FILL 时,使用距离当前时间点最近的数据进行插值,当前后时间戳与当前时间断面一样近时,FILL 前一行的值。此模式在流计算中和窗口查询中不支持。例如 SELECT INTERP(col) FROM tb RANGE('2023-01-01 00:00:00', '2023-01-01 00:10:00') FILL(NEAR)(v3.3.4.9 及以后支持)。 +- INTERP 只有在使用 FILL PREV/NEXT/NEAR 模式时才可以使用伪列 `_irowts_origin`。`_irowts_origin` 在 v3.3.4.9 以后支持。 +- INTERP `RANGE`子句从 v3.3.4.9 开始支持时间范围的扩展,如 `RANGE('2023-01-01 00:00:00', 10s)` 表示只能使用时间点 '2023-01-01 00:00:00' 周边 10s 内的数据进行插值,FILL PREV/NEXT/NEAR 分别表示从时间点开始向前/向后/前后在时间范围内查找数据,若时间点周边在指定时间范围内没有数据,则使用 FILL 指定的默认值进行插值,因此此时 FILL 子句必须同时指定默认值。例如 SELECT INTERP(col) FROM tb RANGE('2023-01-01 00:00:00', 10s) FILL(PREV, 1)。从 v3.3.6.0 开始支持时间区间和时间范围的组合,对于时间区间内的每个断面进行插值时都需要满足时间范围的要求,在此之前的版本仅支持时间点和时间范围的组合。时间范围的值域规则与 EVERY 类似,单位不能是年或月,值必须大于 0,不能带引号。使用该扩展时,不支持除 `FILL PREV/NEXT/NEAR` 外的其他 FILL 模式。 ### LAST @@ -2032,8 +2032,8 @@ TOP(expr, k) **使用说明**: -- *k* 值取值范围 1≤*k*≤100; -- 系统同时返回该记录关联的时间戳列; +- *k* 值取值范围 1≤*k*≤100。 +- 系统同时返回该记录关联的时间戳列。 - 限制:TOP 函数不支持 FILL 子句。 ### UNIQUE @@ -2056,7 +2056,7 @@ UNIQUE(expr) COLS(func(expr), output_expr1, [, output_expr2] ... ) ``` -**功能说明**:在选择函数 func(expr) 执行结果所在数据行上,执行表达式 output_expr1, [, output_expr2],返回其结果,func(expr)结果不输出。 +**功能说明**:在选择函数 func(expr) 执行结果所在数据行上,执行表达式 output_expr1, [, output_expr2],返回其结果,func(expr) 结果不输出。 **返回数据类型**:返回多列数据,每列数据类型为对应表达式返回结果的类型。 @@ -2134,11 +2134,11 @@ ignore_option: { } ``` -**功能说明**:统计表中特定列与之前行的当前列有效值之差。ignore_option 取值为 0|1|2|3,可以不填,默认值为 0. -- `0` 表示不忽略(diff结果)负值不忽略 null 值 -- `1` 表示(diff结果)负值作为 null 值 -- `2` 表示不忽略(diff结果)负值但忽略 null 值 -- `3` 表示忽略(diff结果)负值且忽略 null 值 +**功能说明**:统计表中特定列与之前行的当前列有效值之差。ignore_option 取值为 0|1|2|3,可以不填,默认值为 0。 +- `0` 表示 diff 结果不忽略负值不忽略 null 值 +- `1` 表示 diff 结果的负值作为 null 值 +- `2` 表示 diff 结果不忽略负值但忽略 null 值 +- `3` 表示 diff 结果忽略负值且忽略 null 值 - 对于存在复合主键的表的查询,若时间戳相同的数据存在多条,则只有对应的复合主键最小的数据参与运算。 **返回数据类型**:bool、时间戳及整型数值类型均返回 bigint,浮点类型返回 double,若 diff 结果溢出则返回溢出后的值。 @@ -2150,13 +2150,13 @@ ignore_option: { **使用说明**: - diff 是计算本行特定列与同列的前一个有效数据的差值,同列的前一个有效数据:指的是同一列中时间戳较小的最临近的非空值。 -- 数值类型 diff 结果为对应的算术差值;时间戳类型根据数据库的时间戳精度进行差值计算;bool 类型计算差值时 true 视为 1,false 视为 0 -- 如当前行数据为 null 或者没有找到同列前一个有效数据时,diff 结果为 null -- 忽略负值时(ignore_option 设置为 1 或 3 ),如果 diff 结果为负值,则结果设置为 null,然后根据 null 值过滤规则进行过滤 -- 当 diff 结果发生溢出时,结果是否是 `应该忽略的负值` 取决于逻辑运算结果是正数还是负数,例如 9223372036854775800 - (-9223372036854775806) 的值超出 BIGINT 的范围,diff 结果会显示溢出值 -10,但并不会被作为负值忽略 -- 单个语句中可以使用单个或者多个 diff,并且每个 diff 可以指定相同或不同的 ignore_option,当单个语句中存在多个 diff 时当且仅当某行所有 diff 的结果都为 null,并且 ignore_option 都设置为忽略 null 值,该行才从结果集中剔除 +- 数值类型 diff 结果为对应的算术差值;时间戳类型根据数据库的时间戳精度进行差值计算;bool 类型计算差值时 true 视为 1,false 视为 0。 +- 如当前行数据为 null 或者没有找到同列前一个有效数据时,diff 结果为 null。 +- 忽略负值时(ignore_option 设置为 1 或 3 ),如果 diff 结果为负值,则结果设置为 null,然后根据 null 值过滤规则进行过滤。 +- 当 diff 结果发生溢出时,结果是否是 `应该忽略的负值` 取决于逻辑运算结果是正数还是负数,例如 9223372036854775800 - (-9223372036854775806) 的值超出 BIGINT 的范围,diff 结果会显示溢出值 -10,但并不会被作为负值忽略。 +- 单个语句中可以使用单个或者多个 diff,并且每个 diff 可以指定相同或不同的 ignore_option,当单个语句中存在多个 diff 时当且仅当某行所有 diff 的结果都为 null,并且 ignore_option 都设置为忽略 null 值,该行才从结果集中剔除。 - 可以选择与相关联的列一起使用。例如 `select _rowts, DIFF() from`。 -- 当没有复合主键时,如果不同的子表有相同时间戳的数据,会提示 "Duplicate timestamps not allowed" +- 当没有复合主键时,如果不同的子表有相同时间戳的数据,会提示 "Duplicate timestamps not allowed"。 - 当使用复合主键时,不同子表的时间戳和主键组合可能相同,使用哪一行取决于先找到哪一行,这意味着在这种情况下多次运行 diff() 的结果可能会不同。 ### IRATE @@ -2232,7 +2232,7 @@ STATEDURATION(expr, oper, val, unit) **参数范围**: -- oper:`'LT'` (小于)、`'GT'`(大于)、`'LE'`(小于等于)、`'GE'`(大于等于)、`'NE'`(不等于)、`'EQ'`(等于),不区分大小写,但需要用`''`包括。 +- oper:`'LT'` (小于)、`'GT'`(大于)、`'LE'`(小于等于)、`'GE'`(大于等于)、`'NE'`(不等于)、`'EQ'`(等于),不区分大小写,但需要用 `''` 包括。 - val:数值型 - unit:时间长度的单位,可取值时间单位:1b(纳秒)、1u(微秒)、1a(毫秒)、1s(秒)、1m(分)、1h(小时)、1d(天)、1w(周)。如果省略,默认为当前数据库精度。 diff --git a/docs/zh/14-reference/03-taos-sql/12-distinguished.md b/docs/zh/14-reference/03-taos-sql/12-distinguished.md index ffca617f7a..34959996c2 100644 --- a/docs/zh/14-reference/03-taos-sql/12-distinguished.md +++ b/docs/zh/14-reference/03-taos-sql/12-distinguished.md @@ -76,7 +76,7 @@ window_clause: { FILL 语句指定某一窗口区间数据缺失的情况下的填充模式。填充模式包括以下几种: 1. 不进行填充:NONE(默认填充模式)。 -2. VALUE 填充:固定值填充,此时需要指定填充的数值。例如 FILL(VALUE, 1.23)。这里需要注意,最终填充的值受由相应列的类型决定,如 FILL(VALUE, 1.23),相应列为 INT 类型,则填充值为 1,若查询列表中有多列需要 FILL,则需要给每一个 FILL 列指定 VALUE,如 `SELECT _wstart, min(c1), max(c1) FROM ... FILL(VALUE, 0, 0)`,注意,SELECT 表达式中只有包含普通列时才需要指定 FILL VALUE,如 `_wstart`、`_wstart+1a`、`now`、`1+1` 以及使用 partition by 时的 partition key (如 tbname)都不需要指定 VALUE,如 `timediff(last(ts), _wstart)` 则需要指定 VALUE。 +2. VALUE 填充:固定值填充,此时需要指定填充的数值。例如 `FILL(VALUE, 1.23)`。这里需要注意,最终填充的值受由相应列的类型决定,如 `FILL(VALUE, 1.23)`,相应列为 INT 类型,则填充值为 1,若查询列表中有多列需要 FILL,则需要给每一个 FILL 列指定 VALUE,如 `SELECT _wstart, min(c1), max(c1) FROM ... FILL(VALUE, 0, 0)`,注意,SELECT 表达式中只有包含普通列时才需要指定 FILL VALUE,如 `_wstart`、`_wstart+1a`、`now`、`1+1` 以及使用 `partition by` 时的 `partition key` (如 tbname)都不需要指定 VALUE,如 `timediff(last(ts), _wstart)` 则需要指定 VALUE。 3. PREV 填充:使用前一个非 NULL 值填充数据。例如 FILL(PREV)。 4. NULL 填充:使用 NULL 填充数据。例如 FILL(NULL)。 5. LINEAR 填充:根据前后距离最近的非 NULL 值做线性插值填充。例如 FILL(LINEAR)。 @@ -165,7 +165,7 @@ TDengine 还支持将 CASE 表达式用在状态量,可以表达某个状态 SELECT tbname, _wstart, CASE WHEN voltage >= 205 and voltage <= 235 THEN 1 ELSE 0 END status FROM meters PARTITION BY tbname STATE_WINDOW(CASE WHEN voltage >= 205 and voltage <= 235 THEN 1 ELSE 0 END); ``` -状态窗口支持使用 TRUE_FOR 参数来设定窗口的最小持续时长。如果某个状态窗口的宽度低于该设定值,则会自动舍弃,不返回任何计算结果。例如,设置最短持续时长为 3s: +状态窗口支持使用 TRUE_FOR 参数来设定窗口的最小持续时长。如果某个状态窗口的宽度低于该设定值,则会自动舍弃,不返回任何计算结果。例如,设置最短持续时长为 3s。 ``` SELECT COUNT(*), FIRST(ts), status FROM temp_tb_1 STATE_WINDOW(status) TRUE_FOR (3s); @@ -202,7 +202,7 @@ select _wstart, _wend, count(*) from t event_window start with c1 > 0 end with c ![TDengine Database 事件窗口示意图](./event_window.webp) -事件窗口支持使用 TRUE_FOR 参数来设定窗口的最小持续时长。如果某个事件窗口的宽度低于该设定值,则会自动舍弃,不返回任何计算结果。例如,设置最短持续时长为 3s: +事件窗口支持使用 TRUE_FOR 参数来设定窗口的最小持续时长。如果某个事件窗口的宽度低于该设定值,则会自动舍弃,不返回任何计算结果。例如,设置最短持续时长为 3s。 ``` select _wstart, _wend, count(*) from t event_window start with c1 > 0 end with c2 < 10 true_for (3s); @@ -223,7 +223,7 @@ select _wstart, _wend, count(*) from t count_window(4); ### 时间戳伪列 -窗口聚合查询结果中,如果 SQL 语句中没有指定输出查询结果中的时间戳列,那么最终结果中不会自动包含窗口的时间列信息。如果需要在结果中输出聚合结果所对应的时间窗口信息,需要在 SELECT 子句中使用时间戳相关的伪列: 时间窗口起始时间 (\_WSTART), 时间窗口结束时间 (\_WEND), 时间窗口持续时间 (\_WDURATION), 以及查询整体窗口相关的伪列:查询窗口起始时间(\_QSTART) 和查询窗口结束时间(\_QEND)。需要注意的是时间窗口起始时间和结束时间均是闭区间,时间窗口持续时间是数据当前时间分辨率下的数值。例如,如果当前数据库的时间分辨率是毫秒,那么结果中 500 就表示当前时间窗口的持续时间是 500毫秒 (500 ms)。 +窗口聚合查询结果中,如果 SQL 语句中没有指定输出查询结果中的时间戳列,那么最终结果中不会自动包含窗口的时间列信息。如果需要在结果中输出聚合结果所对应的时间窗口信息,需要在 SELECT 子句中使用时间戳相关的伪列:时间窗口起始时间 (\_WSTART),时间窗口结束时间 (\_WEND),时间窗口持续时间 (\_WDURATION),以及查询整体窗口相关的伪列:查询窗口起始时间(\_QSTART) 和查询窗口结束时间(\_QEND)。需要注意的是时间窗口起始时间和结束时间均是闭区间,时间窗口持续时间是数据当前时间分辨率下的数值。例如,如果当前数据库的时间分辨率是毫秒,那么结果中 500 就表示当前时间窗口的持续时间是 500毫秒 (500 ms)。 ### 示例 diff --git a/docs/zh/14-reference/03-taos-sql/14-stream.md b/docs/zh/14-reference/03-taos-sql/14-stream.md index c8c490dd84..9359f85915 100644 --- a/docs/zh/14-reference/03-taos-sql/14-stream.md +++ b/docs/zh/14-reference/03-taos-sql/14-stream.md @@ -300,7 +300,7 @@ RESUME STREAM [IF EXISTS] [IGNORE UNTREATED] stream_name; CREATE SNODE ON DNODE [id] ``` 其中的 id 是集群中的 dnode 的序号。请注意选择的dnode,流计算的中间状态将自动在其上进行备份。 -从 3.3.4.0 版本开始,在多副本环境中创建流会进行 snode 的**存在性检查**,要求首先创建 snode。如果 snode 不存在,无法创建流。 +从 v3.3.4.0 开始,在多副本环境中创建流会进行 snode 的**存在性检查**,要求首先创建 snode。如果 snode 不存在,无法创建流。 ## 流式计算的事件通知