From d31fd0ad33bf6066bc9433820d7e7fa7a9e5deeb Mon Sep 17 00:00:00 2001 From: sheyanjie-qq <249478495@qq.com> Date: Fri, 21 Mar 2025 11:32:07 +0800 Subject: [PATCH 01/26] update grafana docker compose cfg --- docs/en/10-third-party/03-visual/01-grafana.md | 14 +++++++++++--- docs/zh/10-third-party/03-visual/01-grafana.mdx | 14 +++++++++++--- 2 files changed, 22 insertions(+), 6 deletions(-) diff --git a/docs/en/10-third-party/03-visual/01-grafana.md b/docs/en/10-third-party/03-visual/01-grafana.md index 8a503b4195..1c4d0e36d0 100644 --- a/docs/en/10-third-party/03-visual/01-grafana.md +++ b/docs/en/10-third-party/03-visual/01-grafana.md @@ -151,15 +151,22 @@ Using docker-compose, configure Grafana Provisioning for automated setup, and ex services: tdengine: - image: tdengine/tdengine:3.3.0.0 + image: tdengine/tdengine:latest + container_name: tdengine + hostname: tdengine environment: TAOS_FQDN: tdengine + MONITOR_FQDN: tdengine + EXPLORER_CLUSTER: http://tdengine:6041 + TAOS_KEEPER_TDENGINE_HOST: tdengine volumes: - tdengine-data:/var/lib/taos/ + ports: + - 6060:6060 grafana: - image: grafana/grafana:9.3.6 + image: grafana/grafana:latest volumes: - - ./tdengine.yml/:/etc/grafana/provisioning/tdengine.yml + - ./tdengine.yml:/etc/grafana/provisioning/tdengine.yml - grafana-data:/var/lib/grafana environment: # install tdengine plugin at start @@ -169,6 +176,7 @@ Using docker-compose, configure Grafana Provisioning for automated setup, and ex TDENGINE_BASIC_AUTH: "cm9vdDp0YmFzZTEyNQ==" ports: - 3000:3000 + volumes: grafana-data: tdengine-data: diff --git a/docs/zh/10-third-party/03-visual/01-grafana.mdx b/docs/zh/10-third-party/03-visual/01-grafana.mdx index 38c47672b8..ac80103abe 100644 --- a/docs/zh/10-third-party/03-visual/01-grafana.mdx +++ b/docs/zh/10-third-party/03-visual/01-grafana.mdx @@ -138,15 +138,22 @@ docker run -d \ services: tdengine: - image: tdengine/tdengine:3.3.0.0 + image: tdengine/tdengine:latest + container_name: tdengine + hostname: tdengine environment: TAOS_FQDN: tdengine + MONITOR_FQDN: tdengine + EXPLORER_CLUSTER: http://tdengine:6041 + TAOS_KEEPER_TDENGINE_HOST: tdengine volumes: - tdengine-data:/var/lib/taos/ + ports: + - 6060:6060 grafana: - image: grafana/grafana:9.3.6 + image: grafana/grafana:latest volumes: - - ./tdengine.yml/:/etc/grafana/provisioning/tdengine.yml + - ./tdengine.yml:/etc/grafana/provisioning/tdengine.yml - grafana-data:/var/lib/grafana environment: # install tdengine plugin at start @@ -156,6 +163,7 @@ docker run -d \ TDENGINE_BASIC_AUTH: "cm9vdDp0YmFzZTEyNQ==" ports: - 3000:3000 + volumes: grafana-data: tdengine-data: From ec7177cb7df38e29826ed372bd7084f4065b1749 Mon Sep 17 00:00:00 2001 From: Zhixiao Bao <62235797+xiao-77@users.noreply.github.com> Date: Fri, 21 Mar 2025 14:50:41 +0800 Subject: [PATCH 02/26] fix: correct numberFileset counting cause S3 retention happened while compact. (#30282) --- source/dnode/vnode/src/tsdb/tsdbRetention.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/dnode/vnode/src/tsdb/tsdbRetention.c b/source/dnode/vnode/src/tsdb/tsdbRetention.c index 64a1028029..b3609de4cc 100644 --- a/source/dnode/vnode/src/tsdb/tsdbRetention.c +++ b/source/dnode/vnode/src/tsdb/tsdbRetention.c @@ -678,13 +678,13 @@ static int32_t tsdbDoS3Migrate(SRTNer *rtner) { int32_t r = taosStatFile(fobj->fname, &size, &mtime, NULL); if (size > chunksize && mtime < rtner->now - tsS3UploadDelaySec) { if (pCfg->s3Compact && lcn < 0) { - extern int32_t tsdbAsyncCompact(STsdb * tsdb, const STimeWindow *tw, bool sync); + extern int32_t tsdbAsyncCompact(STsdb * tsdb, const STimeWindow *tw, bool sync,bool s3Migrate); STimeWindow win = {0}; tsdbFidKeyRange(fset->fid, rtner->tsdb->keepCfg.days, rtner->tsdb->keepCfg.precision, &win.skey, &win.ekey); tsdbInfo("vgId:%d, async compact begin lcn: %d.", TD_VID(rtner->tsdb->pVnode), lcn); - code = tsdbAsyncCompact(rtner->tsdb, &win, pCfg->sttTrigger == 1); + code = tsdbAsyncCompact(rtner->tsdb, &win, pCfg->sttTrigger == 1, true); tsdbInfo("vgId:%d, async compact end lcn: %d.", TD_VID(rtner->tsdb->pVnode), lcn); goto _exit; return code; From 4d348a66d674d88cd6f0c050239a4b4929fd0b4d Mon Sep 17 00:00:00 2001 From: Haojun Liao Date: Fri, 21 Mar 2025 22:27:00 +0800 Subject: [PATCH 03/26] Update 09-error-code.md (#30327) --- docs/zh/14-reference/09-error-code.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/zh/14-reference/09-error-code.md b/docs/zh/14-reference/09-error-code.md index 7a87e1ddfb..517658482c 100644 --- a/docs/zh/14-reference/09-error-code.md +++ b/docs/zh/14-reference/09-error-code.md @@ -591,3 +591,17 @@ description: TDengine 服务端的错误码列表和详细说明 | 0x80006206 | Virtual table not support in Topic | 不支持在订阅中使用虚拟表 | 不在订阅中使用虚拟表 | | 0x80006207 | Virtual super table query not support origin table from different databases | 虚拟超级表不支持子表的数据源来自不同的数据库 | 确保虚拟超级表的子表的数据源都来自同一个数据库 | + +## TDgpt + +| 错误码 | 错误描述 | 可能的出错场景或者可能的原因 | 建议用户采取的措施 | +| ---------- | --------------------- | -------------------------------------------------------------------------------- | ------------------------------ | +| 0x80000440 | Analysis service response is NULL | 分析服务返回错误 | 检查服务端日志确认返回信息是否正确 | +| 0x80000441 | Analysis service can't access | 分析服务无法使用 | 检查 anoded 服务是否可用 | +| 0x80000442 | Analysis algorithm is missing | 未指定分析算法名称 | 增加算法名称 | +| 0x80000443 | Analysis algorithm not loaded | 指定算法未加载 | 指定算法未加载 | +| 0x80000444 | Analysis invalid buffer type | 缓存数据格式不对 | 具体查看server端的错误日志 | +| 0x80000445 | Analysis failed since anode return error | anode 返回错误信息 | 请检查服务端日志确认问题原因 | +| 0x80000446 | Analysis failed since too many input rows for anode | 输入数据太多 | 减小分析数据输入规模 | +| 0x80000447 | white-noise data not processed | 白噪声数据不分析 | | +| 0x80000448 | tdgpt internal error, not processed | anode 出现内部错误 | 具体查看server端的错误日志 | From fb469935123b05547df04ad7b0172de306fe023f Mon Sep 17 00:00:00 2001 From: WANG MINGMING Date: Fri, 21 Mar 2025 22:36:37 +0800 Subject: [PATCH 04/26] fix(stream): log level (#30332) --- source/libs/stream/src/streamBackendRocksdb.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/libs/stream/src/streamBackendRocksdb.c b/source/libs/stream/src/streamBackendRocksdb.c index a8ca5f15de..3d9ac06a80 100644 --- a/source/libs/stream/src/streamBackendRocksdb.c +++ b/source/libs/stream/src/streamBackendRocksdb.c @@ -3128,7 +3128,7 @@ rocksdb_iterator_t* streamStateIterCreate(SStreamState* pState, const char* cfKe taosMemoryFree(err); \ code = TSDB_CODE_THIRDPARTY_ERROR; \ } else { \ - stInfo("[InternalERR] write streamState str:%s succ to write to %s, rowValLen:%d, ttlValLen:%d, %p", toString, \ + stDebug("[InternalERR] write streamState str:%s succ to write to %s, rowValLen:%d, ttlValLen:%d, %p", toString, \ funcname, vLen, ttlVLen, wrapper); \ } \ taosMemoryFree(ttlV); \ @@ -4524,7 +4524,7 @@ int32_t streamStatePutBatchOptimize(SStreamState* pState, int32_t cfIdx, rocksdb int32_t klen = ginitDict[cfIdx].enFunc((void*)key, buf); ginitDict[cfIdx].toStrFunc((void*)key, toString); - qInfo("[InternalERR] write cfIdx:%d key:%s vlen:%d", cfIdx, toString, vlen); + stDebug("[InternalERR] write cfIdx:%d key:%s vlen:%d", cfIdx, toString, vlen); char* ttlV = tmpBuf; int32_t ttlVLen = ginitDict[cfIdx].enValueFunc(dst, size, ttl, &ttlV); From 083ee928e97346a4a4e4257f2d45fa0412111ca0 Mon Sep 17 00:00:00 2001 From: haoranchen Date: Sat, 22 Mar 2025 10:59:20 +0800 Subject: [PATCH 05/26] docs:Add Windows support restriction details in README.md --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 5e768b36ea..54f4ff0e9b 100644 --- a/README.md +++ b/README.md @@ -80,7 +80,9 @@ For contributing/building/testing TDengine Connectors, please check the followin # 3. Prerequisites -At the moment, TDengine server supports running on Linux/Windows/MacOS systems. Any application can also choose the RESTful interface provided by taosAdapter to connect the taosd service. TDengine supports X64/ARM64 CPU, and it will support MIPS64, Alpha64, ARM32, RISC-V and other CPU architectures in the future. Right now we don't support build with cross-compiling environment. +At the moment, TDengine server supports running on Linux/MacOS systems. Any application can also choose the RESTful interface provided by taosAdapter to connect the taosd service. TDengine supports X64/ARM64 CPU, and it will support MIPS64, Alpha64, ARM32, RISC-V and other CPU architectures in the future. Right now we don't support build with cross-compiling environment. + +Starting from version 3.1.0.0, TDengine supports the Windows system exclusively in its Enterprise edition. If you want to compile taosAdapter or taosKeeper, you need to install Go 1.18 or above. From 8a1de67039c78dd7218e38ba1d90ad9db0315518 Mon Sep 17 00:00:00 2001 From: haoranchen Date: Sat, 22 Mar 2025 11:07:27 +0800 Subject: [PATCH 06/26] docs: add Windows support restriction details in README.md --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 54f4ff0e9b..13b063d6fb 100644 --- a/README.md +++ b/README.md @@ -126,7 +126,7 @@ brew install argp-standalone gflags pkgconfig ## 3.3 Prerequisites on Windows - +Not available for community edition.
Install required tools on Windows @@ -211,7 +211,7 @@ If you want to compile taosKeeper, you need to add the `-DBUILD_KEEPER=true` opt
## 4.3 Build on Windows - +Not available for community edition.
Detailed steps to build on Windows @@ -284,7 +284,7 @@ sudo make install
## 6.3 Install on Windows - +Not available for community edition.
Detailed steps to install on windows @@ -359,7 +359,7 @@ If TDengine CLI connects the server successfully, welcome messages and version i ## 7.3 Run TDengine on Windows - +Not available for community edition.
Detailed steps to run on windows From 8bbc3a6f9f930fab2d260652bcbcd2ff564eb123 Mon Sep 17 00:00:00 2001 From: haoranchen Date: Sat, 22 Mar 2025 11:11:37 +0800 Subject: [PATCH 07/26] docs:add python support restriction details in tests README.md --- tests/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/tests/README.md b/tests/README.md index df8fbfc655..b3906b8ae9 100644 --- a/tests/README.md +++ b/tests/README.md @@ -19,6 +19,8 @@ This manual is intended to give developers a comprehensive guidance to test TDen > - The commands and scripts below are verified on Linux (Ubuntu 18.04/20.04/22.04). > - [taos-connector-python](https://github.com/taosdata/taos-connector-python) is used by tests written in Python, which requires Python 3.7+. > - The commands and steps described below are to run the tests on a single host. +> - The testing framework is currently compatible with Python versions 3.8 through 3.10. + # 2. Prerequisites From 7a288ed388d8252027362073f9deb34a2b29fbd8 Mon Sep 17 00:00:00 2001 From: haoranchen Date: Sat, 22 Mar 2025 11:17:00 +0800 Subject: [PATCH 08/26] docs: remove content with windows README.md --- README.md | 71 ------------------------------------------------------- 1 file changed, 71 deletions(-) diff --git a/README.md b/README.md index 13b063d6fb..4da7730bae 100644 --- a/README.md +++ b/README.md @@ -127,13 +127,6 @@ brew install argp-standalone gflags pkgconfig ## 3.3 Prerequisites on Windows Not available for community edition. -
- -Install required tools on Windows - -Work in Progress. - -
## 3.4 Clone the repo @@ -212,40 +205,6 @@ If you want to compile taosKeeper, you need to add the `-DBUILD_KEEPER=true` opt ## 4.3 Build on Windows Not available for community edition. -
- -Detailed steps to build on Windows - -If you use the Visual Studio 2013, please open a command window by executing "cmd.exe". -Please specify "amd64" for 64 bits Windows or specify "x86" for 32 bits Windows when you execute vcvarsall.bat. - -```cmd -mkdir debug && cd debug -"C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\vcvarsall.bat" < amd64 | x86 > -cmake .. -G "NMake Makefiles" -nmake -``` - -If you use the Visual Studio 2019 or 2017: - -please open a command window by executing "cmd.exe". -Please specify "x64" for 64 bits Windows or specify "x86" for 32 bits Windows when you execute vcvarsall.bat. - -```cmd -mkdir debug && cd debug -"c:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" < x64 | x86 > -cmake .. -G "NMake Makefiles" -nmake -``` - -Or, you can simply open a command window by clicking Windows Start -> "Visual Studio < 2019 | 2017 >" folder -> "x64 Native Tools Command Prompt for VS < 2019 | 2017 >" or "x86 Native Tools Command Prompt for VS < 2019 | 2017 >" depends what architecture your Windows is, then execute commands as follows: - -```cmd -mkdir debug && cd debug -cmake .. -G "NMake Makefiles" -nmake -``` -
# 5. Packaging @@ -285,17 +244,6 @@ sudo make install ## 6.3 Install on Windows Not available for community edition. -
- -Detailed steps to install on windows - -After building successfully, TDengine can be installed by: - -```cmd -nmake install -``` - -
# 7. Running @@ -360,25 +308,6 @@ If TDengine CLI connects the server successfully, welcome messages and version i ## 7.3 Run TDengine on Windows Not available for community edition. -
- -Detailed steps to run on windows - -You can start TDengine server on Windows platform with below commands: - -```cmd -.\build\bin\taosd.exe -c test\cfg -``` - -In another terminal, use the TDengine CLI to connect the server: - -```cmd -.\build\bin\taos.exe -c test\cfg -``` - -option "-c test/cfg" specifies the system configuration file directory. - -
# 8. Testing From cf0e4ccdf24c8d3f292b3702743bc45841d81fe3 Mon Sep 17 00:00:00 2001 From: WANG Xu Date: Sat, 22 Mar 2025 11:36:49 +0800 Subject: [PATCH 09/26] docs: update README.md and add venv suggestion Signed-off-by: WANG Xu --- README.md | 4 ++++ tests/README.md | 1 + 2 files changed, 5 insertions(+) diff --git a/README.md b/README.md index 4da7730bae..0a52daafab 100644 --- a/README.md +++ b/README.md @@ -126,6 +126,7 @@ brew install argp-standalone gflags pkgconfig
## 3.3 Prerequisites on Windows + Not available for community edition. ## 3.4 Clone the repo @@ -204,6 +205,7 @@ If you want to compile taosKeeper, you need to add the `-DBUILD_KEEPER=true` opt
## 4.3 Build on Windows + Not available for community edition. # 5. Packaging @@ -243,6 +245,7 @@ sudo make install ## 6.3 Install on Windows + Not available for community edition. # 7. Running @@ -307,6 +310,7 @@ If TDengine CLI connects the server successfully, welcome messages and version i ## 7.3 Run TDengine on Windows + Not available for community edition. # 8. Testing diff --git a/tests/README.md b/tests/README.md index b3906b8ae9..7c5e37e796 100644 --- a/tests/README.md +++ b/tests/README.md @@ -20,6 +20,7 @@ This manual is intended to give developers a comprehensive guidance to test TDen > - [taos-connector-python](https://github.com/taosdata/taos-connector-python) is used by tests written in Python, which requires Python 3.7+. > - The commands and steps described below are to run the tests on a single host. > - The testing framework is currently compatible with Python versions 3.8 through 3.10. +> - Vitural Environment is advised when setting up the environment, pease refer to [venv](https://docs.python.org/3/library/venv.html) for details. # 2. Prerequisites From ddb4cd6592e4f15a413819a22ab954167dfa6cf0 Mon Sep 17 00:00:00 2001 From: Haojun Liao Date: Sat, 22 Mar 2025 13:14:01 +0800 Subject: [PATCH 10/26] doc: add error code information about tdgpt (#30338) * Update 09-error-code.md * Update 09-error-code.md * Update 09-error-code.md --- docs/en/14-reference/09-error-code.md | 14 ++++++++++++++ docs/zh/14-reference/09-error-code.md | 2 +- 2 files changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/en/14-reference/09-error-code.md b/docs/en/14-reference/09-error-code.md index 139f8d38d7..3305eb18eb 100644 --- a/docs/en/14-reference/09-error-code.md +++ b/docs/en/14-reference/09-error-code.md @@ -558,6 +558,20 @@ This document details the server error codes that may be encountered when using | 0x80004017 | Invalid status, please subscribe topic first | tmq status invalidate | Without calling subscribe, directly poll data | | 0x80004100 | Stream task not exist | The stream computing task does not exist | Check the server-side error logs | +## TDgpt + +| Error Code | Description | Possible Error Scenarios or Reasons | Recommanded Actions for Users | +| ---------- | --------------------- | -------------------------------------------------------------------------------- | ------------------------------ | +| 0x80000440 | Analysis service response is NULL | The response content is empty | Check the taosanode.app.log for detailed response information | +| 0x80000441 | Analysis service can't access | Service is not work currectly, or network is broken | Check the status of taosanode and network status | +| 0x80000442 | Analysis algorithm is missing | Algorithm used in analysis is not specified | Add the "algo" parameter in forecast function or anomaly_window clause | +| 0x80000443 | Analysis algorithm not loaded | The specified algorithm is not available | Check for the specified algorithm | +| 0x80000444 | Analysis invalid buffer type | The bufferred data type is invalid | Check the taosanode.app.log for more details | +| 0x80000445 | Analysis failed since anode return error | The responses from anode with error message | Check the taosanode.app.log for more details | +| 0x80000446 | Analysis failed since too many input rows for anode | Input data is too many | Reduce the rows of input data to below than the threshold | +| 0x80000447 | white-noise data not processed | white noise data is not processed | Ignore the white noise check or use another input data | +| 0x80000448 | Analysis internal error, not processed | Internal error occurs | Check the taosanode.app.log for more details | + ## virtual table diff --git a/docs/zh/14-reference/09-error-code.md b/docs/zh/14-reference/09-error-code.md index 517658482c..ef585cf706 100644 --- a/docs/zh/14-reference/09-error-code.md +++ b/docs/zh/14-reference/09-error-code.md @@ -604,4 +604,4 @@ description: TDengine 服务端的错误码列表和详细说明 | 0x80000445 | Analysis failed since anode return error | anode 返回错误信息 | 请检查服务端日志确认问题原因 | | 0x80000446 | Analysis failed since too many input rows for anode | 输入数据太多 | 减小分析数据输入规模 | | 0x80000447 | white-noise data not processed | 白噪声数据不分析 | | -| 0x80000448 | tdgpt internal error, not processed | anode 出现内部错误 | 具体查看server端的错误日志 | +| 0x80000448 | Analysis internal error, not processed | anode 出现内部错误 | 具体查看server端的日志 (taosanode.app.log) | From 53fb1fa63628a33d4b80e8c0b7153af07861240e Mon Sep 17 00:00:00 2001 From: WANG Xu Date: Sat, 22 Mar 2025 13:36:29 +0800 Subject: [PATCH 11/26] ci: add release build Signed-off-by: WANG Xu --- .github/workflows/tdengine-release-build.yml | 114 +++++++++++++++++++ 1 file changed, 114 insertions(+) create mode 100644 .github/workflows/tdengine-release-build.yml diff --git a/.github/workflows/tdengine-release-build.yml b/.github/workflows/tdengine-release-build.yml new file mode 100644 index 0000000000..ef708a0ac9 --- /dev/null +++ b/.github/workflows/tdengine-release-build.yml @@ -0,0 +1,114 @@ +name: TDengine Release Build + +on: + push: + branches: + - 'main' + - '3.*' + paths-ignore: + - 'docs/**' + - 'packaging/**' + - 'tests/**' + - '**/*.md' + +concurrency: + group: ${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: true + +jobs: + build: + name: Run on ${{ matrix.os }} + runs-on: ${{ matrix.os }} + strategy: + fail-fast: false + matrix: + os: + - ubuntu-22.04 + - macos-14 + + steps: + - name: Checkout the repository + uses: actions/checkout@v4 + + - name: Set up Go + uses: actions/setup-go@v5 + with: + go-version: 1.18 + + - name: Install dependencies on Linux + if: runner.os == 'Linux' + run: | + sudo apt update -y + sudo apt install -y \ + build-essential \ + cmake \ + gawk \ + libgeos-dev \ + libjansson-dev \ + liblzma-dev \ + libsnappy-dev \ + libssl-dev \ + libz-dev \ + pkg-config \ + zlib1g + + - name: Install dependencies on macOS + if: runner.os == 'macOS' + run: | + brew update + brew install \ + argp-standalone \ + gawk \ + gflags \ + geos \ + jansson \ + openssl \ + pkg-config \ + snappy \ + zlib + + - name: Build and install TDengine + run: | + mkdir debug && cd debug + cmake .. -DBUILD_TOOLS=true \ + -DBUILD_KEEPER=true \ + -DBUILD_HTTP=false \ + -DBUILD_TEST=true \ + -DWEBSOCKET=true \ + -DCMAKE_BUILD_TYPE=Release \ + -DBUILD_DEPENDENCY_TESTS=false + make -j 4 + sudo make install + which taosd + which taosadapter + which taoskeeper + + - name: Statistics ldd + run: | + find ${{ github.workspace }}/debug/build/lib -type f -name "*.so" -print0 | xargs -0 ldd || true + find ${{ github.workspace }}/debug/build/bin -type f -print0 | xargs -0 ldd || true + + - name: Statistics size + run: | + find ${{ github.workspace }}/debug/build/lib -type f -print0 | xargs -0 ls -lhrS + find ${{ github.workspace }}/debug/build/bin -type f -print0 | xargs -0 ls -lhrS + + - name: Start taosd + run: | + cp /etc/taos/taos.cfg ./ + sudo echo "supportVnodes 256" >> taos.cfg + nohup sudo taosd -c taos.cfg & + + - name: Start taosadapter + run: nohup sudo taosadapter & + + - name: Run tests with taosBenchmark + run: | + taosBenchmark -t 10 -n 10 -y + taos -s "select count(*) from test.meters" + + - name: Clean up + if: always() + run: | + if pgrep taosd; then sudo pkill taosd; fi + if pgrep taosadapter; then sudo pkill taosadapter; fi From 0ee9e3db566a05b8dec95d57d83bfe6d6ea61fce Mon Sep 17 00:00:00 2001 From: chenhaoran Date: Sat, 22 Mar 2025 13:56:21 +0800 Subject: [PATCH 12/26] refactor: streamline library removal and linking in installation scripts --- packaging/tools/install.sh | 6 +++++- packaging/tools/make_install.sh | 34 ++++++++++++++++++++++++++------ packaging/tools/remove.sh | 14 ++++++------- packaging/tools/remove_client.sh | 17 ++++++++-------- 4 files changed, 49 insertions(+), 22 deletions(-) diff --git a/packaging/tools/install.sh b/packaging/tools/install.sh index 8fd483b6a7..56a18c64c6 100755 --- a/packaging/tools/install.sh +++ b/packaging/tools/install.sh @@ -273,9 +273,12 @@ function install_lib() { ${csudo}rm -f ${lib64_link_dir}/libtaos.* || : ${csudo}rm -f ${lib_link_dir}/libtaosnative.* || : ${csudo}rm -f ${lib64_link_dir}/libtaosnative.* || : + ${csudo}rm -f ${lib_link_dir}/libtaosws.* || : + ${csudo}rm -f ${lib64_link_dir}/libtaosws.* || : #${csudo}rm -rf ${v15_java_app_dir} || : ${csudo}cp -rf ${script_dir}/driver/* ${install_main_dir}/driver && ${csudo}chmod 777 ${install_main_dir}/driver/* + #link lib/link_dir ${csudo}ln -sf ${install_main_dir}/driver/libtaos.* ${lib_link_dir}/libtaos.so.1 ${csudo}ln -sf ${lib_link_dir}/libtaos.so.1 ${lib_link_dir}/libtaos.so ${csudo}ln -sf ${install_main_dir}/driver/libtaosnative.* ${lib_link_dir}/libtaosnative.so.1 @@ -283,13 +286,14 @@ function install_lib() { [ -f ${install_main_dir}/driver/libtaosws.so ] && ${csudo}ln -sf ${install_main_dir}/driver/libtaosws.so ${lib_link_dir}/libtaosws.so || : + #link lib64/link_dir if [[ -d ${lib64_link_dir} && ! -e ${lib64_link_dir}/libtaos.so ]]; then ${csudo}ln -sf ${install_main_dir}/driver/libtaos.* ${lib64_link_dir}/libtaos.so.1 || : ${csudo}ln -sf ${lib64_link_dir}/libtaos.so.1 ${lib64_link_dir}/libtaos.so || : ${csudo}ln -sf ${install_main_dir}/driver/libtaosnative.* ${lib64_link_dir}/libtaosnative.so.1 || : ${csudo}ln -sf ${lib64_link_dir}/libtaosnative.so.1 ${lib64_link_dir}/libtaosnative.so || : - [ -f ${install_main_dir}/libtaosws.so ] && ${csudo}ln -sf ${install_main_dir}/libtaosws.so ${lib64_link_dir}/libtaosws.so || : + [ -f ${install_main_dir}/driver/libtaosws.so ] && ${csudo}ln -sf ${install_main_dir}/driver/libtaosws.so ${lib64_link_dir}/libtaosws.so || : fi ${csudo}ldconfig diff --git a/packaging/tools/make_install.sh b/packaging/tools/make_install.sh index 4a694f9841..de7dd2d2cb 100755 --- a/packaging/tools/make_install.sh +++ b/packaging/tools/make_install.sh @@ -312,15 +312,37 @@ function install_avro() { function install_lib() { # Remove links - ${csudo}rm -f ${lib_link_dir}/libtaos.* || : - ${csudo}rm -f ${lib_link_dir}/libtaosnative.* || : - [ -f ${lib_link_dir}/libtaosws.so ] && ${csudo}rm -f ${lib_link_dir}/libtaosws.so || : + remove_links() { + local dir=$1 + find ${dir} -name "libtaos.*" -exec ${csudo}rm -f {} \; || : + find ${dir} -name "libtaosnative.so" -exec ${csudo}rm -f {} \; || : + find ${dir} -name "libtaosws.so" -exec ${csudo}rm -f {} \; || : + } + + remove_links ${lib_link_dir} + if [ "$osType" != "Darwin" ]; then - ${csudo}rm -f ${lib64_link_dir}/libtaos.* || : - ${csudo}rm -f ${lib64_link_dir}/libtaosnative.* || : - [ -f ${lib64_link_dir}/libtaosws.so ] && ${csudo}rm -f ${lib64_link_dir}/libtaosws.so || : + remove_links ${lib64_link_dir} fi + # Copy and set permissions for libraries + copy_and_set_permissions() { + local src=$1 + local dest=$2 + if [ "$osType" != "Darwin" ]; then + ${csudo}cp ${src} ${dest} && ${csudo}chmod 777 ${dest} + else + ${csudo}cp -Rf ${src} ${dest} && ${csudo}chmod 777 ${dest} + fi + } + + # Create symbolic links + create_symlink() { + local target=$1 + local link_name=$2 + ${csudo}ln -sf ${target} ${link_name} + } + if [ "$osType" != "Darwin" ]; then ${csudo}cp ${binary_dir}/build/lib/libtaos.so.${verNumber} \ ${install_main_dir}/driver && diff --git a/packaging/tools/remove.sh b/packaging/tools/remove.sh index d62aa5a564..91b1dfc461 100755 --- a/packaging/tools/remove.sh +++ b/packaging/tools/remove.sh @@ -5,7 +5,7 @@ set -e #set -x -verMode=edge +verMode=cluster osType=`uname` RED='\033[0;31m' @@ -179,13 +179,13 @@ remove_bin() { function clean_lib() { # Remove link - ${csudo}rm -f ${lib_link_dir}/libtaos.* || : - [ -f ${lib_link_dir}/libtaosnative.* ] && ${csudo}rm -f ${lib_link_dir}/libtaosnative.* || : - [ -f ${lib_link_dir}/libtaosws.* ] && ${csudo}rm -f ${lib_link_dir}/libtaosws.* || : + ${csudo}find ${lib_link_dir} -name "libtaos.*" -exec ${csudo}rm -f {} \; || : + ${csudo}find ${lib_link_dir} -name "libtaosnative.*" -exec ${csudo}rm -f {} \; || : + ${csudo}find ${lib_link_dir} -name "libtaosws.*" -exec ${csudo}rm -f {} \; || : - ${csudo}rm -f ${lib64_link_dir}/libtaos.* || : - [ -f ${lib64_link_dir}/libtaosnative.* ] && ${csudo}rm -f ${lib64_link_dir}/libtaosnative.* || : - [ -f ${lib64_link_dir}/libtaosws.* ] && ${csudo}rm -f ${lib64_link_dir}/libtaosws.* || : + ${csudo}find ${lib64_link_dir} -name "libtaos.*" -exec ${csudo}rm -f {} \; || : + ${csudo}find ${lib64_link_dir} -name "libtaosnative.*" -exec ${csudo}rm -f {} \; || : + ${csudo}find ${lib64_link_dir} -name "libtaosws.*" -exec ${csudo}rm -f {} \; || : #${csudo}rm -rf ${v15_java_app_dir} || : } diff --git a/packaging/tools/remove_client.sh b/packaging/tools/remove_client.sh index e6ec9c3768..e5c3842a5e 100755 --- a/packaging/tools/remove_client.sh +++ b/packaging/tools/remove_client.sh @@ -70,15 +70,16 @@ function clean_bin() { } function clean_lib() { - # Remove link - ${csudo}rm -f ${lib_link_dir}/libtaos.* || : - [ -f ${lib_link_dir}/libtaosws.* ] && ${csudo}rm -f ${lib_link_dir}/libtaosws.* || : - [ -f ${lib_link_dir}/libtaosnative.* ] && ${csudo}rm -f ${lib_link_dir}/libtaosnative.* || : + # Remove link + ${csudo}find ${lib_link_dir} -name "libtaos.*" -exec ${csudo}rm -f {} \; || : + ${csudo}find ${lib_link_dir} -name "libtaosnative.*" -exec ${csudo}rm -f {} \; || : + ${csudo}find ${lib_link_dir} -name "libtaosws.*" -exec ${csudo}rm -f {} \; || : + + ${csudo}find ${lib64_link_dir} -name "libtaos.*" -exec ${csudo}rm -f {} \; || : + ${csudo}find ${lib64_link_dir} -name "libtaosnative.*" -exec ${csudo}rm -f {} \; || : + ${csudo}find ${lib64_link_dir} -name "libtaosws.*" -exec ${csudo}rm -f {} \; || : + #${csudo}rm -rf ${v15_java_app_dir} || : - ${csudo}rm -f ${lib64_link_dir}/libtaos.* || : - [ -f ${lib64_link_dir}/libtaosws.* ] && ${csudo}rm -f ${lib64_link_dir}/libtaosws.* || : - [ -f ${lib64_link_dir}/libtaosnative.* ] && ${csudo}rm -f ${lib64_link_dir}/libtaosnative.* || : - #${csudo}rm -rf ${v15_java_app_dir} || : } function clean_header() { From 42dbebaff7b738e10d27ca83233e2476be0b761a Mon Sep 17 00:00:00 2001 From: WANG Xu Date: Sat, 22 Mar 2025 14:29:04 +0800 Subject: [PATCH 13/26] chore: update build badge --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 0a52daafab..a5abe6e1b1 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@

-[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/taosdata/tdengine/tdengine-test.yml)](https://github.com/taosdata/TDengine/actions/workflows/tdengine-test.yml) +[![TDengine Release Build](https://github.com/taosdata/TDengine/actions/workflows/tdengine-release-build.yml/badge.svg)](https://github.com/taosdata/TDengine/actions/workflows/tdengine-release-build.yml) [![Coverage Status](https://coveralls.io/repos/github/taosdata/TDengine/badge.svg?branch=3.0)](https://coveralls.io/github/taosdata/TDengine?branch=3.0) [![GitHub commit activity](https://img.shields.io/github/commit-activity/m/taosdata/tdengine)](https://github.com/feici02/TDengine/commits/main/)
From 9c07a28e6573b0e32dab04b8eff14c5cc0bb6798 Mon Sep 17 00:00:00 2001 From: haoranchen Date: Sat, 22 Mar 2025 14:35:05 +0800 Subject: [PATCH 14/26] Update remove.sh --- packaging/tools/remove.sh | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/packaging/tools/remove.sh b/packaging/tools/remove.sh index 91b1dfc461..1f75f00d5d 100755 --- a/packaging/tools/remove.sh +++ b/packaging/tools/remove.sh @@ -5,7 +5,7 @@ set -e #set -x -verMode=cluster +verMode=edge osType=`uname` RED='\033[0;31m' @@ -338,4 +338,4 @@ fi command -v systemctl >/dev/null 2>&1 && ${csudo}systemctl daemon-reload >/dev/null 2>&1 || true echo echo "${productName} is removed successfully!" -echo \ No newline at end of file +echo From 3a29a1daf12dcfe156066d82d99c8edeb39b9f5e Mon Sep 17 00:00:00 2001 From: WANG Xu Date: Sat, 22 Mar 2025 13:36:29 +0800 Subject: [PATCH 15/26] ci: add release build Signed-off-by: WANG Xu --- .github/workflows/tdengine-release-build.yml | 114 +++++++++++++++++++ 1 file changed, 114 insertions(+) create mode 100644 .github/workflows/tdengine-release-build.yml diff --git a/.github/workflows/tdengine-release-build.yml b/.github/workflows/tdengine-release-build.yml new file mode 100644 index 0000000000..ef708a0ac9 --- /dev/null +++ b/.github/workflows/tdengine-release-build.yml @@ -0,0 +1,114 @@ +name: TDengine Release Build + +on: + push: + branches: + - 'main' + - '3.*' + paths-ignore: + - 'docs/**' + - 'packaging/**' + - 'tests/**' + - '**/*.md' + +concurrency: + group: ${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: true + +jobs: + build: + name: Run on ${{ matrix.os }} + runs-on: ${{ matrix.os }} + strategy: + fail-fast: false + matrix: + os: + - ubuntu-22.04 + - macos-14 + + steps: + - name: Checkout the repository + uses: actions/checkout@v4 + + - name: Set up Go + uses: actions/setup-go@v5 + with: + go-version: 1.18 + + - name: Install dependencies on Linux + if: runner.os == 'Linux' + run: | + sudo apt update -y + sudo apt install -y \ + build-essential \ + cmake \ + gawk \ + libgeos-dev \ + libjansson-dev \ + liblzma-dev \ + libsnappy-dev \ + libssl-dev \ + libz-dev \ + pkg-config \ + zlib1g + + - name: Install dependencies on macOS + if: runner.os == 'macOS' + run: | + brew update + brew install \ + argp-standalone \ + gawk \ + gflags \ + geos \ + jansson \ + openssl \ + pkg-config \ + snappy \ + zlib + + - name: Build and install TDengine + run: | + mkdir debug && cd debug + cmake .. -DBUILD_TOOLS=true \ + -DBUILD_KEEPER=true \ + -DBUILD_HTTP=false \ + -DBUILD_TEST=true \ + -DWEBSOCKET=true \ + -DCMAKE_BUILD_TYPE=Release \ + -DBUILD_DEPENDENCY_TESTS=false + make -j 4 + sudo make install + which taosd + which taosadapter + which taoskeeper + + - name: Statistics ldd + run: | + find ${{ github.workspace }}/debug/build/lib -type f -name "*.so" -print0 | xargs -0 ldd || true + find ${{ github.workspace }}/debug/build/bin -type f -print0 | xargs -0 ldd || true + + - name: Statistics size + run: | + find ${{ github.workspace }}/debug/build/lib -type f -print0 | xargs -0 ls -lhrS + find ${{ github.workspace }}/debug/build/bin -type f -print0 | xargs -0 ls -lhrS + + - name: Start taosd + run: | + cp /etc/taos/taos.cfg ./ + sudo echo "supportVnodes 256" >> taos.cfg + nohup sudo taosd -c taos.cfg & + + - name: Start taosadapter + run: nohup sudo taosadapter & + + - name: Run tests with taosBenchmark + run: | + taosBenchmark -t 10 -n 10 -y + taos -s "select count(*) from test.meters" + + - name: Clean up + if: always() + run: | + if pgrep taosd; then sudo pkill taosd; fi + if pgrep taosadapter; then sudo pkill taosadapter; fi From 523b7003a4d007c0a0132d0e54c706956ec586bf Mon Sep 17 00:00:00 2001 From: haoranchen Date: Sat, 22 Mar 2025 15:31:16 +0800 Subject: [PATCH 16/26] fix: add requests pkg in tdgpt install.sh --- tools/tdgpt/script/install.sh | 1 + 1 file changed, 1 insertion(+) diff --git a/tools/tdgpt/script/install.sh b/tools/tdgpt/script/install.sh index 9952b7f0af..e5bf87740b 100755 --- a/tools/tdgpt/script/install.sh +++ b/tools/tdgpt/script/install.sh @@ -400,6 +400,7 @@ function install_anode_venv() { ${csudo}${venvDir}/bin/pip3 install uwsgi ${csudo}${venvDir}/bin/pip3 install torch --index-url https://download.pytorch.org/whl/cpu ${csudo}${venvDir}/bin/pip3 install --upgrade keras + ${csudo}${venvDir}/bin/pip3 install requests echo -e "Install python library for venv completed!" } From e273a943eaeb4a872736598cf495233a8498dea1 Mon Sep 17 00:00:00 2001 From: Linhe Huo Date: Sat, 22 Mar 2025 20:44:07 +0800 Subject: [PATCH 17/26] fix: add show connMode string (#30323) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * fix: add show connMode string * fix: add stdbool.h to pub.h * fix: remove trash file army/output.txt * fix: caseBase.py modify syntax error * fix: restore -R option for taosdump * fix: taosdumpCommandline.py case * fix: native stmt write normal table failed * fix: taosdumpCommandline.py case passed * fix: restore test.py from main branch * fix: taosCli.py check default conn mode * fix: commandline-sml.py case pass * fix: websiteCase.py case passed * fix: connMode.py case * fix: modify default port is 0 * fix: taos_options with config dir not work * fix: websocket.py delete -D timeout options * fix: default_tmq_json.py context move to default_json.py, so delete * fix python kafka bug * chore: improve taos_init in wrapper * chore: add installation path preparation in build workflow * fix connMode bug * fix: fix tmq conf/consumer new error in wrapperFunc.c * fix: correct the spelling toss -> taosGetInstall... * chore: fix compile error in wrapperFunc.c * fix: createConnect fix memory leak * fix: tsim forbid CHECK ODR * modify userOperTest uuse static lib * reverse userOperTest use static lib --------- Co-authored-by: Alex Duan <417921451@qq.com> Co-authored-by: taos-support Co-authored-by: “chris <“zk662144@163.com”> Co-authored-by: t_max <1172915550@qq.com> Co-authored-by: sheyanjie-qq <249478495@qq.com> --- .github/workflows/tdengine-build.yml | 5 ++ .../examples/python/kafka_example_consumer.py | 8 +-- source/client/test/CMakeLists.txt | 2 +- source/client/wrapper/src/wrapperDriver.c | 4 +- source/client/wrapper/src/wrapperFunc.c | 30 +++++++---- tests/army/cmdline/taosCli.py | 11 +++- tests/army/frame/caseBase.py | 4 +- tests/army/output.txt | 52 ------------------- tests/army/test.py | 6 +-- .../tools/benchmark/basic/commandline-sml.py | 12 ++--- tests/army/tools/benchmark/basic/connMode.py | 9 ++-- .../army/tools/benchmark/basic/websiteCase.py | 2 +- tests/army/tools/benchmark/ws/websocket.py | 2 +- .../taosdump/native/taosdumpCommandline.py | 11 +--- tests/develop-test/test.py | 2 - tests/docs-examples-test/python.sh | 5 +- tests/parallel_test/cases.task | 1 - tests/script/test.sh | 3 ++ tests/system-test/test.py | 19 +++---- tools/inc/pub.h | 6 ++- tools/shell/src/shellArguments.c | 4 -- tools/shell/src/shellEngine.c | 11 ++-- tools/shell/src/shellMain.c | 2 +- tools/src/pub.c | 16 ++++-- tools/taos-tools/src/benchData.c | 4 +- tools/taos-tools/src/benchMain.c | 2 +- tools/taos-tools/src/taosdump.c | 7 ++- 27 files changed, 105 insertions(+), 135 deletions(-) delete mode 100644 tests/army/output.txt diff --git a/.github/workflows/tdengine-build.yml b/.github/workflows/tdengine-build.yml index 017c9d69fa..07cd17feab 100644 --- a/.github/workflows/tdengine-build.yml +++ b/.github/workflows/tdengine-build.yml @@ -74,6 +74,11 @@ jobs: snappy \ zlib + - name: prepare install path + run: | + sudo mkdir -p /usr/local/lib + sudo mkdir -p /usr/local/include + - name: Build and install TDengine run: | mkdir debug && cd debug diff --git a/docs/examples/python/kafka_example_consumer.py b/docs/examples/python/kafka_example_consumer.py index e2d5cf535b..43c140fe78 100644 --- a/docs/examples/python/kafka_example_consumer.py +++ b/docs/examples/python/kafka_example_consumer.py @@ -182,7 +182,7 @@ def test_json_to_taos(consumer: Consumer): 'voltage': 105, 'phase': 0.02027, }), partition=1, topic='test', serialized_key_size=None, serialized_header_size=None, - serialized_value_size=None, timestamp=time.time(), timestamp_type=None), + serialized_value_size=None, timestamp=time.time(), timestamp_type=None, leader_epoch=0), ConsumerRecord(checksum=None, headers=None, offset=1, key=None, value=json.dumps({'table_name': 'd1', 'ts': '2022-12-06 15:13:39.643', @@ -190,7 +190,7 @@ def test_json_to_taos(consumer: Consumer): 'voltage': 102, 'phase': 0.02027, }), partition=1, topic='test', serialized_key_size=None, serialized_header_size=None, - serialized_value_size=None, timestamp=time.time(), timestamp_type=None), + serialized_value_size=None, timestamp=time.time(), timestamp_type=None,leader_epoch=0 ), ] ] @@ -203,11 +203,11 @@ def test_line_to_taos(consumer: Consumer): ConsumerRecord(checksum=None, headers=None, offset=1, key=None, value="d0 values('2023-01-01 00:00:00.001', 3.49, 109, 0.02737)".encode('utf-8'), partition=1, topic='test', serialized_key_size=None, serialized_header_size=None, - serialized_value_size=None, timestamp=time.time(), timestamp_type=None), + serialized_value_size=None, timestamp=time.time(), timestamp_type=None,leader_epoch=0 ), ConsumerRecord(checksum=None, headers=None, offset=1, key=None, value="d1 values('2023-01-01 00:00:00.002', 6.19, 112, 0.09171)".encode('utf-8'), partition=1, topic='test', serialized_key_size=None, serialized_header_size=None, - serialized_value_size=None, timestamp=time.time(), timestamp_type=None), + serialized_value_size=None, timestamp=time.time(), timestamp_type=None,leader_epoch=0 ), ] ] consumer._line_to_taos(messages=records) diff --git a/source/client/test/CMakeLists.txt b/source/client/test/CMakeLists.txt index cee5dc08f9..161deb12cd 100644 --- a/source/client/test/CMakeLists.txt +++ b/source/client/test/CMakeLists.txt @@ -129,4 +129,4 @@ add_test( add_test( NAME userOperTest COMMAND userOperTest -) \ No newline at end of file +) diff --git a/source/client/wrapper/src/wrapperDriver.c b/source/client/wrapper/src/wrapperDriver.c index 415affc66f..341485e448 100644 --- a/source/client/wrapper/src/wrapperDriver.c +++ b/source/client/wrapper/src/wrapperDriver.c @@ -39,7 +39,7 @@ EDriverType tsDriverType = DRIVER_NATIVE; void *tsDriver = NULL; -static int32_t tossGetDevelopPath(char *driverPath, const char *driverName) { +static int32_t taosGetDevelopPath(char *driverPath, const char *driverName) { char appPath[PATH_MAX] = {0}; int32_t ret = taosAppPath(appPath, PATH_MAX); if (ret == 0) { @@ -67,7 +67,7 @@ int32_t taosDriverInit(EDriverType driverType) { driverName = DRIVER_WSBSOCKET_NAME; } - if (tsDriver == NULL && tossGetDevelopPath(driverPath, driverName) == 0) { + if (tsDriver == NULL && taosGetDevelopPath(driverPath, driverName) == 0) { tsDriver = taosLoadDll(driverPath); } diff --git a/source/client/wrapper/src/wrapperFunc.c b/source/client/wrapper/src/wrapperFunc.c index e77de0b82d..ed5200c064 100644 --- a/source/client/wrapper/src/wrapperFunc.c +++ b/source/client/wrapper/src/wrapperFunc.c @@ -19,6 +19,9 @@ static TdThreadOnce tsDriverOnce = PTHREAD_ONCE_INIT; volatile int32_t tsDriverOnceRet = 0; +static TdThreadOnce tsInitOnce = PTHREAD_ONCE_INIT; +volatile int32_t tsInitOnceRet = 0; + #define ERR_VOID(code) \ terrno = code; \ return; @@ -89,21 +92,25 @@ setConfRet taos_set_config(const char *config) { return (*fp_taos_set_config)(config); } -static void taos_init_wrapper(void) { +static void taos_init_driver(void) { tsDriverOnceRet = taosDriverInit(tsDriverType); if (tsDriverOnceRet != 0) return; + tsDriverOnceRet = 0; +} +static void taos_init_wrapper(void) { if (fp_taos_init == NULL) { terrno = TSDB_CODE_DLL_FUNC_NOT_LOAD; - tsDriverOnceRet = -1; + tsInitOnceRet = -1; } else { - tsDriverOnceRet = (*fp_taos_init)(); + tsInitOnceRet = (*fp_taos_init)(); } } int taos_init(void) { - (void)taosThreadOnce(&tsDriverOnce, taos_init_wrapper); - return tsDriverOnceRet; + (void)taosThreadOnce(&tsDriverOnce, taos_init_driver); + (void)taosThreadOnce(&tsInitOnce, taos_init_wrapper); + return tsInitOnceRet; } void taos_cleanup(void) { @@ -126,11 +133,7 @@ int taos_options(TSDB_OPTION option, const void *arg, ...) { terrno = TSDB_CODE_REPEAT_INIT; return -1; } - - if (taos_init() != 0) { - terrno = TSDB_CODE_DLL_NOT_LOAD; - return -1; - } + (void)taosThreadOnce(&tsDriverOnce, taos_init_driver); CHECK_INT(fp_taos_options); return (*fp_taos_options)(option, arg); @@ -143,7 +146,7 @@ int taos_options_connection(TAOS *taos, TSDB_OPTION_CONNECTION option, const voi TAOS *taos_connect(const char *ip, const char *user, const char *pass, const char *db, uint16_t port) { if (taos_init() != 0) { - terrno = TSDB_CODE_DLL_NOT_LOAD; + //terrno = TSDB_CODE_DLL_NOT_LOAD; return NULL; } @@ -646,6 +649,7 @@ TAOS_RES *taos_schemaless_insert_ttl_with_reqid_tbname_key(TAOS *taos, char *lin } tmq_conf_t *tmq_conf_new() { + taos_init(); CHECK_PTR(fp_tmq_conf_new); return (*fp_tmq_conf_new)(); } @@ -666,6 +670,7 @@ void tmq_conf_set_auto_commit_cb(tmq_conf_t *conf, tmq_commit_cb *cb, void *para } tmq_list_t *tmq_list_new() { + taos_init(); CHECK_PTR(fp_tmq_list_new); return (*fp_tmq_list_new)(); } @@ -691,6 +696,7 @@ char **tmq_list_to_c_array(const tmq_list_t *tlist) { } tmq_t *tmq_consumer_new(tmq_conf_t *conf, char *errstr, int32_t errstrLen) { + taos_init(); CHECK_PTR(fp_tmq_consumer_new); return (*fp_tmq_consumer_new)(conf, errstr, errstrLen); } @@ -860,11 +866,13 @@ TSDB_SERVER_STATUS taos_check_server_status(const char *fqdn, int port, char *de } void taos_write_crashinfo(int signum, void *sigInfo, void *context) { + taos_init(); CHECK_VOID(fp_taos_write_crashinfo); (*fp_taos_write_crashinfo)(signum, sigInfo, context); } char *getBuildInfo() { + taos_init(); CHECK_PTR(fp_getBuildInfo); return (*fp_getBuildInfo)(); } diff --git a/tests/army/cmdline/taosCli.py b/tests/army/cmdline/taosCli.py index 2624248a28..4aee8f1219 100644 --- a/tests/army/cmdline/taosCli.py +++ b/tests/army/cmdline/taosCli.py @@ -263,7 +263,7 @@ class TDTestCase(TBase): ['-a "abc"', "[0x80000357]"], ] for arg in args: - rlist = self.taos("Z 0 " + arg[0]) + rlist = self.taos("-Z 0 " + arg[0]) if arg[1] != None: self.checkListString(rlist, arg[1]) @@ -340,9 +340,14 @@ class TDTestCase(TBase): self.checkExcept(taos + " -s 'show dnodes;' " + option) def checkModeVersion(self): + + # check default conn mode + #DEFAULT_CONN = "WebSocket" + DEFAULT_CONN = "Native" + # results results = [ - "WebSocket Client Version", + f"{DEFAULT_CONN} Client Version", "2022-10-01 00:01:39.000", "Query OK, 100 row(s) in set" ] @@ -351,8 +356,10 @@ class TDTestCase(TBase): cmd = f"-s 'select ts from test.d0'" rlist = self.taos(cmd, checkRun = True) self.checkManyString(rlist, results) + # websocket cmd = f"-Z 1 -s 'select ts from test.d0'" + results[0] = "WebSocket Client Version" rlist = self.taos(cmd, checkRun = True) self.checkManyString(rlist, results) diff --git a/tests/army/frame/caseBase.py b/tests/army/frame/caseBase.py index b8345c3257..7a73ce09d4 100644 --- a/tests/army/frame/caseBase.py +++ b/tests/army/frame/caseBase.py @@ -196,9 +196,9 @@ class TBase: tdSql.checkFirstValue(sql, expect) # order by desc limit 1 with last - sql = f"select first({col}) from {self.db}.{self.db}." + sql = f"select first({col}) from {self.db}.{self.stb}" expect = tdSql.getFirstValue(sql) - sql = f"select {col} from {self.db}.{self.db}. order by _c0 asc limit 1" + sql = f"select {col} from {self.db}.{self.stb} order by _c0 asc limit 1" tdSql.checkFirstValue(sql, expect) diff --git a/tests/army/output.txt b/tests/army/output.txt deleted file mode 100644 index 132781c0db..0000000000 --- a/tests/army/output.txt +++ /dev/null @@ -1,52 +0,0 @@ -[02/10 13:52:16.164959] SUCC: created database (test) -[02/10 13:52:16.182024] INFO: start creating 1000 table(s) with 8 thread(s) -[02/10 13:52:16.396337] SUCC: Spent 0.2140 seconds to create 1000 table(s) with 8 thread(s) speed: 4673 tables/s, already exist 0 table(s), actual 1000 table(s) pre created, 0 table(s) will be auto created -[02/10 13:53:05.155428] SUCC: thread[2] progressive mode, completed total inserted rows: 12500000, 339193.01 records/second -[02/10 13:53:05.160652] SUCC: thread[7] progressive mode, completed total inserted rows: 12500000, 341816.65 records/second -[02/10 13:53:05.207601] SUCC: thread[0] progressive mode, completed total inserted rows: 12500000, 340556.51 records/second -[02/10 13:53:05.215370] SUCC: thread[4] progressive mode, completed total inserted rows: 12500000, 338804.97 records/second -[02/10 13:53:05.224077] SUCC: thread[5] progressive mode, completed total inserted rows: 12500000, 338596.28 records/second -[02/10 13:53:05.249786] SUCC: thread[1] progressive mode, completed total inserted rows: 12500000, 339208.40 records/second -[02/10 13:53:05.256970] SUCC: thread[3] progressive mode, completed total inserted rows: 12500000, 339174.04 records/second -[02/10 13:53:05.274900] SUCC: thread[6] progressive mode, completed total inserted rows: 12500000, 339551.12 records/second -[02/10 13:53:05.275900] SUCC: Spent 48.867685 (real 36.806958) seconds to insert rows: 100000000 with 8 thread(s) into test 2046342.08 (real 2716877.61) records/second -[02/10 13:53:05.275909] SUCC: insert delay, min: 11.2580ms, avg: 29.4456ms, p90: 32.7750ms, p95: 34.1120ms, p99: 39.5900ms, max: 70.3780ms -[02/12 15:46:06.469780] SUCC: created database (test) -[02/12 15:46:06.499844] INFO: start creating 10000 table(s) with 8 thread(s) -[02/12 15:46:08.185009] SUCC: Spent 1.6860 seconds to create 10000 table(s) with 8 thread(s) speed: 5931 tables/s, already exist 0 table(s), actual 10000 table(s) pre created, 0 table(s) will be auto created -[02/12 15:46:57.356674] SUCC: thread[0] progressive mode, completed total inserted rows: 12500000, 339076.93 records/second -[02/12 15:46:57.434553] SUCC: thread[1] progressive mode, completed total inserted rows: 12500000, 338528.52 records/second -[02/12 15:46:57.452522] SUCC: thread[2] progressive mode, completed total inserted rows: 12500000, 339844.37 records/second -[02/12 15:46:57.452921] SUCC: thread[5] progressive mode, completed total inserted rows: 12500000, 339349.90 records/second -[02/12 15:46:57.463726] SUCC: thread[4] progressive mode, completed total inserted rows: 12500000, 339986.37 records/second -[02/12 15:46:57.466467] SUCC: thread[3] progressive mode, completed total inserted rows: 12500000, 339785.50 records/second -[02/12 15:46:57.499118] SUCC: thread[6] progressive mode, completed total inserted rows: 12500000, 339326.86 records/second -[02/12 15:46:57.501694] SUCC: thread[7] progressive mode, completed total inserted rows: 12500000, 338309.30 records/second -[02/12 15:46:57.502535] SUCC: Spent 49.309586 (real 36.843268) seconds to insert rows: 100000000 with 8 thread(s) into test 2028003.24 (real 2714200.05) records/second -[02/12 15:46:57.502546] SUCC: insert delay, min: 10.9580ms, avg: 29.4746ms, p90: 32.6960ms, p95: 33.8290ms, p99: 36.8390ms, max: 77.9940ms -[02/14 15:27:32.543409] SUCC: created database (test) -[02/14 15:27:32.568881] INFO: start creating 10000 table(s) with 8 thread(s) -[02/14 15:27:34.249759] SUCC: Spent 1.6810 seconds to create 10000 table(s) with 8 thread(s) speed: 5949 tables/s, already exist 0 table(s), actual 10000 table(s) pre created, 0 table(s) will be auto created -[02/14 15:28:26.165699] SUCC: thread[0] progressive mode, completed total inserted rows: 12500000, 321266.73 records/second -[02/14 15:28:26.281188] SUCC: thread[4] progressive mode, completed total inserted rows: 12500000, 319863.00 records/second -[02/14 15:28:26.326975] SUCC: thread[5] progressive mode, completed total inserted rows: 12500000, 321802.51 records/second -[02/14 15:28:26.328615] SUCC: thread[6] progressive mode, completed total inserted rows: 12500000, 321804.13 records/second -[02/14 15:28:26.379189] SUCC: thread[7] progressive mode, completed total inserted rows: 12500000, 320719.22 records/second -[02/14 15:28:26.400891] SUCC: thread[1] progressive mode, completed total inserted rows: 12500000, 321512.59 records/second -[02/14 15:28:26.470912] SUCC: thread[2] progressive mode, completed total inserted rows: 12500000, 319026.94 records/second -[02/14 15:28:26.565079] SUCC: thread[3] progressive mode, completed total inserted rows: 12500000, 317248.21 records/second -[02/14 15:28:26.566013] SUCC: Spent 52.307623 (real 39.013939) seconds to insert rows: 100000000 with 8 thread(s) into test 1911767.24 (real 2563186.45) records/second -[02/14 15:28:26.566024] SUCC: insert delay, min: 11.1290ms, avg: 31.2112ms, p90: 35.4900ms, p95: 37.0580ms, p99: 41.5180ms, max: 68.5900ms -[02/17 14:09:42.181835] SUCC: created database (test) -[02/17 14:09:42.210373] INFO: start creating 10000 table(s) with 8 thread(s) -[02/17 14:09:44.199467] SUCC: Spent 1.9890 seconds to create 10000 table(s) with 8 thread(s) speed: 5028 tables/s, already exist 0 table(s), actual 10000 table(s) pre created, 0 table(s) will be auto created -[02/17 14:10:32.845475] SUCC: thread[3] progressive mode, completed total inserted rows: 12500000, 338184.62 records/second -[02/17 14:10:32.872586] SUCC: thread[4] progressive mode, completed total inserted rows: 12500000, 338445.48 records/second -[02/17 14:10:32.873271] SUCC: thread[1] progressive mode, completed total inserted rows: 12500000, 339256.73 records/second -[02/17 14:10:32.938231] SUCC: thread[5] progressive mode, completed total inserted rows: 12500000, 338737.29 records/second -[02/17 14:10:32.947655] SUCC: thread[2] progressive mode, completed total inserted rows: 12500000, 338938.99 records/second -[02/17 14:10:32.952985] SUCC: thread[0] progressive mode, completed total inserted rows: 12500000, 338652.89 records/second -[02/17 14:10:32.962370] SUCC: thread[6] progressive mode, completed total inserted rows: 12500000, 338890.00 records/second -[02/17 14:10:32.998729] SUCC: thread[7] progressive mode, completed total inserted rows: 12500000, 339216.19 records/second -[02/17 14:10:32.999680] SUCC: Spent 48.790057 (real 36.896020) seconds to insert rows: 100000000 with 8 thread(s) into test 2049597.93 (real 2710319.43) records/second -[02/17 14:10:32.999696] SUCC: insert delay, min: 10.7720ms, avg: 29.5168ms, p90: 32.6910ms, p95: 33.8370ms, p99: 36.6750ms, max: 76.0590ms diff --git a/tests/army/test.py b/tests/army/test.py index a66743b40a..6ac0948b7b 100644 --- a/tests/army/test.py +++ b/tests/army/test.py @@ -37,9 +37,6 @@ import taos import taosrest import taosws -from taos.cinterface import * -taos.taos_options(6, "native") - def checkRunTimeError(): import win32gui timeCount = 0 @@ -261,9 +258,8 @@ if __name__ == "__main__": # # do exeCmd command # - taosAdapter = True # default is websocket , so must start taosAdapter if not execCmd == "": - if taosAdapter or restful or websocket: + if taosAdapter or taosAdapter or restful or websocket: tAdapter.init(deployPath) else: tdDnodes.init(deployPath) diff --git a/tests/army/tools/benchmark/basic/commandline-sml.py b/tests/army/tools/benchmark/basic/commandline-sml.py index 4533dedbbd..8032abdecd 100644 --- a/tests/army/tools/benchmark/basic/commandline-sml.py +++ b/tests/army/tools/benchmark/basic/commandline-sml.py @@ -68,14 +68,10 @@ class TDTestCase(TBase): tdSql.checkData(0, 0, 10*10000) # add normal table - cmd = "%s -N -I sml -t 2 -n 10000 -y" % binPath - tdLog.info("%s" % cmd) - os.system("%s" % cmd) - - tdSql.query("select count(*) from test.d0") - tdSql.checkData(0, 0, 1*10000) - tdSql.query("select count(*) from test.d1") - tdSql.checkData(0, 0, 1*10000) + cmd = "-N -I sml -t 2 -n 10000 -y" + rlist = self.benchmark(cmd, checkRun = False) + # expect failed + self.checkListString(rlist, "schemaless cannot work without stable") def stop(self): tdSql.close() diff --git a/tests/army/tools/benchmark/basic/connMode.py b/tests/army/tools/benchmark/basic/connMode.py index 0f3a99a386..8e85f6a995 100644 --- a/tests/army/tools/benchmark/basic/connMode.py +++ b/tests/army/tools/benchmark/basic/connMode.py @@ -68,12 +68,15 @@ class TDTestCase(TBase): os.environ['TDENGINE_CLOUD_DSN'] = "" def checkCommandLine(self): + # default CONN_MODE + DEFAULT_CONN_MODE = "Native" + # modes modes = ["", "-Z 1 -B 1", "-Z websocket", "-Z 0", "-Z native -B 2"] # result Rows = "insert rows: 9990" results1 = [ - ["Connect mode is : WebSocket", Rows], + [f"Connect mode is : {DEFAULT_CONN_MODE}", Rows], ["Connect mode is : WebSocket", Rows], ["Connect mode is : WebSocket", Rows], ["Connect mode is : Native", Rows], @@ -112,7 +115,7 @@ class TDTestCase(TBase): # ommand # self.benchmarkCmd("-h 127.0.0.1", 5, 100, 10, ["insert rows: 500"]) - self.benchmarkCmd("-h 127.0.0.1 -P 6041 -uroot -ptaosdata", 5, 100, 10, ["insert rows: 500"]) + self.benchmarkCmd("-h 127.0.0.1 -uroot -ptaosdata", 5, 100, 10, ["insert rows: 500"]) self.benchmarkCmd("-Z 0 -h 127.0.0.1 -P 6030 -uroot -ptaosdata", 5, 100, 10, ["insert rows: 500"]) # @@ -120,7 +123,7 @@ class TDTestCase(TBase): # # 6041 is default - options = "-h 127.0.0.1 -P 6041 -uroot -ptaosdata" + options = "-Z 1 -h 127.0.0.1 -P 6041 -uroot -ptaosdata" json = "tools/benchmark/basic/json/connModePriorityErrHost.json" self.insertBenchJson(json, options, True) diff --git a/tests/army/tools/benchmark/basic/websiteCase.py b/tests/army/tools/benchmark/basic/websiteCase.py index 67b5620931..55ee7dcb01 100644 --- a/tests/army/tools/benchmark/basic/websiteCase.py +++ b/tests/army/tools/benchmark/basic/websiteCase.py @@ -221,7 +221,7 @@ class TDTestCase(TBase): def checkTmqJson(self, benchmark, json): OK_RESULT = "Consumed total msgs: 30, total rows: 300000" cmd = benchmark + " -f " + json - output,error = frame.eos.run(cmd, 600) + output, error, code = frame.eos.run(cmd, 600) if output.find(OK_RESULT) != -1: tdLog.info(f"succ: {cmd} found '{OK_RESULT}'") else: diff --git a/tests/army/tools/benchmark/ws/websocket.py b/tests/army/tools/benchmark/ws/websocket.py index 1394e892ef..8242bf8716 100644 --- a/tests/army/tools/benchmark/ws/websocket.py +++ b/tests/army/tools/benchmark/ws/websocket.py @@ -29,7 +29,7 @@ class TDTestCase(TBase): def run(self): binPath = etool.benchMarkFile() - cmd = "%s -t 1 -n 1 -y -W http://localhost:6041 -D 30" % binPath + cmd = "%s -t 1 -n 1 -y -W http://localhost:6041 " % binPath tdLog.info("%s" % cmd) os.system("%s" % cmd) tdSql.execute("reset query cache") diff --git a/tests/army/tools/taosdump/native/taosdumpCommandline.py b/tests/army/tools/taosdump/native/taosdumpCommandline.py index c3b33ba45e..d00df415e2 100644 --- a/tests/army/tools/taosdump/native/taosdumpCommandline.py +++ b/tests/army/tools/taosdump/native/taosdumpCommandline.py @@ -158,7 +158,7 @@ class TDTestCase(TBase): def basicCommandLine(self, tmpdir): #command and check result checkItems = [ - [f"-h 127.0.0.1 -P 6041 -uroot -ptaosdata -A -N -o {tmpdir}", ["OK: Database test dumped"]], + [f"-Z 0 -h 127.0.0.1 -P 6030 -uroot -ptaosdata -A -N -o {tmpdir}", ["OK: Database test dumped"]], [f"-r result -a -e test d0 -o {tmpdir}", ["OK: table: d0 dumped", "OK: 100 row(s) dumped out!"]], [f"-n -D test -o {tmpdir}", ["OK: Database test dumped", "OK: 205 row(s) dumped out!"]], [f"-Z 0 -P 6030 -n -D test -o {tmpdir}", ["OK: Database test dumped", "OK: 205 row(s) dumped out!"]], @@ -348,19 +348,12 @@ class TDTestCase(TBase): self.exceptCommandLine(taosdump, db, stb, tmpdir) tdLog.info("4. except command line ................................. [Passed]") - json = "./tools/taosdump/native/json/insertOther.json" - # insert - db, stb, childCount, insertRows = self.insertData(json) - # dump in/out - self.dumpInOutMode("", db , json, tmpdir) - tdLog.info("5. native varbinary geometry ........................... [Passed]") - # # check connMode # self.checkConnMode(db, stb, childCount, insertRows, tmpdir) - tdLog.info("6. check conn mode ..................................... [Passed]") + tdLog.info("5. check conn mode ..................................... [Passed]") def stop(self): diff --git a/tests/develop-test/test.py b/tests/develop-test/test.py index b291e58e3d..3525fd6332 100644 --- a/tests/develop-test/test.py +++ b/tests/develop-test/test.py @@ -38,8 +38,6 @@ from util.taosadapter import * import taos import taosrest -from taos.cinterface import * -taos.taos_options(6, "native") def checkRunTimeError(): import win32gui diff --git a/tests/docs-examples-test/python.sh b/tests/docs-examples-test/python.sh index 8e43f26d5c..49e3875a6a 100644 --- a/tests/docs-examples-test/python.sh +++ b/tests/docs-examples-test/python.sh @@ -126,7 +126,7 @@ python3 mockdatasource.py python3 fast_write_example.py # 20 -pip3 install kafka-python +pip3 install kafka-python==2.1.2 python3 kafka_example_consumer.py # 21 @@ -196,4 +196,5 @@ check_transactions || exit 1 reset_cache || exit 1 python3 tmq_websocket_example.py -python3 stmt2_native.py \ No newline at end of file +python3 stmt2_native.py + diff --git a/tests/parallel_test/cases.task b/tests/parallel_test/cases.task index 75c50ceb05..b5f41838df 100644 --- a/tests/parallel_test/cases.task +++ b/tests/parallel_test/cases.task @@ -108,7 +108,6 @@ ,,y,army,./pytest.sh python3 ./test.py -f tools/benchmark/basic/custom_col_tag.py ,,y,army,./pytest.sh python3 ./test.py -f tools/benchmark/basic/default_json.py -,,y,army,./pytest.sh python3 ./test.py -f tools/benchmark/basic/default_tmq_json.py ,,y,army,./pytest.sh python3 ./test.py -f tools/benchmark/basic/demo.py ,,y,army,./pytest.sh python3 ./test.py -f tools/benchmark/basic/csv-export.py diff --git a/tests/script/test.sh b/tests/script/test.sh index 080b1c5d1c..81e7bc2f8a 100755 --- a/tests/script/test.sh +++ b/tests/script/test.sh @@ -9,6 +9,9 @@ set +e #set -x +export ASAN_OPTIONS=detect_odr_violation=0 +echo "forbid check ODR violation." + FILE_NAME= VALGRIND=0 TEST=0 diff --git a/tests/system-test/test.py b/tests/system-test/test.py index 1958e9976e..cd0e60160c 100644 --- a/tests/system-test/test.py +++ b/tests/system-test/test.py @@ -40,9 +40,6 @@ import taos import taosrest import taosws -from taos.cinterface import * -taos.taos_options(6, "native") - def checkRunTimeError(): import win32gui timeCount = 0 @@ -73,6 +70,7 @@ def get_local_classes_in_order(file_path): def dynamicLoadModule(fileName): moduleName = fileName.replace(".py", "").replace(os.sep, ".") return importlib.import_module(moduleName, package='..') + # # run case on previous cluster # @@ -254,9 +252,8 @@ if __name__ == "__main__": # # do exeCmd command # - taosAdapter = True # default is websocket , so must start taosAdapter if not execCmd == "": - if taosAdapter or restful or websocket: + if restful or websocket: tAdapter.init(deployPath) else: tdDnodes.init(deployPath) @@ -295,7 +292,7 @@ if __name__ == "__main__": if valgrind: time.sleep(2) - if taosAdapter or restful or websocket: + if restful or websocket: toBeKilled = "taosadapter" # killCmd = "ps -ef|grep -w %s| grep -v grep | awk '{print $2}' | xargs kill -TERM > /dev/null 2>&1" % toBeKilled @@ -391,7 +388,7 @@ if __name__ == "__main__": tdDnodes.deploy(1,updateCfgDict) tdDnodes.start(1) tdCases.logSql(logSql) - if taosAdapter or restful or websocket: + if restful or websocket: tAdapter.deploy(adapter_cfg_dict) tAdapter.start() @@ -431,7 +428,7 @@ if __name__ == "__main__": tdDnodes.starttaosd(dnode.index) tdCases.logSql(logSql) - if taosAdapter or restful or websocket: + if restful or websocket: tAdapter.deploy(adapter_cfg_dict) tAdapter.start() @@ -553,7 +550,7 @@ if __name__ == "__main__": except: pass - if taosAdapter or restful or websocket: + if restful or websocket: tAdapter.init(deployPath, masterIp) tAdapter.stop(force_kill=True) @@ -563,7 +560,7 @@ if __name__ == "__main__": tdDnodes.start(1) tdCases.logSql(logSql) - if taosAdapter or restful or websocket: + if restful or websocket: tAdapter.deploy(adapter_cfg_dict) tAdapter.start() @@ -618,7 +615,7 @@ if __name__ == "__main__": tdDnodes.starttaosd(dnode.index) tdCases.logSql(logSql) - if taosAdapter or restful or websocket: + if restful or websocket: tAdapter.deploy(adapter_cfg_dict) tAdapter.start() diff --git a/tools/inc/pub.h b/tools/inc/pub.h index fd9fa9558f..d6114a55ee 100644 --- a/tools/inc/pub.h +++ b/tools/inc/pub.h @@ -17,6 +17,7 @@ #define PUB_H_ #include +#include #include #include #include @@ -72,10 +73,11 @@ int8_t getConnMode(char *arg); char* strToLowerCopy(const char *str); int32_t parseDsn(char* dsn, char **host, char **port, char **user, char **pwd, char* error); -int32_t setConnMode(int8_t connMode, char *dsn); +int32_t setConnMode(int8_t connMode, char *dsn, bool show); uint16_t defaultPort(int8_t connMode, char *dsn); -int8_t defaultMode(int8_t connMode, char *dsn); +// working connect mode +int8_t workingMode(int8_t connMode, char *dsn); #endif // PUB_H_ \ No newline at end of file diff --git a/tools/shell/src/shellArguments.c b/tools/shell/src/shellArguments.c index 209168149e..0b319ac8a1 100644 --- a/tools/shell/src/shellArguments.c +++ b/tools/shell/src/shellArguments.c @@ -219,9 +219,6 @@ static int32_t shellParseSingleOpt(int32_t key, char *arg) { break; #if defined(LINUX) case 'o': - printf(" -o need todo optins.\n"); - // need todo pass tsLogOutput to engine - /* if (strlen(arg) >= PATH_MAX) { printf("failed to set log output since length overflow, max length is %d\r\n", PATH_MAX); return TSDB_CODE_INVALID_CFG; @@ -235,7 +232,6 @@ static int32_t shellParseSingleOpt(int32_t key, char *arg) { printf("failed to expand log output: '%s' since %s\r\n", arg, tstrerror(terrno)); return terrno; } - */ break; #endif case 'E': diff --git a/tools/shell/src/shellEngine.c b/tools/shell/src/shellEngine.c index 46d0c88b02..afcedeef08 100644 --- a/tools/shell/src/shellEngine.c +++ b/tools/shell/src/shellEngine.c @@ -1355,17 +1355,22 @@ TAOS* createConnect(SShellArgs *pArgs) { } // connect main + TAOS * taos = NULL; if (pArgs->auth) { - return taos_connect_auth(host, user, pArgs->auth, pArgs->database, port); + taos = taos_connect_auth(host, user, pArgs->auth, pArgs->database, port); } else { - return taos_connect(host, user, pwd, pArgs->database, port); + taos = taos_connect(host, user, pwd, pArgs->database, port); } + + // host user pointer in dsnc address + free(dsnc); + return taos; } int32_t shellExecute(int argc, char *argv[]) { int32_t code = 0; printf(shell.info.clientVersion, shell.info.cusName, - defaultMode(shell.args.connMode, shell.args.dsn) == CONN_MODE_NATIVE ? STR_NATIVE : STR_WEBSOCKET, + workingMode(shell.args.connMode, shell.args.dsn) == CONN_MODE_NATIVE ? STR_NATIVE : STR_WEBSOCKET, taos_get_client_info(), shell.info.cusName); fflush(stdout); diff --git a/tools/shell/src/shellMain.c b/tools/shell/src/shellMain.c index 31fad97bd4..edf52da778 100644 --- a/tools/shell/src/shellMain.c +++ b/tools/shell/src/shellMain.c @@ -101,7 +101,7 @@ int main(int argc, char *argv[]) { return -1; } - if (setConnMode(shell.args.connMode, shell.args.dsn)) { + if (setConnMode(shell.args.connMode, shell.args.dsn, false)) { return -1; } diff --git a/tools/src/pub.c b/tools/src/pub.c index 7e561b57d9..4b9389e455 100644 --- a/tools/src/pub.c +++ b/tools/src/pub.c @@ -91,7 +91,7 @@ } // set conn mode -int32_t setConnMode(int8_t connMode, char *dsn) { +int32_t setConnMode(int8_t connMode, char *dsn, bool show) { // check default if (connMode == CONN_MODE_INVALID) { if (dsn && dsn[0] != 0) { @@ -109,11 +109,16 @@ int32_t setConnMode(int8_t connMode, char *dsn) { fprintf(stderr, "failed to load driver. since %s [0x%08X]\r\n", taos_errstr(NULL), taos_errno(NULL)); return code; } + + if (show) { + fprintf(stdout, "\nConnect mode is : %s\n\n", strMode); + } + return 0; } // default mode -int8_t defaultMode(int8_t connMode, char *dsn) { +int8_t workingMode(int8_t connMode, char *dsn) { int8_t mode = connMode; if (connMode == CONN_MODE_INVALID) { // no input from command line or config @@ -129,10 +134,15 @@ int8_t defaultMode(int8_t connMode, char *dsn) { // get default port uint16_t defaultPort(int8_t connMode, char *dsn) { + // port 0 is default + return 0; + + /* // consistent with setConnMode - int8_t mode = defaultMode(connMode, dsn); + int8_t mode = workingMode(connMode, dsn); // default port return mode == CONN_MODE_NATIVE ? DEFAULT_PORT_NATIVE : DEFAULT_PORT_WS_LOCAL; + */ } \ No newline at end of file diff --git a/tools/taos-tools/src/benchData.c b/tools/taos-tools/src/benchData.c index 1a49c7f75c..917897e544 100644 --- a/tools/taos-tools/src/benchData.c +++ b/tools/taos-tools/src/benchData.c @@ -256,13 +256,13 @@ char* genPrepareSql(SSuperTable *stbInfo, char* tagData, uint64_t tableSeq, char "INSERT INTO ? USING `%s`.`%s` TAGS (%s) %s VALUES(?,%s)", db, stbInfo->stbName, tagQ, ttl, colQ); } else { - if (g_arguments->connMode == CONN_MODE_NATIVE) { + if (workingMode(g_arguments->connMode, g_arguments->dsn) == CONN_MODE_NATIVE) { // native n = snprintf(prepare + len, TSDB_MAX_ALLOWED_SQL_LEN - len, "INSERT INTO ? VALUES(?,%s)", colQ); } else { // websocket - bool ntb = stbInfo->tags == NULL || stbInfo->tags->size == 0; // nomral table + bool ntb = stbInfo->tags == NULL || stbInfo->tags->size == 0; // normal table colNames = genColNames(stbInfo->cols, !ntb); n = snprintf(prepare + len, TSDB_MAX_ALLOWED_SQL_LEN - len, "INSERT INTO `%s`.`%s`(%s) VALUES(%s,%s)", db, stbInfo->stbName, colNames, diff --git a/tools/taos-tools/src/benchMain.c b/tools/taos-tools/src/benchMain.c index fa47329b37..190defa5a7 100644 --- a/tools/taos-tools/src/benchMain.c +++ b/tools/taos-tools/src/benchMain.c @@ -168,7 +168,7 @@ int main(int argc, char* argv[]) { } // conn mode - if (setConnMode(g_arguments->connMode, g_arguments->dsn) != 0) { + if (setConnMode(g_arguments->connMode, g_arguments->dsn, true) != 0) { exitLog(); return -1; } diff --git a/tools/taos-tools/src/taosdump.c b/tools/taos-tools/src/taosdump.c index 6ef633fb9b..5d513a3ba6 100644 --- a/tools/taos-tools/src/taosdump.c +++ b/tools/taos-tools/src/taosdump.c @@ -150,6 +150,7 @@ static struct argp_option options[] = { {"inspect", 'I', 0, 0, "inspect avro file content and print on screen", 10}, {"no-escape", 'n', 0, 0, "No escape char '`'. Default is using it.", 10}, + {"restful", 'R', 0, 0, "Use RESTful interface to connect server", 11}, {"cloud", 'C', "CLOUD_DSN", 0, OLD_DSN_DESC, 11}, {"timeout", 't', "SECONDS", 0, "The timeout seconds for " "websocket to interact."}, @@ -691,7 +692,9 @@ static error_t parse_opt(int key, char *arg, struct argp_state *state) { } g_args.thread_num = atoi((const char *)arg); break; - + case 'R': + warnPrint("%s\n", "'-R' is not supported, ignore this options."); + break; case 'C': case 'X': if (arg) { @@ -10910,7 +10913,7 @@ int main(int argc, char *argv[]) { } // conn mode - if (setConnMode(g_args.connMode, g_args.dsn) != 0) { + if (setConnMode(g_args.connMode, g_args.dsn, true) != 0) { return -1; } From d00f5e332d5e10c052dc29617e4093ff32861769 Mon Sep 17 00:00:00 2001 From: Jing Sima Date: Sat, 22 Mar 2025 21:12:25 +0800 Subject: [PATCH 18/26] docs: [TS-4897] Add docs for virtual table. (#30325) * docs: [TS-4897] Add docs for virtual table. * Update 01-model.md * Update 01-model.md * docs: [TS-4897] Modify docs of virtual table. --------- Co-authored-by: Pan Wei <72057773+dapan1121@users.noreply.github.com> --- docs/zh/05-basic/01-model.md | 191 +++++++++++ .../zh/05-basic/data-model-origin-table-2.png | Bin 0 -> 56202 bytes docs/zh/05-basic/data-model-origin-table.png | Bin 0 -> 54631 bytes docs/zh/14-reference/03-taos-sql/04-stable.md | 2 + docs/zh/14-reference/03-taos-sql/22-meta.md | 48 +-- .../03-taos-sql/34-virtualtable.md | 311 ++++++++++++++++++ .../pic/virtual-table-origin-table.png | Bin 0 -> 7998 bytes .../pic/virtual-table-query-res-part.png | Bin 0 -> 3194 bytes .../pic/virtual-table-query-res.png | Bin 0 -> 5027 bytes 9 files changed, 529 insertions(+), 23 deletions(-) create mode 100644 docs/zh/05-basic/data-model-origin-table-2.png create mode 100644 docs/zh/05-basic/data-model-origin-table.png create mode 100644 docs/zh/14-reference/03-taos-sql/34-virtualtable.md create mode 100644 docs/zh/14-reference/03-taos-sql/pic/virtual-table-origin-table.png create mode 100644 docs/zh/14-reference/03-taos-sql/pic/virtual-table-query-res-part.png create mode 100644 docs/zh/14-reference/03-taos-sql/pic/virtual-table-query-res.png diff --git a/docs/zh/05-basic/01-model.md b/docs/zh/05-basic/01-model.md index fc5c3a0a2e..0f01fbf562 100644 --- a/docs/zh/05-basic/01-model.md +++ b/docs/zh/05-basic/01-model.md @@ -77,6 +77,22 @@ toc_max_heading_level: 4 ![数据模型示意图](./data-model.png) +### 虚拟表 + +“一个设备一张表”的设计解决了工业和物联网等场景下的大多数时序数据管理和分析难题，但是在遇到更复杂的场景时，这种设计受到了设备复杂性的挑战。这种复杂性的根源在于一个设备无法简单的用一个或一组数据采集点来描述或管理，而业务分析往往需要综合多个或多组采集点的数据才能完成。以汽车或发电风机为例，整个设备（汽车或风机）中含有非常大量的传感器（数据采集点），这些传感器的输出和采集频率千差万别。一个超级表只能描述其中一种传感器，当需要综合多个传感器的数据进行分析计算时，只能通过多级关联查询的方式来进行，而这往往会导致易用性和性能方面的问题。 + +为了解决这个问题，TDengine 引入虚拟表（Virtual Table，简称为 VTable）的概念。虚拟表是一种不存储实际数据而可以用于分析计算的表，它的数据来源为其它真实存储数据的子表、普通表，通过将不同列数据按照时间戳排序、对齐、合并的方式来生成虚拟表。同真实表类似，虚拟表也可以分为虚拟超级表、虚拟子表、虚拟普通表。虚拟超级表可以是一个设备或一组分析计算所需数据的完整集合，每个虚拟子表可以根据需要引用相同或不同的列，因此可以灵活地根据业务需要进行定义，最终可以达到千表千面的效果。虚拟表不能写入、删除数据，在查询使用上同真实表基本相同，支持虚拟超级表、虚拟子表、虚拟普通表上的任何查询。唯一的区别在于虚拟表的数据是每次查询计算时动态生成的，只有一个查询中引用的列才会被合并进虚拟表中，因此同一个虚拟表在不同的查询中所呈现的数据可能是不同的。 + +虚拟超级表的主要功能特点包括： +1. 列选择与拼接
+ 用户可以从多个原始表中选择指定的列，按需组合到一张虚拟表中，形成统一的数据视图。 +2. 基于时间戳对齐
+ 以时间戳为依据对数据进行对齐，如果多个表在相同时间戳下存在数据，则对应列的值组合成同一行；若部分表在该时间戳下无数据，则对应列填充为 NULL。 +3. 动态更新
+ 虚拟表根据原始表的数据变化自动更新，确保数据的实时性。虚拟表不需实际存储，计算在生成时动态完成。 + +通过引入虚拟表的概念，现在 TDengine 可以非常方便的管理更大更复杂的设备数据。无论每个采集点如何建模（单列 or 多列），无论这些采集点的数据是分布在一个或多个库中，我们现在都可以通过定义虚拟子表的方式跨库跨表任意指定数据源，通过虚拟超级表的方式进行跨设备、跨分析的聚合运算，从此“一个设备一张表”彻底成为现实。 + ### 库 库是 TDengine 中用于管理一组表的集合。TDengine 允许一个运行实例包含多个库，并且每个库都可以配置不同的存储策略。由于不同类型的数据采集点通常具有不同的数据特征，如数据采集频率、数据保留期限、副本数量、数据块大小等。为了在各种场景下确保 TDengine 能够发挥最大效率，建议将具有不同数据特征的超级表创建在不同的库中。 @@ -93,6 +109,7 @@ toc_max_heading_level: 4 在查询数据时，TDengine 客户端会根据应用程序当前的时区设置，自动将保存的 UTC 时间戳转换成本地时间进行显示，确保用户在不同时区下都能看到正确的时间信息。 + ## 数据建模 本节用智能电表做例子，简要的介绍如何在 TDengine 里使用 SQL 创建数据库、超级表、表的基本操作。 @@ -215,3 +232,177 @@ TDengine 支持灵活的数据模型设计，包括多列模型和单列模型 尽管 TDengine 推荐使用多列模型，因为这种模型在写入效率和存储效率方面通常更优，但在某些特定场景下，单列模型可能更为适用。例如，当一个数据采集点的采集量种类经常发生变化时，如果采用多列模型，就需要频繁修改超级表的结构定义，这会增加应用程序的复杂性。在这种情况下，采用单列模型可以简化应用程序的设计和管理，因为它允许独立地管理和扩展每个物理量的超级表。 总之，TDengine 提供了灵活的数据模型选项，用户可以根据实际需求和场景选择最适合的模型，以优化性能和管理复杂性。 + +### 创建虚拟表 + +无论是选择单列模型还是多列模型，TDengine 都可以通过使用虚拟表进行跨表的运算。为智能电表为例，这里介绍虚拟表的两种使用场景： + +1. 单源多维度时序聚合 +2. 跨源采集量对比分析 + +#### 单源多维度时序聚合 +在单源多维度时序聚合场景中，“单源”并非指单一物理表，而是指来自**同一数据采集点**下的多个单列时序数据表。这些数据因业务需求或其他限制被拆分为多个单列存储的表，但通过设备标签和时间基准保持逻辑一致性。虚拟表在此场景中的作用是将一个采集点中“纵向“拆分的数据，还原为完整的“横向”状态。 +例如，在建模时采用了单列模型，对于电流、电压和相位这 3 种物理量，分别建立 3 张超级表。在这种场景下，用户可以通过虚拟表将这 3 种不同的采集量聚合到一张表中，以便进行统一的查询和分析。 + +创建单列模型的超级表的 SQL 如下： + +```sql + +CREATE STABLE current_stb ( + ts timestamp, + current float +) TAGS ( + device_id varchar(64), + location varchar(64), + group_id int +); + +CREATE STABLE voltage_stb ( + ts timestamp, + voltage int +) TAGS ( + device_id varchar(64), + location varchar(64), + group_id int +); + +CREATE STABLE phase_stb ( + ts timestamp, + phase float +) TAGS ( + device_id varchar(64), + location varchar(64), + group_id int +); +``` + +假设分别有 d1001,d1002,d1003,d1004 四个设备，分别对四个设备的电流、电压、相位采集量创建子表，SQL 如下： + +```sql +create table current_d1001 using current_stb(deviceid, location, group_id) tags("d1001", "California.SanFrancisco", 2); +create table current_d1002 using current_stb(deviceid, location, group_id) tags("d1002", "California.SanFrancisco", 3); +create table current_d1003 using current_stb(deviceid, location, group_id) tags("d1003", "California.LosAngeles", 3); +create table current_d1004 using current_stb(deviceid, location, group_id) tags("d1004", "California.LosAngeles", 2); + +create table voltage_d1001 using voltage_stb(deviceid, location, group_id) tags("d1001", "California.SanFrancisco", 2); +create table voltage_d1002 using voltage_stb(deviceid, location, group_id) tags("d1002", "California.SanFrancisco", 3); +create table voltage_d1003 using voltage_stb(deviceid, location, group_id) tags("d1003", "California.LosAngeles", 3); +create table voltage_d1004 using voltage_stb(deviceid, location, group_id) tags("d1004", "California.LosAngeles", 2); + +create table phase_d1001 using phase_stb(deviceid, location, group_id) tags("d1001", "California.SanFrancisco", 2); +create table phase_d1002 using phase_stb(deviceid, location, group_id) tags("d1002", "California.SanFrancisco", 3); +create table phase_d1003 using phase_stb(deviceid, location, group_id) tags("d1003", "California.LosAngeles", 3); +create table phase_d1004 using phase_stb(deviceid, location, group_id) tags("d1004", "California.LosAngeles", 2); +``` + +此时想要通过一张虚拟超级表来讲这三种采集量聚合到一张表中，创建虚拟超级表 SQL 如下： + +```sql +CREATE STABLE meters_v ( + ts timestamp, + current float, + voltage int, + phase float +) TAGS ( + location varchar(64), + group_id int +) VIRTUAL 1; +``` + +并且对四个设备 d1001,d1002,d1003,d1004 分别创建虚拟子表，SQL 如下： + +```sql +CREATE VTABLE d1001_v ( + current from current_d1001.current, + voltage from voltage_d1001.voltage, + phase from phase_d1001.phase +) +USING meters_v +TAGS ( + "California.SanFrancisco", + 2 +); + +CREATE VTABLE d1002_v ( + current from current_d1002.current, + voltage from voltage_d1002.voltage, + phase from phase_d1002.phase +) +USING meters_v +TAGS ( + "California.SanFrancisco", + 3 +); + +CREATE VTABLE d1003_v ( + current from current_d1003.current, + voltage from voltage_d1003.voltage, + phase from phase_d1003.phase +) +USING meters_v +TAGS ( + "California.LosAngeles", + 3 +); + +CREATE VTABLE d1004_v ( + current from current_d1004.current, + voltage from voltage_d1004.voltage, + phase from phase_d1004.phase +) +USING meters_v +TAGS ( + "California.LosAngeles", + 2 +); +``` + +以设备 d1001 为例，假设 d1001 设备的电流、电压、相位数据如下： + +![data-model-origin-table.png](data-model-origin-table.png) + +虚拟表 d1001_v 中的数据如下 : + +| Timestamp | Current | Voltage | Phase | +|:--------------:|:-------:|:---------:|:-------:| +| 1538548685000 | 10.3 | 219 | 0.31 | +| 1538548695000 | 12.6 | 218 | 0.33 | +| 1538548696800 | 12.3 | 221 | 0.31 | +| 1538548697100 | 12.1 | 220 | NULL | +| 1538548697200 | NULL | NULL | 0.32 | +| 1538548697700 | 11.8 | NULL | NULL | +| 1538548697800 | NULL | 222 | 0.33 | + +#### 跨源采集量对比分析 + +在跨源采集量对比分析中，“跨源”指数据来自**不同数据采集点**。在不同数据采集点中提取具有可比语义的采集量，通过虚拟表将这些采集量按照时间戳进行对齐和合并，并进行对比分析。 +例如，用户可以将来自不同设备的电流数据聚合到一张虚拟表中，以便进行电流数据的对比分析。 + +以分析 d1001, d1002, d1003, d1004 四个设备的电流数据为例，创建虚拟表的 SQL 如下： + +```sql +CREATE VTABLE current_v ( + ts timestamp, + d1001_current float from current_d1001.current, + d1002_current float from current_d1002.current, + d1003_current float from current_d1003.current, + d1004_current float from current_d1004.current +); +``` + +假设 d1001, d1002, d1003, d1004 四个设备的电流数据如下： + +![data-model-origin-table-2.png](data-model-origin-table-2.png) + +虚拟表 current_v 中的数据如下： + +| Timestamp | d1001_current | d1002_current | d1003_current | d1004_current | +|:--------------:|:-------------:|:-------------:|:-------------:|:-------------:| +| 1538548685000 | 10.3 | 11.7 | 11.2 | 12.4 | +| 1538548695000 | 12.6 | 11.9 | 10.8 | 11.3 | +| 1538548696800 | 12.3 | 12.4 | 12.3 | 10.1 | +| 1538548697100 | 12.1 | NULL | 11.1 | NULL | +| 1538548697200 | NULL | 12.2 | NULL | 11.7 | +| 1538548697700 | 11.8 | 11.4 | NULL | NULL | +| 1538548697800 | NULL | NULL | 12.1 | 12.6 | + diff --git a/docs/zh/05-basic/data-model-origin-table-2.png b/docs/zh/05-basic/data-model-origin-table-2.png new file mode 100644 index 0000000000000000000000000000000000000000..8d0e203b4e11f02bf24512e8cfc336021b285b31 GIT binary patch literal 56202 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 literal 0 HcmV?d00001 diff --git a/docs/zh/05-basic/data-model-origin-table.png b/docs/zh/05-basic/data-model-origin-table.png new file mode 100644 index 0000000000000000000000000000000000000000..4e128e26b0bcf54db821f425348193368a8f8787 GIT binary patch literal 54631 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 literal 0 HcmV?d00001 diff --git a/docs/zh/14-reference/03-taos-sql/04-stable.md b/docs/zh/14-reference/03-taos-sql/04-stable.md index 98dad1a2e4..5412e6d129 100644 --- a/docs/zh/14-reference/03-taos-sql/04-stable.md +++ b/docs/zh/14-reference/03-taos-sql/04-stable.md @@ -22,6 +22,7 @@ table_option: { COMMENT 'string_value' | SMA(col_name [, col_name] ...) | KEEP value + | VIRTUAL {0 | 1} } ``` @@ -36,6 +37,7 @@ table_option: { 4. 关于 `ENCODE` 和 `COMPRESS` 的使用，请参考 [按列压缩](../compress) 5. 关于 table_option 中的参数说明，请参考 [建表 SQL 说明](../table) 6. 关于 table_option 中的 keep 参数，仅对超级表生效，keep 参数的详细说明可以参考 [数据库说明](02-database.md)，唯一不同的是超级表 keep 不会立即影响查询结果，仅在 compact 后生效。 +7. 关于 table_option 中的 virtual 参数，仅对超级表生效，指定为 1 表示创建虚拟超级表，为 0 表示创建超级表，默认为 0。创建虚拟超级表时，column_definition 中只支持 type_name 选项，不支持定义额外主键列以及压缩选项。 ## 查看超级表 diff --git a/docs/zh/14-reference/03-taos-sql/22-meta.md b/docs/zh/14-reference/03-taos-sql/22-meta.md index 2e583a36b2..e947c06bac 100644 --- a/docs/zh/14-reference/03-taos-sql/22-meta.md +++ b/docs/zh/14-reference/03-taos-sql/22-meta.md @@ -151,18 +151,19 @@ TDengine 内置了一个名为 `INFORMATION_SCHEMA` 的数据库，提供对数 提供用户创建的超级表的相关信息。 -| # | **列名** | **数据类型** | **说明** | -| --- | :-----------: | ------------ | ----------------------------------------------------------------------------------------------------- | -| 1 | stable_name | VARCHAR(192) | 超级表表名 | -| 2 | db_name | VARCHAR(64) | 超级表所在的数据库的名称 | -| 3 | create_time | TIMESTAMP | 创建时间 | -| 4 | columns | INT | 列数目 | -| 5 | tags | INT | 标签数目。需要注意，`tags` 为 TDengine 关键字，作为列名使用时需要使用 ` 进行转义。 | -| 6 | last_update | TIMESTAMP | 最后更新时间 | -| 7 | table_comment | VARCHAR(1024) | 表注释 | -| 8 | watermark | VARCHAR(64) | 窗口的关闭时间。需要注意，`watermark` 为 TDengine 关键字，作为列名使用时需要使用 ` 进行转义。 | -| 9 | max_delay | VARCHAR(64) | 推送计算结果的最大延迟。需要注意，`max_delay` 为 TDengine 关键字，作为列名使用时需要使用 ` 进行转义。| -| 10 | rollup | VARCHAR(128) | rollup 聚合函数。需要注意，`rollup` 为 TDengine 关键字，作为列名使用时需要使用 ` 进行转义。 | +| # | **列名** | **数据类型** | **说明** | +|----|:-------------:|---------------|-----------------------------------------------------------------| +| 1 | stable_name | VARCHAR(192) | 超级表表名 | +| 2 | db_name | VARCHAR(64) | 超级表所在的数据库的名称 | +| 3 | create_time | TIMESTAMP | 创建时间 | +| 4 | columns | INT | 列数目 | +| 5 | tags | INT | 标签数目。需要注意，`tags` 为 TDengine 关键字，作为列名使用时需要使用 ` 进行转义。 | +| 6 | last_update | TIMESTAMP | 最后更新时间 | +| 7 | table_comment | VARCHAR(1024) | 表注释 | +| 8 | watermark | VARCHAR(64) | 窗口的关闭时间。需要注意，`watermark` 为 TDengine 关键字，作为列名使用时需要使用 ` 进行转义。 | +| 9 | max_delay | VARCHAR(64) | 推送计算结果的最大延迟。需要注意，`max_delay` 为 TDengine 关键字，作为列名使用时需要使用 ` 进行转义。 | +| 10 | rollup | VARCHAR(128) | rollup 聚合函数。需要注意，`rollup` 为 TDengine 关键字，作为列名使用时需要使用 ` 进行转义。 | +| 11 | virtual | BOOL | 超级表是否是虚拟超级表。 | ## INS_TABLES @@ -194,17 +195,18 @@ TDengine 内置了一个名为 `INFORMATION_SCHEMA` 的数据库，提供对数 ## INS_COLUMNS -| # | **列名** | **数据类型** | **说明** | -| --- | :-----------: | ------------ | ---------------------- | -| 1 | table_name | VARCHAR(192) | 表名 | -| 2 | db_name | VARCHAR(64) | 该表所在的数据库的名称 | -| 3 | table_type | VARCHAR(21) | 表类型 | -| 4 | col_name | VARCHAR(64) | 列 的名称 | -| 5 | col_type | VARCHAR(32) | 列 的类型 | -| 6 | col_length | INT | 列 的长度 | -| 7 | col_precision | INT | 列 的精度 | -| 8 | col_scale | INT | 列 的比例 | -| 9 | col_nullable | INT | 列 是否可以为空 | +| # | **列名** | **数据类型** | **说明** | +|----|:-------------:|--------------|---------------------------------------------------------------| +| 1 | table_name | VARCHAR(192) | 表名 | +| 2 | db_name | VARCHAR(64) | 该表所在的数据库的名称 | +| 3 | table_type | VARCHAR(21) | 表类型 | +| 4 | col_name | VARCHAR(64) | 列 的名称 | +| 5 | col_type | VARCHAR(32) | 列 的类型 | +| 6 | col_length | INT | 列 的长度 | +| 7 | col_precision | INT | 列 的精度 | +| 8 | col_scale | INT | 列 的比例 | +| 9 | col_nullable | INT | 列 是否可以为空 | +| 10 | col_source | VARCHAR(322) | 列 的数据来源。只有虚拟表的列才会有该值，表示虚拟表的数据来源，为 db_name.table_name.col_name | ## INS_USERS diff --git a/docs/zh/14-reference/03-taos-sql/34-virtualtable.md b/docs/zh/14-reference/03-taos-sql/34-virtualtable.md new file mode 100644 index 0000000000..a243169a0a --- /dev/null +++ b/docs/zh/14-reference/03-taos-sql/34-virtualtable.md @@ -0,0 +1,311 @@ +--- +sidebar_label: 虚拟表 +title: 虚拟表 +description: 对虚拟表的各种管理操作 +--- +## 创建虚拟表 + +`CREATE VTABLE` 语句用于创建普通虚拟表和以虚拟超级表为模板创建虚拟子表。 + +### 创建虚拟超级表 + +见 [创建超级表](./04-stable.md#创建超级表) 中的 `VIRTUAL` 参数。 + +### 创建虚拟普通表 +```sql +CREATE VTABLE [IF NOT EXISTS] [db_name].vtb_name + ts_col_name timestamp, + (create_defination[ ,create_defination] ...) + + create_definition: + vtb_col_name column_definition + +column_definition: + type_name [FROM [db_name.]table_name.col_name] + +``` + +### 创建虚拟子表 +```sql +CREATE VTABLE [IF NOT EXISTS] [db_name].vtb_name + (create_defination[ ,create_defination] ...) + USING [db_name.]stb_name + [(tag_name [, tag_name] ...)] + TAGS (tag_value [, tag_value] ...) + + create_definition: + [stb_col_name FROM] [db_name.]table_name.col_name + tag_value: + const_value +``` + +**使用说明** + +1. 虚拟表（列）名命名规则参见 [名称命名规则](./19-limit.md#名称命名规则)。 +2. 表名最大长度为 192。 +3. 表的第一个字段必须是 TIMESTAMP，并且系统自动将其设为主键。 +4. 表的每行长度不能超过 64KB（注意：每个 VARCHAR/NCHAR/GEOMETRY 类型的列还会额外占用 2 个字节的存储位置）。 +5. 使用数据类型 VARCHAR/NCHAR/GEOMETRY，需指定其最长的字节数，如 VARCHAR(20)，表示 20 字节。 +6. 创建虚拟表时使用 FROM 来指定列的数据源，支持使用 db_name 跨库指定数据源，不指定 db_name 时默认使用当前 use 的数据库，若不指定 db_name 且未 use 数据库，则会报错。 +7. 创建虚拟表时不显式的指定 ts 列的数据源，ts 列的取值是查询虚拟表时查询语句中包含的所有列对应的原始表的主键时间戳合并的结果。 +8. 虚拟超级表下只支持创建虚拟子表，虚拟子表也只能以虚拟超级表为模版来创建。 +9. 创建虚拟表时需要保证虚拟表中的列、标签和指定的数据来源列、标签的数据类型相同，否则会报错。 +10. 在同一个数据库内，虚拟表名称不允许重名，虚拟表名和表名也不允许重名。虚拟表名和视图名允许重名（不推荐）当出现视图与虚拟表名重名时，写入、查询、授权、回收权限等操作优先使用同名表。 +11. 创建虚拟子表和虚拟普通表时，使用 FROM 指定某一列的数据来源时，该列只能来源于普通子表或普通表，不支持来源于超级表、视图或其他虚拟表。也不支持来源于有复合主键的表。 + +## 查询虚拟表 + +虚拟表与正常表无论是查询语法还是范围都没有区别，不同之处在于虚拟表所呈现的数据集在不同的查询中可能是不相同的，具体可以参考虚拟表数据生成规则。 + +### 虚拟表数据生成规则 + +1. 虚拟表以时间戳为基准，对多个原始表的数据进行对齐。 +2. 如果多个原始表在相同时间戳下有数据，则这些列的值组合成同一行；否则，对于缺失的列，填充 NULL。 +3. 虚拟表的时间戳的值是查询中包含的所有列所在的原始表的时间戳的并集，因此当不同查询选择列不同时可能出现结果集行数不一样的情况。 +4. 用户可以从多个表中选择任意列进行组合，未选择的列不会出现在虚拟表中。 + +**示例** + +假设有表 t1, t2, t3 结构和数据如下： + +![virtual-table-origin-table.png](pic/virtual-table-origin-table.png) + +并且有虚拟普通表 v1 ，创建方式如下： + +```sql +create vtable v1 ( + ts timestamp, + c1 int from t1.value, + c2 int from t2.value, + c3 int from t3.value1, + c4 int from t3.value2); +``` + +那么根据虚拟表对于多表数据的整合规则，执行如下查询时： + +```sql +select * from v1; +``` + +结果如下： + +![virtual-table-query-res.png](pic/virtual-table-query-res.png) + +如果没有选择全部列，只是选择了部分列，查询的结果只会包含选择的列的原始表的时间戳，例如执行如下查询： + +```sql +select c1, c2 from v1; +``` + +得到的结果如下图所示： + +![virtual-table-query-res-part.png](pic/virtual-table-query-res-part.png) + +因为 c1, c2 列对应的原始表 t1, t2 中没有 0:00:03 这个时间戳，所以最后的结果也不会包含这个时间戳。 + +**使用限制** + +1. 查询虚拟超级表时，暂不支持虚拟子表的数据源来自不同的数据库。 + +## 修改虚拟普通表 + +```sql +ALTER VTABLE [db_name.]vtb_name alter_table_clause + +alter_table_clause: { + ADD COLUMN vtb_col_name vtb_column_type [FROM table_name.col_name] + | DROP COLUMN vtb_col_name + | ALTER COLUMN vtb_col_name SET {table_name.col_name | NULL } + | MODIFY COLUMN col_name column_type + | RENAME COLUMN old_col_name new_col_name +} +``` + +**使用说明** +对虚拟普通表可以进行如下修改操作 + +1. ADD COLUMN：添加列。 +2. DROP COLUMN：删除列。 +3. MODIFY COLUMN：修改列定义，如果数据列的类型是可变长类型，那么可以使用此指令修改其宽度，只能改大，不能改小。如果虚拟表该列已指定数据源，那么修改列宽会因为修改后的列宽和数据源的列宽不匹配而报错，可以先将数据源置为空后再修改列宽。 +4. RENAME COLUMN：修改列名称。 +5. ALTER COLUMN .. SET：修改列的数据源。 SET NULL 表示将虚拟表某列的数据源置为空。 + +### 增加列 + +```sql +ALTER VTABLE vtb_name ADD COLUMN vtb_col_name vtb_col_type [FROM [db_name].table_name.col_name] +``` + +### 删除列 + +```sql +ALTER VTABLE vtb_name DROP COLUMN vtb_col_name +``` + +### 修改列宽 + +```sql +ALTER VTABLE vtb_name MODIFY COLUMN vtb_col_name data_type(length); +``` + +### 修改列名 + +```sql +ALTER VTABLE vtb_name RENAME COLUMN old_col_name new_col_name +``` + +### 修改列的数据源 + +```sql +ALTER VTABLE vtb_name ALTER COLUMN vtb_col_name SET {[db_name.]table_name.col_name | NULL} +``` + +## 修改虚拟子表 + +```sql +ALTER VTABLE [db_name.]vtb_name alter_table_clause + +alter_table_clause: { + ALTER COLUMN vtb_col_name SET table_name.col_name + | SET TAG tag_name = new_tag_value +} +``` + +**使用说明** + +1. 对虚拟子表的列和标签的修改，除了更改标签值以外，都要通过虚拟超级表才能进行。 + +### 修改虚拟子表标签值 + +```sql +ALTER VTABLE tb_name SET TAG tag_name1=new_tag_value1, tag_name2=new_tag_value2 ...; +``` + +### 修改列的数据源 + +```sql +ALTER VTABLE vtb_name ALTER COLUMN vtb_col_name SET {[db_name.]table_name.col_name | NULL} +``` + +## 删除虚拟表 + +```sql +DROP VTABLE [IF EXISTS] [dbname].vtb_name; +``` + +## 查看虚拟表的信息 + +### 显示某个数据库下所有虚拟表 + +如下 SQL 语句可以列出当前数据库中的所有虚拟表名。 + +```sql +SHOW [NORMAL | CHILD] [db_name.]VTABLES [LIKE 'pattern']; +``` + +**使用说明** + +1. 如果没有指定 db_name, 显示当前数据库下的所有虚拟普通表和虚拟子表的信息。若没有使用数据库并且没有指定 db_name, 则会报错 database not specified。可以使用 LIKE 对表名进行模糊匹配。NORMAL 指定只显示虚拟普通表信息， CHILD 指定只显示虚拟子表信息。 + +### 显示虚拟表创建语句 + +```sql +SHOW CREATE VTABLE [db_name.]vtable_name; +``` + +显示 vtable_name 指定的虚拟表的创建语句。支持虚拟普通表和虚拟子表。常用于数据库迁移。对一个已经存在的虚拟表，返回其创建语句；在另一个集群中执行该语句，就能得到一个结构完全相同的虚拟表。 + +### 获取虚拟表结构信息 + +```sql +DESCRIBE [db_name.]vtb_name; +``` + +### 查看所有虚拟表信息 + +```sql +SELECT ... FROM information_schema.ins_tables where type = 'VIRTUAL_NORMAL_TABLE' or type = 'VIRTUAL_CHILD_TABLE'; +``` + +## 写入虚拟表 + +不支持向虚拟表中写入数据，以及不支持删除虚拟表中的数据。虚拟表只是对原始表进行运算后的计算结果，是一张逻辑表，因此只能对其进行查询，不可以写入或删除数据。 + + +## 虚拟表与视图 + +虚拟表与视图看起来相似，但是有很多不同点： + +| 属性 |虚拟表 (Virtual Table) |视图 (View)| +|----------------|------------------------|-----------| +| 定义 |虚拟表是一种动态数据结构，根据多表的列和时间戳组合规则生成逻辑表。 |视图是一种基于 SQL 查询的虚拟化表结构，用于保存查询逻辑的定义。| +| 数据来源 |来自多个原始表，可以动态选择列，并通过时间戳对齐数据。 |来自单个或多个表的查询结果，通常是一个复杂的 SQL 查询。| +| 数据存储 |不实际存储数据，所有数据在查询时动态生成。 |不实际存储数据，仅保存 SQL 查询逻辑。| +| 时间戳处理 |通过时间戳对齐将不同表的列整合到统一的时间轴上。| 不支持时间戳对齐，数据由查询逻辑直接决定。| +| 更新机制 |动态更新，原始表数据变更时，虚拟表数据实时反映变化。| 动态更新，但依赖于视图定义的查询逻辑，不涉及对齐或数据整合。| +| 功能特性 |支持空值填充和插值（如 prev、next、linear）。 |不支持内置填充和插值功能，需通过查询逻辑自行实现。| +| 应用场景 |时间序列对齐、跨表数据整合、多源数据对比分析等场景。| 简化复杂查询逻辑、限制用户访问、封装业务逻辑等场景。| +| 性能 |由于多表对齐和空值处理，查询复杂度可能较高，尤其在数据量大时。| 性能通常取决于视图的查询语句复杂度，与单表查询性能相似。| + +不支持虚拟表和视图之间的相互转化，如根据虚拟表建立视图或者根据视图建立虚拟表。 + +## 虚拟表的权限 + +### 权限说明 + +虚拟表的权限分为 READ、WRITE 两种，查询操作需要具备 READ 权限，对虚拟表本身的删除和修改操作需要具备 WRITE 权限。 + +### 语法 + +#### 授权 + +```sql +GRANT privileges ON [db_name.]vtable_name TO user_name +privileges: { + ALL, + | priv_type [, priv_type] ... +} +priv_type: { + READ + | WRITE +} +``` + +#### 回收权限 + +```sql +REVOKE privileges ON [db_name.]vtable_name FROM user_name +privileges: { + ALL, + | priv_type [, priv_type] ... +} +priv_type: { + READ + | WRITE +} +``` + +### 权限规则 + +1. 虚拟表的创建者和 root 用户默认具备所有权限。 +2. 用户可以通过 dbname.vtbname 来为指定的虚拟表表（包括虚拟超级表和虚拟普通表）授予或回收其读写权限，不支持直接对虚拟子表授予或回收权限。 +3. 虚拟子表和虚拟超级表不支持基于标签的授权（表级授权），虚拟子表继承虚拟超级表的权限。 +4. 对其他用户进行授权与回收权限可以通过 GRANT 和 REVOKE 语句进行，该操作只能由 root 用户进行。 +5. 具体相关权限控制细则总结如下： + +| 序号 | 操作 | 权限要求 | +|------|------|----------------------------------------------------------| +| 1 | CREATE VTABLE | 用户对虚拟表所属数据库有 WRITE 权限 且
用户对虚拟表的数据源对应的原始表有 READ 权限。 | +| 2 | DROP/ALTER VTABLE | 用户对虚拟表有 WRITE 权限，若要指定某一列的数据源，需要同时对数据源对应的原始表有 READ 权限。 | +| 3 |SHOW VTABLES | 无 | +| 4 | SHOW CREATE VTABLE | 无 | +| 5 | DESCRIBE VTABLE | 无 | +| 6 | 系统表查询 | 无 | +| 7 | SELECT FROM VTABLE | 操作用户对虚拟表有 READ 权限 | +| 8 | GRANT/REVOKE | 只有 root 用户有权限 | + +## 使用场景 + +| SQL 查询 | SQL 写入 | STMT 查询 | STMT 写入 | 订阅 | 流计算 | +|---------|--------|---------|------|--------|---| +| 支持 | 不支持 | 不支持 | 不支持 | 不支持 | 支持 | \ No newline at end of file diff --git a/docs/zh/14-reference/03-taos-sql/pic/virtual-table-origin-table.png b/docs/zh/14-reference/03-taos-sql/pic/virtual-table-origin-table.png new file mode 100644 index 0000000000000000000000000000000000000000..4819389b22550ed58308fdc5f42c54f27772ef39 GIT binary patch literal 7998 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 literal 0 HcmV?d00001 diff --git a/docs/zh/14-reference/03-taos-sql/pic/virtual-table-query-res-part.png b/docs/zh/14-reference/03-taos-sql/pic/virtual-table-query-res-part.png new file mode 100644 index 0000000000000000000000000000000000000000..5afbdac55e068f93a983b5bf3fec60ee69386fb7 GIT binary patch literal 3194 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 Qeq!8(mKPRVL7?XKFY3rBA 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 Uh{1=zKi>%8vZ^x0(xw6b1!APL00000 literal 0 HcmV?d00001 From c625106609361e172aa2bab1d2271f2ac07367ce Mon Sep 17 00:00:00 2001 From: Mario Peng <48949600+Pengrongkun@users.noreply.github.com> Date: Sat, 22 Mar 2025 21:14:08 +0800 Subject: [PATCH 19/26] fix(stmt2):stmt2 get fields return wrong when tag is value (#30283) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * ci: add 3.3.6 branch * fix: delete taos-tools repo in Jenkinsfile2 * ci:add 3.3.6 branch to taosd-ci.yml * fix: [TD-34074] compile error (#30220) * fix: add case * fix: stmt2 get fields return wrong when tag is value * enh: replace preCtb bool to flag,handle more situation * fix: some unit test error * diff: add case and fix some problem * fix: remove async test, handle in TD-34077 * fix: [TD-34074] Forbid virtual table in tq and stmt and forbid supertable query's origin table from different databases. fix: [TD-34074] Forbid virtual table in tq and stmt and forbid supertable query's origin table from different databases. * fix(sml): process space in the end if writing raw data in sml & change some log level #30306 fix(sml): process space in the end if writing raw data in sml & change some log level * fix: taosadapter version 3.3.6 (#30324) * docs(stream): document streaming computation support for virtual tables in user manual (#30319) * docs(stream): document streaming computation support for virtual tables in user manual - Added section to user manual describing streaming computation support for virtual tables - Listed known limitations and behavior when using virtual tables in streaming mode * Update 14-stream.md --------- Co-authored-by: Pan Wei <72057773+dapan1121@users.noreply.github.com> * fix: review * ci: add tdgpt .c file into TDengine and TDgpt workflow * ci: add tdgpt .c file into TDengine and TDgpt workflow --------- Signed-off-by: WANG Xu Co-authored-by: WANG Xu Co-authored-by: haoranchen Co-authored-by: Simon Guan Co-authored-by: Feng Chao Co-authored-by: facetosea <285808407@qq.com> Co-authored-by: Jing Sima Co-authored-by: Jinqing Kuang Co-authored-by: dapan1121 Co-authored-by: Pan Wei <72057773+dapan1121@users.noreply.github.com> Co-authored-by: Haojun Liao Co-authored-by: huohong <346479823@qq.com> Co-authored-by: Minglei Jin Co-authored-by: freemine Co-authored-by: Yihao Deng Co-authored-by: 54liuyao <54liuyao@163.com> Co-authored-by: Bomin Zhang Co-authored-by: 蟑螂·魂 Co-authored-by: wangjiaming Co-authored-by: Haojun Liao Co-authored-by: dongming chen Co-authored-by: Zhiyu Yang <69311263+zyyang90@users.noreply.github.com> Co-authored-by: Nie Minhui <143420805+minhuinie@users.noreply.github.com> Co-authored-by: Zhixiao Bao <62235797+xiao-77@users.noreply.github.com> Co-authored-by: Kaili Xu Co-authored-by: Linhe Huo Co-authored-by: tjuzyp Co-authored-by: yanyuxing Co-authored-by: WANG MINGMING Co-authored-by: yihaoDeng Co-authored-by: facetosea <25808407@qq.com> Co-authored-by: Minglei Jin <49711132+stephenkgu@users.noreply.github.com> Co-authored-by: She Yanjie <57549981+sheyanjie-qq@users.noreply.github.com> Co-authored-by: jiajingbin <39030567+jiajingbin@users.noreply.github.com> Co-authored-by: Alex Duan <51781608+DuanKuanJun@users.noreply.github.com> Co-authored-by: kevin men Co-authored-by: Hongze Cheng Co-authored-by: Yaming Pei Co-authored-by: Xuefeng Tan <1172915550@qq.com> --- .github/workflows/tdengine-test.yml | 1 + cmake/taosadapter_CMakeLists.txt.in | 2 +- docs/en/14-reference/03-taos-sql/14-stream.md | 18 ++++ docs/zh/14-reference/03-taos-sql/14-stream.md | 18 ++++ include/libs/parser/parser.h | 10 +- source/client/inc/clientStmt.h | 2 +- source/client/src/clientSmlTelnet.c | 2 +- source/client/src/clientStmt.c | 12 ++- source/client/src/clientStmt2.c | 19 ++-- source/client/test/stmt2Test.cpp | 99 ++++++++++++++----- source/libs/parser/src/parInsertSql.c | 70 ++++++++----- source/libs/parser/src/parInsertStmt.c | 13 +-- source/util/src/tmempool.c | 2 +- source/util/test/memPoolTest.cpp | 2 +- utils/test/c/sml_test.c | 28 +++++- 15 files changed, 222 insertions(+), 76 deletions(-) diff --git a/.github/workflows/tdengine-test.yml b/.github/workflows/tdengine-test.yml index b981d005c4..e5e2cdbfaf 100644 --- a/.github/workflows/tdengine-test.yml +++ b/.github/workflows/tdengine-test.yml @@ -6,6 +6,7 @@ on: - 'main' - '3.0' - '3.1' + - '3.3.6' paths-ignore: - 'packaging/**' - 'docs/**' diff --git a/cmake/taosadapter_CMakeLists.txt.in b/cmake/taosadapter_CMakeLists.txt.in index ef6ed4af1d..a768b332a6 100644 --- a/cmake/taosadapter_CMakeLists.txt.in +++ b/cmake/taosadapter_CMakeLists.txt.in @@ -2,7 +2,7 @@ # taosadapter ExternalProject_Add(taosadapter GIT_REPOSITORY https://github.com/taosdata/taosadapter.git - GIT_TAG 3.0 + GIT_TAG 3.3.6 SOURCE_DIR "${TD_SOURCE_DIR}/tools/taosadapter" BINARY_DIR "" #BUILD_IN_SOURCE TRUE diff --git a/docs/en/14-reference/03-taos-sql/14-stream.md b/docs/en/14-reference/03-taos-sql/14-stream.md index 00e29b0e3d..f8ad80d2a3 100644 --- a/docs/en/14-reference/03-taos-sql/14-stream.md +++ b/docs/en/14-reference/03-taos-sql/14-stream.md @@ -532,6 +532,24 @@ These fields are present only when "windowType" is "Count". #### Fields for Window Invalidation Due to scenarios such as data disorder, updates, or deletions during stream computing, windows that have already been generated might be removed or their results need to be recalculated. In such cases, a notification with the eventType "WINDOW_INVALIDATION" is sent to inform which windows have been invalidated. + For events with "eventType" as "WINDOW_INVALIDATION", the following fields are included: 1. "windowStart": A long integer timestamp representing the start time of the window. 1. "windowEnd": A long integer timestamp representing the end time of the window. + +## Support for Virtual Tables in Stream Computing + +Starting with v3.3.6.0, stream computing can use virtual tables—including virtual regular tables, virtual sub-tables, and virtual super tables—as data sources for computation. The syntax is identical to that for non‑virtual tables. + +However, because the behavior of virtual tables differs from that of non‑virtual tables, the following restrictions apply when using stream computing: + +1. The schema of virtual regular tables/virtual sub-tables involved in stream computing cannot be modified. +1. During stream computing, if the data source corresponding to a column in a virtual table is changed, the stream computation will not pick up the change; it will still read from the old data source. +1. During stream computing, if the original table corresponding to a column in a virtual table is deleted and later a new table with the same name and a column with the same name is created, the stream computation will not read data from the new table. +1. The watermark for stream computing must be 0; otherwise, an error will occur during creation. +1. If the data source for stream computing is a virtual super table, sub-tables that are added after the stream computing task starts will not participate in the computation. +1. The timestamps of different underlying tables in a virtual table may not be completely consistent; merging the data might produce null values, and interpolation is currently not supported. +1. Out-of-order data, updates, or deletions are not handled. In other words, when creating a stream, you cannot specify `ignore update 0` or `ignore expired 0`; otherwise, an error will be reported. +1. Historical data computation is not supported. That is, when creating a stream, you cannot specify `fill_history 1`; otherwise, an error will be reported. +1. The trigger modes MAX_DELAY, CONTINUOUS_WINDOW_CLOSE and FORCE_WINDOW_CLOSE are not supported. +1. The COUNT_WINDOW type is not supported. 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 b4c4a76922..a9225a3ab4 100644 --- a/docs/zh/14-reference/03-taos-sql/14-stream.md +++ b/docs/zh/14-reference/03-taos-sql/14-stream.md @@ -527,6 +527,24 @@ CREATE STREAM avg_current_stream FILL_HISTORY 1 #### 窗口失效相关字段 因为流计算过程中会遇到数据乱序、更新、删除等情况，可能造成已生成的窗口被删除，或者结果需要重新计算。此时会向通知地址发送一条 WINDOW_INVALIDATION 的通知，说明哪些窗口已经被删除。 + 这部分是 eventType 为 WINDOW_INVALIDATION 时，event 对象才有的字段。 1. windowStart：长整型时间戳，表示窗口的开始时间，精度与结果表的时间精度一致。 1. windowEnd: 长整型时间戳，表示窗口的结束时间，精度与结果表的时间精度一致。 + +## 流式计算对虚拟表的支持 + +从 v3.3.6.0 开始，流计算能够使用虚拟表（包括虚拟普通表、虚拟子表、虚拟超级表）作为数据源进行计算，语法和非虚拟表完全一致。 + +但是虚拟表的行为与非虚拟表存在差异，所以目前在使用流计算对虚拟表进行计算时存在以下限制： + +1. 流计算中涉及的虚拟普通表/虚拟子表的 schema 不允许更改。 +1. 流计算过程中，如果修改虚拟表某一列对应的数据源，对流计算来说不生效。即：流计算仍只读取老的数据源。 +1. 流计算过程中，如果虚拟表某一列对应的原始表被删除，之后新建了同名的表和同名的列，流计算不会读取新表的数据。 +1. 流计算的 watermark 只能是 0，否则创建时就报错。 +1. 如果流计算的数据源是虚拟超级表，流计算任务启动后新增的子表不参与计算。 +1. 虚拟表的不同原始表的时间戳不完全一致，数据合并后可能会产生空值，暂不支持插值处理。 +1. 不处理数据的乱序、更新或删除。即：流创建时不能指定 `ignore update 0` 或者 `ignore expired 0`，否则报错。 +1. 不支持历史数据计算，即：流创建时不能指定 `fill_history 1`，否则报错。 +1. 不支持触发模式：MAX_DELAY, FORCE_WINDOW_CLOSE, CONTINUOUS_WINDOW_CLOSE。 +1. 不支持窗口类型：COUNT_WINDOW。 diff --git a/include/libs/parser/parser.h b/include/libs/parser/parser.h index 7ce4684f07..4fd6fef81a 100644 --- a/include/libs/parser/parser.h +++ b/include/libs/parser/parser.h @@ -49,10 +49,16 @@ extern "C" { } \ } while (0) +#define HAS_BIND_VALUE ((uint8_t)0x1) +#define IS_FIXED_VALUE ((uint8_t)0x2) +#define USING_CLAUSE ((uint8_t)0x4) +#define IS_FIXED_TAG ((uint8_t)0x8) +#define NO_DATA_USING_CLAUSE ((uint8_t)0x7) + typedef struct SStmtCallback { TAOS_STMT* pStmt; int32_t (*getTbNameFn)(TAOS_STMT*, char**); - int32_t (*setInfoFn)(TAOS_STMT*, STableMeta*, void*, SName*, bool, SHashObj*, SHashObj*, const char*, bool); + int32_t (*setInfoFn)(TAOS_STMT*, STableMeta*, void*, SName*, bool, SHashObj*, SHashObj*, const char*, uint8_t); int32_t (*getExecInfoFn)(TAOS_STMT*, SHashObj**, SHashObj**); } SStmtCallback; @@ -175,7 +181,7 @@ int32_t qBindStmtColsValue(void* pBlock, SArray* pCols, TAOS_MULTI_BIND* bind, c int32_t qBindStmtSingleColValue(void* pBlock, SArray* pCols, TAOS_MULTI_BIND* bind, char* msgBuf, int32_t msgBufLen, int32_t colIdx, int32_t rowNum, void* charsetCxt); int32_t qBuildStmtColFields(void* pDataBlock, int32_t* fieldNum, TAOS_FIELD_E** fields); -int32_t qBuildStmtStbColFields(void* pBlock, void* boundTags, bool hasCtbName, int32_t* fieldNum, +int32_t qBuildStmtStbColFields(void* pBlock, void* boundTags, uint8_t tbNameFlag, int32_t* fieldNum, TAOS_FIELD_ALL** fields); int32_t qBuildStmtTagFields(void* pBlock, void* boundTags, int32_t* fieldNum, TAOS_FIELD_E** fields); int32_t qBindStmtTagsValue(void* pBlock, void* boundTags, int64_t suid, const char* sTableName, char* tName, diff --git a/source/client/inc/clientStmt.h b/source/client/inc/clientStmt.h index 74260c42e0..5d61e8b5d0 100644 --- a/source/client/inc/clientStmt.h +++ b/source/client/inc/clientStmt.h @@ -64,7 +64,7 @@ typedef struct SStmtBindInfo { int32_t sBindLastIdx; int8_t tbType; bool tagsCached; - bool preCtbname; + uint8_t tbNameFlag; void *boundTags; char tbName[TSDB_TABLE_FNAME_LEN]; char tbFName[TSDB_TABLE_FNAME_LEN]; diff --git a/source/client/src/clientSmlTelnet.c b/source/client/src/clientSmlTelnet.c index dd264da11e..0427196b83 100644 --- a/source/client/src/clientSmlTelnet.c +++ b/source/client/src/clientSmlTelnet.c @@ -75,7 +75,7 @@ static int32_t smlProcessTagTelnet(SSmlHandle *info, char *data, char *sqlEnd){ const char *sql = data; while (sql < sqlEnd) { JUMP_SPACE(sql, sqlEnd) - if (unlikely(*sql == '\0')) break; + if (unlikely(*sql == '\0' || *sql == '\n')) break; const char *key = sql; size_t keyLen = 0; diff --git a/source/client/src/clientStmt.c b/source/client/src/clientStmt.c index 2d9001d248..4cef20056b 100644 --- a/source/client/src/clientStmt.c +++ b/source/client/src/clientStmt.c @@ -238,7 +238,7 @@ int32_t stmtRestoreQueryFields(STscStmt* pStmt) { } */ int32_t stmtUpdateBindInfo(TAOS_STMT* stmt, STableMeta* pTableMeta, void* tags, SName* tbName, const char* sTableName, - bool autoCreateTbl) { + bool autoCreateTbl, uint8_t tbNameFlag) { STscStmt* pStmt = (STscStmt*)stmt; char tbFName[TSDB_TABLE_FNAME_LEN]; int32_t code = tNameExtractFullName(tbName, tbFName); @@ -256,6 +256,7 @@ int32_t stmtUpdateBindInfo(TAOS_STMT* stmt, STableMeta* pTableMeta, void* tags, pStmt->bInfo.tbType = pTableMeta->tableType; pStmt->bInfo.boundTags = tags; pStmt->bInfo.tagsCached = false; + pStmt->bInfo.tbNameFlag = tbNameFlag; tstrncpy(pStmt->bInfo.stbFName, sTableName, sizeof(pStmt->bInfo.stbFName)); return TSDB_CODE_SUCCESS; @@ -271,10 +272,10 @@ int32_t stmtUpdateExecInfo(TAOS_STMT* stmt, SHashObj* pVgHash, SHashObj* pBlockH } int32_t stmtUpdateInfo(TAOS_STMT* stmt, STableMeta* pTableMeta, void* tags, SName* tbName, bool autoCreateTbl, - SHashObj* pVgHash, SHashObj* pBlockHash, const char* sTableName, bool preCtbname) { + SHashObj* pVgHash, SHashObj* pBlockHash, const char* sTableName, uint8_t tbNameFlag) { STscStmt* pStmt = (STscStmt*)stmt; - STMT_ERR_RET(stmtUpdateBindInfo(stmt, pTableMeta, tags, tbName, sTableName, autoCreateTbl)); + STMT_ERR_RET(stmtUpdateBindInfo(stmt, pTableMeta, tags, tbName, sTableName, autoCreateTbl, tbNameFlag)); STMT_ERR_RET(stmtUpdateExecInfo(stmt, pVgHash, pBlockHash)); pStmt->sql.autoCreateTbl = autoCreateTbl; @@ -1729,7 +1730,10 @@ int stmtGetTagFields(TAOS_STMT* stmt, int* nums, TAOS_FIELD_E** fields) { STMT_ERRI_JRET(stmtFetchTagFields(stmt, nums, fields)); _return: - + // compatible with previous versions + if (code == TSDB_CODE_PAR_TABLE_NOT_EXIST && (pStmt->bInfo.tbNameFlag & NO_DATA_USING_CLAUSE) == 0x0) { + code = TSDB_CODE_TSC_STMT_TBNAME_ERROR; + } pStmt->errCode = preCode; return code; diff --git a/source/client/src/clientStmt2.c b/source/client/src/clientStmt2.c index cfd302d895..c4f8702f43 100644 --- a/source/client/src/clientStmt2.c +++ b/source/client/src/clientStmt2.c @@ -193,7 +193,7 @@ static int32_t stmtGetTbName(TAOS_STMT2* stmt, char** tbName) { } static int32_t stmtUpdateBindInfo(TAOS_STMT2* stmt, STableMeta* pTableMeta, void* tags, SName* tbName, - const char* sTableName, bool autoCreateTbl, bool preCtbname) { + const char* sTableName, bool autoCreateTbl, int8_t tbNameFlag) { STscStmt2* pStmt = (STscStmt2*)stmt; char tbFName[TSDB_TABLE_FNAME_LEN]; int32_t code = tNameExtractFullName(tbName, tbFName); @@ -217,7 +217,7 @@ static int32_t stmtUpdateBindInfo(TAOS_STMT2* stmt, STableMeta* pTableMeta, void pStmt->bInfo.boundTags = tags; pStmt->bInfo.tagsCached = false; - pStmt->bInfo.preCtbname = preCtbname; + pStmt->bInfo.tbNameFlag = tbNameFlag; tstrncpy(pStmt->bInfo.stbFName, sTableName, sizeof(pStmt->bInfo.stbFName)); return TSDB_CODE_SUCCESS; @@ -233,10 +233,10 @@ static int32_t stmtUpdateExecInfo(TAOS_STMT2* stmt, SHashObj* pVgHash, SHashObj* } static int32_t stmtUpdateInfo(TAOS_STMT2* stmt, STableMeta* pTableMeta, void* tags, SName* tbName, bool autoCreateTbl, - SHashObj* pVgHash, SHashObj* pBlockHash, const char* sTableName, bool preCtbname) { + SHashObj* pVgHash, SHashObj* pBlockHash, const char* sTableName, uint8_t tbNameFlag) { STscStmt2* pStmt = (STscStmt2*)stmt; - STMT_ERR_RET(stmtUpdateBindInfo(stmt, pTableMeta, tags, tbName, sTableName, autoCreateTbl, preCtbname)); + STMT_ERR_RET(stmtUpdateBindInfo(stmt, pTableMeta, tags, tbName, sTableName, autoCreateTbl, tbNameFlag)); STMT_ERR_RET(stmtUpdateExecInfo(stmt, pVgHash, pBlockHash)); pStmt->sql.autoCreateTbl = autoCreateTbl; @@ -1233,7 +1233,8 @@ static int stmtFetchStbColFields2(STscStmt2* pStmt, int32_t* fieldNum, TAOS_FIEL } STMT_ERRI_JRET( - qBuildStmtStbColFields(*pDataBlock, pStmt->bInfo.boundTags, pStmt->bInfo.preCtbname, fieldNum, fields)); + qBuildStmtStbColFields(*pDataBlock, pStmt->bInfo.boundTags, pStmt->bInfo.tbNameFlag, fieldNum, fields)); + if (pStmt->bInfo.tbType == TSDB_SUPER_TABLE && cleanStb) { pStmt->bInfo.needParse = true; qDestroyStmtDataBlock(*pDataBlock); @@ -2022,7 +2023,9 @@ int stmtParseColFields2(TAOS_STMT2* stmt) { STMT_TYPE_MULTI_INSERT != pStmt->sql.type) { pStmt->bInfo.needParse = false; } - + if (pStmt->sql.stbInterlaceMode && pStmt->sql.siInfo.pDataCtx != NULL) { + pStmt->bInfo.needParse = false; + } if (pStmt->exec.pRequest && STMT_TYPE_QUERY == pStmt->sql.type && pStmt->sql.runTimes) { taos_free_result(pStmt->exec.pRequest); pStmt->exec.pRequest = NULL; @@ -2036,6 +2039,10 @@ int stmtParseColFields2(TAOS_STMT2* stmt) { } _return: + // compatible with previous versions + if (code == TSDB_CODE_PAR_TABLE_NOT_EXIST && (pStmt->bInfo.tbNameFlag & NO_DATA_USING_CLAUSE) == 0x0) { + code = TSDB_CODE_TSC_STMT_TBNAME_ERROR; + } pStmt->errCode = preCode; diff --git a/source/client/test/stmt2Test.cpp b/source/client/test/stmt2Test.cpp index cc54cd55d3..5e50760648 100644 --- a/source/client/test/stmt2Test.cpp +++ b/source/client/test/stmt2Test.cpp @@ -534,7 +534,7 @@ TEST(stmt2Case, insert_ctb_using_get_fields_Test) { printf("support case \n"); // case 1 : test child table already exist { - const char* sql = "INSERT INTO stmt2_testdb_3.t0(ts,b)using stmt2_testdb_3.stb (t1,t2) TAGS(?,?) VALUES (?,?)"; + const char* sql = "INSERT INTO stmt2_testdb_3.t0(ts,b)using stmt2_testdb_3.stb (t1,t2) TAGS(?,?) VALUES(?,?)"; TAOS_FIELD_ALL expectedFields[4] = {{"t1", TSDB_DATA_TYPE_INT, 0, 0, 4, TAOS_FIELD_TAG}, {"t2", TSDB_DATA_TYPE_BINARY, 0, 0, 12, TAOS_FIELD_TAG}, {"ts", TSDB_DATA_TYPE_TIMESTAMP, 2, 0, 8, TAOS_FIELD_COL}, @@ -612,7 +612,7 @@ TEST(stmt2Case, insert_ctb_using_get_fields_Test) { // case 8 : 'db' 'stb' { - const char* sql = "INSERT INTO 'stmt2_testdb_3'.? using 'stmt2_testdb_3'.'stb' (t1,t2) TAGS(?,?) (ts,b)VALUES(?,?)"; + const char* sql = "INSERT INTO 'stmt2_testdb_3'.? using 'stmt2_testdb_3'.'stb' (t1,t2) TAGS(?,?)(ts,b)VALUES(?,?)"; TAOS_FIELD_ALL expectedFields[5] = {{"tbname", TSDB_DATA_TYPE_BINARY, 0, 0, 271, TAOS_FIELD_TBNAME}, {"t1", TSDB_DATA_TYPE_INT, 0, 0, 4, TAOS_FIELD_TAG}, {"t2", TSDB_DATA_TYPE_BINARY, 0, 0, 12, TAOS_FIELD_TAG}, @@ -634,9 +634,20 @@ TEST(stmt2Case, insert_ctb_using_get_fields_Test) { printf("case 9 : %s\n", sql); getFieldsSuccess(taos, sql, expectedFields, 5); } + // case 11: TD-34097 + { + do_query(taos, "use stmt2_testdb_3"); + const char* sql = "INSERT INTO ? using stb (t1,t2) TAGS(1,'abc') (ts,b)VALUES(?,?)"; + TAOS_FIELD_ALL expectedFields[3] = {{"tbname", TSDB_DATA_TYPE_BINARY, 0, 0, 271, TAOS_FIELD_TBNAME}, + {"ts", TSDB_DATA_TYPE_TIMESTAMP, 2, 0, 8, TAOS_FIELD_COL}, + {"b", TSDB_DATA_TYPE_BINARY, 0, 0, 12, TAOS_FIELD_COL}}; + printf("case 11 : %s\n", sql); + getFieldsSuccess(taos, sql, expectedFields, 3); + } // case 10 : test all types { + do_query(taos, "use stmt2_testdb_3"); const char* sql = "insert into ? using all_stb tags(?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?) values(?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)"; TAOS_FIELD_ALL expectedFields[33] = {{"tbname", TSDB_DATA_TYPE_BINARY, 0, 0, 271, TAOS_FIELD_TBNAME}, @@ -711,7 +722,27 @@ TEST(stmt2Case, insert_ctb_using_get_fields_Test) { printf("case 5 : %s\n", sql); getFieldsError(taos, sql, TSDB_CODE_TSC_SQL_SYNTAX_ERROR); } - + // case 6 : mix value and ? + { + do_query(taos, "use stmt2_testdb_3"); + const char* sql = "INSERT INTO ? using stb (t1,t2) TAGS(1,?) (ts,b)VALUES(?,?)"; + printf("case 6 : %s\n", sql); + getFieldsError(taos, sql, TSDB_CODE_TSC_SQL_SYNTAX_ERROR); + } + // case 7 : mix value and ? + { + do_query(taos, "use stmt2_testdb_3"); + const char* sql = "INSERT INTO ? using stb (t1,t2) TAGS(?,?) (ts,b)VALUES(15910606280001,?)"; + printf("case 7 : %s\n", sql); + getFieldsError(taos, sql, TSDB_CODE_TSC_INVALID_OPERATION); + } + // case 8 : mix value and ? + { + do_query(taos, "use stmt2_testdb_3"); + const char* sql = "INSERT INTO ? using stb (t1,t2) TAGS(?,?) (ts,b)VALUES(15910606280001,'abc')"; + printf("case 8 : %s\n", sql); + getFieldsError(taos, sql, TSDB_CODE_TSC_INVALID_OPERATION); + } do_query(taos, "drop database if exists stmt2_testdb_3"); taos_close(taos); } @@ -1002,6 +1033,15 @@ TEST(stmt2Case, stmt2_insert_non_statndard) { printf("stmt2 [%s] : %s\n", "less params", sql); int code = taos_stmt2_prepare(stmt, sql, 0); checkError(stmt, code); + // test get fields + int fieldNum = 0; + TAOS_FIELD_ALL* pFields = NULL; + code = taos_stmt2_get_fields(stmt, &fieldNum, &pFields); + checkError(stmt, code); + ASSERT_EQ(fieldNum, 2); + ASSERT_STREQ(pFields[0].name, "tbname"); + ASSERT_STREQ(pFields[1].name, "ts"); + int total_affect_rows = 0; int t64_len[2] = {sizeof(int64_t), sizeof(int64_t)}; @@ -1024,11 +1064,22 @@ TEST(stmt2Case, stmt2_insert_non_statndard) { code = taos_stmt2_bind_param(stmt, &bindv, -1); checkError(stmt, code); + code = taos_stmt2_get_fields(stmt, &fieldNum, &pFields); + checkError(stmt, code); + ASSERT_EQ(fieldNum, 2); + ASSERT_STREQ(pFields[0].name, "tbname"); + ASSERT_STREQ(pFields[1].name, "ts"); + int affected_rows; taos_stmt2_exec(stmt, &affected_rows); total_affect_rows += affected_rows; - checkError(stmt, code); + + code = taos_stmt2_get_fields(stmt, &fieldNum, &pFields); + checkError(stmt, code); + ASSERT_EQ(fieldNum, 2); + ASSERT_STREQ(pFields[0].name, "tbname"); + ASSERT_STREQ(pFields[1].name, "ts"); } ASSERT_EQ(total_affect_rows, 12); @@ -1959,27 +2010,27 @@ void stmt2_async_test(std::atomic& stop_task) { stop_task = true; } -TEST(stmt2Case, async_order) { - std::atomic stop_task(false); - std::thread t(stmt2_async_test, std::ref(stop_task)); +// TEST(stmt2Case, async_order) { +// std::atomic stop_task(false); +// std::thread t(stmt2_async_test, std::ref(stop_task)); - // 等待 60 秒钟 - auto start_time = std::chrono::steady_clock::now(); - while (!stop_task) { - auto elapsed_time = std::chrono::steady_clock::now() - start_time; - if (std::chrono::duration_cast(elapsed_time).count() > 100) { - if (t.joinable()) { - t.detach(); - } - FAIL() << "Test[stmt2_async_test] timed out"; - break; - } - std::this_thread::sleep_for(std::chrono::seconds(1)); // 每 1s 检查一次 - } - if (t.joinable()) { - t.join(); - } -} +// // 等待 60 秒钟 +// auto start_time = std::chrono::steady_clock::now(); +// while (!stop_task) { +// auto elapsed_time = std::chrono::steady_clock::now() - start_time; +// if (std::chrono::duration_cast(elapsed_time).count() > 100) { +// if (t.joinable()) { +// t.detach(); +// } +// FAIL() << "Test[stmt2_async_test] timed out"; +// break; +// } +// std::this_thread::sleep_for(std::chrono::seconds(1)); // 每 1s 检查一次 +// } +// if (t.joinable()) { +// t.join(); +// } +// } TEST(stmt2Case, rowformat_bind) { TAOS* taos = taos_connect("localhost", "root", "taosdata", "", 0); diff --git a/source/libs/parser/src/parInsertSql.c b/source/libs/parser/src/parInsertSql.c index 81129a6f8f..25e8ccc1c6 100644 --- a/source/libs/parser/src/parInsertSql.c +++ b/source/libs/parser/src/parInsertSql.c @@ -32,7 +32,7 @@ typedef struct SInsertParseContext { bool needTableTagVal; bool needRequest; // whether or not request server bool isStmtBind; // whether is stmt bind - bool preCtbname; + uint8_t stmtTbNameFlag; } SInsertParseContext; typedef int32_t (*_row_append_fn_t)(SMsgBuf* pMsgBuf, const void* value, int32_t len, void* param); @@ -993,6 +993,10 @@ static int32_t parseTagsClauseImpl(SInsertParseContext* pCxt, SVnodeModifyOpStmt code = buildSyntaxErrMsg(&pCxt->msg, "? only used in stmt", token.z); break; } + if (pTagVals->size != 0) { + code = buildSyntaxErrMsg(&pCxt->msg, "no mix usage for ? and tag values", token.z); + break; + } continue; } @@ -1026,6 +1030,10 @@ static int32_t parseTagsClauseImpl(SInsertParseContext* pCxt, SVnodeModifyOpStmt pTag = NULL; } + if (code == TSDB_CODE_SUCCESS && !isParseBindParam) { + pCxt->stmtTbNameFlag |= IS_FIXED_TAG; + } + _exit: for (int32_t i = 0; i < taosArrayGetSize(pTagVals); ++i) { STagVal* p = (STagVal*)TARRAY_GET_ELEM(pTagVals, i); @@ -1416,6 +1424,7 @@ static int32_t parseUsingTableName(SInsertParseContext* pCxt, SVnodeModifyOpStmt return getTargetTableSchema(pCxt, pStmt); } pStmt->usingTableProcessing = true; + pCxt->stmtTbNameFlag |= USING_CLAUSE; // pStmt->pSql -> stb_name [(tag1_name, ...) pStmt->pSql += index; int32_t code = parseDuplicateUsingClause(pCxt, pStmt, &pCxt->usingDuplicateTable); @@ -1465,7 +1474,7 @@ static int32_t getTableDataCxt(SInsertParseContext* pCxt, SVnodeModifyOpStmt* pS char tbFName[TSDB_TABLE_FNAME_LEN]; int32_t code = 0; - if (pCxt->preCtbname) { + if ((pCxt->stmtTbNameFlag & NO_DATA_USING_CLAUSE) == USING_CLAUSE) { tstrncpy(pStmt->targetTableName.tname, pStmt->usingTableName.tname, sizeof(pStmt->targetTableName.tname)); tstrncpy(pStmt->targetTableName.dbname, pStmt->usingTableName.dbname, sizeof(pStmt->targetTableName.dbname)); pStmt->targetTableName.type = TSDB_SUPER_TABLE; @@ -2764,6 +2773,7 @@ static int32_t checkTableClauseFirstToken(SInsertParseContext* pCxt, SVnodeModif } if (TK_NK_QUESTION == pTbName->type) { + pCxt->stmtTbNameFlag &= ~IS_FIXED_VALUE; pCxt->isStmtBind = true; if (NULL == pCxt->pComCxt->pStmtCb) { return buildSyntaxErrMsg(&pCxt->msg, "? only used in stmt", pTbName->z); @@ -2772,14 +2782,15 @@ static int32_t checkTableClauseFirstToken(SInsertParseContext* pCxt, SVnodeModif char* tbName = NULL; int32_t code = (*pCxt->pComCxt->pStmtCb->getTbNameFn)(pCxt->pComCxt->pStmtCb->pStmt, &tbName); if (TSDB_CODE_SUCCESS == code) { + pCxt->stmtTbNameFlag |= HAS_BIND_VALUE; pTbName->z = tbName; pTbName->n = strlen(tbName); - } else if (code == TSDB_CODE_TSC_STMT_TBNAME_ERROR) { - pCxt->preCtbname = true; - code = TSDB_CODE_SUCCESS; - } else { - return code; } + if (code == TSDB_CODE_TSC_STMT_TBNAME_ERROR) { + pCxt->stmtTbNameFlag &= ~HAS_BIND_VALUE; + code = TSDB_CODE_SUCCESS; + } + return code; } if (TK_NK_ID != pTbName->type && TK_NK_STRING != pTbName->type && TK_NK_QUESTION != pTbName->type) { @@ -2788,26 +2799,34 @@ static int32_t checkTableClauseFirstToken(SInsertParseContext* pCxt, SVnodeModif // db.? situation，ensure that the only thing following the '.' mark is '?' char* tbNameAfterDbName = strnchr(pTbName->z, '.', pTbName->n, true); - if ((tbNameAfterDbName != NULL) && (*(tbNameAfterDbName + 1) == '?')) { - char* tbName = NULL; - if (NULL == pCxt->pComCxt->pStmtCb) { - return buildSyntaxErrMsg(&pCxt->msg, "? only used in stmt", pTbName->z); - } - int32_t code = (*pCxt->pComCxt->pStmtCb->getTbNameFn)(pCxt->pComCxt->pStmtCb->pStmt, &tbName); - if (code != TSDB_CODE_SUCCESS) { - pCxt->preCtbname = true; + if (tbNameAfterDbName != NULL) { + if (*(tbNameAfterDbName + 1) == '?') { + pCxt->stmtTbNameFlag &= ~IS_FIXED_VALUE; + char* tbName = NULL; + if (NULL == pCxt->pComCxt->pStmtCb) { + return buildSyntaxErrMsg(&pCxt->msg, "? only used in stmt", pTbName->z); + } + int32_t code = (*pCxt->pComCxt->pStmtCb->getTbNameFn)(pCxt->pComCxt->pStmtCb->pStmt, &tbName); + if (TSDB_CODE_SUCCESS == code) { + pCxt->stmtTbNameFlag |= HAS_BIND_VALUE; + pTbName->z = tbName; + pTbName->n = strlen(tbName); + } + if (code == TSDB_CODE_TSC_STMT_TBNAME_ERROR) { + pCxt->stmtTbNameFlag &= ~HAS_BIND_VALUE; + code = TSDB_CODE_SUCCESS; + } } else { - pTbName->z = tbName; - pTbName->n = strlen(tbName); - } - } - - if (pCxt->isStmtBind) { - if (TK_NK_ID == pTbName->type || (tbNameAfterDbName != NULL && *(tbNameAfterDbName + 1) != '?')) { - // In SQL statements, the table name has already been specified. + pCxt->stmtTbNameFlag |= IS_FIXED_VALUE; parserWarn("QID:0x%" PRIx64 ", table name is specified in sql, ignore the table name in bind param", pCxt->pComCxt->requestId); + *pHasData = true; } + return TSDB_CODE_SUCCESS; + } + + if (TK_NK_ID == pTbName->type) { + pCxt->stmtTbNameFlag |= IS_FIXED_VALUE; } *pHasData = true; @@ -2824,7 +2843,7 @@ static int32_t setStmtInfo(SInsertParseContext* pCxt, SVnodeModifyOpStmt* pStmt) SStmtCallback* pStmtCb = pCxt->pComCxt->pStmtCb; int32_t code = (*pStmtCb->setInfoFn)(pStmtCb->pStmt, pStmt->pTableMeta, tags, &pStmt->targetTableName, pStmt->usingTableProcessing, pStmt->pVgroupsHashObj, pStmt->pTableBlockHashObj, - pStmt->usingTableName.tname, pCxt->preCtbname); + pStmt->usingTableName.tname, pCxt->stmtTbNameFlag); memset(&pCxt->tags, 0, sizeof(pCxt->tags)); pStmt->pVgroupsHashObj = NULL; @@ -2880,9 +2899,6 @@ static int32_t parseInsertBody(SInsertParseContext* pCxt, SVnodeModifyOpStmt* pS if (TSDB_CODE_SUCCESS == code && hasData) { code = parseInsertTableClause(pCxt, pStmt, &token); } - if (TSDB_CODE_PAR_TABLE_NOT_EXIST == code && pCxt->preCtbname) { - code = TSDB_CODE_TSC_STMT_TBNAME_ERROR; - } } if (TSDB_CODE_SUCCESS == code && !pCxt->missCache) { diff --git a/source/libs/parser/src/parInsertStmt.c b/source/libs/parser/src/parInsertStmt.c index 9bb98eb223..2dc9e96264 100644 --- a/source/libs/parser/src/parInsertStmt.c +++ b/source/libs/parser/src/parInsertStmt.c @@ -1070,10 +1070,11 @@ int32_t buildBoundFields(int32_t numOfBound, int16_t* boundColumns, SSchema* pSc } int32_t buildStbBoundFields(SBoundColInfo boundColsInfo, SSchema* pSchema, int32_t* fieldNum, TAOS_FIELD_ALL** fields, - STableMeta* pMeta, void* boundTags, bool preCtbname) { + STableMeta* pMeta, void* boundTags, uint8_t tbNameFlag) { SBoundColInfo* tags = (SBoundColInfo*)boundTags; - bool hastag = tags != NULL; - int32_t numOfBound = boundColsInfo.numOfBound + (preCtbname ? 1 : 0); + bool hastag = (tags != NULL) && !(tbNameFlag & IS_FIXED_TAG); + int32_t numOfBound = + boundColsInfo.numOfBound + ((tbNameFlag & IS_FIXED_VALUE) == 0 && (tbNameFlag & USING_CLAUSE) != 0 ? 1 : 0); if (hastag) { numOfBound += tags->mixTagsCols ? 0 : tags->numOfBound; } @@ -1084,7 +1085,7 @@ int32_t buildStbBoundFields(SBoundColInfo boundColsInfo, SSchema* pSchema, int32 return terrno; } - if (preCtbname && numOfBound != boundColsInfo.numOfBound) { + if ((tbNameFlag & IS_FIXED_VALUE) == 0 && (tbNameFlag & USING_CLAUSE) != 0) { (*fields)[idx].field_type = TAOS_FIELD_TBNAME; tstrncpy((*fields)[idx].name, "tbname", sizeof((*fields)[idx].name)); (*fields)[idx].type = TSDB_DATA_TYPE_BINARY; @@ -1188,7 +1189,7 @@ int32_t qBuildStmtColFields(void* pBlock, int32_t* fieldNum, TAOS_FIELD_E** fiel return TSDB_CODE_SUCCESS; } -int32_t qBuildStmtStbColFields(void* pBlock, void* boundTags, bool preCtbname, int32_t* fieldNum, +int32_t qBuildStmtStbColFields(void* pBlock, void* boundTags, uint8_t tbNameFlag, int32_t* fieldNum, TAOS_FIELD_ALL** fields) { STableDataCxt* pDataBlock = (STableDataCxt*)pBlock; SSchema* pSchema = getTableColumnSchema(pDataBlock->pMeta); @@ -1202,7 +1203,7 @@ int32_t qBuildStmtStbColFields(void* pBlock, void* boundTags, bool preCtbname, i } CHECK_CODE(buildStbBoundFields(pDataBlock->boundColsInfo, pSchema, fieldNum, fields, pDataBlock->pMeta, boundTags, - preCtbname)); + tbNameFlag)); return TSDB_CODE_SUCCESS; } diff --git a/source/util/src/tmempool.c b/source/util/src/tmempool.c index 0a56c69505..96a9cfcea2 100644 --- a/source/util/src/tmempool.c +++ b/source/util/src/tmempool.c @@ -1029,7 +1029,7 @@ void mpUpdateSystemAvailableMemorySize() { atomic_store_64(&tsCurrentAvailMemorySize, sysAvailSize); - uDebug("system available memory size: %" PRId64, sysAvailSize); + uTrace("system available memory size: %" PRId64, sysAvailSize); } void mpSchedTrim(int64_t* loopTimes) { diff --git a/source/util/test/memPoolTest.cpp b/source/util/test/memPoolTest.cpp index 8af8b01368..a0086b8d1c 100644 --- a/source/util/test/memPoolTest.cpp +++ b/source/util/test/memPoolTest.cpp @@ -729,7 +729,7 @@ int32_t mptGetMemPoolMaxMemSize(void* pHandle, int64_t* maxSize) { } if (TSDB_CODE_SUCCESS != code) { - uError("get system avaiable memory size failed, error: 0x%x", code); + uError("get system available memory size failed, error: 0x%x", code); return code; } diff --git a/utils/test/c/sml_test.c b/utils/test/c/sml_test.c index 0907c2a641..4db5a1908d 100644 --- a/utils/test/c/sml_test.c +++ b/utils/test/c/sml_test.c @@ -87,7 +87,8 @@ int smlProcess_telnet_Test() { const char *sql1[] = {"sys.if.bytes.out 1479496100 1.3E0 host=web01 interface=eth0", "sys.if.bytes.out 1479496101 1.3E1 interface=eth0 host=web01 ", "sys.if.bytes.out 1479496102 1.3E3 network=tcp", - " sys.procs.running 1479496100 42 host=web01 "}; + " sys.procs.running 1479496100 42 host=web01 ", + " newline 1479496100 42 host=web\n01 t=fsb\n "}; // for(int i = 0; i < 4; i++){ // strncpy(sql[i], sql1[i], 128); @@ -2355,12 +2356,35 @@ int sml_td17324_Test() { return code; } +int smlProcess_34114_Test() { + TAOS *taos = taos_connect("localhost", "root", "taosdata", NULL, 0); + + TAOS_RES *pRes = taos_query(taos, "create database if not exists sml_34114_db schemaless 1"); + taos_free_result(pRes); + + pRes = taos_query(taos, "use sml_34114_db"); + taos_free_result(pRes); + + char *sql = {"sys.if.bytes.out 1479496100 1.3E0 host=web01 interface=eth0 \nsys.if.bytes.out 1479496101 1.3E1 interface=eth0 host=web01 "}; + int32_t totalRows = 0; + pRes = taos_schemaless_insert_raw(taos, sql, strlen(sql), &totalRows, TSDB_SML_TELNET_PROTOCOL, + TSDB_SML_TIMESTAMP_NANO_SECONDS); + printf("%s result:%s\n", __FUNCTION__, taos_errstr(pRes)); + int code = taos_errno(pRes); + taos_free_result(pRes); + taos_close(taos); + + return code; +} + int main(int argc, char *argv[]) { if (argc == 2) { taos_options(TSDB_OPTION_CONFIGDIR, argv[1]); } - int ret = smlProcess_json0_Test(); + int ret = smlProcess_34114_Test(); + ASSERT(!ret); + ret = smlProcess_json0_Test(); ASSERT(!ret); ret = sml_ts5528_test(); ASSERT(!ret); From 21317576e4a7471a82f6f46232e6eb136f7eb759 Mon Sep 17 00:00:00 2001 From: She Yanjie <57549981+sheyanjie-qq@users.noreply.github.com> Date: Sat, 22 Mar 2025 21:16:42 +0800 Subject: [PATCH 20/26] docs: fix virtual table err code (#30348) --- docs/en/14-reference/09-error-code.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/14-reference/09-error-code.md b/docs/en/14-reference/09-error-code.md index 3305eb18eb..90a7c67d0a 100644 --- a/docs/en/14-reference/09-error-code.md +++ b/docs/en/14-reference/09-error-code.md @@ -584,4 +584,4 @@ This document details the server error codes that may be encountered when using | 0x80006204 | Virtual table not support decimal type | Create virtual table using decimal type | create virtual table without using decimal type | | 0x80006205 | Virtual table not support in STMT query and STMT insert | Use virtual table in stmt query and stmt insert | do not use virtual table in stmt query and insert | | 0x80006206 | Virtual table not support in Topic | Use virtual table in topic | do not use virtual table in topic | -| 0x80006206 | Virtual super table query not support origin table from different databases | Virtual super table ‘s child table's origin table from different databases | make sure virtual super table's child table's origin table from same database | +| 0x80006207 | Virtual super table query not support origin table from different databases | Virtual super table ‘s child table's origin table from different databases | make sure virtual super table's child table's origin table from same database | From 97063eb19bf408be5a5ce8aaed157cd1e7d05da3 Mon Sep 17 00:00:00 2001 From: Linhe Huo Date: Sat, 22 Mar 2025 22:18:43 +0800 Subject: [PATCH 21/26] doc: update docs for analysis (#30352) * Update 09-error-code.md * Update 03-preprocess.md * Update index.md * Update index.md * Update index.md * doc: update docs. * Update index.md * Update index.md * Update index.md * docs: fix ci error in forecast doc * docs: fix anoal-detection doc ci error --------- Co-authored-by: Haojun Liao Co-authored-by: Haojun Liao --- docs/zh/06-advanced/06-TDgpt/03-preprocess.md | 4 +- .../06-advanced/06-TDgpt/04-forecast/index.md | 51 +++++++++--------- .../06-TDgpt/05-anomaly-detection/index.md | 26 +++++---- .../06-TDgpt/pic/ad-result-figure.png | Bin 42407 -> 0 bytes .../zh/06-advanced/06-TDgpt/pic/ad-result.png | Bin 20151 -> 26716 bytes docs/zh/06-advanced/06-TDgpt/pic/fc.png | Bin 13240 -> 0 bytes 6 files changed, 45 insertions(+), 36 deletions(-) delete mode 100644 docs/zh/06-advanced/06-TDgpt/pic/ad-result-figure.png mode change 100644 => 100755 docs/zh/06-advanced/06-TDgpt/pic/ad-result.png delete mode 100644 docs/zh/06-advanced/06-TDgpt/pic/fc.png diff --git a/docs/zh/06-advanced/06-TDgpt/03-preprocess.md b/docs/zh/06-advanced/06-TDgpt/03-preprocess.md index b63cae0740..8cc207943a 100644 --- a/docs/zh/06-advanced/06-TDgpt/03-preprocess.md +++ b/docs/zh/06-advanced/06-TDgpt/03-preprocess.md @@ -9,14 +9,14 @@ import wndata from './pic/white-noise-data.png' ### 分析流程 时序数据分析之前需要有预处理的过程，为减轻分析算法的负担，TDgpt 在将时序数据发给具体分析算法进行分析时，已经对数据做了预处理，整体的流程如下图所示。 -预处理流程 +预处理流程 TDgpt 首先对输入数据进行白噪声检查（White Noise Data check）, 检查通过以后针对预测分析，还要进行输入（历史）数据的重采样和时间戳对齐处理（异常检测跳过数据重采样和时间戳对齐步骤）。 预处理完成以后，再进行预测或异常检测操作。预处理过程不属于预测或异常检测处理逻辑的一部分。 ### 白噪声检查 -white-noise-data +white-noise-data 白噪声时序数据可以简单地认为是随机数构成的时间数据序列（如上图所示的正态分布随机数序列），随机数构成的时间序列没有分析的价值，因此会直接返回。白噪声检查采用经典的 `Ljung-Box` 统计量检验，计算 `Ljung-Box` 统计量需遍历整个输入时间序列。如果用户能够明确输入序列一定不是白噪声序列，那么可以在参数列表中增加参数 `wncheck=0` 强制要求分析平台忽略白噪声检查，从而节省计算资源。 TDgpt 暂不提供独立的时间序列白噪声检测功能。 diff --git a/docs/zh/06-advanced/06-TDgpt/04-forecast/index.md b/docs/zh/06-advanced/06-TDgpt/04-forecast/index.md index 560e6cdcc0..e0f6f238cf 100644 --- a/docs/zh/06-advanced/06-TDgpt/04-forecast/index.md +++ b/docs/zh/06-advanced/06-TDgpt/04-forecast/index.md @@ -3,19 +3,18 @@ title: 预测算法 description: 预测算法 --- -import fc_result from '../pic/fc.png'; -import fc_result_figure from '../pic/fc-result.png'; +import fc_result from '../pic/fc-result.png'; 时序数据预测处理以持续一个时间段的时序数据作为输入，预测接下来一个连续时间区间内时间序列数据趋势。用户可以指定输出的（预测）时间序列数据点的数量，因此其输出的结果行数不确定。为此，TDengine 使用新 SQL 函数 `FORECAST` 提供时序数据预测服务。基础数据（用于预测的历史时间序列数据）是该函数的输入，预测结果是该函数的输出。用户可以通过 `FORECAST` 函数调用 Anode 提供的预测算法提供的服务。 -在后续章节中，使用时序数据表`foo`作为示例，介绍预测和异常检测算法的使用方式，`foo` 表的模式如下： +在后续章节中，使用时序数据表 `foo` 作为示例，介绍预测和异常检测算法的使用方式，`foo` 表的模式如下： -|列名称|类型|说明| -|---|---|---| -|ts| timestamp| 主时间戳列| -|i32| int32| 4字节整数，设备测量值 metric| +| 列名称 | 类型 | 说明 | +| ------ | --------- | ---------------------------- | +| ts | timestamp | 主时间戳列 | +| i32 | int32 | 4字节整数，设备测量值 metric | -```bash +```sql taos> select * from foo; ts | i32 | ======================================== @@ -30,6 +29,7 @@ taos> select * from foo; ``` ### 语法 + ```SQL FORECAST(column_expr, option_expr) @@ -42,21 +42,21 @@ algo=expr1 [,start=start_ts_val] [,expr2] "} - ``` + 1. `column_expr`：预测的时序数据列，只支持数值类型列输入。 2. `options`：预测函数的参数。字符串类型，其中使用 K=V 方式调用算法及相关参数。采用逗号分隔的 K=V 字符串表示，其中的字符串不需要使用单引号、双引号、或转义号等符号，不能使用中文及其他宽字符。预测支持 `conf`, `every`, `rows`, `start`, `rows` 几个控制参数，其含义如下： ### 参数说明 -|参数|含义|默认值| -|---|---|---| -|algo|预测分析使用的算法|holtwinters| -|wncheck|白噪声（white noise data）检查|默认值为 1，0 表示不进行检查| -|conf|预测数据的置信区间范围 ，取值范围 [0, 100]|95| -|every|预测数据的采样间隔|输入数据的采样间隔| -|start|预测结果的开始时间戳|输入数据最后一个时间戳加上一个采样间隔时间区间| -|rows|预测结果的记录数|10| +| 参数 | 含义 | 默认值 | +| ------- | ------------------------------------------ | ---------------------------------------------- | +| algo | 预测分析使用的算法 | holtwinters | +| wncheck | 白噪声（white noise data）检查 | 默认值为 1，0 表示不进行检查 | +| conf | 预测数据的置信区间范围 ，取值范围 [0, 100] | 95 | +| every | 预测数据的采样间隔 | 输入数据的采样间隔 | +| start | 预测结果的开始时间戳 | 输入数据最后一个时间戳加上一个采样间隔时间区间 | +| rows | 预测结果的记录数 | 10 | 1. 预测查询结果新增三个伪列，具体如下：`_FROWTS`：预测结果的时间戳、`_FLOW`：置信区间下界、`_FHIGH`：置信区间上界, 对于没有置信区间的预测算法，其置信区间同预测结果 2. 更改参数 `START`：返回预测结果的起始时间，改变起始时间不会影响返回的预测数值，只影响起始时间。 @@ -74,7 +74,8 @@ FROM foo; SELECT _flow, _fhigh, _frowts, FORECAST(i32, "algo=arima,alpha=95,period=10,wncheck=0") FROM foo; ``` -``` + +```sql taos> select _flow, _fhigh, _frowts, forecast(i32) from foo; _flow | _fhigh | _frowts | forecast(i32) | ======================================================================================== @@ -90,8 +91,8 @@ taos> select _flow, _fhigh, _frowts, forecast(i32) from foo; -1076.1566162 | 1214.4498291 | 2020-01-01 00:01:44.000 | 69 | ``` - ## 内置预测算法 + - [arima](./02-arima.md) - [holtwinters](./03-holtwinters.md) - CES (Complex Exponential Smoothing) @@ -111,6 +112,7 @@ taos> select _flow, _fhigh, _frowts, forecast(i32) from foo; - TimesNet ## 算法有效性评估工具 + TDgpt 提供预测分析算法有效性评估工具 `analytics_compare`，调用该工具并设置合适的参数，能够使用 TDengine 中的数据作为回测依据，评估不同预测算法或相同的预测算法在不同的参数或训练模型的下的预测有效性。预测有效性的评估使用 `MSE` 和 `MAE` 指标作为依据，后续还将增加 `MAPE`指标。 ```ini @@ -134,12 +136,13 @@ res_start_time = 1730000000000 gen_figure = true ``` -算法对比分析运行完成以后，生成 fc-results.xlsx 文件，其中包含了调用算法的预测分析误差、执行时间、调用参数等信息。如下图所示： - -预测对比结果 +算法对比分析运行完成以后，生成 fc-results.xlsx 文件，其中包含了调用算法的预测分析误差、执行时间、调用参数等信息，如下表： +| algorithm | params | MSE | elapsed_time(ms.) | +| ----------- | ------------------------------------------------------------------------- | ------- | ----------------- | +| holtwinters | `{"trend":"add", "seasonal":"add"}` | 351.622 | 125.1721 | +| arima | `{"time_step":3600000, "start_p":0, "max_p":10, "start_q":0, "max_q":10}` | 433.709 | 45577.9187 | 如果设置了 `gen_figure` 为 true，分析结果中还会有绘制的分析预测结果图（如下图所示）。 -预测对比结果 - +预测对比结果 diff --git a/docs/zh/06-advanced/06-TDgpt/05-anomaly-detection/index.md b/docs/zh/06-advanced/06-TDgpt/05-anomaly-detection/index.md index 4802fa2e4f..9b7a5d2834 100644 --- a/docs/zh/06-advanced/06-TDgpt/05-anomaly-detection/index.md +++ b/docs/zh/06-advanced/06-TDgpt/05-anomaly-detection/index.md @@ -5,7 +5,6 @@ description: 异常检测算法 import ad from '../pic/anomaly-detection.png'; import ad_result from '../pic/ad-result.png'; -import ad_result_figure from '../pic/ad-result-figure.png'; TDengine 中定义了异常（状态）窗口来提供异常检测服务。异常窗口可以视为一种特殊的**事件窗口（Event Window）**，即异常检测算法确定的连续异常时间序列数据所在的时间窗口。与普通事件窗口区别在于——时间窗口的起始时间和结束时间均是分析算法识别确定，不是用户给定的表达式进行判定。因此，在 `WHERE` 子句中使用 `ANOMALY_WINDOW` 关键词即可调用时序数据异常检测服务，同时窗口伪列（`_WSTART`, `_WEND`, `_WDURATION`）也能够像其他时间窗口一样用于描述异常窗口的起始时间(`_WSTART`)、结束时间(`_WEND`)、持续时间(`_WDURATION`)。例如： @@ -40,13 +39,15 @@ algo=expr1 4. 输入数据默认进行白噪声检查，如果输入数据是白噪声，将不会有任何（异常）窗口信息返回。 ### 参数说明 -|参数|含义|默认值| -|---|---|---| -|algo|异常检测调用的算法|iqr| -|wncheck|对输入数据列是否进行白噪声检查，取值为0或1|1| + +| 参数 | 含义 | 默认值 | +| ------- | ------------------------------------------ | ------ | +| algo | 异常检测调用的算法 | iqr | +| wncheck | 对输入数据列是否进行白噪声检查，取值为0或1 | 1 | ### 示例 + ```SQL --- 使用 iqr 算法进行异常检测，检测列 i32 列。 SELECT _wstart, _wend, SUM(i32) @@ -65,11 +66,12 @@ taos> SELECT _wstart, _wend, count(*) FROM foo ANOMAYL_WINDOW(i32); Query OK, 1 row(s) in set (0.028946s) ``` - ### 内置异常检测算法 + 分析平台内置了6个异常检查模型，分为3个类别，分别是[基于统计学的算法](./02-statistics-approach.md)、[基于数据密度的算法](./03-data-density.md)、以及[基于机器学习的算法](./04-machine-learning.md)。在不指定异常检测使用的方法的情况下，默认调用 IQR 进行异常检测。 ### 异常检测算法有效性比较工具 + TDgpt 提供自动化的工具对比不同数据集的不同算法监测有效性，针对异常检测算法提供查全率（recall）和查准率（precision）两个指标衡量不同算法的有效性。 通过在配置文件中(analysis.ini)设置以下的选项可以调用需要使用的异常检测算法，异常检测算法测试用数据的时间范围、是否生成标注结果的图片、调用的异常检测算法以及相应的参数。 调用异常检测算法比较之前，需要人工手动标注异常监测数据集的结果，即设置[anno_res]选项的数值，第几个数值是异常点，需要标注在数组中，如下测试集中，第 9 个点是异常点，我们就标注异常结果为 [9]. @@ -93,14 +95,18 @@ anno_res = [9] ksigma={"k": 2} iqr={} grubbs={} -lof={"algo":"auto", "n_neighbor": 3} +lof={"algorithm":"auto", "n_neighbor": 3} ``` 对比程序执行完成以后，会自动生成名称为`ad_result.xlsx` 的文件，第一个卡片是算法运行结果（如下图所示），分别包含了算法名称、执行调用参数、查全率、查准率、执行时间 5 个指标。 -异常检测对比结果 +| algorithm | params | precision(%) | recall(%) | elapsed_time(ms.) | +| --------- | -------------------------------------- | ------------ | --------- | ----------------- | +| ksigma | `{"k":2}` | 100 | 100 | 0.453 | +| iqr | `{}` | 100 | 100 | 2.727 | +| grubbs | `{}` | 100 | 100 | 2.811 | +| lof | `{"algorithm":"auto", "n_neighbor":3}` | 0 | 0 | 4.660 | 如果设置了 `gen_figure` 为 `true`，比较程序会自动将每个参与比较的算法分析结果采用图片方式呈现出来（如下图所示为 ksigma 的异常检测结果标注）。 -异常检测标注图 - +异常检测标注图 diff --git a/docs/zh/06-advanced/06-TDgpt/pic/ad-result-figure.png b/docs/zh/06-advanced/06-TDgpt/pic/ad-result-figure.png deleted file mode 100644 index b1bf23178639f91b56ec1db66e5d0a63aba81cb3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 42407 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 diff --git a/docs/zh/06-advanced/06-TDgpt/pic/ad-result.png b/docs/zh/06-advanced/06-TDgpt/pic/ad-result.png old mode 100644 new mode 100755 index 80667c5733336d2f666c2160a36fbd77402bac26..40b9bb44350789d9a8e8f279431907413c373bcb GIT binary patch literal 26716 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 QDz-%~&hCe+4hE(E7oM;|G5`Po literal 20151 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 Q-8Q#W!J3NI@~?ycA9RTndH?_b From ab428f860f2854a683950f82ef5d719a9add04a2 Mon Sep 17 00:00:00 2001 From: Haojun Liao Date: Sat, 22 Mar 2025 22:36:25 +0800 Subject: [PATCH 22/26] doc: update docs. (#30347) * Update 09-error-code.md * Update 03-preprocess.md * Update index.md * Update index.md * Update index.md * doc: update docs. * Update index.md * Update index.md * Update index.md --- docs/zh/06-advanced/06-TDgpt/04-forecast/index.md | 3 +-- docs/zh/06-advanced/06-TDgpt/05-anomaly-detection/index.md | 3 +++ 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/zh/06-advanced/06-TDgpt/04-forecast/index.md b/docs/zh/06-advanced/06-TDgpt/04-forecast/index.md index e0f6f238cf..9c9468c9f0 100644 --- a/docs/zh/06-advanced/06-TDgpt/04-forecast/index.md +++ b/docs/zh/06-advanced/06-TDgpt/04-forecast/index.md @@ -136,8 +136,6 @@ res_start_time = 1730000000000 gen_figure = true ``` -算法对比分析运行完成以后，生成 fc-results.xlsx 文件，其中包含了调用算法的预测分析误差、执行时间、调用参数等信息，如下表： - | algorithm | params | MSE | elapsed_time(ms.) | | ----------- | ------------------------------------------------------------------------- | ------- | ----------------- | | holtwinters | `{"trend":"add", "seasonal":"add"}` | 351.622 | 125.1721 | @@ -146,3 +144,4 @@ gen_figure = true 如果设置了 `gen_figure` 为 true，分析结果中还会有绘制的分析预测结果图（如下图所示）。 预测对比结果 + diff --git a/docs/zh/06-advanced/06-TDgpt/05-anomaly-detection/index.md b/docs/zh/06-advanced/06-TDgpt/05-anomaly-detection/index.md index 9b7a5d2834..9ca0204b42 100644 --- a/docs/zh/06-advanced/06-TDgpt/05-anomaly-detection/index.md +++ b/docs/zh/06-advanced/06-TDgpt/05-anomaly-detection/index.md @@ -100,6 +100,7 @@ lof={"algorithm":"auto", "n_neighbor": 3} 对比程序执行完成以后，会自动生成名称为`ad_result.xlsx` 的文件，第一个卡片是算法运行结果（如下图所示），分别包含了算法名称、执行调用参数、查全率、查准率、执行时间 5 个指标。 + | algorithm | params | precision(%) | recall(%) | elapsed_time(ms.) | | --------- | -------------------------------------- | ------------ | --------- | ----------------- | | ksigma | `{"k":2}` | 100 | 100 | 0.453 | @@ -107,6 +108,8 @@ lof={"algorithm":"auto", "n_neighbor": 3} | grubbs | `{}` | 100 | 100 | 2.811 | | lof | `{"algorithm":"auto", "n_neighbor":3}` | 0 | 0 | 4.660 | + 如果设置了 `gen_figure` 为 `true`，比较程序会自动将每个参与比较的算法分析结果采用图片方式呈现出来（如下图所示为 ksigma 的异常检测结果标注）。 异常检测标注图 + From adc892dea601883cc712261cb8622c9a860b6db0 Mon Sep 17 00:00:00 2001 From: Simon Guan Date: Sat, 22 Mar 2025 23:17:13 +0800 Subject: [PATCH 23/26] docs: minor changes for virtual table (#30358) --- docs/zh/05-basic/01-model.md | 71 +++++++++---------- .../03-taos-sql/34-virtualtable.md | 14 ++-- 2 files changed, 42 insertions(+), 43 deletions(-) diff --git a/docs/zh/05-basic/01-model.md b/docs/zh/05-basic/01-model.md index 0f01fbf562..15f192b3bc 100644 --- a/docs/zh/05-basic/01-model.md +++ b/docs/zh/05-basic/01-model.md @@ -79,9 +79,9 @@ toc_max_heading_level: 4 ### 虚拟表 -“一个设备一张表”的设计解决了工业和物联网等场景下的大多数时序数据管理和分析难题，但是在遇到更复杂的场景时，这种设计受到了设备复杂性的挑战。这种复杂性的根源在于一个设备无法简单的用一个或一组数据采集点来描述或管理，而业务分析往往需要综合多个或多组采集点的数据才能完成。以汽车或发电风机为例，整个设备（汽车或风机）中含有非常大量的传感器（数据采集点），这些传感器的输出和采集频率千差万别。一个超级表只能描述其中一种传感器，当需要综合多个传感器的数据进行分析计算时，只能通过多级关联查询的方式来进行，而这往往会导致易用性和性能方面的问题。 +“一个设备一张表”的设计解决了工业和物联网等场景下的大多数时序数据管理和分析难题，但是在遇到更复杂的场景时，这种设计受到了设备复杂性的挑战。根源在于一个设备无法简单的用一个或一组数据采集点来描述或管理，而业务分析往往需要综合多个或多组采集点的数据才能完成。以汽车或发电风机为例，整个设备（汽车或风机）中含有非常大量的传感器（数据采集点），这些传感器的输出和采集频率千差万别。一个超级表只能描述其中一种传感器，当需要综合多个传感器的数据进行分析计算时，只能通过多级关联查询的方式来进行，而这往往会导致易用性和性能方面的问题。 -为了解决这个问题，TDengine 引入虚拟表（Virtual Table，简称为 VTable）的概念。虚拟表是一种不存储实际数据而可以用于分析计算的表，它的数据来源为其它真实存储数据的子表、普通表，通过将不同列数据按照时间戳排序、对齐、合并的方式来生成虚拟表。同真实表类似，虚拟表也可以分为虚拟超级表、虚拟子表、虚拟普通表。虚拟超级表可以是一个设备或一组分析计算所需数据的完整集合，每个虚拟子表可以根据需要引用相同或不同的列，因此可以灵活地根据业务需要进行定义，最终可以达到千表千面的效果。虚拟表不能写入、删除数据，在查询使用上同真实表基本相同，支持虚拟超级表、虚拟子表、虚拟普通表上的任何查询。唯一的区别在于虚拟表的数据是每次查询计算时动态生成的，只有一个查询中引用的列才会被合并进虚拟表中，因此同一个虚拟表在不同的查询中所呈现的数据可能是不同的。 +为了解决这个问题，TDengine 引入虚拟表（Virtual Table，简称为 VTable）的概念。虚拟表是一种不存储实际数据而可以用于分析计算的表，它的数据来源为其它真实存储数据的子表、普通表，通过将不同列数据按照时间戳排序、对齐、合并的方式来生成虚拟表。同真实表类似，虚拟表也可以分为虚拟超级表、虚拟子表、虚拟普通表。虚拟超级表可以是一个设备或一组分析计算所需数据的完整集合，每个虚拟子表可以根据需要引用相同或不同的列，因此可以灵活地根据业务需要进行定义，最终达到千表千面的效果。虚拟表不能写入、删除数据，在查询使用上同真实表基本相同，支持虚拟超级表、虚拟子表、虚拟普通表上的任何查询。唯一的区别在于虚拟表的数据是每次查询计算时动态生成的，只有一个查询中引用的列才会被合并进虚拟表中，因此同一个虚拟表在不同的查询中所呈现的数据可能是不同的。 虚拟超级表的主要功能特点包括： 1. 列选择与拼接
@@ -91,7 +91,7 @@ toc_max_heading_level: 4 3. 动态更新
虚拟表根据原始表的数据变化自动更新，确保数据的实时性。虚拟表不需实际存储，计算在生成时动态完成。 -通过引入虚拟表的概念，现在 TDengine 可以非常方便的管理更大更复杂的设备数据。无论每个采集点如何建模（单列 or 多列），无论这些采集点的数据是分布在一个或多个库中，我们现在都可以通过定义虚拟子表的方式跨库跨表任意指定数据源，通过虚拟超级表的方式进行跨设备、跨分析的聚合运算，从此“一个设备一张表”彻底成为现实。 +通过引入虚拟表的概念，TDengine 可以非常方便的管理更大更复杂的设备数据。无论每个采集点如何建模（单列 or 多列），无论这些采集点的数据是分布在一个或多个库中，都可以通过定义虚拟子表的方式跨库跨表任意指定数据源，通过虚拟超级表的方式进行跨设备、跨分析的聚合运算，从此“一个设备一张表”彻底成为现实。 ### 库 @@ -101,7 +101,7 @@ toc_max_heading_level: 4 ### 时间戳 -时间戳在时序数据处理中扮演着至关重要的角色，特别是在应用程序需要从多个不同时区访问数据库时，这一问题变得更加复杂。在深入了解 TDengine 如何处理时间戳与时区之前，我们先介绍以下几个基本概念。 +时间戳在时序数据处理中扮演着至关重要的角色，特别是在应用程序需要从多个不同时区访问数据库时，这一问题变得更加复杂。在深入了解 TDengine 如何处理时间戳与时区之前，先介绍以下几个基本概念。 - 本地日期时间：指特定地区的当地时间，通常表示为 yyyy-MM-dd hh:mm:ss.SSS 格式的字符串。这种时间表示不包含任何时区信息，如 “2021-07-21 12:00:00.000”。 - 时区：地球上不同地理位置的标准时间。协调世界时（Universal Time Coordinated，UTC）或格林尼治时间是国际时间标准，其他时区通常表示为相对于 UTC 的偏移量，如 “UTC+8” 代表东八区时间。 UTC 时间戳：表示自 UNIX 纪元（即 UTC 时间 1970 年 1 月 1 日 0 点）起经过的毫秒数。例如，“1700000000000” 对应的日期时间是 “2023-11-14 22:13:20（UTC+0）”。 在 TDengine 中保存时序数据时，实际上保存的是 UTC 时间戳。TDengine 在写入数据时，时间戳的处理分为如下两种情况。 - RFC-3339 格式：当使用这种格式时，TDengine 能够正确解析带有时区信息的时间字符串为 UTC 时间戳。例如，“2018-10-03T14:38:05.000+08:00” 会被转换为 UTC 时间戳。 @@ -109,10 +109,9 @@ toc_max_heading_level: 4 在查询数据时，TDengine 客户端会根据应用程序当前的时区设置，自动将保存的 UTC 时间戳转换成本地时间进行显示，确保用户在不同时区下都能看到正确的时间信息。 - ## 数据建模 -本节用智能电表做例子，简要的介绍如何在 TDengine 里使用 SQL 创建数据库、超级表、表的基本操作。 +本节以智能电表为例，介绍如何在 TDengine 里使用 SQL 创建数据库、超级表、表的基本操作。 ### 创建数据库 @@ -276,7 +275,7 @@ CREATE STABLE phase_stb ( ); ``` -假设分别有 d1001,d1002,d1003,d1004 四个设备，分别对四个设备的电流、电压、相位采集量创建子表，SQL 如下： +假设有 d1001、d1002、d1003、d1004 四个设备，为四个设备的电流、电压、相位采集量分别创建子表，SQL 如下： ```sql create table current_d1001 using current_stb(deviceid, location, group_id) tags("d1001", "California.SanFrancisco", 2); @@ -295,7 +294,7 @@ create table phase_d1003 using phase_stb(deviceid, location, group_id) tags("d10 create table phase_d1004 using phase_stb(deviceid, location, group_id) tags("d1004", "California.LosAngeles", 2); ``` -此时想要通过一张虚拟超级表来讲这三种采集量聚合到一张表中，创建虚拟超级表 SQL 如下： +可通过一张虚拟超级表来将这三种采集量聚合到一张表中，创建虚拟超级表 SQL 如下： ```sql CREATE STABLE meters_v ( @@ -309,51 +308,51 @@ CREATE STABLE meters_v ( ) VIRTUAL 1; ``` -并且对四个设备 d1001,d1002,d1003,d1004 分别创建虚拟子表，SQL 如下： +并且对四个设备 d1001、d1002、d1003、d1004 分别创建虚拟子表，SQL 如下： ```sql CREATE VTABLE d1001_v ( - current from current_d1001.current, - voltage from voltage_d1001.voltage, - phase from phase_d1001.phase + current from current_d1001.current, + voltage from voltage_d1001.voltage, + phase from phase_d1001.phase ) USING meters_v TAGS ( - "California.SanFrancisco", - 2 + "California.SanFrancisco", + 2 ); CREATE VTABLE d1002_v ( - current from current_d1002.current, - voltage from voltage_d1002.voltage, - phase from phase_d1002.phase + current from current_d1002.current, + voltage from voltage_d1002.voltage, + phase from phase_d1002.phase ) USING meters_v TAGS ( - "California.SanFrancisco", - 3 + "California.SanFrancisco", + 3 ); CREATE VTABLE d1003_v ( - current from current_d1003.current, - voltage from voltage_d1003.voltage, - phase from phase_d1003.phase + current from current_d1003.current, + voltage from voltage_d1003.voltage, + phase from phase_d1003.phase ) USING meters_v TAGS ( - "California.LosAngeles", - 3 + "California.LosAngeles", + 3 ); CREATE VTABLE d1004_v ( - current from current_d1004.current, - voltage from voltage_d1004.voltage, - phase from phase_d1004.phase + current from current_d1004.current, + voltage from voltage_d1004.voltage, + phase from phase_d1004.phase ) USING meters_v TAGS ( - "California.LosAngeles", - 2 + "California.LosAngeles", + 2 ); ``` @@ -361,7 +360,7 @@ TAGS ( ![data-model-origin-table.png](data-model-origin-table.png) -虚拟表 d1001_v 中的数据如下 : +虚拟表 d1001_v 中的数据如下: | Timestamp | Current | Voltage | Phase | |:--------------:|:-------:|:---------:|:-------:| @@ -378,15 +377,15 @@ TAGS ( 在跨源采集量对比分析中，“跨源”指数据来自**不同数据采集点**。在不同数据采集点中提取具有可比语义的采集量，通过虚拟表将这些采集量按照时间戳进行对齐和合并，并进行对比分析。 例如，用户可以将来自不同设备的电流数据聚合到一张虚拟表中，以便进行电流数据的对比分析。 -以分析 d1001, d1002, d1003, d1004 四个设备的电流数据为例，创建虚拟表的 SQL 如下： +以分析 d1001、d1002、d1003、d1004 四个设备的电流数据为例，创建虚拟表的 SQL 如下： ```sql CREATE VTABLE current_v ( - ts timestamp, - d1001_current float from current_d1001.current, - d1002_current float from current_d1002.current, - d1003_current float from current_d1003.current, - d1004_current float from current_d1004.current + ts timestamp, + d1001_current float from current_d1001.current, + d1002_current float from current_d1002.current, + d1003_current float from current_d1003.current, + d1004_current float from current_d1004.current ); ``` diff --git a/docs/zh/14-reference/03-taos-sql/34-virtualtable.md b/docs/zh/14-reference/03-taos-sql/34-virtualtable.md index a243169a0a..976e48acbd 100644 --- a/docs/zh/14-reference/03-taos-sql/34-virtualtable.md +++ b/docs/zh/14-reference/03-taos-sql/34-virtualtable.md @@ -17,10 +17,10 @@ CREATE VTABLE [IF NOT EXISTS] [db_name].vtb_name ts_col_name timestamp, (create_defination[ ,create_defination] ...) - create_definition: + create_definition: vtb_col_name column_definition -column_definition: + column_definition: type_name [FROM [db_name.]table_name.col_name] ``` @@ -33,9 +33,9 @@ CREATE VTABLE [IF NOT EXISTS] [db_name].vtb_name [(tag_name [, tag_name] ...)] TAGS (tag_value [, tag_value] ...) - create_definition: + create_definition: [stb_col_name FROM] [db_name.]table_name.col_name - tag_value: + tag_value: const_value ``` @@ -66,7 +66,7 @@ CREATE VTABLE [IF NOT EXISTS] [db_name].vtb_name **示例** -假设有表 t1, t2, t3 结构和数据如下： +假设有表 t1、t2、t3 结构和数据如下： ![virtual-table-origin-table.png](pic/virtual-table-origin-table.png) @@ -101,7 +101,7 @@ select c1, c2 from v1; ![virtual-table-query-res-part.png](pic/virtual-table-query-res-part.png) -因为 c1, c2 列对应的原始表 t1, t2 中没有 0:00:03 这个时间戳，所以最后的结果也不会包含这个时间戳。 +因为 c1、c2 列对应的原始表 t1、t2 中没有 0:00:03 这个时间戳，所以最后的结果也不会包含这个时间戳。 **使用限制** @@ -205,7 +205,7 @@ SHOW [NORMAL | CHILD] [db_name.]VTABLES [LIKE 'pattern']; **使用说明** -1. 如果没有指定 db_name, 显示当前数据库下的所有虚拟普通表和虚拟子表的信息。若没有使用数据库并且没有指定 db_name, 则会报错 database not specified。可以使用 LIKE 对表名进行模糊匹配。NORMAL 指定只显示虚拟普通表信息， CHILD 指定只显示虚拟子表信息。 +1. 如果没有指定 db_name，显示当前数据库下的所有虚拟普通表和虚拟子表的信息。若没有使用数据库并且没有指定 db_name, 则会报错 database not specified。可以使用 LIKE 对表名进行模糊匹配。NORMAL 指定只显示虚拟普通表信息， CHILD 指定只显示虚拟子表信息。 ### 显示虚拟表创建语句 From 9723fd9182f7bb9dbda52eafd1af8d272f888b67 Mon Sep 17 00:00:00 2001 From: Hongze Cheng Date: Sat, 22 Mar 2025 23:23:14 +0800 Subject: [PATCH 24/26] fix: send uninitialized memory (#30328) --- source/dnode/vnode/src/meta/metaTable.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/dnode/vnode/src/meta/metaTable.c b/source/dnode/vnode/src/meta/metaTable.c index 9ae5a11f26..f3ac385b3c 100644 --- a/source/dnode/vnode/src/meta/metaTable.c +++ b/source/dnode/vnode/src/meta/metaTable.c @@ -153,7 +153,7 @@ int metaUpdateMetaRsp(tb_uid_t uid, char *tbName, SSchemaWrapper *pSchema, STabl return terrno; } - pMetaRsp->pSchemaExt = taosMemoryMalloc(pSchema->nCols * sizeof(SSchemaExt)); + pMetaRsp->pSchemaExt = taosMemoryCalloc(1, pSchema->nCols * sizeof(SSchemaExt)); if (pMetaRsp->pSchemaExt == NULL) { taosMemoryFree(pMetaRsp->pSchemas); return terrno; From 685fa2c42d31a3f517140fc6bff45e899c0eab12 Mon Sep 17 00:00:00 2001 From: Linhe Huo Date: Sat, 22 Mar 2025 23:45:24 +0800 Subject: [PATCH 25/26] fix: windows ci error in 3.0 [ci skip] (#30357) --- source/client/test/CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/client/test/CMakeLists.txt b/source/client/test/CMakeLists.txt index 161deb12cd..0bbe5cb53f 100644 --- a/source/client/test/CMakeLists.txt +++ b/source/client/test/CMakeLists.txt @@ -38,7 +38,7 @@ TARGET_LINK_LIBRARIES( ADD_EXECUTABLE(userOperTest ../../../tests/script/api/passwdTest.c) TARGET_LINK_LIBRARIES( userOperTest - PUBLIC ${TAOS_NATIVE_LIB} + PUBLIC ${TAOS_NATIVE_LIB_STATIC} ) ADD_EXECUTABLE(stmt2Test stmt2Test.cpp) From 8ad8bc741a935f22dc4a6917bd3251ec25fa55e2 Mon Sep 17 00:00:00 2001 From: Linhe Huo Date: Sun, 23 Mar 2025 00:46:55 +0800 Subject: [PATCH 26/26] fix: userOperTest in linux (#30363) Co-authored-by: taos-support --- source/client/test/CMakeLists.txt | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/source/client/test/CMakeLists.txt b/source/client/test/CMakeLists.txt index 0bbe5cb53f..870d979eca 100644 --- a/source/client/test/CMakeLists.txt +++ b/source/client/test/CMakeLists.txt @@ -36,10 +36,17 @@ TARGET_LINK_LIBRARIES( #) ADD_EXECUTABLE(userOperTest ../../../tests/script/api/passwdTest.c) +if (TD_WINDOWS) TARGET_LINK_LIBRARIES( userOperTest PUBLIC ${TAOS_NATIVE_LIB_STATIC} ) +else() +TARGET_LINK_LIBRARIES( + userOperTest + PUBLIC ${TAOS_NATIVE_LIB} +) +endif() ADD_EXECUTABLE(stmt2Test stmt2Test.cpp) TARGET_LINK_LIBRARIES(