下载与安装

更新时间：2026-07-24

tsdb-cli 是百度智能云为 TSDB 专享版提供的命令行工具，支持管理 Database、Table、Retention 和 Token，以及执行 Query 和 Write 操作。

支持平台和下载地址

当前版本为 3.1.0，发布时间为 2026-07-13。请选择与运行环境匹配的制品，其他 OS / Arch 暂不在支持范围内。

OS / Arch	最低运行要求	下载地址	校验文件	SHA-256
Linux AMD64	x86-64，glibc 2.17 或更高版本	tsdb-cli-3.1.0-linux-amd64.tar.gz	.sha256	`eeef1f34df9a7ef3ae388e3f704327a119a42082ff869802818f41ff10de1e28`
macOS ARM64	Apple Silicon Mac	tsdb-cli-3.1.0-darwin-arm64.tar.gz	.sha256	`b33d30e74e887e2541ebe6d34cc1020265f1642d88a1a74d9c4619c178dcbecb`

每个压缩包的同路径还提供 .sha256 校验文件。版本化下载路径不可变，同一版本、平台和文件名的内容不会变化。

在 Linux AMD64 上安装

下载压缩包和校验文件：

                Bash
                
                VERSION='3.1.0'
FILE="tsdb-cli-${VERSION}-linux-amd64.tar.gz"
curl -fLO "https://tsdb-cli.bj.bcebos.com/${VERSION}/${FILE}"
curl -fLO "https://tsdb-cli.bj.bcebos.com/${VERSION}/${FILE}.sha256"

校验并安装到当前用户目录：

                Bash
                
            

                FILE='tsdb-cli-3.1.0-linux-amd64.tar.gz'
sha256sum -c "${FILE}.sha256"
tar -xzf "${FILE}"
mkdir -p "${HOME}/.local/bin"
install -m 0755 tsdb-cli "${HOME}/.local/bin/tsdb-cli"
export PATH="${HOME}/.local/bin:${PATH}"
            

如果 ~/.local/bin 尚未加入 PATH，请按照当前 Shell 的配置方式加入后重新打开终端。

在 macOS ARM64 上安装

下载压缩包和校验文件：

                Bash
                
                VERSION='3.1.0'
FILE="tsdb-cli-${VERSION}-darwin-arm64.tar.gz"
curl -fLO "https://tsdb-cli.bj.bcebos.com/${VERSION}/${FILE}"
curl -fLO "https://tsdb-cli.bj.bcebos.com/${VERSION}/${FILE}.sha256"

校验并安装到当前用户目录：

                Bash
                
            

                FILE='tsdb-cli-3.1.0-darwin-arm64.tar.gz'
shasum -a 256 -c "${FILE}.sha256"
tar -xzf "${FILE}"
mkdir -p "${HOME}/.local/bin"
install -m 0755 tsdb-cli "${HOME}/.local/bin/tsdb-cli"
export PATH="${HOME}/.local/bin:${PATH}"
            

验证安装

执行以下命令确认当前终端使用的是预期版本：

Bash

1tsdb-cli --version
2tsdb-cli --help

tsdb-cli --version 应输出 tsdb-cli 3.1.0。

配置集群连接信息

设置集群连接地址和访问令牌（在集群详情页获取，见连接地址与认证）：

                Bash
                
                export TSDB_HOST_URL='http://<访问地址>:<端口>'
export TSDB_AUTH_TOKEN='<访问令牌>'

以上示例使用环境变量，便于连续执行多条命令。单次调用时，也可以通过 --host 和 --token 参数传入连接信息。

需要数据库上下文的命令还可以配置：

                Bash
                
                export TSDB_DATABASE_NAME='mydb'

全局选项

选项	环境变量	说明
`-H, --host <URL>`	`TSDB_HOST_URL`	由访问地址和端口组成的完整 HTTP URL。
`--token <TOKEN>`	`TSDB_AUTH_TOKEN`	访问令牌。
`-d, --database <NAME>`	`TSDB_DATABASE_NAME`	Table、Query 和 Write 命令使用的目标数据库。

命令行参数适合单次调用；需要连续执行多条命令时，可以使用环境变量。显式传入的命令行参数优先于环境变量。

升级

tsdb-cli 不提供内置升级命令。升级时按新版本对应的平台下载地址重新下载制品，验证 SHA-256 后替换现有二进制，再执行 tsdb-cli --version 确认版本。不要跳过校验，也不要用其他平台的二进制覆盖当前安装。

卸载

删除安装的二进制即可：

                Bash
                
                rm "${HOME}/.local/bin/tsdb-cli"

如已在 Shell 配置文件中持久化 TSDB_* 环境变量，请同时删除相应配置。卸载 CLI 不会删除 TSDB 专享版中的 Database、Table、数据或业务访问令牌。

命令范围

命令	用途
`database create/list/update/delete`	管理 Database 和 Database 级 Retention。
`table create/list/update/delete`	管理 Table、Schema 和 Table 级 Retention。
`retention list`	查看 Database 与 Table 的有效 Retention。
`token create/list/regenerate/delete`	管理命名业务访问令牌。
`query`（别名 `q`）	执行 SQL 并输出表格、JSON、CSV 或 Parquet。
`write`（别名 `w`）	从参数、文件或标准输入写入 Line Protocol。

完整用法请继续查看管理 Database 与 Retention、管理 Table、管理 Token和查询与写入。

评价此篇文章

有帮助没帮助

百度智能云

时序时空数据库 TSDB