简介面向64位系统的 Oracle 数据访问组件ODAC11.2.0.3.20 Xcopy 版是为解决 SQL Server 与 Oracle 异构数据库集成而准备的开发包。组件中包含关键的 Oracle Provider for OLE DB 驱动该驱动是在 SQL Server 环境中建立链接服务器并访问 Oracle 的核心桥梁借此可实现跨数据库的查询、更新和数据管理同时附带的 Oracle Instant Client 11.2 也支持 ASP.NET 应用程序直接连接 Oracle满足 Web 场景下的数据访问需求。整个压缩包共有 194 个文件其中 90 个动态库负责运行时的数据交互42 个 SQL 脚本和 17 个存储过程文件用于部署和管理数据库对象另有可执行工具、配置文件、说明文档及安装卸载批处理等整包约 54.16MB。已有 9183 人学习下载。通过包内提供的安装与配置脚本、卸载脚本及说明文档可以快速完成组件注册、环境变量配置和卸载Instant Client 与 OLEDB 模块则有助于排查跨库访问中的驱动注册、网络连通和身份认证问题对于需要打通 SQL Server 与 Oracle、或者为 Web 应用接入 Oracle 的开发运维人员来说这份资源在跨库调试、驱动配置和数据迁移方面都具有实用价值。1. ODAC1120320Xcopy_x64 是什么一台没装 Oracle 客户端的 Windows怎么半天内连上库在一台没有 Oracle 客户端的 Windows 服务器上要连内网 Oracle 库最常见的卡点是三件套没有管理员权限装不了安装版、装完写一堆注册表全局配置、机器上已有别的数据库客户端时还会打架。ODAC1120320Xcopy_x64 就是绕开这套流程的方案——它是 Oracle 官方按 Xcopy 方式发布的 ODAC 11.2.0.3.2 x64 部署包不用运行安装向导解压就能用不碰系统全局配置。包里带 SQL*Plus、ODP.NET 托管与非托管驱动、OLE DB Provider 和 ODBC 驱动覆盖命令行、C# 程序、报表工具三类最常见的连库方式。适合正在 Windows 上做部署脚本、写 .NET 连 Oracle、或者需要把多个版本客户端隔离共存的运维和开发。2. 先理解 Xcopy 部署ODAC 为什么可以“解压即用”但又不完全免依赖2.1 包里的组件清单SQL*Plus、ODP.NET、OLE DB、ODBC 各管什么ODAC 是 Oracle Data Access Components 的缩写ODAC1120320Xcopy_x64 把这一整套组件打成了一个 zip。版本号拆开看1120 对应 11.2.0320 对应 3.2也就是 ODAC 11.2.0.3.2对应 Oracle Database 11g R2 时代的客户端组件。它和很多人的认知偏差在于ODAC 并不是一个“安装程序”而是一组面向不同开发接口的访问组件集合。组件形式典型使用者Oracle Instant Client含 SQL*Plus、tnsping原生命令行工具DBA、运维ODP.NET 非托管驱动Oracle.DataAccess.dll.NET Framework 程序集依赖 OCI老 C# 项目ODP.NET 托管驱动Oracle.ManagedDataAccess.dll纯托管程序集不依赖 OCI.NET 4.5 项目、x64 进程Oracle Provider for OLE DBCOM 组件老 ASP、SSIS、ExcelOracle ODBC DriverODBC 驱动报表工具、第三方 BIOracle Services for Microsoft Transaction Server分布式事务支持MSDTC 场景我平时判断包有没有下对第一件事不是看目录而是解压后找两个文件sqlplus.exe 和 Oracle.ManagedDataAccess.dll。前者说明命令行工具齐全后者说明 .NET 访问能力在。Xcopy 包不包含 Visual Studio 的集成工具开发机上要装完整版但部署机只需要运行组件这一点反而干净。2.2 Xcopy 与完整安装版的本质差别注册表、PATH、OCI 三条线完整安装版做的事是把文件散到 Oracle 目录、注册 ORACLE_HOME 到 Windows 注册表、把 ODP.NET 程序集注册进 GAC、设置性能计数器、安装 Windows 服务。好处是什么都替你配好了坏处是卸载时总留下残留而且同机多版本容易互相抢占注册表里的默认 HOME。Xcopy 模式只解压文件所有程序集和 DLL 都在这一个目录里。运行时靠三条线定位资源PATH 环境变量找 sqlplus.exe 和原生 DLLTNS_ADMIN 环境变量找 tnsnames.oraORACLE_HOME 让非托管 ODP.NET 找到 OCI 层。托管驱动最省事只需要引用程序集连 ORACLE_HOME 都不需要。这意味着一个真实的部署边界如果你的程序用的是 Oracle.ManagedDataAccess.dll 托管驱动Xcopy 几乎是零配置如果你还在用 Oracle.DataAccess.dll 非托管驱动那 ORACLE_HOME、PATH 和位数必须三对齐否则跑起来就是各种“未能加载文件或程序集”。常见做法是把 Xcopy 目录做成隔离沙盒不碰系统里的其他 Oracle 产品多版本共存就是目录隔离互不干扰。2.3 运行依赖VC 运行库和 Windows 版本边界Xcopy 不是彻底自包含。sqlplus.exe 和 OCI 原生 DLL 是 C 编译的依赖 Microsoft Visual C Redistributable。ODAC 11.2 时代主要依赖 VC 2010 的 msvcr100.dll但由于后来的 ODAC 组件也在同一台机器上跑我一般直接把以下三个一次装齐避免后面补装又得重启服务缺失文件名对应运行库包msvcr100.dllMicrosoft Visual C 2010 Redistributable (x64)msvcr120.dllMicrosoft Visual C 2013 Redistributable Package (x64)vcruntime140.dllMicrosoft Visual C 2015-2022 Redistributable (x64)Windows 版本方面这个包在 Windows Server 2016/2019/2022 上都能正常跑Windows 10/11 桌面版也没问题。有一点要注意这是编译给 x64 的原生驱动不是 arm64 的原生包。在 Windows 11 ARM64 设备上x64 模拟层可能能跑通 SQL*Plus但非托管 ODP.NET 和 OLE DB 这类依赖 OCI 的组件在模拟环境下容易出 0xc000007b 这类加载错误服务器场景别拿 ARM64 去赌。3. 在 Windows x64 上落地部署从解压到 SQL*Plus 连上库的完整动作3.1 部署目录与版本核对先确认拿到的是真正的 x64 包ODAC1120320Xcopy_x64 的文件名里已经写了 x64但下载页面通常同时提供 x86 和 x64 两个 zip手滑下错的事经常发生。核对方式是解压后看目录里有没有 64 位特征文件最直接的是 sqlplus.exe 的属性里“兼容性”标签页有没有提示或者直接用 PowerShell 读取 PE 头$stream [System.IO.File]::OpenRead(C:\oracle\odac11x64\sqlplus.exe) $reader New-Object System.IO.BinaryReader($stream) $stream.Position 0x3C $peOffset $reader.ReadInt32() $stream.Position $peOffset 4 $machine $reader.ReadUInt16() $stream.Close() if ($machine -eq 0x8664) { x64 } elseif ($machine -eq 0x14c) { x86 }读 PE 头里的 Machine 字段0x8664 是 AMD640x14c 是 x86。这一步能直接把下错包的问题在解压后一分钟内揪出来不用等到连接报错才回头查。解压目录我固定用 C:\oracle\odac11x64纯 ASCII、无空格、无括号避开后面一系列路径相关的坑。3.2 最小部署命令解压、设环境变量、写 tnsnames.ora这是整套部署的核心动作四步全部在命令行完成。第一步解压Windows 10 1803 以后的系统自带 tar 可以直接解 zipmkdir C:\oracle\odac11x64 tar -xf ODAC1120320Xcopy_x64.zip -C C:\oracle\odac11x64tar 解压会保留目录结构解压完成后 C:\oracle\odac11x64 下应该有 bin、network\admin、odp.net 等子目录。如果你的系统没有 tar用右键“全部解压”也行问题不大。第二步设置三个用户级环境变量setx ORACLE_HOME C:\oracle\odac11x64 setx TNS_ADMIN C:\oracle\odac11x64\network\admin setx PATH C:\oracle\odac11x64;C:\oracle\odac11x64\bin;%PATH%setx 写入的是用户级环境变量不需要管理员权限。注意两个隐含行为setx 对 PATH 有 1024 字符截断风险如果原 PATH 很长先 echo %PATH% 确认长度再操作setx 只对“新开的终端”生效当前窗口里跑完 setx 立刻 echo 是看不到变化的这不是命令失败是会话机制。第三步写 tnsnames.oraORCL (DESCRIPTION (ADDRESS (PROTOCOL TCP)(HOST 192.168.10.20)(PORT 1521)) (CONNECT_DATA (SERVER DEDICATED) (SERVICE_NAME orcl)))保存到 C:\oracle\odac11x64\network\admin\tnsnames.ora。连接标识符 ORCL 是自定义的HOST 写数据库服务器的 IP 或主机名PORT 默认 1521。SERVICE_NAME 是数据库的服务名和 SID 不是一回事RAC 或 PDB 环境用 SERVICE_NAME 更通用单机库用 SID 也能通。文件名必须是 tnsnames.ora少个 s 变成 tnsname.ora 就会让系统找不到配置。3.3 验证连接tnsping 和 SQL*Plus 的第一次成功会话环境变量设好后新开一个 cmd 窗口先验证配置可见echo %ORACLE_HOME% echo %TNS_ADMIN% tnsping ORCLtnsping 走到最后一行显示 OK 就说明 TNS 解析和网络通路都正常。如果报 TNS-03505 或 TNS-12541回 3.2 查 tnsnames.ora 和监听地址不用急着怪数据库。网络通之后进 SQL*Plussqlplus systemORCL输入口令后出现 SQL 提示符连库就成功了。用一句 SQL 做最终确认select name, open_mode from v$database;能返回行就说明这条 Xcopy 链路从客户端到服务端全部通。最后再补一个版本和位数确认sqlplus -v输出里能看到 SQL*Plus 的 Release 版本号。这一步我习惯每次都做不是怀疑包不对而是 11.2.0.3.2 这个版本在项目验收时经常被要求展示留个命令输出的截图比事后翻部署文档省事得多。4. 让 .NET 程序接上这套部署ODP.NET 驱动选型、注册与最小连接4.1 两个 ODP.NET 驱动怎么选Oracle.DataAccess 与 Oracle.ManagedDataAccessODAC1120320Xcopy_x64 里带了两套 .NET 驱动选择直接决定你后面会不会被位数问题纠缠。非托管版 Oracle.DataAccess.dll 是 C 封装的运行时通过 ORACLE_HOME 找 OCI 原生库进程必须是 x64配置链路长托管版 Oracle.ManagedDataAccess.dll 是纯 C# 实现自带 TNS 解析和网络协议不碰 OCI进程位数任意部署时只需要把 DLL 放在程序目录。对比项Oracle.DataAccess非托管Oracle.ManagedDataAccess托管运行时依赖依赖 OCI 原生库和 ORACLE_HOME无原生依赖进程位数必须 x64对应 x64 包AnyCPU 即可配置文件需要正确注册 DbProviderFactories同样需要但更简单适用 .NET 版本.NET Framework 4.x.NET Framework 4.5 / .NET Core老项目迁移成本大量老代码用这个命名空间需改 using 和连接串行为我的选择标准很简单新项目一律托管驱动老项目只要还能改代码也往托管驱动迁。非托管驱动在 Xcopy 部署下要保证 ORACLE_HOME、PATH、进程位数三条同时正确任何一个掉链子都是运行期诡异报错。托管驱动把这些问题全绕开了代价只是个别高级特性比如某些 OCI 回调不支持。4.2 DbProviderFactories 注册machine.config 还是 app.config无论用哪个驱动要让别人调用 DbProviderFactories.GetFactory(...) 能拿到工厂对象必须先注册。Xcopy 模式没有安装器帮你写 machine.config所以要手动做。常见做法是优先改 app.config只影响当前程序如果你的程序是要装成 Windows 服务、被多个进程调用就改 machine.config。system.data DbProviderFactories remove invariantOracle.ManagedDataAccess.Client / add nameOracle Data Provider for .NET invariantOracle.ManagedDataAccess.Client descriptionOracle Data Provider for .NET typeOracle.ManagedDataAccess.Client.OracleClientFactory, Oracle.ManagedDataAccess / /DbProviderFactories /system.datatype 属性里的程序集名严格写法要带 Version、Culture、PublicKeyToken手动填容易抄错。不要背这个字符串用一行代码让它自己告诉你Console.WriteLine(typeof(Oracle.ManagedDataAccess.Client.OracleClientFactory).AssemblyQualifiedName);跑一下把输出原样复制到 machine.config 的 type 属性里比手写可靠得多。这一步是典型的“看起来简单、填错一次查半小时”的活让 CLR 自己报答案等于给自己留后悔药。4.3 最小 C# 连接示例与连接串参数说明注册完成后最小可用的连接代码长这样using System; using Oracle.ManagedDataAccess.Client; class Program { static void Main() { string cs User Idscott;Passwordtiger;Data SourceORCL;; using (var conn new OracleConnection(cs)) { conn.Open(); using (var cmd new OracleCommand(select sysdate from dual, conn)) { var dt Convert.ToDateTime(cmd.ExecuteScalar()); Console.WriteLine(dt.ToString(yyyy-MM-dd HH:mm:ss)); } } } }连接串里 User Id 和 Password 对应数据库账号Data Source 的 ORCL 会走 tnsnames.ora 解析。如果不想依赖客户端配置文件可以直接把完整描述符写进连接串程序独立部署时常用这招免去目标机器上维护 tnsnames 的成本Data Source(DESCRIPTION(ADDRESS(PROTOCOLTCP)(HOST192.168.10.20)(PORT1521))(CONNECT_DATA(SERVICE_NAMEorcl)))编译运行。如果用的是托管驱动csc 直接编译就行如果用非托管 Oracle.DataAccess项目平台必须选 x64否则一运行就报 BadImageFormatException。这点在 Xcopy 部署里是最高频的翻车原因不是程序集没放对是位数没对齐。5. 部署避坑ODAC Xcopy 最常见的 5 个翻车现场5.1 sqlplus 双击闪退事件日志指向 MSVCR100.dll现象cmd 里敲 sqlplus 回车窗口一闪就没了Windows 事件查看器里应用程序错误日志显示错误模块是 msvcr100.dll。原因ODAC 11.2 的 SQL*Plus 和 OCI 原生层是用 VC 2010 编译的系统里没有 Microsoft Visual C 2010 Redistributable (x64)或者只装了 x86 版本。64 位程序加载不到 64 位运行库直接启动失败而且失败得很安静。解决装对应运行库。防御性做法是第 2.3 节那张表里的三个一起装掉因为装了 2015-2022 并不能替代 2010它们各管各的 DLL。装完不用重启新开一个 cmd 再跑 sqlplus 即可验证。5.2 tnsping 报 TNS-03505sqlplus 跟着报 ORA-12154现象tnsping ORCL 返回 TNS-03505: Failed to resolve namesqlplus 报 ORA-12154: TNS:could not resolve the connect identifier。原因八成是 TNS_ADMIN 没有指向 tnsnames.ora 所在目录或者文件本身名字写错。setx 设了环境变量但没开新终端也会造成当前窗口里解析不到。更隐蔽的情况是系统“隐藏已知文件类型的扩展名”开着文件实际叫 tnsnames.ora.txt看起来是 tnsnames.ora。解决新开终端echo %TNS_ADMIN% 确认值cd 到那个目录 dir 看真实文件名确认没有 .txt 尾巴确认文件内容里没有把连接标识符写歪。都对了再跑 tnsping。5.3 C# 报 BadImageFormatExceptionx86 进程加载了 x64 驱动现象程序在开发机上跑得好好的部署到服务器上启动就抛 System.BadImageFormatException或者提示“未能加载文件或程序集 Oracle.DataAccess”。原因Xcopy 包是 x64 的非托管 ODP.NET 的 Oracle.DataAccess.dll 和 OCI 都是 64 位。项目编译成 x86或 AnyCPU 在 x86 模式下运行时CLR 尝试把 64 位程序集加载进 32 位进程直接失败。托管驱动不会踩这个坑因为它没有原生层。解决项目平台从 x86 改成 x64或者换 Oracle.ManagedDataAccess.dll一劳永逸。如果项目已经发布成 exe 且没法改配置检查有没有 .config 里的 supportedRuntime 强制了 x86。5.4 ORA-2804011.2 客户端连 12c/19c 数据库被拒现象sqlplus 和 tnsping 都正常输入口令后报 ORA-28040: No matching authentication protocol。原因12c 之后的数据库默认 SQLNET.ALLOWED_LOGON_VERSION 是 12把 11.2 这种老客户端的认证协议拒绝在门外。这不是 ODAC 包的问题是协议版本不对等升级数据库不等于客户端能自动跟着升。解决在有权限的情况下改数据库服务器上的 sqlnet.ora加入SQLNET.ALLOWED_LOGON_VERSION_CLIENT8 SQLNET.ALLOWED_LOGON_VERSION_SERVER8保存后重启监听。需要注意这是数据库侧的全局安全设置改动前先和 DBA 确认某些安全基线不允许把这个参数放低。5.5 解压到 Program Files (x86) 导致连接超时或怪报错现象tnsnames 和监听都正常tnsping 偶尔能通sqlplus 连接时卡住或报 ORA-12541、ORA-12560 这类跟网络拓扑不太匹配的错误。原因Oracle 老版本的原生组件对路径里的空格和括号非常敏感Program Files (x86) 里的空格和括号会让部分 DLL 解析路径出错。这个不是每次都复现属于典型的“玄学”故障但踩过的人都知道是路径的锅。解决统一解压到 C:\oracle\odac11x64 这类纯 ASCII、无空格、无括号的路径。如果已经装错了把目录搬过去后ORACLE_HOME、TNS_ADMIN、PATH 三个环境变量全部重新 setx 一遍新开终端再验证。6. 把 Xcopy 部署当资产管理脚本固化、验证清单与干净卸载6.1 用批处理脚本固化部署流程换机器重跑一遍部署一次之后把这四步写成一个 deploy_odac.cmd下次给另一台机器配环境就不用翻笔记了echo off set ODIRC:\oracle\odac11x64 mkdir %ODIR% tar -xf ODAC1120320Xcopy_x64.zip -C %ODIR% setx ORACLE_HOME %ODIR% setx TNS_ADMIN %ODIR%\network\admin setx PATH %ODIR%;%ODIR%\bin;%PATH%tnsnames.ora 不要放在脚本里反复覆盖用单独的文件维护换库的时候只改 tnsnames 这一段。部署完成后按这张清单过一遍全部通过就可以交付给应用侧接入了检查项预期结果sqlplus -v显示 Release 版本号echo %TNS_ADMIN%路径指向 network\admintnsping ORCL末尾显示 OK连接串登录能执行 select 查询任务管理器 sqlplus 位数x646.2 卸载即删目录不写注册表的后悔药Xcopy 部署最大的红利是卸载干净。完整安装版卸载后注册表残留经常导致重装失败Xcopy 方式删掉目录、撤掉环境变量就结束了。环境变量用 PowerShell 清理[Environment]::SetEnvironmentVariable(ORACLE_HOME, $null, User) [Environment]::SetEnvironmentVariable(TNS_ADMIN, $null, User)PATH 里的两个目录手动编辑用户环境变量删掉就行。第一次用这个包是在一台跑着 SQL Server 2008R2 的老服务器上机器上不能动 ODBC 全局配置Xcopy 方式把 Oracle 客户端完全隔离在一个目录里SQL Server 的 ODBC 链路一点没受影响。从那以后凡是在 Windows 上连 Oracle我都先问能不能上 Xcopy——能就按这套流程走一遍二十分钟内肯定能连上出问题也能在一小时内定位希望帮到你。本文还有配套的精品资源点击获取
