以 Windows 10 操作系统为例
场景介绍
- 简单来说，12c 以上版本一个 CDB 容器对应多个 PDB 数据库服务
- JDBC 实际上操作的是 CDB 容器中的某个 PDB 服务
- 因此 JDBC 连接 12c 的方式和 11g 也略有不同
- 想了解更多 CDB 和 PDB 的知识可自行查阅
- 本文主要讲述如何用 JDBC 连接并操作 12c 以上版本的 Oracle 数据库
一、获取 PDB 容器名称和服务名称
- (1) 在 PowerShell 或者 cmd 中以超级管理员的身份进入 CDB 容器
sqlplus / as sysdba- 如果连接成功，显示结果如下
- 接下来的操作都在
SQL>命令行进行
PS C:\> sqlplus / as sysdba
SQL*Plus: Release 19.0.0.0.0 - Production on
Version 19.3.0.0.0
Copyright (c) 1982, 2019, Oracle. All rights reserved.
连接到:
Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production
Version 19.3.0.0.0
SQL>
- (2) 查看 PDB 容器名称
select name from v$pdbs;- PDB 容器名称为
ORCLPDB
SQL> select name from v$pdbs;
NAME
--------------------------------------------------------------------------------
PDB$SEED
ORCLPDB
- (3) 查看 PDB 服务名称
select name, pdb from v$services;- 可以看到步骤 (3) 获得的
ORCLPDB容器对应的服务名称是orclpdb
SQL> select name, pdb from v$services;
NAME
--------------------------------------------------------------------------------
PDB
--------------------------------------------------------------------------------
SYS$USERS
CDB$ROOT
orclpdb
ORCLPDB
二、配置服务器连接信息
- 修改 tnsname.ora 文件
- 文件路径
$Oracle_home\network\admin\tnsname.ora - 其中开头的
ORCLPDB就是步骤 一、(2) 获取的 PDB 容器名称 -
SERVICE_NAME = orclpdb中的orclpdb就是步骤 一、(3) 获取的 PDB 服务名称
- 文件路径
ORCLPDB =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = orclpdb)
)
)
三、创建 scott 用户
- (1) 将会话从 CDB 容器转到配置好的 PCB 容器
alter session set container = ORCLPDB;- PDB 名称 ORCLPDB 是从步骤 一、(2) 中获取的
SQL> alter session set container = ORCLPDB;
会话已更改
- (2) 使用 sys 用户，以超级管理员的身份连接到 PCB 数据库
conn sys/change_on_install@orclpdb as sysdba- 其中 sys 的密码如果没有设置过，默认是
change_on_install
SQL> conn sys/change_on_install@orclpdb as sysdba;
已连接。
- (3) 创建 scott 用户
create user scott identified by tiger;- 其中 scott 和 tiger 分别是用户名和密码
SQL> create user scott identified by tiger;
用户已创建。
- (4) 为 scott 用户授权
-
grant connect,resource to scott;- 拥有 connect 权限的用户可以登录Oracle
- 拥有 resource 权限的用户可以创建实体
-
grant unlimited tablespace to scott;- 分配表空间配额，在配额使用范围内创建表
-
SQL> grant connect,resource to scott;
授权成功。
SQL> grant unlimited tablespace to scott;
授权成功。
- (5) 使用 scott 用户连接 PDB 数据库
conn scott/tiger@orclpdb
SQL> conn scott/tiger@orclpdb;
已连接。
四、使用 JDBC 操作 PDB 数据库里的表
- (1) 在 scott 用户下，新建一张表用于测试
create table student(id number, name varchar2(20));
SQL> create table student(id number, name varchar2(20));
表已创建。
- (2) 用 JDBC 程序操作新建的表
- 根据 Oracle 和 JDK 版本，下载对应的 ojdbc.jar
- 本例中使用的版本是 Oracle 19c(19.3)，JDK1.8
- 对应的 ojdbc 版本 ojdbc8.jar
- 下载地址
- 详细代码和注释如下
import java.sql.*;
/**
* 测试 JDBC 连接 Oracle 数据库
*
* 版本信息：
* JDK1.8
* Oracle 19c(19.3)
* ojdbc8.jar
*
* @author admin
*/
public class TestJDBC {
public static void main(String[] args) {
try {
// 反射方式加载数据库驱动
Class.forName("oracle.jdbc.OracleDriver");
// 数据库连接 url
// 注意：连接 CDB 时，端口号 1521 后是冒号 ":"，如 xxx:1521:ORCL
// 连接 PDB 时，端口号 1521 后是斜杠 "/"，如 xxx:1521/ORCLPDB
String url = "jdbc:oracle:thin:@127.0.0.1:1521/ORCLPDB";
// 用户名和密码
String userName = "scott";
String password = "tiger";
// 创建连接
Connection connection = DriverManager.getConnection(url, userName, password);
// 创建 Statement 对象
Statement statement = connection.createStatement();
// 编写插入 sql 语句
String sql = "insert into student values(1, 'Tom')";
// 执行插入语句并获取结果
int count = statement.executeUpdate(sql);
// 执行正确后的打印结果
// 插入条数： 1
System.out.println("插入条数： " + count);
// 编写查询 sql 语句
sql = "select * from student where id=1";
// 执行查询语句并获取结果
ResultSet resultSet = statement.executeQuery(sql);
// 遍历并打印查询结果
while (resultSet.next()) {
int id = resultSet.getInt("id");
String name = resultSet.getString("name");
// 执行正确后的打印结果
// id=1, name=Tom
System.out.println("id=" + id + ", name=" + name);
}
} catch (ClassNotFoundException | SQLException e) {
e.printStackTrace();
}
}
}
常见错误
- (1)
java.sql.SQLException: ORA-01017: 用户名/口令无效; 登录被拒绝- 确认连接地址 url 中，端口号 1521 后是 PDB 地址，不是 CDB 地址
- 如果连接到 CDB，CDB 中没有创建相关的用户，自然会提示用户名/口令无效
- (2)
ORA-12505, TNS:listener does not currently know of SID given in connect descriptor- 检查连接地址 url 中，端口号 1521 后是斜杠+PDB 地址
xx1521/ORCLPDB，不是冒号 - 如果是冒号，会根据 PDB 的服务名称，去 CDB 中查找同名的容器，因此报找不到 SID 错误
- 检查连接地址 url 中，端口号 1521 后是斜杠+PDB 地址
- (3)
No suitable driver found for jdbc:oracle:thin:@xxx.x.x.x:1521/xxxx- 原因1：数据库驱动版本不对，请检查 Oracle 安装版本、JDK 版本和 ojdbc.jar 是否匹配
- 原因2：url 连接书写错误，如
jdbc:oracle:thin:@xxx.x.x.x:1521/xxxx中写错了符号等，也会出现这个错误
参考资料
- Oracle12c中scott用户的创建方法
- Oracle 12c JDBC方式连接PDB数据库
- 解析grant connect, resource to user语句
- JDBC 原理及使用 Statement 访问数据库
- DT 课堂颜群的《JavaWeb视频教程》第 13 课
- https://www.bilibili.com/video/BV18s411u7EH?p=13
