ArcSDE 10.2 for Oracle 安装配置全指南：从建库到避坑

简介ArcSDE 10.2 for Oracle 10g/11g 安装包是 Esri 推出的地理空间数据中间件面向 GIS 管理员、数据库管理员及 ArcGIS 二次开发人员用于在 Windows 平台将 Oracle 数据库与 ArcGIS 无缝集成并高效管理海量分布式地理数据。压缩包共 14 个文件大小约 77.88MB涵盖 Oracle 10g 和 11g 两个版本内部包含 exe 与 msi 安装程序、cab 组件数据文件、chm 帮助文档、ini 配置示例及 htm 安装引导页面可完整支撑从环境准备、服务端安装到客户端连接的全流程。其中还针对不同 Oracle 版本整理了配置说明与故障排查思路有助于规避版本兼容性陷阱并借此理解版本化数据存储、并发编辑、WFS/WMS 服务发布以及索引、分区等性能优化机制。已有 989 人学习适合离线搭建 ArcGIS Oracle 集成环境的中高级 GIS 工程师、系统运维人员也可作为企业空间数据库建设的备选参考。1. ArcSDE 10.2 不是安装包是 GIS 和 Oracle 之间的“翻译官”ArcSDE 10.2 for Oracle 10g/11g 这个安装包装进去的不是一个普通软件而是 Esri 在 Windows 平台上用来把 Oracle 变成“空间数据库”的中间件。简单说没有它ArcGIS Desktop 和 ArcGIS Server 就只能把数据存成文件有了它几百 GB 的矢量数据可以扔进 Oracle让 ArcGIS 通过 SDE 服务或直连方式读写还支持多版本编辑和长事务。我当年第一次部署时也以为它就是个带界面的服务端程序结果发现真正的活儿全在命令行和数据库权限里。这个包适合三类人做 GIS 二次开发的工程师、管 ArcGIS Server 环境的运维以及要把 ArcSDE 从老版本迁上来的老手。它的使用边界也很明确——只覆盖 10.2 版本配 Oracle 10g/11g换数据库版本就得换包。2. 装之前先定三件事数据库版本、SDE 服务模式、Oracle 客户端位数2.1 先看清包里的两个文件夹Oracle10g 和 Oracle11g 不能混用压缩包解压后会有两个并列的目录一个叫 ArcSDEOracle10g一个叫 ArcSDEOracle11g。这不是让用户选哪个顺手而是 ArcSDE 10.2 针对 Oracle 数据库版本分开做的安装介质。Oracle 10g 目录对应数据库 10.1.0.x 到 10.2.0.xOracle 11g 目录对应 11.1.0.x 和 11.2.0.x。如果数据库是 11.2.0.4却拿着 ArcSDEOracle10g 里的 setup.msi 去装装完配置阶段会直接连不上因为 Server 端组件注册的 DLL 版本和数据库内部包不匹配。我一般会先在新环境里跑一遍sqlplus / as sysdba确认数据库版本再决定用哪个目录。这一步花不了两分钟但能省掉后面至少半天的排错。版本低于 10.2.0.5 的 Oracle 10g 数据库建议先打补丁再装 ArcSDE不然在 sdesetup 阶段容易报 ORA-00942: table or view does not exist实际上是数据库自身缺了必要的视图不是 ArcSDE 的问题。2.2 服务模式还是直连模式10.2 开始两种都要懂ArcSDE 从 10.x 版本开始官方主推直连direct connection但不少老项目里还在用传统的 ArcSDE 服务giomgr 进程。这个区别必须在装之前想清楚因为安装步骤和服务注册命令完全不同。直连模式下ArcGIS Desktop 客户端不经过任何中间服务进程直接通过 Oracle 客户端连到数据库里的 SDE schema连接字符串里写的是数据库地址和实例名。老模式则是装一个 Windows 服务客户端先连这个服务再由它转发给 Oracle。两种模式的数据存储结构一样都是 SDE schema 里的那套表区别只在访问路径。10.2 版本有个特殊之处它同时支持两种模式所以安装包里既有服务端组件也带客户端 DLL。我见过有人只装了服务端就跑到 ArcGIS Catalog 里配直连结果报“Failed to connect to database”其实就是缺了直连要用的 Oracle 客户端库。反过来只跑 Desktop 的人如果不需要多用户并发编辑完全没必要装服务端直接用直连就好还能少维护一个 Windows 服务。2.3 安装介质里的文件有什么讲究setup.exe、setup.msi、instmsi3.exe 各管一段打开任意一个目录里面这几样东西几乎是固定的Setup.exe、setup.msi、setup.ini、Setup.chm、Install.htm、Data1.cab还有一个 instmsi3.exe。它们的分工说清楚排错就有方向。Setup.exe 是引导程序负责检查系统环境比如是否装了旧版 ArcSDE然后调用 MSI 执行安装。setup.msi 才是真正的安装逻辑所有文件的复制、注册表写入都靠它。Data1.cab 是压缩数据包MSI 安装时从里面解出实际文件。setup.ini 是静默安装用的配置入口里面可以指定安装路径、组件。instmsi3.exe 是 Windows Installer 3.1 的安装补丁在 Windows Server 2008 这类老系统上如果 MSI 引擎版本太低Setup.exe 会先去跑它。我第一次装就踩过 instmsi3.exe 的坑在 Windows 7 上双击 Setup.exe 没反应后来才发现引导程序在后台等 MSI 引擎升级手动点了 instmsi3.exe 再跑 setup.msi 就好了。Install.htm 是网页版安装说明Setup.chm 是 CHM 格式帮助文档装之前先把这两份翻一遍里面对 Oracle 版本的注意事项写得比网上任何博客都准。3. Windows 上把安装包跑起来从解压到 MSI 落地的三条路线3.1 解压路径选不好MSI 第一阶段就翻车安装包拿到手第一件事是解压。注意解压路径最好不要带空格和中文C:\ArcSDE\ArcSDEOracle11g这种都行但D:\软件\ArcSDE 10.2\新建文件夹这种就等着出问题。原因在于 Setup.msi 在安装过程中会把安装源路径写进 Windows Installer 的缓存路径含中文时部分调用 Oracle DLL 的步骤会用 ANSI 编码解析路径到配置阶段就变成乱码。解压后建议先看 Install.htm它会对当前系统需要什么前置条件做说明。按我的经验Windows Server 2008 R2 或 2012 上装基本不需要额外补丁如果是 Windows 7 桌面环境测试用先确认 .NET Framework 3.5 已经开了ArcSDE 服务管理工具 sdeservice 依赖它。3.2 静默安装setup.ini 里藏着可改的参数如果给客户部署多台服务器或者本地就打算用命令行装setup.ini 就是关键。默认内容大致是:[InstallShield] SilentYes ; 静默模式开关Yes 表示不弹界面 ComponentsService,Client ; 组件选择Service 装服务端Client 装客户端库 TARGETDIRC:\ArcSDE ; 安装根目录默认在系统盘建议手工改 REG_SOFTWARE_INSTALL_PATHC:\ArcSDE静默装的时候我一般这么跑:setup.exe -r -f1C:\ArcSDE\setup.iss-r是记录本次安装操作-f1指定响应文件路径。第一次先在图形界面装一遍生成 setup.iss后面批量部署时用:setup.exe -s -f1C:\ArcSDE\setup.iss参数说明-s表示静默执行-f1指定响应文件注意千万不要漏掉响应文件路径否则安装程序会去找默认位置的 setup.iss找不到就直接退出日志里什么都看不到。Setup.ini 里的 Components 字段值得多说一句只做客户端直连的话把 Service 去掉可以省掉后面注册 Windows 服务那一堆事。3.3 图形界面安装双击 Setup.exe 之后的三个选择项含义图形界面没什么玄学但有几个选项容易选错。第一步是安装类型通常选“ArcSDE Default”它会同时装好服务端和管理工具如果只是给 ArcGIS Desktop 用选“Client”就够。第二步是选数据库支持。界面会列出 Oracle 10g、Oracle 11g 等选项这里要和数据库实例匹配。注意这个选项决定安装程序往 Oracle 的安装目录里复制哪些 DLL选错了后面 sdesetup 直接报版本错误。第三步是服务账户。老版本装完会要求指定一个 Windows 账户跑 ArcSDE 服务我建议选一个专用的域账户别用 Local System。不然到了后面配置 Oracle 连接时服务起来后访问网络资源会出权限问题表现为 sdemon 能起来但客户端连不上。4. 配库才是主战场sdesetup 建库、sdeconfig 调参、sdeservice 注册4.1 Oracle 侧准备先建用户、表空间再动 ArcSDE安装介质落地之后如果直接在 ArcGIS 里连 Oracle大概率会收到“ORA-01017: invalid username/password”。因为 ArcSDE 要求 Oracle 里先有一个专用的数据库用户来存 SDE schema它不是安装程序自动创建的。这一步需要在数据库里手工做。CREATE TABLESPACE sde_data DATAFILE C:\ORACLE\ORADATA\ORCL\sde_data01.dbf SIZE 2G AUTOEXTEND ON NEXT 100M MAXSIZE 32G; CREATE USER sde IDENTIFIED BY sde_password DEFAULT TABLESPACE sde_data QUOTA UNLIMITED ON sde_data; GRANT CONNECT, RESOURCE TO sde;说明表空间名字可以改成项目名但用户名的 sde 是硬约定ArcSDE 的脚本默认去找 SDE schema换名字会非常痛苦。QUOTA UNLIMITED这段如果漏了后期写入数据时频繁报 ORA-01950。GRANT 里的 RESOURCE 角色在 Oracle 11g 里包含 CREATE TABLE、CREATE PROCEDURE 等权限但 sdesetup 建库过程中要执行的是更高级的存储过程授权所以通常还要给 sde 用户加一句GRANT UNLIMITED TABLESPACE TO sde;这段的意义在于避免数据文件扩容时单独给每张表分配配额。生产环境我一般还给 sde 用户开启CREATE SESSION之外的最小权限模型但测试环境先把上面的跑通再说。4.2 sdesetup 命令建库语法、参数、以及 Oracle 服务名怎么传Oracle 侧的用户和表空间就绪后就开始真正的建库操作。用的是安装目录下的 sdesetup.exe在命令行里跑sdesetup -o install -d ORACLE11G -u sde -p sde_password -h orcl -H C:\ArcSDE\Logs逐个参数说清楚-o install执行建库操作在 SDE schema 下创建全部数据字典和存储过程。-d ORACLE11G数据库类型注意是 ORACLE11G 或 ORACLE10G和安装时选的目录对应。-u sde数据库用户名固定是 sde。-p sde_password上面建用户时设置的密码。-h orcl这里填的是 Oracle TNS 服务名或者 SID 简写不是主机名。如果填错会报 ORA-12154。-H C:\ArcSDE\Logs日志输出目录sdesetup 会把建库过程中的每一步写进 sde_setup.log排错全靠它。我第一次跑的时候把-h写成了数据库 IP结果折腾半小时换成 tnsnames.ora 里配的服务名立刻通过。sdesetup执行成功以后SDE schema 下会出现 sde_layer、sde_table_registry、sde_versions 等核心表你可以用 sqlplus 登录 sde 用户确认。4.3 sdeconfig 调参连接池、超时、临时文件路径都有默认值要改建库完成后紧接着要执行一次 sdeconfig 更新参数。这一步很多人跳过结果生产环境连上后不断报连接中断。常用的是:sdeconfig -o update -d ORACLE11G -u sde -p sde_password -s orcl -C CONNECTIONS200这里的-s orcl也是 TNS 服务名-C CONNECTIONS200是让 SDE 服务同时处理的连接数上限。默认值通常很低ArcGIS Server 多个实例并发访问时很快就打满表现是客户端长时间等待后报“Connection timed out”。另外值得调的是临时文件目录sdeconfig -o update -d ORACLE11G -u sde -p sde_password -s orcl -C TEMPC:\ArcSDE\TempTEMP参数控制 ArcSDE 做空间运算时写临时文件的路径默认指向系统临时目录。Windows 服务器上如果系统盘空间小一个大的缓冲分析直接撑爆 C 盘所以习惯上建一个独立目录。调完这两个参数后用 sdemon 重启服务:sdemon -o stop -i esri_sde sdemon -o start -i esri_sde-i esri_sde是服务名默认是 esri_sde如果你在 sdeservice 里改过名这里要跟着改。4.4 别忘了注册服务sdeservice 创建 Windows 服务装完 MSI 不等于有了服务Windows 服务是单独注册的跑下面的命令sdeservice -o create -d ORACLE11G -u sde -p sde_password -i esri_sde-o create创建服务-i esri_sde指定服务标识。执行成功后能在 Windows 服务管理器里看到一个名为 ArcSDE_esri_sde 的服务。这里有个常见的玄学点服务创建成功但启动失败十有八九是 Oracle 客户端缺少环境变量或监听没起来。先别急着 reinstall到服务属性的“登录”选项卡确认账户有“Log on as a service”权限再到系统环境变量里确认 PATH 包含 Oracle 客户端的 bin 目录。5. 避坑手册ArcSDE 10.2 安装最常见的五个翻车现场5.1 现象sdesetup 报 ORA-01031: insufficient privileges原因sde 用户缺少建库所需的角色权限这是所有权限错误里最常见的一种。解决用 sysdba 登录给 sde 用户补授权执行GRANT EXECUTE ON DBMS_PIPE TO sde;再执行GRANT CREATE SEQUENCE TO sde;。ArcSDE 建库要用 DBMS_PIPE 和序列这两项经常被漏掉把 4.1 里所有的授权语句一次性跑完基本能避开。5.2 现象安装完成后双击 ArcGIS Catalog 连接报“Failed to connect to database”原因我先说结论——八成是 Oracle 客户端位数不对。ArcSDE 10.2 的组件是 32 位的而服务器上如果只装了 64 位 Oracle 客户端直连时加载 OCI 库失败报得很笼统。解决下载 32 位 Oracle Instant Client在系统 PATH 里把它的目录放到最前面。另一个坑是 tnsnames.ora 里没有这个实例的条目ArcSDE 在 Windows 上读 Oracle 配置是按环境变量 TNS_ADMIN 找的把这个变量显式指到 tnsnames.ora 所在目录很多奇怪的连接问题当场消失。5.3 现象ArcSDE 服务能启动但客户端连上去执行第一个编辑操作就报“ORA-24777”原因字面意思是使用了未经允许的事务多数情况下是 Oracle 的分布式事务配置缺失具体讲是 Oracle 参数文件中没有给 ArcSDE 打开必要的 XA 支持。解决在 Oracle 的 init.ora 或 spfile 中加一行compatible11.2.0.4.0版本按实际来然后确认数据库的 global_names 没有强制为 TRUE。改完后重启 Oracle 实例和 ArcSDE 服务这个错误基本就没有了。5.4 现象Setup.chm 双击打开是空白页原因Windows 从 XP SP2 之后对 CHM 文件默认加锁从压缩包解压出来的文件尤其容易触发。解决右键点击 Setup.chm选择“属性”在底部“解除锁定”前打勾再打开就能看到内容。这个文件里对 10.2 支持的 Oracle 补丁号写得非常明确排错时多翻翻能少走很多弯路。5.5 现象sdesetup 失败日志显示 ORA-00955: name is already used by an existing object原因数据库里已经存在同名的 SDE schema比如之前装过一次没卸载干净或者有人手工建过 sde 用户。解决确认不是线上数据后用 sysdba 登录执行DROP USER SDE CASCADE;先把旧 schema 清干净再重新跑 sdesetup。注意这个操作会把 SDE schema 下所有空间数据字典一并删除执行前确认这个库不是生产库。6. 装完怎么验证“真活着”三步确认一个库能不能进生产6.1 三步验证SQL 查表、sdemon 查服务、ArcCatalog 建连接很多新手装完只看到“安装完成”界面就以为大功告成其实 ArcSDE 部署里最怕的是“装了但用不了”。我给自己定的规矩是任何一台服务器配完 ArcSDE必须走完下面三步才算交付。第一步在数据库侧确认。用 sqlplus 登录 sde 用户执行下面这句:SELECT COUNT(*) FROM sde.sde_layer;COUNT返回大于 0 就说明建库成功如果这张表不存在或者报权限错误直接说明前面的 sdesetup 没跑干净。第二步在服务侧确认。命令行跑sdemon -o status -i esri_sde看到状态行为 Running且进程没有反复重启服务侧就算通过。第三步在客户端确认。打开 ArcGIS Catalog添加数据库连接填上 Oracle TNS 服务名和 sde 用户的密码测试连接成功后新建一条要素类再删掉确认写读都通。6.2 日志和端口出事时先看这两个地方ArcSDE 的日常维护大部分时间花在日志分析上。服务端日志默认在安装目录的logs文件夹下文件名类似sde_esri_sde.log连接失败时这里会有明细。Oracle 侧的alert_SID.log也要看ArcSDE 在 Oracle 里执行 DDL 或存储过程失败时数据库日志里的信息往往比 ArcSDE 日志更接近根因。端口方面老版本 SDE 用 5151/tcp直连模式不走这个端口走 Oracle 的 1521/tcp。经常有人配了防火墙只开 5151直连却连不上。判断方法直连模式下用tnsping orcl测通 Oracle 监听通了就说明网络链路没问题问题在客户端配置服务模式下用telnet 服务器IP 5151判断端口通不通。6.3 最后一次交付时的习惯记忆很深的一次项目交付客户那边所有验证都过了第二天说 ArcGIS Server 发布服务时偶尔报超时。查了两小时最后发现是服务器上有多个 Oracle 客户端版本PATH 顺序不对导致 ArcGIS Server 加载了旧版 OCI。从那以后我每次部署完都要加做一次环境变量核对打开命令行set PATH看一眼 Oracle 的 bin 目录排在第几位然后用select * from v$version和select * from sde.sde_version两条 SQL 锁死数据库版本和 SDE 版本的一致性这一套流程不走完绝不放服务器进生产。这算是我这些年被磨出来的一个强迫症虽然蠢但每次都能把人从翻车边缘拉回来。希望帮到你。ArcSDE 10.2 回避点补充如果你在 64 位 Windows 上装好后直连始终报 ORA-12154先用echo %TNS_ADMIN%确认环境变量指向了正确的 tnsnames.ora 目录再验证 Oracle 客户端下的sqlplus能不能登录到目标库。记住一个铁律——ArcSDE 能不能连上永远是 Oracle 客户端先能连上才有可能这个顺序反了就永远在排查死胡同里打转。本文还有配套的精品资源点击获取