背景
不知不觉 Weekly report 已拖更三周,除了日常忙碌之外,也是觉得没有什么特别值得写的。
八月中旬的时候开始着手写一个工具 - bendsql(见33 weekly report),用来帮助用户更高效地操作 Databend Cloud,当时是用了大概一周的时间完成了这个项目,经过几周的内部使用和迭代,现在已经被用在 perf test 和 e2e test 中,跑得还算稳定QUQ,所以决定本周将其开源,让更多的用户/开发者使用并参与到产品的开发中。
bensql
在这里先简单介绍一下 Databend Cloud: Databend Cloud 由 Databend 强力驱动,是一款基于 Databend 内核打造的 SAAS 云数仓平台,具有简单、弹性、安全、速度快、成本低等特性,专注于云端大数据一站式解决方案,以解决传统大数据项目中运维难,成本高,使用复杂的问题。
bendsql
是一个为 Databend Cloud 打造的 Cli 工具,能够帮助用户高效地操作数仓平台,比如 list/create/delete warehouse, list stage, upload 文件,执行 SQL 等,提供跟 web 页面近乎一致的体验。
How to use
在使用 bendsql
之前,需要现在 Databend Cloud
上申请注册账号,然后在 下载页面 找到对应平台的二进制包下载安装。
- auth login
首先用注册的账号登录,
1 | bendsql auth login |
登录过程中选择需要使用的组织,直接回车使用默认组织。
当然,登录后也可以使用 bendsql configure --org YOURORG
来修改。
- 操作 warehouse
使用bendsql
就可以完成对 warehouse 的所有操作,1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16USAGE
bendsql warehouse cmd [flags]
CORE COMMANDS
create: Create a warehouse
delete: Delete a warehouse
ls: show warehouse list
resume: Resume a warehouse
status: show warehouse status
suspend: Suspend a warehouse
INHERITED FLAGS
--help Show help for command
LEARN MORE
Use 'bendsql <command> <subcommand> --help' for more information about a command.
参考使用文档即可,这里就不详细展开了。
- 操作 stage
1
2
3
4
5
6
7
8
9
10
11
12
13
14Operate stage
USAGE
bendsql stage <command> [flags]
CORE COMMANDS
ls: List stage or files in stage
upload: Upload file to stage using warehouse
INHERITED FLAGS
--help Show help for command
LEARN MORE
Use 'bendsql <command> <subcommand> --help' for more information about a command.
可以使用 bendsql
很方便地将文件上传到 stage 中。也可以查看目标 stage 中的文件情况。
- Exec SQL
bendsql
可以来执行 SQL 语句,
假如你执行的 SQL 语句比较耗费资源,可以在执行 SQL 的同时指定使用更大规格的 warehouse,
1 | bendsql query --sql YOURSQL --warehouse WAREHOUSE |
但是这种执行 SQL 的方式对用户来说不太友好,后面的 RoadMap 中会考虑支持 bendsql query
就进入到交互式 SQL 的环境中,再支持命令补全后,体验就大幅提升了。
关于使用就先介绍这些,感兴趣的可以下载安装 bendsql -h
后继续探索。
彩蛋❀ 最开始的时候这个工具并不是叫
bendsql
,而是bendctl
,大家觉得bendctl
这个命名太过于工程师化了 =.=,经过讨论最后改为bendsql
。
以上。往期文章可以访问 https://cloudsjhan.github.io/ 继续阅读。