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