From 9b0f45345088f30a06dbfbf87616a60cdad250fb Mon Sep 17 00:00:00 2001 From: Haojun Liao Date: Mon, 24 Mar 2025 00:11:24 +0800 Subject: [PATCH 1/2] Merge pull request #30383 from taosdata/doc/analysis doc: Update 09-tutorial.md --- docs/zh/06-advanced/06-TDgpt/09-tutorial.md | 75 ++++++++++++++++++++- 1 file changed, 74 insertions(+), 1 deletion(-) diff --git a/docs/zh/06-advanced/06-TDgpt/09-tutorial.md b/docs/zh/06-advanced/06-TDgpt/09-tutorial.md index 5877e6a122..365466d13a 100644 --- a/docs/zh/06-advanced/06-TDgpt/09-tutorial.md +++ b/docs/zh/06-advanced/06-TDgpt/09-tutorial.md @@ -1,4 +1,77 @@ --- title: "快速体验" sidebar_label: "快速体验" ---- \ No newline at end of file +--- + +# 通过 Docker 快速体验 +本节首先介绍如何通过 Docker 快速体验 TDgpt。 + +## 启动 TDgpt + +如果已经安装了 Docker，首先拉取最新的 TDengine 容器镜像： + +```shell +docker pull tdengine/tdengine:latest +``` + +或者指定版本的容器镜像： + +```shell +docker pull tdengine/tdengine:3.3.3.0 +``` + +然后只需执行下面的命令： + +```shell +docker run -d -p 6030:6030 -p 6041:6041 -p 6043:6043 -p 6044-6049:6044-6049 -p 6044-6045:6044-6045/udp -p 6060:6060 tdengine/tdengine +``` + +注意：TDgpt 服务端使用 6090 TCP 端口。TDgpt 是一个无状态时序数据分析智能体，并不会在本地持久化保存数据，仅根据配置可能在本地生成运行日志。 + + +确定该容器已经启动并且在正常运行。 + +```shell +docker ps +``` + +进入该容器并执行 `bash` + +```shell +docker exec -it bash +``` + +然后就可以执行相关的 Linux 命令操作和访问 TDengine。 + +# 通过安装包快速体验 + +## 获取安装包 + +1. 从列表中下载获得 tar.gz 安装包： + +2. 进入到安装包所在目录，使用 `tar` 解压安装包； +3. 进入到安装包所在目录，先解压文件后，进入子目录，执行其中的 install.sh 安装脚本。 + +> 请将 `` 替换为下载的安装包版本 + +```bash +tar -zxvf TDengine-anode--Linux-x64.tar.gz +``` + +解压文件后，进入相应子目录，执行其中的 `install.sh` 安装脚本： + +```bash +sudo ./install.sh +``` + + +## 安装部署使用 +请参考[安装部署指南](./management) 准备环境，并安装部署 TDgpt。 + + +# 通过云服务快速体验 +TDgpt 可以在云服务上进行快速体验，如果您已经有云服务账号，那么直接建立 TDgpt 的服务实例，并参考用户手册将其注册到TDengine 实例中。如果您在 TDengine Cloud 中没有实例，请参考[用云服务快速体验](../../../cloud) 获得 TDengine 云服务上的实例。 + +然后选择创建 TDgp 实例即可。 +之后请参考[anode基本操作](./management) 管理 anode。 + From 18f35f2118c8f804223ce0cb751f45d707c7401a Mon Sep 17 00:00:00 2001 From: Jing Sima Date: Mon, 24 Mar 2025 09:27:39 +0800 Subject: [PATCH 2/2] docs: [TS-4897] modify pics of virtual table. (#30388) --- docs/en/14-reference/03-taos-sql/05-virtualtable.md | 0 .../03-taos-sql/{05-insert.md => 06-insert.md} | 0 .../03-taos-sql/{06-select.md => 07-select.md} | 0 .../03-taos-sql/{07-tag-index.md => 08-tag-index.md} | 0 .../{08-delete-data.md => 09-delete-data.md} | 0 docs/zh/05-basic/01-model.md | 6 ++++-- .../{34-virtualtable.md => 05-virtualtable.md} | 11 ++++++++--- .../03-taos-sql/{05-insert.md => 06-insert.md} | 0 .../03-taos-sql/{06-select.md => 07-select.md} | 0 .../03-taos-sql/{07-tag-index.md => 08-tag-index.md} | 0 .../{08-delete-data.mdx => 09-delete-data.mdx} | 0 11 files changed, 12 insertions(+), 5 deletions(-) create mode 100644 docs/en/14-reference/03-taos-sql/05-virtualtable.md rename docs/en/14-reference/03-taos-sql/{05-insert.md => 06-insert.md} (100%) rename docs/en/14-reference/03-taos-sql/{06-select.md => 07-select.md} (100%) rename docs/en/14-reference/03-taos-sql/{07-tag-index.md => 08-tag-index.md} (100%) rename docs/en/14-reference/03-taos-sql/{08-delete-data.md => 09-delete-data.md} (100%) rename docs/zh/14-reference/03-taos-sql/{34-virtualtable.md => 05-virtualtable.md} (97%) rename docs/zh/14-reference/03-taos-sql/{05-insert.md => 06-insert.md} (100%) rename docs/zh/14-reference/03-taos-sql/{06-select.md => 07-select.md} (100%) rename docs/zh/14-reference/03-taos-sql/{07-tag-index.md => 08-tag-index.md} (100%) rename docs/zh/14-reference/03-taos-sql/{08-delete-data.mdx => 09-delete-data.mdx} (100%) diff --git a/docs/en/14-reference/03-taos-sql/05-virtualtable.md b/docs/en/14-reference/03-taos-sql/05-virtualtable.md new file mode 100644 index 0000000000..e69de29bb2 diff --git a/docs/en/14-reference/03-taos-sql/05-insert.md b/docs/en/14-reference/03-taos-sql/06-insert.md similarity index 100% rename from docs/en/14-reference/03-taos-sql/05-insert.md rename to docs/en/14-reference/03-taos-sql/06-insert.md diff --git a/docs/en/14-reference/03-taos-sql/06-select.md b/docs/en/14-reference/03-taos-sql/07-select.md similarity index 100% rename from docs/en/14-reference/03-taos-sql/06-select.md rename to docs/en/14-reference/03-taos-sql/07-select.md diff --git a/docs/en/14-reference/03-taos-sql/07-tag-index.md b/docs/en/14-reference/03-taos-sql/08-tag-index.md similarity index 100% rename from docs/en/14-reference/03-taos-sql/07-tag-index.md rename to docs/en/14-reference/03-taos-sql/08-tag-index.md diff --git a/docs/en/14-reference/03-taos-sql/08-delete-data.md b/docs/en/14-reference/03-taos-sql/09-delete-data.md similarity index 100% rename from docs/en/14-reference/03-taos-sql/08-delete-data.md rename to docs/en/14-reference/03-taos-sql/09-delete-data.md diff --git a/docs/zh/05-basic/01-model.md b/docs/zh/05-basic/01-model.md index 904d43d4e3..c8a6646983 100644 --- a/docs/zh/05-basic/01-model.md +++ b/docs/zh/05-basic/01-model.md @@ -3,6 +3,8 @@ sidebar_label: 数据模型 title: TDengine 数据模型 toc_max_heading_level: 4 --- +import origintable from './data-model-origin-table.png'; +import origintable2 from './data-model-origin-table-2.png'; 为了清晰地阐述时序数据的基本概念，并为示例程序的编写提供便利，整个文档都将以智能电表为例，探讨时序数据的典型应用场景。设想有一种型号的智能电表，它能够采集 电流、电压和相位这 3 个模拟量。此外，每块智能电表还具有位置和分组等静态属性。这些智能电表采集的数据示例如下表所示。 @@ -355,7 +357,7 @@ TAGS ( 以设备 d1001 为例，假设 d1001 设备的电流、电压、相位数据如下： -![data-model-origin-table.png](data-model-origin-table.png) +data-model-origin-table 虚拟表 d1001_v 中的数据如下: @@ -388,7 +390,7 @@ CREATE VTABLE current_v ( 假设 d1001, d1002, d1003, d1004 四个设备的电流数据如下： -![data-model-origin-table-2.png](data-model-origin-table-2.png) +data-model-origin-table-2 虚拟表 current_v 中的数据如下： diff --git a/docs/zh/14-reference/03-taos-sql/34-virtualtable.md b/docs/zh/14-reference/03-taos-sql/05-virtualtable.md similarity index 97% rename from docs/zh/14-reference/03-taos-sql/34-virtualtable.md rename to docs/zh/14-reference/03-taos-sql/05-virtualtable.md index 976e48acbd..54c150ab4f 100644 --- a/docs/zh/14-reference/03-taos-sql/34-virtualtable.md +++ b/docs/zh/14-reference/03-taos-sql/05-virtualtable.md @@ -3,6 +3,11 @@ sidebar_label: 虚拟表 title: 虚拟表 description: 对虚拟表的各种管理操作 --- + +import origintable from './pic/virtual-table-origin-table.png'; +import queryres from './pic/virtual-table-query-res.png'; +import partres from './pic/virtual-table-query-res-part.png'; + ## 创建虚拟表 `CREATE VTABLE` 语句用于创建普通虚拟表和以虚拟超级表为模板创建虚拟子表。 @@ -68,7 +73,7 @@ CREATE VTABLE [IF NOT EXISTS] [db_name].vtb_name 假设有表 t1、t2、t3 结构和数据如下： -![virtual-table-origin-table.png](pic/virtual-table-origin-table.png) +origintable 并且有虚拟普通表 v1 ，创建方式如下： @@ -89,7 +94,7 @@ select * from v1; 结果如下： -![virtual-table-query-res.png](pic/virtual-table-query-res.png) +queryres 如果没有选择全部列，只是选择了部分列，查询的结果只会包含选择的列的原始表的时间戳，例如执行如下查询： @@ -99,7 +104,7 @@ select c1, c2 from v1; 得到的结果如下图所示： -![virtual-table-query-res-part.png](pic/virtual-table-query-res-part.png) +partres 因为 c1、c2 列对应的原始表 t1、t2 中没有 0:00:03 这个时间戳，所以最后的结果也不会包含这个时间戳。 diff --git a/docs/zh/14-reference/03-taos-sql/05-insert.md b/docs/zh/14-reference/03-taos-sql/06-insert.md similarity index 100% rename from docs/zh/14-reference/03-taos-sql/05-insert.md rename to docs/zh/14-reference/03-taos-sql/06-insert.md diff --git a/docs/zh/14-reference/03-taos-sql/06-select.md b/docs/zh/14-reference/03-taos-sql/07-select.md similarity index 100% rename from docs/zh/14-reference/03-taos-sql/06-select.md rename to docs/zh/14-reference/03-taos-sql/07-select.md diff --git a/docs/zh/14-reference/03-taos-sql/07-tag-index.md b/docs/zh/14-reference/03-taos-sql/08-tag-index.md similarity index 100% rename from docs/zh/14-reference/03-taos-sql/07-tag-index.md rename to docs/zh/14-reference/03-taos-sql/08-tag-index.md diff --git a/docs/zh/14-reference/03-taos-sql/08-delete-data.mdx b/docs/zh/14-reference/03-taos-sql/09-delete-data.mdx similarity index 100% rename from docs/zh/14-reference/03-taos-sql/08-delete-data.mdx rename to docs/zh/14-reference/03-taos-sql/09-delete-data.mdx