MapForce配置数据库连接需确保驱动兼容性，正确安装匹配位数和JRE版本的JDBC驱动；Database Input仅作只读输入，连接配置须手动保存为.dbconn文件；字段类型与XML Schema需严格对应，NULL字段应设minOccurs="0"；生成代码中的连接信息必须人工替换为外部配置以保障安全。
MapForce 中配置数据库连接前必须确认驱动兼容性
MapForce 本身不内置数据库驱动，所有 JDBC/ODBC 连接依赖本地已安装的驱动程序。如果你在 Database Connection 向导中看不到目标数据库（如 PostgreSQL、SQL Server），大概率是驱动未正确注册或版本不匹配。32 位 MapForce 只能加载 32 位 JDBC 驱动 JAR，64 位同理；混合会导致 ClassNotFoundException 或空列表。
- MySQL：使用
mysql-connector-java-8.0.x.jar（8.0+ 要求显式设置allowPublicKeyRetrieval=true&useSSL=false） - PostgreSQL：推荐
postgresql-42.6.x.jar，避免用过时的pg74.215.jdbc3.jar - SQL Server：用
mssql-jdbc-12.4.2.jre11.jar，JRE 版本必须与 MapForce 运行环境一致 - Oracle：需
ojdbc8.jar（对应 Oracle 12c/19c），且不能用ojdbc6.jar在 Java 11+ 下运行
在 Mapping Designer 中添加 Database Input 时的关键步骤
不是所有“数据库节点”都等价：Database Input 是只读数据源，用于映射输入；Database Output 才支持写入。右键画布 → Add Component → Database Input，此时会弹出连接向导——但注意：它不会自动保存连接配置到项目，每次新建映射都要重选或手动导入已存连接文件（.dbconn）。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 连接测试成功后，务必点击
Save As...保存为独立.dbconn文件，否则关闭向导即丢失 - 表选择界面支持多选，但勾选多个表时生成的 SQL 默认是
CROSS JOIN，非业务所需关联方式需手动编辑 SQL（右键节点 →Edit SQL Statement） - 字段别名（AS）会被 MapForce 识别为输出列名，影响后续 XML 元素命名；若希望保持原始列名，SQL 中不要用
AS
XML Schema 与数据库字段类型映射的隐式规则
MapForce 不做强类型校验，但字段类型错配会导致运行时报错或数据截断。例如将数据库 VARCHAR(10) 映射到 XML Schema 中定义为 xsd:integer 的元素，在生成 XSLT 或代码时可能静默失败，实际执行时抛出 NumberFormatException。
-
DATE/TIMESTAMP→ 默认映射为xsd:date或xsd:dateTime，但 Oracle 的DATE实际含时间部分，建议统一用xsd:dateTime -
DECIMAL(p,s)→ 对应xsd:decimal，若 Schema 写成xsd:float，精度可能丢失 -
BIT（SQL Server）或BOOLEAN（PostgreSQL）→ 必须映射到xsd:boolean，值为1/0或true/false，不能映射到字符串 - NULL 值处理：数据库字段允许 NULL 时，对应 XML 元素应设
minOccurs="0"，否则生成 XML 时会强制填充默认值（如空字符串）
生成可执行代码时数据库连接信息如何安全传递
MapForce 导出的 Java/.NET/Python 代码默认把连接参数（URL、用户名、密码）硬编码在源文件里，这不符合生产环境要求。你必须手动替换为外部配置读取逻辑，且注意不同语言的注入点不同。
- Java 输出：查找
getConnection()方法体，将"jdbc:mysql://..."替换为Config.getProperty("db.url") - .NET 输出：修改
GetConnection()中的new SqlConnection(...)字符串拼接，改用ConfigurationManager.ConnectionStrings["MyDB"].ConnectionString - Python 输出：搜索
create_engine('sqlite:///...')类调用，改为从os.environ或configparser加载 - 密码明文问题：MapForce 不支持密钥库或加密配置项，所有敏感字段必须人工脱敏，不可保留在工程内
public static Connection getConnection() throws SQLException {
// ❌ 不要这样
return DriverManager.getConnection("jdbc:postgresql://localhost:5432/mydb", "admin", "p@ssw0rd");
// ✅ 应改为
String url = Config.get("db.url");
String user = Config.get("db.user");
String pass = Config.get("db.pass");
return DriverManager.getConnection(url, user, pass);
}
MapForce 的数据库映射能力足够完成常规 ETL 场景，但它的连接管理是静态的、生成代码是半托管的——这意味着任何涉及连接池、事务控制、动态查询参数或权限隔离的需求，都得靠人工补全，而不是依赖工具自动生成。 
