Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
taosdata
TDengine
提交
b5073a5d
T
TDengine
项目概览
taosdata
/
TDengine
1 年多 前同步成功
通知
1185
Star
22016
Fork
4786
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
1
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
T
TDengine
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
1
Issue
1
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
b5073a5d
编写于
4月 18, 2022
作者:
陶建辉(Jeff)
提交者:
GitHub
4月 18, 2022
浏览文件
操作
浏览文件
下载
差异文件
Merge pull request #11624 from taosdata/docs/jtao1735-doc3
Update 08-taos-shell.md
上级
49484724
cbd7a38d
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
42 addition
and
14 deletion
+42
-14
docs-cn/14-reference/08-taos-shell.md
docs-cn/14-reference/08-taos-shell.md
+42
-14
未找到文件。
docs-cn/14-reference/08-taos-shell.md
浏览文件 @
b5073a5d
...
...
@@ -4,42 +4,75 @@ sidebar_label: TDengine CLI
description
:
TDengine CLI 的使用说明和技巧
---
TDengine 命令行
(以下简称 TDengine CLI)是用户操作 TDengine
并与之交互的最简洁最常用的方式。
TDengine 命令行
程序(以下简称 TDengine CLI)是用户操作 TDengine 实例
并与之交互的最简洁最常用的方式。
## 基本使用
请参考
[
这里
](
/get-started/
)
## 安装
如果在 TDengine 服务器端执行,无需任何安装,已经自动安装好。如果要在非 TDengine 服务器端运行,需要安装 TDengine 客户端驱动,具体安装,请参考
[
连接器
](
/reference/connector/
)
。
## 执行
要进入 TDengine CLI,您只要在 Linux 终端或Windos 终端执行
`taos`
即可。
```
bash
taos
```
如果连接服务成功,将会打印出欢迎消息和版本信息。如果失败,则会打印错误消息出来(请参考
[
FAQ
](
/train-fqa/faq
)
来解决终端连接服务端失败的问题)。TDengine CLI 的提示符号如下:
```
cmd
taos>
```
进入CLI后,你可执行各种SQL语句,包括插入、查询以及各种管理命令。
## 执行 SQL 脚本
在 TDengine CLI 里可以通过
`source`
命令来运行 SQL 命令脚本。
```
sql
taos
>
source
<
filename
>
;
```
## 在线修改显示字符宽度
可以在 TDengine CLI 里使用如下命令调整字符显示宽度
```
sql
SET
MAX_BINARY_DISPLAY_WIDTH
<
nn
>
;
```
如显示的内容后面以...结尾时,表示该内容已被截断,可通过本命令修改显示字符宽度以显示完整的内容。
## 命令行参数
您可通过配置命令行参数来改变 TDengine CLI 的行为。以下为常用的几个命令行参数:
-
-h, --host=HOST: 要连接的 TDengine 服务端所在服务器的 FQDN, 默认为连接本地服务
-
-P, --port=PORT: 指定服务端所用端口号
-
-u, --user=USER: 连接时使用的用户名
-
-p, --password=PASSWORD: 连接服务端时使用的密码
-
-?, --help: 打印出所有命令行参数
还有更多其他参数:
-
-c, --config-dir: 指定配置文件目录,默认为
`/etc/taos`
,该目录下的配置文件默认名称为 taos.cfg
-
-C, --dump-config: 打印 -c 指定的目录中 taos.cfg 的配置参数
-
-d, --database=DATABASE: 指定连接到服务端时使用的数据库
-
-D, --directory=DIRECTORY: 导入指定路径中的 SQL 脚本文件
-
-f, --file=FILE: 以非交互模式执行 SQL 脚本文件
-
-h, --host=HOST: 要连接的 TDengine 服务端所在服务器的 FQDN, 默认为连接本地服务
-
-k, --check=CHECK: 指定要检查的表
-
-l, --pktlen=PKTLEN: 网络测试时使用的测试包大小
-
-n, --netrole=NETROLE: 网络连接测试时的测试范围,默认为 startup, 可选值为 client, server, rpc, startup, sync, speed, fqdn
-
-p, --password=PASSWORD: 连接服务端时使用的密码
-
-P, --port=PORT: 指定服务端所用端口号
-
-r, --raw-time: 将时间输出出 uint64_t
-
-s, --commands=COMMAND: 以非交互模式执行的 SQL 命令
-
-S, --pkttype=PKTTYPE: 指定网络测试所用的包类型,默认为 TCP。只有 netrole 为 speed 时既可以指定为 TCP 也可以指定为 UDP
-
-T, --thread=THREADNUM: 以多线程模式导入数据时的线程数
-
-u, --user=USER: 连接时使用的用户名
-
-s, --commands: 在不进入终端的情况下运行 TDengine 命令
-
-z, --timezone=TIMEZONE: 指定时区,默认为本地
-
-V, --version: 打印出当前版本号
-
-?, --help: 打印出所有命令行参数
示例:
```
bash
taos
-h
h1.taos.com
-s
"use db; show tables;"
```
## TDengine CLI 小技巧
-
可以使用上下光标键查看历史输入的指令
...
...
@@ -48,8 +81,3 @@ taos -h h1.taos.com -s "use db; show tables;"
-
执行
`RESET QUERY CACHE`
可清除本地缓存的表 schema
-
批量执行 SQL 语句。可以将一系列的 shell 命令(以英文 ; 结尾,每个 SQL 语句为一行)按行存放在文件里,在 shell 里执行命令
`source <file-name>`
自动执行该文件里所有的 SQL 语句
-
输入 q 回车,退出 taos shell
-
在线修改显示字符宽度
```
sql
SET
MAX_BINARY_DISPLAY_WIDTH
<
nn
>
;
```
如显示的内容后面以...结尾时,表示该内容已被截断,可通过本命令修改显示字符宽度以显示完整的内容。
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录