跳到主要内容

数据源

网关前缀：${API_BASE}/metadata/datasources/...

DTO 字段说明（DataSourceDto）​

  • id 字符串（返回时）
  • name 字符串，必填，唯一数据源名称
  • type 字符串，必填，数据库类型，如 POSTGRES、MYSQL
  • jdbcUrl 字符串，必填，JDBC连接串
  • username 字符串，可选，数据库用户名
  • password 字符串，可选，数据库密码
  • active 布尔，可选，是否激活

创建数据源​

  • POST /datasources
  • 示例：
curl -X POST \
  "${API_BASE}/metadata/datasources" \
  -H "Content-Type: application/json" \
  -d '{
    "name":"main_db",
    "type":"POSTGRES",
    "jdbcUrl":"jdbc:postgresql://db.local:5432/aidaas",
    "username":"dbuser",
    "password":"secret",
    "active": true
  }'

更新数据源​

  • PUT /datasources/{id}
  • 参数组合示例：只切换激活状态
curl -X PUT \
  "${API_BASE}/metadata/datasources/ds-1001" \
  -H "Content-Type: application/json" \
  -d '{"active": false}'

按ID/名称获取​

  • GET /datasources/{id}
  • GET /datasources/name/{name}
  • 示例：
curl -X GET "${API_BASE}/metadata/datasources/ds-1001"
curl -X GET "${API_BASE}/metadata/datasources/name/main_db"

分页查询与活跃列表​

  • GET /datasources?search=&type=&isActive=&page=&size=&sortBy=&sortDirection=
  • GET /datasources/active
  • 示例：
curl "${API_BASE}/metadata/datasources?search=main&page=0&size=10"
curl "${API_BASE}/metadata/datasources/active"

删除数据源​

  • DELETE /datasources/{id}
curl -X DELETE "${API_BASE}/metadata/datasources/ds-1001"

连接测试​

  • POST /datasources/{id}/test（按ID）
  • POST /datasources/test（提供配置）
curl -X POST "${API_BASE}/metadata/datasources/ds-1001/test"
curl -X POST "${API_BASE}/metadata/datasources/test" -H "Content-Type: application/json" \
  -d '{"type":"POSTGRES","jdbcUrl":"jdbc:postgresql://db.local:5432/aidaas","username":"dbuser","password":"secret"}'

激活/停用切换​

  • PUT /datasources/{id}/toggle?active=true|false
curl -X PUT "${API_BASE}/metadata/datasources/ds-1001/toggle?active=false"

表结构发现​

  • GET /datasources/{id}/tables
  • GET /datasources/{id}/tables/{tableName}
curl -X GET "${API_BASE}/metadata/datasources/ds-1001/tables"
curl -X GET "${API_BASE}/metadata/datasources/ds-1001/tables/orders"