连接你的数据源

Beyondata 支持 MySQL、PostgreSQL、ClickHouse、BigQuery 等常见数据源。本文以 PostgreSQL 为例。

准备工作

确保你有:

• 数据库的连接地址(host:port)
• 一个只读账号(强烈建议)
• 网络可达性(Beyondata 服务能连到这个地址)

配置连接

控制台界面

1. 进入 控制台 → 数据源 → 新增
2. 选择 PostgreSQL,填入连接信息
3. 点「测试连接」,绿色对勾出现即成功

命令行

beyondata datasource add \
  --type postgres \
  --name 生产库 \
  --host db.internal.example.com \
  --port 5432 \
  --database analytics \
  --username readonly_user

回车后会提示输入密码。

配置文件

在 ~/.beyondata/datasources.yaml 添加:

datasources:
  - name: 生产库
    type: postgres
    host: db.internal.example.com
    port: 5432
    database: analytics
    username: readonly_user
    password_env: PG_READONLY_PASSWORD

然后:

beyondata datasource sync

权限建议

为 Beyondata 单独建一个只读账号,避免任何意外的写入:

CREATE USER beyondata_ro WITH PASSWORD 'strong-password-here';
GRANT CONNECT ON DATABASE analytics TO beyondata_ro;
GRANT USAGE ON SCHEMA public TO beyondata_ro;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO beyondata_ro;

:::warning 不要给写权限 即使你信任 Beyondata,LLM 偶尔会理解错问题。只读账号是最后一道防线。 :::

验证

连接成功后,试着问一个简单问题:

beyondata ask "users 表里现在有多少行?"