主题
.jdbc 数据源连接元数据
数据源连接是 SuccApp 数据接入的系统级基础设施，描述数据库连接器、JDBC URL、认证信息、schema/catalog、连接池、超时和连接能力重载等内容，供数据模型、数据加工、查询执行和系统管理功能统一使用。
jdbc 文件只放在 sysdata/data/sources/*.jdbc，一个 SuccApp 部署环境可以连接多个数据源，每个数据源通常对应一个 jdbc 配置文件。普通项目不保存 jdbc 文件；需要使用某个系统数据源时，应通过项目可用数据源把该数据源加入项目可用范围。
当一个部署环境需要接入新的业务库、数据仓库、外部数据库或特殊 JDBC 连接器时，应维护 jdbc。普通元数据项目只通过项目设置选择可用数据源，不应把系统级连接配置复制进项目目录。
jdbc 使用 JSONC 格式，可以在文件中写注释。文件名通常就是数据源名称；没有显式写 name 时，系统会按配置文件名识别数据源。
配置边界
- 系统数据源连接信息保存在
sysdata/data/sources/*.jdbc。 - 普通项目通过项目设置的项目可用数据源引用系统数据源。
- 数据源名称、默认 schema/catalog、连接池、超时和连接能力会影响所有引用该数据源的项目。
- 密码、令牌和生产连接信息不应出现在公开示例或普通 Git diff 中。
