使用 BendSQL 连接自建 Databend
本教程将指导你如何使用 BendSQL 连接自建 Databend 实例。
1
开始之前
- 请先在本地安装 Docker，用于启动 Databend。
- 请先安装 BendSQL，参见 安装 BendSQL。
2
启动 Databend
在终端运行以下命令启动 Databend：
docker run -d --name databend \
-e QUERY_DEFAULT_USER=eric \
-e QUERY_DEFAULT_PASSWORD=abc123 \
-p 3307:3307 -p 8000:8000 -p 8124:8124 -p 8900:8900 \
datafuselabs/databend:nightly
该命令会在本地 Docker 容器中启动 Databend，连接信息如下：
- Host：
127.0.0.1 - Port：
8000 - User：
eric - Password：
abc123
3
启动 BendSQL
Databend 成功运行后，即可通过 BendSQL 连接。在终端执行：
bendsql --host 127.0.0.1 --port 8000 --user eric --password abc123
该命令会使用 HTTP API 连接到 127.0.0.1:8000，用户名 eric、密码 abc123。成功连接后会看到类似输出：
Welcome to BendSQL 0.24.7-ff9563a(2024-12-27T03:23:17.723492000Z).
Connecting to 127.0.0.1:8000 as user eric.
Connected to Databend Query v1.2.725-nightly-25ee2d6e65(rust-1.88.0-nightly-2025-04-16T13:54:25.363718584Z)
Loaded 1432 auto complete keywords from server.
Started web server at 127.0.0.1:8080
4
执行查询
连接成功后即可在 BendSQL shell 内执行 SQL。例如输入 SELECT NOW(); 查询当前时间：
eric@127.0.0.1:8000/default> SELECT NOW();
SELECT NOW()
┌────────────────────────────┐
│ now() │
│ Timestamp │
├────────────────────────────┤
│ 2025-04-24 13:24:06.640616 │
└────────────────────────────┘
1 row read in 0.025 sec. Processed 1 row, 1 B (40 rows/s, 40 B/s)
