Oracle 12c 以上版本，JDBC 连接配置指南

以 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));

表已创建。


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 错误
  • (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 中写错了符号等，也会出现这个错误

参考资料

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
平台声明：文章内容（如有图片或视频亦包括在内）由作者上传并发布，文章内容仅代表作者本人观点，简书系信息发布平台，仅提供信息存储服务。

推荐阅读更多精彩内容