简介面向 SAP Data Services 初学者的 MySQL 连接操作指南重点解决如何通过 ODBC 配置跨数据库数据源的问题。资源是一个单独的 Word 文档压缩后体积约 1.43MB适合数据集成工程师、BI 开发人员在搭建 ETL 流程或数据仓库项目时随手查阅。文档按实际操作顺序展开从启动 SAP Business Objects Data Services 并创建新的数据存储开始逐步讲解选择 MySQL 数据库类型、填写服务器地址与登录账号、在 ODBC 管理器中新增数据源并执行连通性测试随后返回数据存储设置界面确认参数并保存再到导入当前已有的表元数据、查看表结构设计以及预览表中数据内容。整个过程覆盖了连接前的环境检查、连接参数配置、测试验证、元数据导入和最终使用等关键环节同时提醒用户确保 MySQL 服务处于启动状态、相关库表已经建立并考虑工具版本对目标数据库的兼容性以及账号密码安全、数据备份恢复等事项。目前已有 1618 人学习下载是一份可以直接对照操作的配置参考能帮助读者快速完成 SAP Data Services 与 MySQL 的集成提升数据抽取和转换的工作效率。1. Data Services 连 MySQL配好数据源不等于能跑批SAP Data Services 连接 MySQL 这件事我第一次做是在一个零售 ETL 项目里Data Services 负责把 MySQL 业务库的数据抽到 SAP BW设计器里确认连接成功的那一刻我以为任务完成了。结果到了跑批阶段Job Server 报数据源无法打开回查才知道 ODBC 层根本没配对。SAP Data Services 接 MySQL 的通道并不是内置 JDBC而是通过 ODBC 驱动中转这意味着你可以绕开 MySQL 安装、MySQL ODBC Driver 的各种版本坑但前提是你得把 DSN、驱动位数、DS 服务账号这三样一次性捋顺。这篇写给两类人一类是刚接手 Data Services需要把 MySQL 作为数据源的 ETL 开发另一类是已经配过 SQL Server、Oracle但第一次接 MySQL 的运维。目标只有一个——让 Data Services 的 Data Store 能用来导入表、跑抽取作业。2. 前置检查DS 版本、ODBC 驱动与 MySQL 端就绪2.1 先确认版本匹配关系我说“配好数据源不等于能跑批”根源就在版本矩阵上。SAP Data Services下文简称 DS从 14.x 到 16.x对 MySQL 的支持策略都是“通过 ODBC 接入”而不是像 SQL Server 那样走原生驱动。你在 New Datastore 向导里选择了 MySQLDS 实际做的事是打开一个已经存在于操作系统里的 ODBC DSN把用户名和密码透传给 MySQL Connector/ODBC。所以版本匹配要分三层来看DS 官方支持的 MySQL 版本、MySQL Connector/ODBC 的版本、MySQL 服务端版本。常见组合是这样DS 14.2 时代官方支持 MySQL 5.1 到 5.6常用 Connector/ODBC 5.2 或 5.3DS 16.0 之后支持 MySQL 5.7 和 8.0驱动则推荐 MySQL Connector/ODBC 8.0。我见过一套跑得很稳的经典配置DS 14.2.3 MySQL 5.7.44 Connector/ODBC 5.3也见过 DS 16 MySQL 8.0 用 5.3 驱动连接测试能通过一旦导入表列表就超时。如果你拿不准去 SAP Product Availability Matrix 查你 DS 小版本对应的 MySQL 版本号再决定装 5.3 还是 8.0。注意一点不要用最新驱动去连老 DSConnector/ODBC 8.0 安装后如果注册表里同时带 5.3DS 会默认抓 5.3 的 DSN反而容易混。MySQL 服务端的default_authentication_plugin在 5.7 是mysql_native_password8.0 默认变成了caching_sha2_password。这个问题放到避坑部分细说前置阶段你只要记住8.0 环境下尽量配 8.0 驱动否则认证协议不匹配DS 里报 Access denied。另外如果你用 Docker 部署 MySQL 8.0记得在环境变量里显式指定默认认证插件为老协议否则容器默认用新认证。2.2 ODBC 驱动的 32/64 位陷阱这一步是绝大多数“测试成功但跑批失败”的元凶。Data Services 的 Designer 和 Job Server 有各自的运行位宽老版本 DS 14.x 多为 32 位客户端Job Server 也可能部署成 32 位DS 16 之后才有 64 位。Windows 的 ODBC 管理工具也有两套C:\Windows\SysWOW64\odbcad32.exe是 32 位C:\Windows\System32\odbcad32.exe是 64 位。你装 Connector/ODBC 时如果只选了 64 位组件那么 64 位 DSN 只在 64 位管理器里可见32 位的 DS 客户端根本读不到——现象就是 DS 里找不到你创建的 DSN。我的做法是装驱动时 32 位和 64 位都装然后在对应位宽的管理器里各建一个同名 DSN。举例DS 14.2 是 32 位就在 SysWOW64 那个 odbcad32.exe 里建 System DSN名字叫mysql_ds如果这台机器上还有 64 位的其他程序要用 MySQL在 64 位管理器里也建一个mysql_ds。DSN 名称保持一致省得换客户端调试时来回改。判断 DS 位宽有一个笨办法看安装目录在Program Files (x86)还是在Program Files前者就是 32 位客户端。另外DSN 类型要用 System DSN不要用 User DSN。原因很实际Job Server 作为一个 Windows 服务运行登录账号很可能不是你在 Designer 里用的那个人User DSN 对服务账号不可见。你在设计器里测试 Data Store是在有权限的用户域里测的跑批时 Job Server 在另一个用户域里同一个 DSN 就不可见了这一层坑叫“用户可见性陷阱”也不为过。选择 System DSN 后DSN 对机器上所有登录账号和服务可见问题自然消失。2.3 MySQL 端准备账号、权限与服务检查在动 DS 之前先把 MySQL 侧准备好。不要用 root 去连数据集成工具用 root 账号既危险也容易触发 DS 对某些元数据查询的超时。我给这种场景建账号的原则是最小权限抽取只需要读表结构、读数据、读视图定义SQL 脚本如下-- 连接 MySQL 服务端执行 CREATE USER ds_user% IDENTIFIED BY Ds_2024#MySQL; GRANT SELECT, SHOW VIEW ON *.* TO ds_user%; FLUSH PRIVILEGES;逻辑说明第一条语句创建抽取专用账号%表示允许从任意主机连接如果你的 DS Job Server 和 MySQL 在同一台机器可以收紧成localhost。第二条授权只有SELECT和SHOW VIEW这是 DS 导入表 metadata 的最低要求SHOW VIEW用于读取视图定义纯表场景可以不加但加上更保险避免后续导入视图时报权限错误。FLUSH PRIVILEGES让授权立即生效。参数说明密码里的#、、这类字符在 ODBC 连接串里要求转义DS 的密码框会自动处理但如果你把密码写进 SQL 覆盖语句转义就得自己做这一点后面坑里再提。接着确认 MySQL 服务在监听 3306以及防火墙没有挡住 DS 所在服务器的访问# 在 MySQL 服务器上检查端口监听 netstat -an | grep 3306 # 在 DS 服务器上用 nc 验证 TCP 连通性 nc -zv mysql-host.example.com 3306逻辑说明第一条命令如果输出里能看到LISTENING状态的 3306 端口说明 MySQL 正常第二条在 DS 机器上以客户端模式连接目标端口能通才说明网络层没问题这一步可以直接排除“DS 配了但连不上”的物理链路因素。参数说明3306是 MySQL 默认端口如果实例改过端口两个地方的端口都要同步改。我见过一个翻车现场DS 机器到 MySQL 之间有个安全组策略ping 通、DNS 解析正常就是 3306 被静默丢弃telnet 一步就定位了。Windows 自带 telnet 通常够用没有就装个 telnet 客户端比反复在 DS 里点测试高效得多。3. 创建 Data Store参数填写与 ODBC 连接测试3.1 新建 Data Store 的三条路径打开 SAP Business Objects Data Services Designer输入连接信息进入工作区之后在界面右下角能找到 Data Store 标签页。标签页下面的空白区域右键弹出菜单里选 New也可以走菜单栏的 File → New → Datastore第三种是用快捷键 CtrlN在弹出的向导类型里选 Datastore。三条路径都能进入同一个新建向导区别在于右键方式默认把数据源加到当前工程视图里File 菜单方式可以让你先建好再决定挂在哪个 Job 下。实际上对于建 MySQL 连接我习惯只走右键Data Store 标签页旁边就是已有的 SQL Server、Oracle 等数据源新建出来的 MySQL 数据源会和它们并列展示后续导入表、查看 View Data 都在同一个面板里操作。向导界面第一个要你选的是 Datastore 类型下拉列表里选 MySQL。如果你看到的选项只有 ODBC 而没有 MySQL说明你的 DS 安装版本或补丁级别偏低官方把 MySQL 的接入类型隐藏了这种情况下优先升级 DS 补丁而不是强行用泛 ODBC 去接后者会在 metadata 读取上出现各种类型映射错误。还有一个细节容易被忽略向导里的类型列表一旦选了 ODBC Generic后续就没法在界面上切回 MySQL只能删掉重建。所以第一次进入向导时先确认下拉列表里 MySQL 是否存在再做选择。DS 14.2 和 16.0 的向导界面在这一步几乎是相同的后面的参数面板也一致下面的表格可以直接套用。3.2 Data Store 参数逐项说明新建向导里的参数是分层显示的第一层选类型第二层填连接信息。我按实际填写顺序列一张表这张表同样适用于你以后重建数据源参数值说明Datastore TypeMySQL必须选 MySQL不是 ODBC GenericDatastore Namemysql_ds自定义名称建议与 ODBC DSN 名一致Server / Hostmysql-host.example.com可填 IP 或主机名必须能被 DS 机器解析Port3306MySQL 默认端口改过端口就填实际值Database Namesalesdb要连接的库名DS 会据此列出表User Nameds_user第 2 章创建的专用账号PasswordDs_2024#MySQL注意特殊字符转义ODBC DSNmysql_ds必须和系统 DSN 完全一致含大小写说明一点向导界面在不同 DS 版本里字段名称会有差异14.x 里是 Datasource Name16.x 里可能改成 Connection Name但核心就是“DSN 指到 ODBC”。最容易填错的是把 Database Name 当成 DSN或者反过来。记住分工ODBC DSN 负责告诉 DS“去哪找驱动”Database Name 负责告诉 DS“连到哪个库”两者各管各的DSN 不包含库名筛选库名在 Data Store 参数里单独填。多库场景下你可以建多个 Data Store 指向同一个 DSN只是 Database Name 不同这是比每个库建一个 DSN 更省事的方式。另外DS 里 Data Store 的密码字段有个特点首次填写保存后密码不会回显在界面上只显示掩码。如果换环境部署需要重新输入密码否则复制出去的 Data Store 对象会连接失败。这也是为什么很多人把配置好的 Data Store 导出后再导入到另一台 DS 服务器时总报认证失败——密码没有被序列化进导出文件。这种情况下的正确做法是重新手动录入密码再用 Test Connection 验证一次而不是怀疑驱动配置。3.3 ODBC Admin 里配置 DSN 并测试填完第一版参数先别急着点 OK。正文里提到的正确顺序是先选中 ODBC Admin创建 MySQL 的 ODBC 连接测试通过后再返回 Data Store 参数页完善。ODBC Admin 可以理解成 Windows 的 ODBC 数据源管理器DS 安装包通常会在菜单里放一个启动入口也可以自己到控制面板 → 管理工具 → ODBC 数据源管理器打开。注意 2.2 节说的位宽如果 DS 是 32 位的就在 32 位管理器里操作配合C:\Windows\SysWOW64目录下的 odbcad32.exe 使用。在 ODBC Admin 里选择 Add驱动列表选 MySQL ODBC Driver。如果你装了 8.0 的驱动会出现 MySQL ODBC 8.0 Driver 和 MySQL ODBC 8.0 Unicode Driver 两个条目选 Unicode因为这个驱动内部按 UTF-8 处理字符能避免中文乱码。配置项里必填的是 TCP/IP Server、Port、User、Password、Database。测试之前有个小技巧在 Connection Options 或 Advanced 页里把OPTION4194304开启多结果集模式DS 导入 metadata 时有时会调用多结果集查询开着更保险。测试按钮是一个绿色旗帜图标点击后如果报 Connection test successful说明驱动、网络、账号都通。测试失败的定位顺序也有讲究。ODBC 测试报错时先看错误号2003是网络层问题1045是认证问题1049是库不存在1130是 MySQL 主机不允许 DS 所在 IP 连接。这三个号码在我排障时命中率最高。2003去查防火墙和监听端口1045去查账号权限和认证插件1130去 MySQL 的 user 表确认 host 范围是否覆盖 DS 机器 IP。尤其1130我在一个测试环境里碰到过MySQL 的ds_user%行存在但 host 列实际是localhostDS 从另一台机器连接时报 1130改掉 host 后立即恢复。测试成功后回到 DS 的 Data Store 参数页把 ODBC DSN 下拉选到刚建的mysql_ds再补全账密信息点 OK。这时左侧数据源列表里会出现一个新的 MySQL 数据源如果没有自动刷新右键刷新一下。一个必须做的验证在 Data Store 上右键选 Test ConnectionDS 自己会走一遍连接逻辑这条通过才有意义——ODBC 的测试只是操作系统层面的DS 的测试是应用层面的两码事。如果 ODBC 测试通过而 DS 测试失败回到第 2.2 节查位宽和 System DSN 属性。4. 导入表结构metadata 进 DS 才算真正打通4.1 展开 tables 并批量导入Data Store 创建完成后它就像一个空壳DS 还不知道里面有哪些表。双击 Data Store 名称下面的 Tables 节点右侧面板会列出 MySQL 数据库里已有的表。正文里的关键动作是选中所有的表右键选择 import把这些表的 metadata 导入到 Data Services 中。展开 Tables 这一步有个容易被忽略的行为它会触发 DS 在后台执行一次SHOW FULL TABLES和若干DESC操作。如果你的 MySQL 侧网络有延迟右侧列表可能长时间空白这时不要一次次去点刷新先确认 ODBC DSN 在 System DSN 里再检查账号的SHOW VIEW权限。列表出来后表名排序是 MySQL 返回的原始顺序不是字母序你想快速定位某张表可以用列表上方的过滤框。全选导入在表数量大时会给 MySQL 造成连接压力DS 会为每个表开一个元数据查询游标。我处理过 500 张表的库导入耗时约 10 分钟中间 DS 界面会看着像卡住其实日志里一直在输出。不要在这个阶段关 DS 客户端你可以打开 DS 的日志目录看进度安装目录下的logs\datastore_import.log会逐行记录导入的表名。导入确认对话框里有两个勾选项是否包含索引、是否包含外键默认全勾建议保持因为 ETL 映射时索引信息会被 DS 用来生成查询计划。4.2 导入后检查表设计信息导入完成之后Data Store 下面的 Tables 节点会展开每一张 MySQL 表都变成一个可展开的 DS 对象。正文里专门举了 dimcustomer 这张表双击 Data Store 下面的 dimcustomer 表主区域会显示该表的设计信息包括 Columns 页签的字段名、类型、长度、可空属性Keys 页签的主键与外键Indexes 页签的索引清单。这一步对于后续 ETL 映射非常重要。DS 的 Transform 组件里做字段映射时你从数据源表拖过来的字段用的就是这份 metadata如果导入的列顺序和 MySQL 不一致DS 会对齐字段名而不是按位置所以 metadata 里字段名必须精确。常见翻车点在于MySQL 里字段名大小写敏感Linux 下而 DS 导入后统一按大写存储你做映射时如果不注意表达式里的小写字段名会导致编译错误。解决方式是在写表达式时一律用大写字段名或者干脆让 MySQL 建表时统一小写。顺便说下类型映射MySQL 的varchar在 DS 里映射成VARCHAR(n)decimal映射成DECIMAL(p,s)tinyint(1)不会自动转成布尔而是保留整数。这个映射关系在写表达式时要心里有数避免在做类型转换时多写一层 Cast。如果你发现导入后的表缺少某些字段多半是之前导入过旧版本 metadataDS 默认不会自动删掉已经不存在的列。此时右键这张表选择 Refresh 或 Reimport强制 DS 重新读取一次最新表结构。这个操作在开发期约束频繁变更时几乎是每天都要用的比反复删除 Data Store 重建高效得多。重新导入不会丢 Data Store 里的 Job 映射DS 会按字段名自动对齐新增字段会追加到末尾。4.3 View Data右键预览数据设计信息看完了想验证数据是不是真能读取在 dimcustomer 上右键选择 View DataDS 会打开一个数据预览窗口显示表的前若干行数据。这个功能是 ETL 开发阶段最常用的调试入口它等价于在 DS 里发起一次SELECT * FROM dimcustomer LIMIT 100但好处是你不必自己写 SQL也不必先生成 Job 才能看数据。View Data 和测试连接的区别测试连接只验证 DS 能打开 Data Store 对象View Data 验证的是驱动层真正能把数据从 MySQL 传回 DS 客户端。如果测试连接通过但 View Data 报错问题集中在 ODBC 驱动的数据传输参数上比如 Fetch Buffer Size 太小的报错提示或者字符集参数没有设成 utf8mb4 导致中文读取异常。正文里特意把 View Data 放在导入 metadata 之后是一个合理的顺序——先保证表结构进来了再用数据验证驱动层两步都过你的 Data Store 才算真正打通。View Data 预览窗口默认显示 100 行数据量大时窗口加载会慢这不是 DS 性能问题而是它把结果集整个拉回内存了。想快速查看大表的前几十行先别用 View Data最好通过 MySQL 客户端确认数据范围再回到 DS 里用 Job 的 Query 组件加 WHERE 条件验证。有一个参数值得记一下在 ODBC DSN 配置里把 Fetch Buffer Size 从默认的 32KB 调到 128KB大字段表预览时加载速度快很多这个调整对正式抽取也有正面影响。另外DS 14.2 以上版本的 View Data 结果可以直接右键导出为 CSV方便快速核对抽取结果不需要先建一个抽取 Job。5. 避坑与排查连接 MySQL 的六大高频问题5.1 连接阶段测试成功但创建失败坑一32/64 位 DSN 错配。现象ODBC Admin 里测试连接成功但 DS 的 Datastore 创建时提示 Datasource not found下拉列表里选不到你刚建的 DSN。原因DS 客户端是 32 位而你建的 DSN 在 64 位管理器里或者反过来建到了 32 位管理器但 DS 要读 64 位。解决确认 DS 安装目录位数用对应的 odbcad32.exe 重建 System DSN。验证方法是在 DS 机器的C:\Windows\SysWOW64和C:\Windows\System32下分别打开 odbcad32.exe看系统 DSN 页里是否存在mysql_ds两个管理器里至少有一个能看到它且必须和 DS 位数匹配。坑二MySQL 8.0 认证插件报 Access denied。现象DS 测试连接时报ERROR 1045 (28000): Access denied for user ds_userhost但同一个账号在 MySQL 命令行输入密码能正常登录。原因MySQL 8.0 默认caching_sha2_password认证低版本 Connector/ODBC 5.3 不支持该插件。解决升级 Connector/ODBC 到 8.0或者在 MySQL 端把账号认证改回传统插件ALTER USER ds_user% IDENTIFIED WITH mysql_native_password BY Ds_2024#MySQL; FLUSH PRIVILEGES;逻辑说明ALTER USER把账号的认证插件显式指定为mysql_native_password这是 MySQL 5.7 时代的默认协议DS 与老驱动兼容性最好。参数说明ds_user%要与创建账号时的主机范围一致否则 MySQL 会报账号不存在改完记得FLUSH PRIVILEGES。如果你的安全策略不允许老认证方式那就走升级驱动这一条路8.0 驱动已经支持新的认证插件前提是 DS 版本足够新14.2 以下不建议这么赌。坑三DSN 名称大小写和空格。现象ODBC 里建了名为MySql_DS的 DSNDS 里填mysql_ds报找不到数据源。原因DSN 名称是注册表键大小写敏感且不允许尾随空格复制粘贴时最容易带入一个空格。解决在 ODBC 管理器里确认 DSN 名再回到 DS 参数页逐字核对或者干脆统一用小写无空格命名从源头消灭这个问题。5.2 导入阶段表列表刷不出来坑四账号权限不足。现象DS 测试连接成功双击 Tables 节点等待很久右侧面板空白日志报SHOW VIEW command denied或SELECT command denied。原因DS 导 metadata 的底层 SQL 不只有SHOW TABLES还有对每张表执行SHOW CREATE TABLE权限不足时全部静默失败。解决回到 MySQL 执行第 2.3 节的授权语句补上SHOW VIEW必要时加上SELECT到具体库GRANT SELECT, SHOW VIEW ON salesdb.* TO ds_user%; FLUSH PRIVILEGES;逻辑说明salesdb.*表示限定在 salesdb 这个库的范围内授权比*.*更收敛符合最小权限原则。参数说明如果你后续要做跨库 Join需要用*.*如果只处理单库用库名.*更安全。授权完成后不需要重启 MySQL但 DS 里已打开的 Tables 列表不会自动更新要重新双击刷新一次。坑五MySQL 服务没监听或防火墙拦截。现象DS 报Cant connect to MySQL server on host (10060)或Connection refused。原因MySQL 没有启动、绑定了 loopback 地址或者 DS 机器到 MySQL 主机的 3306 端口被防火墙丢弃。解决先在 MySQL 主机跑netstat -an | grep 3306确认监听再在 DS 机器跑telnet mysql-host 3306验证 TCP这比在 DS 里反复测试更直接。如果 MySQL 绑定的是127.0.0.1需要改my.cnf的bind-address0.0.0.0并重启服务。还有一个极端情况MySQL 以mysqld --skip-networking启动服务是活的但完全不走 TCPnetstat 里看不到 3306这种只能靠客户端本地连接处理。5.3 数据阶段乱码与时区坑六中文乱码与 8 小时时差。现象View Data 打开 MySQL 表中文显示成问号datetime字段比 MySQL 实际值少 8 小时。原因ODBC 驱动的字符集参数没有设为 utf8mb4DS 客户端与 MySQL 会话时区不一致。解决在 ODBC DSN 配置里把 Character Set 设成utf8mb4并在连接参数里加上initStmtSET time_zone8:00按你的业务时区。这个参数对 DS 导入 metadata 没有影响但对后续 ETL 抽取数据有决定性影响。顺手检查一下 DS 所在服务器和 MySQL 所在服务器的系统时区两边不一致时即使 ODBC 参数对了DS 的日志时间也会误导排障方向。还有一个和 SSL 相关的坑MySQL 8.0 若开启了require_secure_transportDS 连接必须显式启用 SSL。ODBC DSN 配置里勾选 Enable SSL 并指定 CA 证书连接串参数加上sslca...不配置的话报 3159 或 SSL connection error。如果业务库没有强制 SSL别动这个选项保持默认关闭反而省事。6. 让连接更稳刷新 metadata、权限最小化与安全习惯Data Store 建好只是第一步MySQL 的 schema 会变表结构会加字段DS 里的 metadata 不会自动跟着变。我一般的习惯是每次跑批前在 DS 里右键 Data Store 名称选择 Refresh让 DS 重新读取一次表结构。这个动作在表和字段变更频繁的环境里是保命操作——你按旧 metadata 写的映射在新结构下跑一半报字段不存在重新导入花不了几分钟比排查一半翻车强得多。验证连接是否真的稳定除了设计器里的 Test Connection还有一个更接近生产的行为创建一个最小的 Job源端拉 dimcustomer 的 10 行数据目标端写到一个本地文件跑一遍 Batch。这一步能验证 Job Server 视角的连接因为设计器测试和 Job Server 测试走的是不同进程、不同账号域。血泪经验告诉我这一步至少在首次上线前必须做一次很多“测试通过但跑批失败”的案例都死在这一步之前。权限最小化的习惯也值得坚持。给 DS 的账号只保持SELECT, SHOW VIEW不要为了省事给 ALL PRIVILEGES。MySQL 的密码不要写在 Job 的文本属性里DS 的 Data Store 对象本身会把密码加密存放在本地 Repository 中但如果你在 Job 里用字符串变量覆盖密码密码会以明文方式留在 Job 的序列化文件里。我见过有同事把密码直接写在 Transform 的 SQL 覆盖语句里审计时被数据安全团队点名。从那以后我每次新建 MySQL 数据源都强制走一遍完整流程版本核对 → 双位驱动检查 → System DSN → 最小权限账号 → 导入表 → View Data → 跑一个最小 Job。这套流程看着繁琐但它过滤掉了九成以上的“测试通过但跑批失败”问题。希望帮到你。本文还有配套的精品资源点击获取