Oracle 命名方法（Naming Methods）详解

适用版本：Oracle Database 11g / 12c / 19c / 23ai 文档版本：v1.0 / 2026-07

1. 概述

命名方法（Naming Methods） 是 Oracle 客户端解析连接标识符（如 orcl）的方式[1]：

方法	说明	适用场景
Local Naming	tnsnames.ora	单机/小型
Directory Naming	LDAP	大型企业
Easy Connect	URL 格式	简单场景
External Naming	NIS/外部	特殊
Host Naming	主机名	简化

2. 配置命名方法

2.1 sqlnet.ora 配置

# $ORACLE_HOME/network/admin/sqlnet.ora

# 命名方法解析顺序
NAMES.DIRECTORY_PATH = (TNSNAMES, EZCONNECT, LDAP)

# 默认域名
NAMES.DEFAULT_DOMAIN = example.com

解析顺序：

客户端连接 orcl
自动追加域名：orcl.example.com
按 NAMES.DIRECTORY_PATH 顺序尝试解析

3. Local Naming（tnsnames.ora）

3.1 配置

# $ORACLE_HOME/network/admin/tnsnames.ora
ORCL =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = dbhost)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = orcl)
    )
  )

ORCL_RAC =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = rac-scan)(PORT = 1521))
    (LOAD_BALANCE = ON)
    (FAILOVER = ON)
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = orcl)
    )
  )

3.2 优缺点

优点：

配置简单
易于理解
不依赖外部服务

缺点：

每个客户端独立维护
配置变更需同步多机
大规模环境维护困难

3.3 适用场景

单机环境
小型部署
开发测试环境

4. Directory Naming（LDAP）

4.1 概念

使用 LDAP 目录服务（如 Oracle Internet Directory、Microsoft Active Directory）集中管理连接信息。

4.2 配置

# sqlnet.ora
NAMES.DIRECTORY_PATH = (LDAP, TNSNAMES)

# ldap.ora
DIRECTORY_SERVERS = (ldap.example.com:389:636)
DIRECTORY_SERVER_TYPE = OID
DEFAULT_ADMIN_CONTEXT = "dc=example,dc=com"

4.3 LDAP 条目

dn: cn=orcl,cn=OracleContext,dc=example,dc=com
objectClass: orclNetService
orclNetDescString: (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=dbhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orcl)))

4.4 优缺点

优点：

集中管理
全局可用
易于变更

缺点：

需部署 LDAP 服务器
依赖网络
配置复杂

4.5 适用场景

大型企业
多数据库环境
需要统一管理

5. Easy Connect

5.1 格式

# 基本格式
sqlplus scott/tiger@host[:port]/service_name

# 示例
sqlplus scott/tiger@dbhost:1521/orcl
sqlplus scott/tiger@dbhost/orcl
sqlplus scott/tiger@192.168.1.100:1521/sales

# 带参数
sqlplus scott/tiger@dbhost:1521/orcl?connect_timeout=60

5.2 配置

# sqlnet.ora
NAMES.DIRECTORY_PATH = (EZCONNECT, TNSNAMES)

# 默认支持，无需 tnsnames.ora

5.3 优缺点

优点：

无需配置文件
简单易用
适合快速测试

缺点：

不支持高级特性（TAF、负载均衡）
需要记住主机/端口/服务名
不适合生产环境

5.4 适用场景

临时连接
管理员快速测试
简单应用

6. External Naming（NIS）

6.1 配置

# sqlnet.ora
NAMES.DIRECTORY_PATH = (NIS, TNSNAMES)

# NIS map 中
orcl (DESCRIPTION=(ADDRESS=...)(CONNECT_DATA=...))

6.2 适用场景

已有 NIS 基础设施
Unix/Linux 环境

7. Host Naming

7.1 概念

仅使用主机名作为连接标识符：

sqlplus scott/tiger@dbhost

7.2 配置

# sqlnet.ora
NAMES.DIRECTORY_PATH = (HOSTNAME)

# 必须使用静态注册
# listener.ora
SID_LIST_LISTENER =
  (SID_LIST =
    (SID_DESC =
      (GLOBAL_DBNAME = dbhost.example.com)
      (ORACLE_HOME = /u01/app/oracle/product/19.3.0/dbhome_1)
      (SID_NAME = orcl)
    )
  )

7.3 限制

仅支持 TCP/IP
仅支持静态注册
不支持高级特性

8. 命名方法选择

场景	推荐方法
单机开发	Easy Connect + Local Naming
小型生产	Local Naming
中型企业	Local Naming + LDAP
大型企业	LDAP
临时测试	Easy Connect
RAC 生产	Local Naming（含 SCAN）

9. 多种方法组合

9.1 配置示例

# sqlnet.ora
NAMES.DIRECTORY_PATH = (TNSNAMES, EZCONNECT, LDAP)
NAMES.DEFAULT_DOMAIN = example.com

9.2 解析顺序

客户端连接 'sales'：

1. 自动补全域名：sales.example.com
2. 按顺序尝试：
   a. TNSNAMES: 查找 tnsnames.ora 中的 sales.example.com
   b. EZCONNECT: 尝试解析为 host:port/service
   c. LDAP: 查询 LDAP 目录
3. 找到第一个匹配的即返回

10. 常见坑与排错

10.1 ORA-12154: could not resolve the connect identifier

现象：客户端连接报 ORA-12154。

排查：

# 1. 检查 sqlnet.ora
cat $ORACLE_HOME/network/admin/sqlnet.ora

# 2. 检查 tnsnames.ora
cat $ORACLE_HOME/network/admin/tnsnames.ora | grep sales

# 3. tnsping 测试
tnsping sales

# 4. 检查 TNS_ADMIN
echo $TNS_ADMIN

10.2 域名追加问题

现象：tnsping orcl 成功，但 sqlplus orcl 失败。

原因：NAMES.DEFAULT_DOMAIN 自动追加域名，导致实际查找 orcl.example.com。

修复：

# 方法 1：tnsnames.ora 中加 orcl.example.com
# 方法 2：sqlnet.ora 中删除 NAMES.DEFAULT_DOMAIN
# 方法 3：连接时使用全名
sqlplus scott/tiger@orcl.example.com

10.3 LDAP 解析失败

修复：

# 1. 检查 ldap.ora
cat $ORACLE_HOME/network/admin/ldap.ora

# 2. 测试 LDAP 连接
ldapsearch -h ldap.example.com -p ****** -b "dc=example,dc=com" "(cn=orcl)"

# 3. 检查网络
telnet ldap.example.com 389

10.4 tnsnames.ora 配置错误

现象：ORA-12154 或连接到错误数据库。

修复：

# 1. 验证语法
tnsping orcl

# 2. 检查括号匹配
# 3. 检查空格和缩进

11. 最佳实践

生产用 Local Naming + LDAP：本地备份，LDAP 主用
统一 sqlnet.ora：所有客户端一致
规范命名：避免冲突
tnsnames.ora 版本控制：Git 管理
测试 tnsping：变更后验证
默认域谨慎使用：避免混淆
Easy Connect 仅用于临时：不适合生产
LDAP 集中管理：大规模部署
配置文档化：记录所有服务
定期审计：清理过期配置

12. 参考资料

[1] Oracle Database Net Services Administrator’s Guide 19c, “Naming Methods” https://docs.oracle.com/en/database/oracle/oracle-database/19/netag/configuring-naming-methods.html

[2] Oracle Database Net Services Reference 19c https://docs.oracle.com/en/database/oracle/oracle-database/19/netrf/