// 免费工具

Oracle 连接字符串生成器

在一个表单里构建 Oracle Easy Connect 字符串、TNS 连接描述符、JDBC thin URL 或 ODP.NET 字符串;也可以粘贴一个,看看主机、端口和服务名,并发现 SID 和服务名混用的问题。 所有操作都在你的浏览器中运行:你输入的内容不会被发送到任何地方。

在 SQLly 中打开此连接

打开 SQLly 的连接编辑器并自动填入内容。

从设计上保护隐私。 构建器和解码器是运行在此标签页中的纯 JavaScript。页面不会把你输入的内容发送给任何服务器,不存储任何内容(甚至不存入浏览器),一旦加载完毕即可离线继续工作。“在 SQLly 中打开”链接会直接从浏览器跳转到你电脑上的应用。

Oracle 连接字符串格式

Oracle 客户端以三种方式命名数据库:Easy Connect(host:1521/service_name)、完整的连接描述符((DESCRIPTION=(ADDRESS=...)(CONNECT_DATA=(SERVICE_NAME=...)))),或一个 TNS 别名,从 tnsnames.ora中查找的 TNS 别名。JDBC thin、ODP.NET、python-oracledb 和 node-oracledb 都接受前两种方式。

经典的错误是混淆 SID 和服务名。可插拔数据库和云数据库是通过服务名访问的;Easy Connect 完全无法表示 SID,而传统的 JDBC 形式 host:port:SID 如果你给它的是服务名,就会报 ORA-12505 错误。

Easy Connect SQL*Plus、SQLcl、python-oracledb、node-oracledb、ODP.NET

db.example.com:1521/FREEPDB1

通过 TLS 的 Easy Connect Easy Connect Plus

tcps://db.example.com:2484/FREEPDB1

连接描述符 tnsnames.ora,每个 Oracle 客户端

(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=db.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=FREEPDB1)))

JDBC thin Oracle JDBC (ojdbc)

jdbc:oracle:thin:@//db.example.com:1521/FREEPDB1

ADO.NET (ODP.NET) Oracle.ManagedDataAccess

User Id=app_user;Password=your_password;Data Source=db.example.com:1521/FREEPDB1;

SQLAlchemy URL python-oracledb

oracle+oracledb://app_user:[email protected]:1521/?service_name=FREEPDB1

占位符,例如 your_password 就是这样:用上面的表单自己拼一个连接字符串即可。更多关于将 SQLly 连接到 Oracle 的信息: SQLly 适用于 Oracle.

Easy Connect (Plus) 语法

[[protocol:]//]host[,host2][:port][/service_name][:server_type][/instance_name][?parameter=value&...]。协议是 tcp (默认)或 tcps;两者的端口默认都是 1521。Easy Connect 中不能使用 SID。

关键字同义词默认作用
protocol - tcp tcps:// 使用 TLS。TLS 监听器通常使用 2484,这是 Oracle 注册的端口,但你必须写明它。
port - 1521 监听器端口。
service_name - - 数据库服务,例如 PDB 名称,如 FREEPDB1 或者 ORCLPDB1.
server_type - - dedicated, shared 或者 pooled.
connect_timeout - 无 建立连接所需的秒数。
transport_connect_timeout - - TCP 连接本身允许的秒数。
retry_count / retry_delay - - / 0 连接重试次数及重试之间的间隔。
ssl_server_dn_match - ON(19.2+ 客户端) 核对服务器证书的 DN 与主机是否相符。
wallet_location - - TCPS 钱包所在的目录。

ODP.NET 连接字符串属性

ADO.NET 风格。 Data Source 接受 Easy Connect 字符串、TNS 别名或完整描述符。

关键字同义词默认作用
User Id - - 数据库用户。
Password - - 密码;如果包含特殊字符,请用双引号括起来。
Data Source - - Easy Connect、别名或描述符。
DBA Privilege - - SYSDBA, SYSOPER, SYSASM, SYSBACKUP, SYSDG, SYSKM, SYSRAC.
Connection Timeout - 15 等待池连接的秒数。
Pooling - true 连接池。
Max Pool Size - 100 最大连接池大小。
Min Pool Size - 1 最小的连接池。
Incr Pool Size - 5 连接池扩容时新增的连接。
Statement Cache Size - 0 语句按连接缓存。
Validate Connection - 假的 在分配之前检查池中的连接。
Connection Lifetime - 0 池中连接可以存活的秒数。

Oracle JDBC thin URL 格式

以连接属性方式传递用户和密码,而不是将其嵌入。

关键字同义词默认作用
jdbc:oracle:thin:@//host:port/service - - 服务名(Easy Connect)。
jdbc:oracle:thin:@tcps://host:port/service - - TLS;添加 ?wallet_location=/path 用于钱包。
jdbc:oracle:thin:@(DESCRIPTION=...) - - 完整连接描述符。
jdbc:oracle:thin:@alias?TNS_ADMIN=/path - - 来自该目录的 tnsnames.ora 的 TNS 别名(或 oracle.net.tns_admin 属性)。
jdbc:oracle:thin:@host:port:SID - - 旧式 SID 写法;建议改用服务名。

常见的 Oracle 连接错误

ORA-12154: TNS:could not resolve the connect identifier specified

原因: 客户端把这个字符串当成了 TNS 别名,却找不到它:没有 tnsnames.ora, TNS_ADMIN 指向了别处,或者别名或 Easy Connect 字符串里打错了字。

修复: 使用 Easy Connect (host:1521/service)或完整描述符来跳过 tnsnames.ora,或者设置 TNS_ADMIN 到存放相应文件的目录

ORA-12514: TNS:listener does not currently know of service requested in connect descriptor

原因: 监听器可以访问,但没有数据库向它注册这个服务名:服务名错误或拼写有误、把 SID 当成了服务名,或者数据库尚未打开。

修复: 运行 lsnrctl services (或向 DBA 询问)已注册的服务,并使用其中一个名称。

ORA-12505: TNS:listener does not currently know of SID given in connect descriptor

原因: 该字符串通过 SID 连接(host:port:SID 或者 (SID=...)),且该值不是监听器所知的 SID,通常是因为它其实是一个服务名。

修复: 切换到服务名形式: //host:port/service_name.

ORA-12541: TNS:no listener

原因: 该主机和端口上没有服务在监听:监听器已停止、端口不对,或者被防火墙挡住了。

修复: 检查 lsnrctl status 在服务器上、端口(默认 1521)以及防火墙。

ORA-01017: invalid username/password; logon denied

原因: 用户名或密码错误。密码区分大小写,带特殊字符的密码在 SQL*Plus 中可能需要加双引号。

修复: 检查凭证;在 SQL*Plus 中对密码加引号,如 user/"p@ss"@host/service.

ORA-28000: the account is locked

原因: 登录失败次数过多或者 DBA 锁定了账户。

修复: 一位 DBA 运行 ALTER USER app_user ACCOUNT UNLOCK;.

Oracle 连接字符串常见问题

什么是 Oracle Easy Connect 字符串?

一种简洁的连接标识符, host[:port]/service_name,无需 tnsnames.ora 条目。Easy Connect Plus(19c 及更高版本)增加了 tcps://、多个主机和 ?parameter=value 选项,例如 connect_timeout.

SID 和服务名有什么区别?

SID 命名一个数据库实例;服务名是客户端向监听器请求的名称,一个数据库(或可插拔数据库)可以提供多个。现代和云数据库都是通过服务名访问的。Easy Connect 仅接受服务名。

Oracle 的默认端口是多少?

1521 是监听器的默认端口。除非你另行配置,TLS(TCPS)用的也是这个默认端口;很多站点使用 2484,即 Oracle over TLS 的注册端口。

如何在不安装 Oracle Client 的情况下使用 python-oracledb 连接?

python-oracledb 默认以 Thin 模式运行,不需要 Oracle 客户端库: oracledb.connect(user=..., password=..., dsn="host:1521/service").

SQLly 可以通过连接字符串打开 Oracle 连接吗?

SQLly 可以连接到 Oracle,但它的粘贴连接字符串功能尚不支持 Oracle 字符串,因此 Oracle 的“在 SQLly 中打开”按钮不可用。请改为在 SQLly 的连接编辑器中输入主机、端口和服务名。

// 完全跳过这些字符串

连接一次。之后只管写 SQL。

SQLly 是适用于 macOS、Windows 和 Linux 的原生 SQL 工作台。在连接编辑器中粘贴连接字符串,把密码保存在系统钥匙串里,并在 Oracle 等引擎上获得模式感知的 IntelliSense。