| // |
| // Licensed to the Apache Software Foundation (ASF) under one |
| // or more contributor license agreements. See the NOTICE file |
| // distributed with this work for additional information |
| // regarding copyright ownership. The ASF licenses this file |
| // to you under the Apache License, Version 2.0 (the |
| // "License"); you may not use this file except in compliance |
| // with the License. You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, |
| // software distributed under the License is distributed on an |
| // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| // KIND, either express or implied. See the License for the |
| // specific language governing permissions and limitations |
| // under the License. |
| // |
| |
| = 从 NetBeans IDE 连接到 Oracle 数据库 |
| :jbake-type: tutorial |
| :jbake-tags: tutorials |
| :jbake-status: published |
| :icons: font |
| :syntax: true |
| :source-highlighter: pygments |
| :toc: left |
| :toc-title: |
| :description: 从 NetBeans IDE 连接到 Oracle 数据库 - Apache NetBeans |
| :keywords: Apache NetBeans, Tutorials, 从 NetBeans IDE 连接到 Oracle 数据库 |
| |
| NetBeans IDE 包括对 Oracle 数据库的内置支持。您可以轻松地从 IDE 建立连接，并开始使用数据库。本教程介绍了如何使用本地安装的 Oracle Database 10_g_ Express Edition (Oracle Database XE)，这是一种可免费开发、部署和分发的小型数据库。 |
| |
| 本文档说明了如何从 NetBeans IDE <<connect,建立到本地安装>>的 Oracle Database XE 的连接、如何使用 IDE 的内置 SQL 编辑器<<createuser,处理数据库数据>>，以及如何<<oci8,启用 OCI 8 PHP 扩展>>以编写连接到 Oracle 数据库的 PHP 代码。 |
| |
| |
| *要学习本教程，您需要具备以下软件和资源。* |
| |
| |=== |
| |软件或资源 |要求的版本 |
| |
| |link:https://netbeans.org/downloads/index.html[+NetBeans IDE+] |7.2、7.3、7.4、8.0、Java EE 包 |
| |
| |link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Java 开发工具包 (JDK)+] |版本 7 或 8 |
| |
| |link:http://www.oracle.com/technetwork/database/express-edition/overview/index.html[+Oracle Database XE+] |10 _g_ Express Edition |
| |
| |link:http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-112010-090769.html[+Oracle JDBC 驱动程序+] |link:http://download.oracle.com/otn/utilities_drivers/jdbc/11202/ojdbc6.jar[+ojdbc6.jar+] |
| |=== |
| |
| |
| == 开始之前 |
| |
| 在开始学习本教程之前，请注意以下事项： |
| |
| * 本教程介绍了如何连接到本地系统上安装的 Oracle Database XE 实例，但这些步骤也适用于连接到远程实例。如果要连接到本地实例，您需要link:http://www.oracle.com/technetwork/database/express-edition/overview/index.html[+下载+]并安装 Oracle Database XE。安装过程非常简单直观，但如果遇到问题，请参见适用于您的平台的《link:http://www.oracle.com/pls/xe102/homepage[+Oracle Database XE 安装指南+]》。 |
| * 有两种类型的 Oracle JDBC 驱动程序：OCI 和 JDBC Thin。 |
| * Oracle 的 JDBC Thin 驱动程序基于 Java，而与平台无关。该独立驱动程序不要求有其他 Oracle 库，并允许直接连接到 Oracle 数据库。本教程使用该驱动程序说明如何连接到 Oracle 数据库。在开始学习本教程之前，您需要link:http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-112010-090769.html[+下载+] ``ojdbc6.jar`` 文件并将其保存到您的系统上。 |
| |
| *Windows 用户注意事项：*Windows 可能会将下载文件的扩展名从 .jar 更改为 .zip。不过，它仍是 .jar 文件。您可以将该文件重命名为 .jar。 |
| |
| * Oracle 的 OCI 驱动程序使用 Oracle 的本机客户端库与数据库通信。这些库是作为 Oracle Instant Client 的一部分获取的。虽然大多数情况下使用 Thin 驱动程序就足够了，但也可能需要按照<<oci,将 OCI JDBC 驱动程序与 NetBeans IDE 一起使用>>中的步骤使用 OCI 驱动程序。 |
| 使用 OCI 驱动程序的一个很好的例子是，在 PHP 应用程序中使用 Oracle Instant Client 库访问远程 Oracle 数据库。有关如何启用 OCI8 PHP 扩展的信息，请参见本教程中的 <<oci8,OCI 8 PHP 扩展和适用于 PHP 的 NetBeans IDE>> 部分。 |
| * 如果从未使用过 Oracle Database XE，则需要获取 Oracle Database XE link:http://download.oracle.com/docs/cd/B25329_01/doc/admin.102/b25610/toc.htm[+使用入门教程+]。 |
| |
| *GlassFish 用户警告：*默认情况下，用于管理数据库的 Oracle Database XE 主页使用端口 8080。默认情况下，Oracle GlassFish Application Server 也使用端口 8080。如果同时运行这两个程序，则 Oracle Database XE 会阻止浏览器访问 GlassFish（位于 localhost:8080）。在这种情况下，GlassFish 上部署的所有应用程序都返回 404。简单的解决方案是，在运行 GlassFish 时，关闭不需要用到的 Oracle Database XE。如果需要同时运行这两个程序，请更改 Oracle Database XE 使用的默认端口。这比更改 GlassFish 的默认端口要简单。Internet 上提供了很多有关更改 Oracle Database XE 默认端口的指令集，包括 link:https://forums.oracle.com/forums/thread.jspa?threadID=336855[+Oracle 论坛+]中的指令集。 |
| |
| |
| == 建立到 Oracle 数据库的连接 |
| |
| 在本练习中，将测试并建立到数据库的新连接。 |
| |
| 1. 启动 Oracle 数据库。 |
| 2. 打开 "Services"（服务）窗口（"Window"（窗口）> "Services"（服务）或按 Ctrl-5 组合键；在 Mac 上按 ⌘-5 组合键）。在 "Services"（服务）窗口中，右键单击 "Databases"（数据库）节点，然后选择 "New Connection"（新建连接）。 |
| |
| image::images/new-connection.png[] |
| |
| |
| . 在新建连接向导中，从 "Driver"（驱动程序）下拉列表中选择 "Oracle Thin"。 |
| . 单击 "Add"（添加），然后找到以前下载的文件 ``ojdbc6.jar`` 。单击 "Next"（下一步）。 |
| . 在该向导的 "Customize Connection"（定制连接）面板中输入以下值，然后单击 "Next"（下一步）。 |
| |
| |=== |
| |
| |名称 |值 |
| |
| |Driver Name（驱动程序名称） |Oracle Thin（带有服务 ID (SID)） |
| |
| |Host（主机） | ``localhost`` 或 127.0.0.1。 |
| _注_：对于远程连接，请提供安装了该数据库的计算机的 IP 地址或可解析主机名。 |
| |
| |Port（端口） |1521（默认值） |
| |
| |Service ID (SID)（服务 ID (SID)） | ``XE`` （Oracle Database XE 的默认 SID）。 |
| _注_：如果要连接到远程数据库，请要求数据库管理员为您提供数据库 SID。 |
| |
| |Username（用户名） | |
| |
| 请输入用户名。 |
| 就本教程而言，请输入 ``system`` （默认数据库管理员帐户）和安装数据库期间使用的口令。 |
| |
| |
| |
| |Password |输入与选定用户名相对应的口令。 |
| |=== |
| |
| |
| . 单击 "Test Connection"（测试连接），以确认 IDE 能否连接到数据库。单击 "Next"（下一步）。 |
| |
| 如果尝试成功，则会在向导中显示 "Connection succeeded"（连接成功）消息。 |
| |
| image::images/customize-conn.png[] |
| |
| |
| . 在 "Select Schema"（选择方案）下拉列表中选择 ``HR`` 。单击 "Finish"（完成）。 |
| |
| NOTE: 您需要解锁 HR 方案，然后才能在 NetBeans 中访问它。解锁 HR 数据库在 Oracle Database XE link:http://download.oracle.com/docs/cd/B25329_01/doc/admin.102/b25610/toc.htm[+使用入门教程+]中进行了介绍。 |
| |
| 此时将在 "Services"（服务）窗口的 "Databases"（数据库）节点下面显示新连接。您可以展开该连接，然后开始浏览数据库对象的结构。 |
| 更改连接节点的显示名称：从节点的弹出式菜单中选择 "Properties"（属性），然后单击 "Display Name"（显示名称）属性的省略号按钮。输入 OracleDB 作为显示名称，然后单击 "OK"（确定）。 |
| |
| image::images/connection.png[] |
| |
| NOTE: 虽然以上步骤说明的是连接到本地数据库实例的情况，连接到_远程_数据库的步骤也相同。唯一的区别是，输入安装 Oracle 数据库的远程计算机的 IP 地址或主机名，而不是将 ``localhost`` 指定为主机名。 |
| |
| |
| == 处理 Oracle 数据库中的数据 |
| |
| 与数据库进行交互的一种常见方法是，在 SQL 编辑器中运行 SQL 命令或使用数据库管理界面。例如，Oracle Database XE 具有基于浏览器的界面，您可以通过该界面管理数据库，管理数据库对象以及处理数据。 |
| |
| 虽然可以通过 Oracle 数据库管理界面执行大多数与数据库有关的任务，但在本教程中，我们介绍如何使用 NetBeans IDE 中的 SQL 编辑器执行其中的一些任务。以下练习介绍了如何创建新用户、如何快速重新创建表，以及如何复制表数据。 |
| |
| |
| === 创建用户 |
| |
| 让我们创建一个新数据库用户帐户以处理数据库中的表和数据。要创建新的用户，您必须使用数据库管理员帐户登录。在本示例中，我们使用在安装数据库期间创建的默认 ``system`` 帐户。 |
| |
| 1. 在 "Services"（服务）窗口中，右键单击 "OracleDB" 连接节点，然后选择 "Execute Command"（执行命令）。此时将打开 NetBeans IDE 的 SQL 编辑器，您可以在其中输入将发送到数据库的 SQL 命令。 |
| |
| image::images/execute.png[] |
| |
| |
| . 要创建新用户，请在 "SQL Editor"（SQL 编辑器）窗口中输入以下命令，然后单击工具栏上的 "Run SQL"（运行 SQL）按钮。 |
| |
| image::images/create-user.png[] |
| |
| [source,sql] |
| ---- |
| |
| create user jim identified by mypassword default tablespace users temporary tablespace temp quota unlimited on users; |
| ---- |
| |
| 该命令可创建新用户 ``jim`` ，口令为 ``mypassword`` 。默认表空间为 ``users`` ，且分配的空间不受限制。 |
| |
| |
| . 下一步是为 ``jim`` 用户帐户授予在数据库中执行操作的权限。我们需要允许该用户连接到数据库，在用户默认表空间中创建和修改表以及访问 ``hr`` 样例数据库中的 ``Employees`` 表。 |
| |
| 实际上，数据库管理员可创建定制角色，并微调每个角色的权限。但就本教程而言，我们可以使用预定义的角色，例如 ``CONNECT`` 。有关角色和权限的详细信息，请参见 link:http://download.oracle.com/docs/cd/E11882_01/network.112/e16543/toc.htm[+Oracle 数据库安全指南+]。 |
| |
| |
| [source,sql] |
| ---- |
| grant connect to jim; |
| grant create table to jim; |
| grant select on hr.departments to jim; |
| ---- |
| |
| |
| === Oracle 数据库中的表空间 |
| |
| 表空间是任何 Oracle 数据库的逻辑数据库存储单元。事实上，数据库的所有数据都存储在表空间中。您可以在分配的表空间中创建表。如果未明确为用户指定默认表空间，则默认使用系统表空间（最好避免出现这种情况）。 |
| |
| 有关表空间概念的详细信息，请参见 link:http://www.orafaq.com/wiki/Tablespace[+Oracle 常见问题解答：表空间+] |
| |
| |
| |
| === 创建表 |
| |
| 可以使用几种方法通过 NetBeans IDE 在数据库中创建表。例如，您可以运行 SQL 文件（右键单击文件并选择 "Run File"（运行文件）），执行 SQL 命令（右键单击连接节点并选择 "Execute Command"（执行命令））或使用 "Create Table"（创建表）对话框（右键单击 "Tables"（表）节点并选择 "Create Table"（创建表））。在本练习中，将使用一个表的结构重新创建另一个表。 |
| |
| 在本示例中，您希望用户 ``jim`` 通过 ``hr`` 数据库重新创建 ``Departments`` 表，以便在其方案中创建该表的副本。在创建该表之前，您需要与服务器断开连接，然后以用户 ``jim`` 身份登录。 |
| |
| 1. 在 "Services"（服务）窗口中右键单击 ``OracleDB`` 连接节点，然后选择 "Disconnect"（断开连接）。 |
| 2. 右键单击 ``OracleDB`` 连接节点，选择 "Connect"（连接），然后以 ``jim`` 身份登录。 |
| 3. 展开 "HR" 方案下面的 "Tables"（表）节点，然后确认用户 ``jim`` 只能访问 ``Departments`` 表。 |
| |
| 在创建用户 ``jim`` 后，选择权限仅限于 ``Departments`` 表。 |
| |
| image::images/hr-view.png[] |
| |
| |
| . 右键单击 ``Departments`` 表节点，然后选择 "Grab Structure"（抓取结构）。将 ``.grab`` 文件保存到磁盘上。 |
| . 展开 ``JIM`` 方案，右键单击 ``Tables`` （表）节点，然后选择 "Recreate Table"（重新创建表）。 |
| 指向您创建的 ``.grab`` 文件。 |
| |
| image::images/recreate.png[] |
| |
| |
| . 查看用于创建表的 SQL 脚本。单击 "OK"（确定）。 |
| |
| image::images/nametable.png[] |
| |
| 单击 "OK"（确定）时，将会创建新的 ``DEPARTMENTS`` 表，并在 ``JIM`` 方案节点下面显示该表。如果右键单击表节点并选择 "View Data"（查看数据），则会看到该表是空的。 |
| |
| 如果要将原始 ``Departments`` 表中的数据复制到新表，则既可在表编辑器中手动输入数据，也可针对新表运行 SQL 脚本以填充该表。 |
| |
| *要手动输入数据，请执行以下步骤。* |
| |
| 1. 右键单击 ``JIM`` 方案下方的 ``DEPARTMENTS`` 表，然后选择 "View Data"（查看数据）。 |
| 2. 单击 "View Data"（查看数据）工具栏上的 "Insert Record"（插入记录）图标，以打开 "Insert Record"（插入记录）窗口。 |
| |
| image::images/insert-rec.png[] |
| |
| |
| . 在字段中以键入方式输入数据。单击 "OK"（确定）。 |
| |
| 例如，可以输入从原始 ``DEPARTMENTS`` 表中提取的以下值。 |
| |
| |=== |
| |列 |值 |
| |
| |DEPARTMENT_ID |10 |
| |
| |DEPARTMENT_NAME |Administration |
| |
| |MANAGER_ID |200 |
| |
| |LOCATION_ID |1700 |
| |=== |
| |
| *要使用 SQL 脚本填充表，请执行以下步骤。* |
| |
| 1. 右键单击 ``JIM`` 方案下方的 ``DEPARTMENTS`` 表，然后选择 "Execute Command"（执行命令）。 |
| 2. 在 "SQL Command"（SQL 命令）标签中输入脚本。单击工具栏中的 "Run"（运行）按钮。 |
| |
| 以下脚本使用原始表中的数据填充新表的第一行。 |
| |
| |
| [source,sql] |
| ---- |
| INSERT INTO JIM.DEPARTMENTS (DEPARTMENT_ID, DEPARTMENT_NAME, MANAGER_ID, LOCATION_ID) VALUES (10, 'Administration', 200, 1700); |
| ---- |
| |
| 您可以通过执行以下步骤，获取使用原始表填充新表的 SQL 脚本。 |
| |
| 1. 右键单击 ``HR`` 方案下方的 ``DEPARTMENTS`` 表，然后选择 "View Data"（查看数据）。 |
| 2. 在 "View Data"（查看数据）窗口中选择所有行，在该表中右键单击，然后从弹出式菜单中选择 "Show SQL Script for INSERT"（显示 INSERT 的 SQL 脚本），以打开包含脚本的 "Show SQL"（显示 SQL）对话框。 |
| |
| 然后，您可以复制该脚本并根据需要进行修改，在您的表中插入数据。 |
| |
| 有关使用 SQL 编辑器的详细信息，请参见<<tips,提示>>。 |
| |
| |
| === 使用表数据 |
| |
| 要使用表数据，可以利用 NetBeans IDE 中的 SQL 编辑器。通过运行 SQL 查询，可以添加、修改和删除数据库结构中保留的数据。 |
| |
| 首先，在 ``jim`` 方案中创建第二个名为 Locations 的表（仍然使用 jim 的用户帐户登录）。这一次，我们只需要在 IDE 中运行现成的 SQL 文件即可： |
| |
| 1. 下载 link:https://netbeans.org/project_downloads/samples/Samples/Java/locations.sql[+locations.sql+] 文件并将其保存到计算机上的 _USER_HOME_ 目录中。 |
| 2. 打开 IDE 的 "Favorites"（收藏夹）窗口，然后找到 ``locations.sql`` 文件。 |
| |
| 要打开 "Favorites"（收藏夹）窗口，请在主菜单中单击 "Window"（窗口）> "Favorites"（收藏夹）（按 Ctrl-3 组合键）。默认情况下，将在 "Favorites"（收藏夹）窗口中列出 _USER_HOME_ 目录。 |
| |
| |
| . 右键单击 ``locations.sql`` 文件，然后选择 "Run File"（运行文件）。 |
| |
| image::images/run-file.png[] |
| |
| NOTE: 如果有多个数据库连接注册到 IDE，则 IDE 可能会提示您选择正确的连接。 |
| |
| |
| . 在 "Services"（服务）窗口中，右键单击 "Tables"（表）节点，然后在弹出式菜单中选择 "Refresh"（刷新）。 |
| |
| 您可以看到在 ``JIM`` 方案中添加了包含数据的 ``Locations`` 表。 |
| |
| image::images/second-table.png[] |
| |
| |
| . 右键单击 Locations 表节点，然后选择 "View Data"（查看数据）以查看表内容。您将看到 Locations 表的内容。 |
| 您可以直接在此视图窗口中插入新记录和修改现有数据。 |
| |
| image::images/view-data1.png[] |
| |
| |
| . 接下来，我们运行一个查询以显示以下两个表中的信息：Departments 和 Locations。 |
| |
| 在本示例中，我们使用简单的“自然合并”，因为两个表具有相同的 "location_id" 列，其中保存了相同数据类型的值。这种合并仅选择在匹配 location_id 列中具有相等值的行。 |
| |
| 打开 "SQL Command"（SQL 命令）窗口（右键单击 ``JIM`` 方案下面的 ``Tables`` （表）节点，然后选择 "Execute Command"（执行命令）），输入以下 SQL 语句，然后单击 "Run SQL"（运行 SQL）图标。 |
| |
| |
| [source,sql] |
| ---- |
| |
| SELECT DEPARTMENT_NAME, MANAGER_ID, LOCATION_ID, STREET_ADDRESS, POSTAL_CODE, CITY, STATE_PROVINCE |
| FROM departments NATURAL JOIN locations |
| ORDER by DEPARTMENT_NAME; |
| ---- |
| |
| 该 SQL 查询返回 Departments 表中的 location_id 值与 Locations 表中的匹配列值相等的行，并按 Department 名称对结果进行排序。请注意，您无法在此查询结果中直接插入新记录，这与单个表的表示形式不同。 |
| |
| image::images/join.png[] |
| |
| 您可以将 SQL 合并查询保存为视图（右键单击 "View"（视图）节点，然后选择 "Create View"（创建视图）），并在以后需要时方便地运行该视图。为此，应为数据库用户授予我们的样例用户所没有的 "Create View"（创建视图）权限。您可以使用 system 帐户登录，为 ``jim`` 授予 "Create View"（创建视图）权限（使用以下 SQL 语句："grant create view to jim;"），然后尝试创建自己的视图。 |
| |
| |
| === NetBeans IDE SQL 编辑器使用提示 |
| |
| 如果学习过本教程前面的内容，则您已使用了 NetBeans IDE SQL 编辑器功能。我们在此处列出了几个可能对您有用的其他 NetBeans IDE SQL 编辑器功能。 |
| |
| 1. *数据库表的 GUI 视图*。在 "Services"（服务）窗口中右键单击表节点并选择 "View Data"（查看数据）时，IDE 将显示该表的可视表示形式及其数据（如上图所示）。您还可以在该视图中直接添加、修改和删除表数据。 |
| * 要添加记录，请单击 "Insert Records"（插入记录）image:images/row-add.png[] 图标并在打开的 "Insert Records"（插入记录）窗口中插入新数据。单击 "Show SQL"（显示 SQL）按钮以查看该操作的 SQL 代码。该表将使用新记录自动更新。 |
| * 要修改记录，请在表的 GUI 视图中的任何单元格内直接双击，然后键入新值。在提交更改之前，将使用绿色显示修改的文本。要提交更改，请单击 "Commit Changes"（提交更改）image:images/row-commit.png[] 图标。要取消更改，请单击 "Cancel Edits"（取消编辑）image:images/row-commit.png[] 图标。 |
| * 要删除行，请选择该行并单击 "Delete Selected Records"（删除选定的记录）image:images/row-commit.png[] 图标。 |
| |
| [start=2] |
| . *保留先前的标签*。在 SQL 编辑器工具栏上单击 "Keep Prior Tabs"（保留先前的标签）image:images/keepoldresulttabs.png[] 图标以保留打开以前查询结果的窗口。如果要比较多个查询的结果，这可能很有用。 |
| |
| [start=3] |
| . *SQL 历史记录*（Ctrl-Alt-Shift-H 组合键）。使用 SQL 编辑器工具栏上的 "SQL History"（SQL 历史记录）image:images/sql-history.png[] 图标可查看已为每个数据库连接运行的所有 SQL 语句。从下拉列表中选择该连接，查找所需的 SQL 语句，然后单击 "Insert"（插入）将该语句放在 "SQL Command"（SQL 命令）窗口中。 |
| |
| [start=4] |
| . *连接列表*。如果有多个数据库连接，并需要在 SQL 编辑器中快速切换这几个连接，请使用 "Connections"（连接）下拉列表。 |
| |
| [start=5] |
| . *运行 SQL 语句*。要运行当前 "SQL Command"（SQL 命令）窗口中的完整语句，请单击 "Run SQL"（运行 SQL）image:images/runsql.png[] 图标。如果您希望只运行 SQL 语句的一部分，请在 "SQL Command"（SQL 命令）窗口中将其选中，右键单击所选内容，然后选择 "Run Selection"（运行选择）。在这种情况下，仅执行所选的部分。 |
| |
| |
| |
| == OCI 8 PHP 扩展和适用于 PHP 的 NetBeans IDE |
| |
| 您可以使用 OCI 8 PHP 扩展和适用于 PHP 的 NetBeans IDE 编写 PHP 代码，以便与 Oracle 数据库通信。使用适用于 PHP 的 NetBeans IDE 和 Oracle 数据库： |
| |
| 1. 按照 link:../../trails/php.html[+PHP 学习资源+]的“配置 PHP 开发环境”部分所述，设置 PHP 环境。请注意，NetBeans IDE 仅支持 PHP 5.2 或 5.3。 |
| 2. 在编辑器中打开 ``php.ini`` 文件。确保将 ``extension_dir`` 属性设置为 PHP 扩展目录。此目录通常为 ``PHP_HOME/ext`` 。例如，在将 PHP 5.2.9 安装到 ``C:`` 根目录时， ``extension_dir`` 设置应为 ``extension_dir="C:\php-5.2.9\ext"`` 。 |
| 3. 找到 ``extension=php_oci8_11g.dll`` （适用于 Oracle 11g）或 ``extension=php_oci8.dll`` （适用于 Oracle 10.2 或 XE）行并取消注释。每次只能启用其中的一个扩展。 |
| |
| *重要说明：*如果 ``php.ini`` 中没有这些行，请在 extensions 文件夹中查找 OCI 8 扩展文件。如果 extensions 文件夹中没有 OCI 8 扩展文件，请参见link:http://www.oracle.com/technetwork/articles/technote-php-instant-084410.html[+在 Linux 和 Windows 中安装 PHP 和 Oracle Instant Client+] 以了解 OCI 8 的下载和安装信息。 |
| |
| |
| . 重新启动 Apache。（Windows 用户应重新启动计算机。） |
| . 运行 ``phpinfo()`` 。如果成功启用了 OCI 8，则会在 ``phpinfo()`` 输出中显示 OCI 8 部分。 |
| |
| 有关启用 OCI 8 的详细信息（尤其是将 OCI 8 与远程 Oracle DB 服务器一起使用的信息），请参见link:http://www.oracle.com/technetwork/articles/technote-php-instant-084410.html[+在 Linux 和 Windows 中安装 PHP 和 Oracle Instant Client+]。 |
| |
| 如果启用了 OCI 8，适用于 PHP 的 NetBeans IDE 将访问该扩展以完成代码并进行调试。 |
| |
| image::images/oci-cc.png[] |
| |
| |
| == 将 OCI JDBC 驱动程序与 NetBeans IDE 一起使用 |
| |
| OCI 驱动程序包是在与 JDBC Thin 驱动程序 ( ``ojdbc6.jar`` ) 相同的 JAR 文件中提供的。选择使用哪个驱动程序取决于以下接口： ``oracle.jdbc.OracleDriver`` 用于 Thin 驱动程序； ``oracle.jdbc.driver.OracleDriver`` 用于 OCI 驱动程序。要使用 OCI 驱动程序，还必须安装 Oracle Database Instant Client，因为它包含 OCI 驱动程序与数据库进行通信所需的所有库。 |
| |
| *从 NetBeans IDE 中使用 Oracle OCI 驱动程序连接到 Oracle 数据库：* |
| |
| 1. link:http://www.oracle.com/technetwork/database/features/instant-client/index-100365.html[+下载+]适用于您的平台的基本 Oracle Database Instant Client 软件包。按照link:http://www.oracle.com/technetwork/database/features/instant-client/index-100365.html[+此页+]上的安装说明进行操作。 |
| 2. 在 IDE 的 "Services"（服务）窗口中，右键单击 "Databases"（数据库）节点，然后选择 "New Connection"（新建连接）。 |
| 3. 在 "Locate Driver"（查找驱动程序）步骤中，选择 "Oracle OCI"，然后单击 "Add"（添加）并指定 ``ojdbc6.jar`` 文件。 |
| 4. 在 "Customize Connection"（定制连接）对话框中，提供以下连接详细信息：IP 地址、端口、SID、用户名和口令。 |
| 请注意 OCI 和 Thin 驱动程序的 JDBC URL 的差别。 |
| |
| image::images/oci-connection.png[] |
| |
| |
| == 疑难解答 |
| |
| 下面的疑难解答提示仅介绍了我们遇到的几种异常错误。如果此处没有解答您的问题，请自行搜索或使用“发送有关此教程的反馈意见”链接提供建设性反馈。 |
| |
| * 您将会看到类似下面的错误： |
| |
| [source,bash] |
| ---- |
| |
| Shutting down v3 due to startup exception : No free port within range: |
| >> 8080=com.sun.enterprise.v3.services.impl.monitor.MonitorableSelectorHandler@7dedad |
| ---- |
| 出现这种错误的原因是，GlassFish 应用服务器和 Oracle 数据库均使用端口 8080。如果要同时使用这两个应用程序，您需要更改其中的一个应用程序的默认端口。要重置 Oracle 数据库的默认端口，您可以使用以下命令： |
| |
| [source,bash] |
| ---- |
| |
| CONNECT SYSTEM/passwordEXEC DBMS_XDB.SETHTTPPORT(<new port number>); |
| ---- |
| * 出现以下错误： |
| |
| [source,bash] |
| ---- |
| |
| Listener refused the connection with the following error: ORA-12505, TNS:listener does not currently know of SID given in connect descriptor. |
| ---- |
| 如果监听程序无法识别连接描述符提供的数据库实例的服务 ID (SID)，则会出现这种错误。出现该异常错误有几个原因。例如，如果未启动 Oracle 数据库，则可能会出现该异常（最简单的情况）。SID 不正确或监听程序无法识别 SID。如果使用默认 SID（例如，Oracle Database Express Edition 的默认 SID 为 XE），则不太可能会出现该问题。SID 包含在 ``tnsnames.ora`` 文件的 CONNECT DATA 部分（在 Windows 计算机上，该文件位于 ``%ORACLE_HOME%\network\admin\tnsnames.ora`` ）。 |
| * 出现以下错误： |
| |
| [source,bash] |
| ---- |
| |
| ORA-12705: Cannot access NLS data files or invalid environment specified. |
| ---- |
| |
| 通常，这表示 NLS_LANG 环境变量包含无效的语言、国家/地区或字符集值。如果属于这种情况，则应在操作系统级别禁用无效的 NLS_LANG 设置。对于 Windows，请在 Windows 注册表的 \HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE 中重命名 NLS_LANG 子键。对于 Linux/Unix，请运行 "unset NLS_LANG" 命令。 |
| |
| link:/about/contact_form.html?to=3&subject=Feedback:%20Connecting%20to%20Oracle%20Database%20from%20NetBeans%20IDE[+请将您的反馈意见发送给我们+] |
| |
| |
| |
| == 另请参见 |
| |
| 有关管理和使用 Oracle 数据库的更多信息，请参见相应的 Oracle 文档。我们在下面简要列出了最常用的文档。 |
| |
| * link:http://download.oracle.com/docs/cd/E11882_01/server.112/e17118/toc.htm[+Oracle 数据库 SQL 参考+]。完整介绍用于处理 Oracle 数据库中信息的 SQL 语句。 |
| * link:http://download.oracle.com/docs/cd/E11882_01/network.112/e16543/toc.htm[+Oracle 数据库安全指南+]。提供并解释在管理 Oracle 数据库时使用的主要概念。 |
| * link:http://st-curriculum.oracle.com/tutorial/DBXETutorial/index.htm[+Oracle Database 10_g_ Express Edition 教程+]。快速而详细地介绍了如何使用 Oracle Database XE。 |
| * link:http://www.oracle.com/technetwork/articles/technote-php-instant-084410.html[+在 Linux 和 Windows 中安装 PHP 和 Oracle Instant Client+]。有关安装 PHP 和 Oracle Instant Client 的直观操作方法文章。 |
| |
| 有关如何在 NetBeans IDE 中使用其他数据库的信息，请参见 |
| |
| * link:java-db.html[+使用 Java DB (Derby) 数据库+] |
| * link:mysql.html[+连接 MySQL 数据库+] |
| * link:../web/mysql-webapp.html[+使用 MySQL 数据库创建简单的 Web 应用程序+] |
