---
title: .jdbc 数据源连接元数据
description: .jdbc 数据源连接文件阅读入口，指向系统数据源、数据库连接器、JDBC URL、连接池和连接能力的 DTS 说明
navTitle: .jdbc
---
# .jdbc 数据源连接元数据

数据源连接是 SuccApp 数据接入的系统级基础设施，描述数据库连接器、JDBC URL、认证信息、schema/catalog、连接池、超时和连接能力重载等内容，供数据模型、数据加工、查询执行和系统管理功能统一使用。

jdbc 文件只放在 `sysdata/data/sources/*.jdbc`，一个 SuccApp 部署环境可以连接多个数据源，每个数据源通常对应一个 jdbc 配置文件。普通项目不保存 jdbc 文件；需要使用某个系统数据源时，应通过项目可用数据源把该数据源加入项目可用范围。

当一个部署环境需要接入新的业务库、数据仓库、外部数据库或特殊 JDBC 连接器时，应维护 jdbc。普通元数据项目只通过项目设置选择可用数据源，不应把系统级连接配置复制进项目目录。

jdbc 使用 JSONC 格式，可以在文件中写注释。文件名通常就是数据源名称；没有显式写 `name` 时，系统会按配置文件名识别数据源。

## 配置边界{#config-boundary}

- 系统数据源连接信息保存在 `sysdata/data/sources/*.jdbc`。
- 普通项目通过项目设置的项目可用数据源引用系统数据源。
- 数据源名称、默认 schema/catalog、连接池、超时和连接能力会影响所有引用该数据源的项目。
- 密码、令牌和生产连接信息不应出现在公开示例或普通 Git diff 中。

## DTS 入口{#types}

- 根结构：[`types/meta/file-types/jdbc-conf.d.ts`](../../../../../dev-types/types/meta/file-types/jdbc-conf.d.ts)
- 项目设置：[`types/meta/file-types/project-settings.d.ts`](../../../../../dev-types/types/meta/file-types/project-settings.d.ts)
- 数据库连接器扩展：[`types/extension/succ.dbconnector.d.ts`](../../../../../dev-types/types/extension/succ.dbconnector.d.ts)
- 数据库资源和 DW 通用类型：[`types/dw-meta-types.d.ts`](../../../../../dev-types/types/dw-meta-types.d.ts)