讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

Seko
Seko

AI短剧一键生成成片

如何配置Oracle19c的tnsnames.ora网络连接文件?

阿芳姑娘_6563

阿芳姑娘_6563

发布时间:2026-11-16 08:52:28

|

318人浏览过

|

来源于php中文网

原创

tnsnames.ora必须放在TNS_ADMIN指定路径或$ORACLE_HOME/network/admin下,若TNS_ADMIN已设置则忽略$ORACLE_HOME路径,且语法严格:等号无空格、括号匹配、大小写敏感。

如何配置oracle19c的tnsnames.ora网络连接文件?

tnsnames.ora 文件该放哪儿?路径错就全白配

Oracle 客户端根本不会自动扫描你“觉得应该放”的目录。它只认 TNS_ADMIN 环境变量指向的路径,或者默认 fallback 到 $ORACLE_HOME/network/admin(Windows 是 %ORACLE_HOME%\network\admin)。但注意:如果 TNS_ADMIN 已设置,$ORACLE_HOME 下的路径会被完全忽略。

常见错误现象:tnsping ORCL 成功,但 sqlplus user/pass@ORCL 报 ORA-12154——大概率是客户端读了别的 tnsnames.ora,比如系统盘根目录下某个旧版本残留文件,或 IDE 自带的轻量客户端偷偷加载了它自己的配置。

  • 用 echo $TNS_ADMIN(Linux/macOS)或 echo %TNS_ADMIN%(Windows)确认变量值,检查该路径是否存在且可读
  • 在 Linux 上可用 strace -e trace=openat sqlplus /nolog 2>&1 | grep tnsnames 查看实际打开的文件路径
  • Windows 上推荐用 Process Monitor 过滤进程名 sqlplus.exe + 路径含 tnsnames.ora

tnsnames.ora 条目里 SERVICE_NAME 和 SID 到底填哪个?

填错服务标识是 ORA-12514 或 ORA-12505 的主因。19c 默认启用多租户(CDB/PDB),而 PDB 没有 SID,只有 SERVICE_NAME。

执行 lsnrctl status(需登录数据库服务器)查看监听器注册的服务列表,重点找 Services Summary 下的条目:

  • 如果目标是 CDB 根容器,通常用 SERVICE_NAME = orcl(或你实际的全局数据库名)
  • 如果目标是 PDB(如 ORCLPDB1),必须用 SERVICE_NAME = ORCLPDB1,不能写 SID = ORCLPDB1
  • 旧应用若坚持用 SID 连接,需在 listener.ora 中为 PDB 静态注册一个 SID_LIST,但这属于妥协方案,不推荐新项目采用

示例正确条目(连接 PDB):

QuantOracle
QuantOracle

63个确定性量化金融计算器 + 10个通过MCP的复合工作流。期权定价、Greeks、奇异衍生品、风险指标、投资组合优化……

下载
ORCLPDB1 =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = 172.23.92.61)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = ORCLPDB1)
    )
  )

tnsnames.ora 语法哪些地方一碰就报错?

Oracle 对格式极其敏感,空格、括号、换行、逗号缺一不可。最常踩的坑不是逻辑错,而是肉眼难辨的格式问题。

  • 等号 = 两侧**不能有空格**:写成 HOST = 172.23.92.61 就会解析失败;必须是 HOST=172.23.92.61
  • 每个 DESCRIPTION 块末尾的右括号 ) 必须与开头的左括号 ( 数量严格匹配,少一个就整个条目失效
  • 条目名(如 ORCLPDB1)后不能跟冒号或分号,也不能用中文、空格、连字符
  • 注释只能用 # 开头,且必须独占一行;// 或 /* */ 不被识别

验证方式:运行 tnsping ORCLPDB1。返回 OK 仅说明名称能解析、网络可达;若返回 TNS-03505: Failed to resolve name,基本就是语法或路径问题。

多个 Oracle 客户端共存时,tnsnames.ora 怎么不串?

一台机器装了 12c、19c 甚至 Instant Client,ORACLE_HOME 和 TNS_ADMIN 一旦设错,工具就会读错配置。PL/SQL Developer、SQL Developer、Python cx_Oracle、Java JDBC 都可能各自走不同路径。

  • 避免全局设置 ORACLE_HOME 或 TNS_ADMIN,改用工具级环境变量(如启动脚本中 export TNS_ADMIN=/path/to/19c/tns)
  • Instant Client 用户必须显式设置 TNS_ADMIN,它不依赖 ORACLE_HOME
  • SQL*Plus 启动时会打印当前使用的 tnsnames.ora 路径(加 -V 参数可强制显示),这是最直接的验证依据
  • ODBC 数据源配置里明确指定 TNS Service Name,它不查本地文件,而是靠 ODBC 驱动从注册表(Windows)或 odbc.ini 读取服务名映射

真正麻烦的从来不是写对一条记录,而是让所有调用链路上的每个组件都读到同一份、且正确的 tnsnames.ora。路径、权限、大小写、服务名拼写——四个点只要一个不对,连接就断在看不见的地方。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
oracle清空表数据
oracle清空表数据

当表中的数据不需要时,则应该删除该数据并释放所占用的空间。本专题为大家提供oracle清空表数据的相关文章,帮助大家解决该问题。

1161

2023.08.16

Oracle中declare的使用
Oracle中declare的使用

Oracle DECLARE语句是PL/SQL编程语言中用于声明变量、常量、游标或异常的关键字。它的主要作用是在程序中定义这些对象,以便在后续的代码中使用。DECLARE语句的语法简单明了,可以根据需要声明多个对象。通过使用这些声明的对象,可以进行各种操作,如计算、查询数据库、处理异常等 。

3493

2023.09.15

oracle怎么分页
oracle怎么分页

实现分页的步骤:1、使用ROWNUM进行分页查询;2、在执行查询之前进行设置分页参数;3、使用"COUNT(*)"函数来获取总行数,并使用"CEIL"函数来向上取整计算总页数;4、在外部查询中使用"WHERE"子句来筛选出特定的行号范围,以实现分页查询。想了解更多oracle怎么分页的文章,可以来阅读本专题先的文章。

3510

2023.09.18

Oracle查看表操作历史记录
Oracle查看表操作历史记录

查看操作历史记录的方法:1、使用Oracle内置的审计功能,可以记录数据库中发生的各种操作,包括登录、DDL语句、DML语句等;2、使用Oracle日志文件,其中包含了数据库中发生的各种操作,可以通过查看日志文件来获取操作历史记录;3、使用Oracle的Flashback功能,可以查看数据库在某个时间点的操作历史记录;4、使用第三方工具等。本专题还提供其他查看表操作的文章,大家可以免费阅读。

2009

2023.09.19

Oracle中RAC的用法
Oracle中RAC的用法

Oracle中RAC的用法:1、通过在多个服务器上运行数据库实例来提供高可用性;2、允许在需要时增加或减少节点数量;3、通过将工作负载分布到多个节点上来实现负载均衡;4、使用共享存储来实现多个节点之间的数据共享;5、允许多个节点同时处理数据库请求,从而实现并行处理;6、提供了透明故障切换功能;7、使用了一些技术来确保数据的一致性;8、提供了管理工具来简化RAC环境的管理和维护。本专题还提供RAC相关的其他文章,大家可以免费阅读。

2593

2023.09.19

oracle imp
oracle imp

imp是Oracle数据库中的一个命令行工具,用于将导出的数据和对象从一个数据库实例导入到另一个数据库实例。imp命令的一般语法为“imp username/password@connect_string file=file_name [options]”。

3669

2023.09.19

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4989

2023.11.02

oracle通配符有哪些
oracle通配符有哪些

oracle通配符有“%”、“_”、“[]”和“[^]"。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

257

2023.11.08

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

120

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn