如何创建Oracle网关连接SQL Server_Database Gateway配置-Oracle-PHP中文网

oracle database gateway for sql server（dg4msql）是独立安装的异构网关，将oracle sql翻译为t-sql访问sql server；因oracle原生db link仅支持oracle数据库，故无法直连sql server。

oracle database gateway for sql server 是什么，为什么不能直接用 oracle 自带的 db link

oracle database gateway for sql server（常缩写为 dg4msql）不是 oracle 自带功能，而是一个独立安装的网关组件，运行在 oracle 服务器所在操作系统上，作为中间代理把 oracle 的 sql 请求翻译成 t-sql 发给 sql server。它和普通 db link 完全不同：create database link 只能连 oracle 数据库；想连 sql server，必须走 dg4msql 这条路。

常见错误现象是：直接写 CREATE DATABASE LINK ... CONNECT TO ... USING 'sqlserver_tns'，结果报 ORA-28545: error diagnosed by Net8 when connecting to an agent 或 ORA-12154: TNS could not resolve the connect identifier —— 因为 TNS 名字背后没配真实网关监听器。

安装后必须配置的三个核心文件路径和作用

DG4MSQL 安装完成后，关键配置集中在 $ORACLE_HOME/hs/admin 目录下，三个文件缺一不可：

init<em>dg4msql.ora</em>（必须存在且命名规范）：定义 SQL Server 连接参数，比如 HGFS_SQLSERVER_SERVER=192.168.1.100、HGFS_SQLSERVER_PORT=1433、HGFS_SQLSERVER_DATABASE=MyDB。注意变量名大小写敏感，HGFS_ 前缀不能漏
listener.ora：在 Oracle 监听器里注册一个专用 SID_NAME，例如 SID_NAME = dg4msql，并指向上面的 init 文件：ORACLE_HOME = /u01/app/oracle/product/19c/gateway
tnsnames.ora：定义客户端可访问的别名，内容类似：
```
(DESCRIPTION =
  (ADDRESS = (PROTOCOL = TCP)(HOST = oracleserver)(PORT = 1521))
  (CONNECT_DATA = (SID = dg4msql))
  (HS = OK)
)
```
其中 HS = OK 是硬性要求，漏掉就无法触发异构服务协议

SQL Server 连接账号权限和字符集陷阱

DG4MSQL 默认以 Windows 身份或 SQL Server 混合模式登录，但账号权限容易被低估：

必须有目标数据库的 SELECT 权限（不只是 db_datareader 角色，某些视图需显式授权）
如果查系统表（如 sys.tables），需要 VIEW SERVER STATE 权限，否则报 ORA-28500: connection from ORACLE to a non-Oracle system returned this message: [Microsoft][ODBC Driver 17 for SQL Server][SQL Server]The SELECT permission was denied
字符集不匹配会导致中文乱码或插入失败：SQL Server 端用 Chinese_PRC_CI_AS，Oracle 端 NLS_LANG 必须设为 AMERICAN_AMERICA.AL32UTF8（推荐），且网关 init 文件中加 HGFS_CHARACTER_SET=AL32UTF8

建 DB Link 时最常错的三处语法和验证步骤

DB Link 创建本身简单，但错一处就全链路失败：

必须指定 USING 后的 TNS 别名，且该别名必须已在 tnsnames.ora 中定义并含 HS = OK —— 写成 USING 'dg4msql' 而不是 USING 'dg4msql.world'（除非域名真配了）
用户名密码要转义特殊字符，比如密码含 @，得写成 'user/"p@ssw0rd"/@dg4msql'，否则解析出错
验证不能只看 CREATE DATABASE LINK 是否成功，必须立刻执行：
```
SELECT * FROM all_tables@dg4msql WHERE ROWNUM = 1;
```
如果卡住或报 ORA-28545，大概率是监听器没 reload 或 SQL Server 防火墙拦截了 1433 端口

真正麻烦的是跨版本兼容：DG4MSQL 19c 不支持 SQL Server 2022 的新身份验证方式（如 Azure AD），也不支持 SQL Server 的内存优化表直连。这类限制不会报明确错误，而是查询返回空或超时，得翻 $ORACLE_HOME/hs/log 下的 trace 日志才能定位。