PL/SQL Developer如何新建数据库连接配置？

在 Oracle 数据库的日常开发与管理工作中，PL/SQL Developer 以其强大的功能和便捷的操作，成为了众多开发者的首选集成开发环境（IDE），而所有高效工作的起点，便是成功建立一个与目标数据库的稳定连接，掌握如何在 PL/SQL Developer 中新建数据库连接，是每一位使用者必须迈出的第一步，本文将详细、清晰地介绍这一过程，并分享一些实用技巧,帮助您快速上手。

第一步：打开数据库连接窗口

启动 PL/SQL Developer 后，您会看到主界面，要新建连接，最直接的方式是点击工具栏上那个类似“插头”的图标（“Database”下拉菜单旁的按钮），您也可以通过菜单栏选择 文件 -> 新建 -> 数据库连接，或者使用快捷键 Ctrl+N，点击后，会弹出一个名为“选择数据库连接”的对话框,这里就是我们配置连接信息的核心区域。

第二步：配置连接参数

这个对话框中包含了连接数据库所需的所有关键信息，每个字段都至关重要，必须准确填写，为了更直观地理解,下表详细列出了各个参数的含义和配置方法：

参数名称	描述	配置示例
连接名称	为这个连接起一个易于识别的名称，方便日后区分和管理。	生产环境-财务系统、本地测试库
用户名	用于登录数据库的账户名。	scott、hr、system
密码	对应用户名的登录密码。	tiger
数据库	这是连接配置的核心，根据下方选择的“连接方式”，此处填写的内容不同。	ORCL (TNS别名) 或 168.1.100:1521/ORCLPDB1 (直接连接)
连接方式	决定了 PL/SQL Developer 如何解析“数据库”字段，通常有两种选择。	TNS 或 直接
主机	当选择“直接”连接时，填写数据库服务器的 IP 地址或主机名。	168.1.100、db-server.mycompany.com
端口	数据库监听器正在监听的端口号，Oracle 默认为 1521。	1521
SID / 服务名	当选择“直接”连接时，需要指定数据库实例的标识符，现代 Oracle 环境推荐使用服务名。	SID: ORCL；服务名: ORCLPDB1.localdomain

连接方式详解：

• TNS 连接：这是最传统和常见的方式，它依赖于本地配置的 tnsnames.ora 文件，该文件存储了数据库别名（即“数据库”字段中填写的内容）与具体网络地址（主机、端口、SID/服务名）的映射关系，使用 TNS 的好处是，当数据库地址变更时，只需修改 tnsnames.ora 文件，而无需逐个修改 PL/SQL Developer 中的连接配置。
• 直接连接：这种方式不依赖 tnsnames.ora 文件，而是将所有网络信息直接在 PL/SQL Developer 中指定，格式通常为 主机:端口/SID 或 主机:端口/服务名，它的优点是便携性强，换一台电脑只要知道连接信息就能立刻使用,无需额外配置文件。

第三步：测试并保存连接

在填写完所有信息后，强烈建议先点击“测试”按钮，PL/SQL Developer 会尝试使用您提供的参数连接数据库，如果连接成功，会弹出“连接成功”的提示框；如果失败，则会显示具体的错误代码和信息（如 ORA-12154 或 ORA-12541）,这为排查问题提供了关键线索。

测试通过后，点击“确定”或“保存”按钮，这个新的数据库连接就会出现在主界面的连接列表中，下次启动时，只需双击该连接，输入密码（如果未保存密码）,即可快速登录。

高效管理：连接的颜色与分组

为了进一步提升工作效率，PL/SQL Developer 提供了连接颜色编码功能，在连接配置窗口中，您可以点击“颜色”下拉框，为不同的连接设置不同的背景色，可以为生产环境设置醒目的红色，为测试环境设置安全的绿色，从而有效避免误操作，您还可以在连接列表中右键，选择“新建文件夹”，将不同项目或环境的连接进行分组管理,使界面更加整洁有序。

---

常见问题解答 (FAQs)

Q1: 提示“ORA-12154: TNS: 无法解析指定的连接标识符”是什么意思？如何解决？

A1: 这个错误通常在使用 TNS 连接方式时出现，它的意思是 PL/SQL Developer 无法根据您在“数据库”字段中填写的别名，在 tnsnames.ora 文件中找到对应的网络配置,解决方法如下：

1. 检查 Oracle 主目录：在 PL/SQL Developer 中，进入 工具 -> 首选项 -> Oracle -> 连接，查看“Oracle 主目录”和“OCI 库”的路径是否正确指向了您的 Oracle 客户端安装位置。
2. ：该文件通常位于上述 Oracle 主目录下的 network/admin 文件夹内，打开文件，确认您使用的连接别名是否存在，并且其后的配置（HOST, PORT, SID/SERVICE_NAME）格式正确、没有拼写错误。
3. 环境变量：检查系统环境变量 TNS_ADMIN 是否设置，如果设置了，PL/SQL Developer 会优先从该变量指向的目录寻找 tnsnames.ora 文件。

Q2: 连接时出现“ORA-12541: TNS: 无监听程序”错误怎么办？

A2: 这个错误表明您的客户端已经成功解析了数据库地址（无论是通过 TNS 还是直接连接），但在目标服务器上，没有找到正在运行的数据库监听程序，或者监听程序没有在您指定的端口上监听,解决步骤如下：

1. 确认服务器端监听状态：登录到数据库服务器，打开命令行工具，使用 lsnrctl status 命令查看监听器的状态，如果显示“没有监听程序”，则使用 lsnrctl start 命令启动它。
2. 检查防火墙：确保数据库服务器的防火墙允许来自您客户端 IP 地址的、通过指定端口（默认 1521）的访问请求。
3. 核对连接信息：再次确认您在 PL/SQL Developer 中填写的“主机”地址和“端口”是否与服务器上监听器实际监听的地址和端口完全一致,有时监听器可能配置在非标准端口上。