设置和说明 (12.2.0.1.0) 2017 年 7 月

下载内容包含以下产品：

a) Oracle Developer Tools for Visual Studio (12.2.0.1.0)

b) Oracle Data Provider for .NET 4 (12.2.0.1.0)

c) Oracle Data Provider for .NET 2 (12.2.0.1.0)

d) Oracle Providers for ASP.NET 4 (12.2.0.1.0)

e) Oracle Providers for ASP.NET 2 (12.2.0.1.0)

f) Oracle Data Provider for .NET Oracle TimesTen In-Memory Database (12.2.0.1.0)

g) Oracle Services for MTS (12.2.0.1.0)

h) Oracle Provider for OLE DB (12.2.0.1.0)

i) Oracle ODBC 驱动程序 (12.2.0.1.0)

j) Oracle SQL*Plus (12.2.0.1.0)

k) Oracle 调用接口 (12.2.0.1.0)

l) Oracle C++ 调用接口 (12.2.0.1.0)

m) Oracle Instant Client (12.2.0.1.0)

n) Oracle Universal Installer (12.2.0.1.0)

系统要求

ODAC 需要以下各项：

• Windows x64 操作系统
  • Windows 10（专业版、企业版和教育版）、Windows 8.1 和 Windows 8（专业版和企业版）、Windows 7（专业版、企业版、旗舰版）、Windows Server 2016（Standard、Datacenter 和 Essentials 版本）、Windows Server 2012 R2 和 Windows Server 2012（Standard、Datacenter、Essentials 和 Foundation 版本）
• 访问 Oracle Database Server（Oracle 10g 版本 2 或更高版本）

有关要求的附加说明：

• ODP.NET 需要 Microsoft .NET Framework。
  • ODP.NET 托管驱动程序需要 .NET Framework 4 或更高版本（最高 .NET Framework 4.7）
  • ODP.NET 非托管驱动程序需要 .NET Framework 3.5 SP 1 或更高版本（最高 .NET Framework 4.7）
• Oracle Developer Tools for Visual Studio 需要 Microsoft Visual Studio 2017 或 Visual Studio 2015

注：Oracle Developer Tools 不支持 Visual Studio Express Edition。不过，Visual Studio Express Edition 支持 ODP.NET。

• 如果您将分布式事务处理与 ODP.NET 结合使用，请阅读《ODP.NET 开发人员指南》，详细了解如何将应用配置为使用分布式事务处理。

安装说明

在使用 Oracle Universal Installer 安装 ODAC 时，需按照以下说明操作。下载内容附带了 Xcopy 安装说明。

1. 将 ODAC zip 文件下载到临时目录中。注：请不要将此文件下载到“Tmp”目录中。
2. 将该文件的内容解压缩到此目录中。
3. 通过启动解压缩到同一目录中的 setup.exe 来运行 Oracle Universal Installer (OUI)。您将需要管理员权限。
4. OUI 将引导您完成计算机上的 ODAC 安装。安装后，您可删除 zip 文件以及解压缩的文件夹和文件。

注：如果已安装另一个 ODAC 测试版，请先将其卸载，然后再安装此 ODAC 版本。

卸载说明

卸载时，请使用最初安装 Oracle 主目录时所用的安装类型（即 Oracle Universal Installer、xcopy、NuGet 和 MSI）。您不应从按其他安装类型创建的 Oracle 主目录卸载。Oracle 强烈建议在执行卸载时使用与安装的 ODAC 相同的版本，并建议先卸载 ODAC，然后再在 Oracle 主目录上安装其他 Oracle 组件。

在使用 Oracle Universal Installer 卸载 ODAC 时，需按照以下说明操作。下载内容附带了 Xcopy 卸载说明。

1. 导航到 Windows“开始”菜单，然后选择“Universal Installer”：（所有程序 --> Oracle - < Oracle 主目录名称 > --> Oracle 安装产品 --> Universal Installer）。如果出现用户帐户控制提示，请授予权限。
2. 单击“卸载产品”按钮。
3. 从树控件中选择要卸载的 Oracle 主目录（即 Oracle Data Access Components for Oracle Client）。单击“删除”按钮。如果除了 ODAC 之外，您还要卸载其他组件，请确保首先卸载 ODAC。
4. 通过单击“是”按钮，确认卸载 Oracle 主目录。

如需静默卸载 ODAC，请在命令行上执行以下命令：

1.<Oracle Home Path>\oui\bin\setup.exe -silent -deinstall DEINSTALL_LIST={"oracle.odac.client","12.2.0.1.0"} ORACLE_HOME=<Oracle Home Path>

使用上述命令可卸载和取消 ODAC 组件配置。不过，通过此方法卸载 ODAC 时，将会在 Oracle 主目录中保留一些 Oracle Client 二进制文件和用户生成的所有文件。要完全删除 Oracle 主目录中的所有文件和文件夹，除了运行第一个命令之外，还可运行以下 Windows 命令：

2. rmdir <Oracle 主目录路径>\ /s

注：Oracle 主目录文件一经删除，便无法恢复。在执行上述命令之前，请对 Oracle 主目录中的任何重要内容进行备份。如果希望安静运行上述命令，可改为执行以下命令：

3. rmdir <Oracle 主目录路径>\ /s /q

连接设置快速入门

自动设置

在新的 Oracle 主目录中安装 ODAC 时，OUI 会自动将 Oracle 本地命名 (tnsnames.ora)、配置文件 (sqlnet.ora) 和目录 (ldap.ora) 参数文件和设置从现有 Oracle 主目录复制到新安装的 ODAC 主目录中，前提是它们的位数相同（即，它们都是 32 位或 64 位）。

或者，可将现有 *.ora 文件从上一有效的 Oracle 主目录之外的其他 Oracle 主目录中复制到新的 ODAC Oracle 主目录中。OUI 最多可为三个其他现有 Oracle 主目录（如有）的这些文件提供位置信息。如果新的 Oracle 主目录使用的配置不同于之前从中复制文件的 Oracle 主目录的配置，则可自定义 *.ora 文件。

如果安装到现有 ODAC 或 RDBMS Oracle 主目录中，则不会复制或创建新的 *.ora 文件。

如果安装到没有上述任何 Oracle 主目录的计算机上，则 OUI 将要求用户提供数据库连接别名信息。然后，OUI 将自动创建 tnsnames.ora 文件。如果未提供任何别名信息，则不会创建 tnsnames.ora 文件。即使用户没有所有可用的数据库连接信息，Oracle 也建议在安装过程中插入占位符值，然后使用实际值修改 tnsnames.ora 文件以便在以后替换占位符。

为 ODP.NET 托管驱动程序安装修改版 Machine.config

如果安装 ODP.NET 托管驱动程序，则 OUI 会自动将 TNS_ADMIN 和 LDAP_ADMIN 条目复制到 .NET maching.config 文件中（如果已包含在预先存在的 Oracle 主目录中，并且选择了计算机范围配置）。

手动设置

将 Oracle Client 连接到数据库的两种最常见方法是 EZCONNECT 和 TNSNAMES。EZCONNECT 设置超简单。从长远来看，TNSNAMES 更易于维护。如果您是初次使用 Oracle 产品，建议您使用 EZCONNECT。您只需选择这两种方法中的任一个进行连接即可。

这些快速入门说明假设您具有数据库服务器的有效用户名和密码。

注：在下面的设置说明中，ORACLE_HOME 表示您的计算机上安装 Oracle Client 主目录的目录。OUI Oracle Client 主目录的典型目录为：
C:\app\client\\product\12.1.0\client_1

在继续之前，您需要知道此目录的位置。

EZCONNECT 设置

1. 将此目录中的 sqlnet.ora 文件：
ORACLE_HOME\Network\Admin\Sample\
复制到此目录：
ORACLE_HOME\Network\Admin\

此文件告知 Oracle Client 可通过哪种方法（例如 EZCONNECT）连接到 Oracle 数据库服务器。

2。 然后，Oracle Client 必须指定有效的用户名、密码和数据源才能连接到数据库服务器。要指定数据源，您可使用 EZCONNECT 格式。在 ODP.NET 数据源属性中，使用以下格式定义客户端连接到数据库服务器的方式：
[//]host[:port][/service_name]

• host = 数据库服务器计算机的主机名
• port = 用于侦听传入连接请求的数据库服务器计算机端口
• service_name = 数据库的全局名称

例如，一些语法有效的连接字符串遵循：

"user id=hr;password=hr;data source=//sales-server:1521/sales.us.acme.com"

"user id=hr;password=hr;data source=//sales-server/sales.us.acme.com"

"user id=hr;password=hr;data source=sales-server/sales.us.acme.com"

如果未指定端口号，则默认使用 1521。

TNSNAMES 设置

Oracle Net 服务名称允许 Oracle Client 使用简单的别名连接到数据库服务器。别名定义包含创建与数据库服务器的连接所需的所有信息。别名信息存储在 tnsnames.ora 文件中，该文件通常位于 ORACLE_HOME\Network\Admin 目录中。该别名用作连接字符串中的数据源值。ODAC 安装不会创建 tnsnames.ora 文件，因此您需要创建该文件。以下说明假设您必须创建一个新的 tnsnames.ora 文件。

1. 将此目录中的 tnsnames.ora 文件：
ORACLE_HOME\Network\Admin\Sample\
复制到此目录：
ORACLE_HOME\Network\Admin\

<data source alias> = 
          (DESCRIPTION = 
          (ADDRESS = (PROTOCOL = TCP)(HOST = <hostname or IP>)(PORT = <port>)) 
          (CONNECT_DATA = 
          (SERVER = DEDICATED) 
          (SERVICE_NAME = <database service name>)))

• data source alias = 用来标识连接描述符的快捷方式名称。在 ODP.NET 连接字符串中，开发人员将“数据源”属性设置为数据源别名。
• hostname or IP = 数据库服务器计算机的主机名或 IP 地址
• port = 用于侦听传入连接请求的数据库服务器计算机端口。通常，此值设置为端口“1521”。
• database service name = 数据库的全局名称

应适当修改 tnsnames.ora 中的数据源别名、主机名/IP、端口和数据库服务名称。如果 Oracle Client 未识别 ORACLE_HOME\network\admin\tnsnames.ora 文件中的 TNS 条目，请使用任意文本编辑器创建 ORACLE_HOME\oracle.key 文件，并在以下行中键入：
SOFTWARE\ORACLE\< home key >

其中，< home key > 是 ODAC Oracle 主目录的注册表键。例如，如果在安装过程中使用了默认的 Oracle 主目录位置，则 oracle.key 文件的正确条目将为：SOFTWARE\ORACLE\KEY_OraClient12c_home1

计算机范围配置

利用 ODAC，可选择采用托管或非托管 ODP.NET 的计算机范围或非计算机范围配置进行安装。计算机范围配置包括将提供程序程序集放入 GAC，并使用配置节处理程序和 DbProviderFactory 信息更新 machine.config。如果选择非计算机范围配置，则不会进行上述更改。默认情况下，ODAC 安装会将非计算机范围配置用于新的 Oracle 主目录安装和重新安装。

如果您计划在同一台计算机上安装 ODAC 和 ODP.NET 12.2.0.1 的 NuGet，则应在非计算机范围内配置 ODP.NET。此外，请确保未在计算机范围内安装其他 ODP.NET 12.2.0.1 版本。

通过将 ODP.NET 重新安装到已安装相同版本的 ODP.NET 的同一 Oracle 主目录中，用户可将 ODP.NET 从计算机范围配置重新配置为非计算机范围配置。例如，如果您已在计算机范围内配置 ODP.NET，则可通过将 ODP.NET 重新安装到同一 Oracle 主目录中并选择非计算机范围配置选项来重新配置它。

对于依赖未在计算机范围内配置的某版本 ODP.NET 的应用，需要注意的是 A) 需要将此应用所依赖的 ODP.NET 程序集复制到应用目录中，并且 B) 需正确设置 .NET 配置才能使用提供程序工厂和/或提供程序特定的配置。请参阅《ODP.NET 开发人员指南》第 2 章，了解更多详细信息。

常见的安装和设置问题

ODAC 不支持安装到现有 Oracle 服务器主目录中。如果 ODAC 共享 12.x 版本和更早版本的前两个主要版本（即 ODAC 12.2 无法安装到 ODAC 12.1 主目录中）或共享 Oracle 18 和更高版本的主要版本（即 Oracle 18 无法安装到 Oracle 19 主目录中），则可将 ODAC 安装到现有的 Oracle Client 主目录中。在安装到现有 Oracle Client 主目录中时，必须使用相同的安装程序技术。OUI ODAC 只能安装到 OUI ODAC 主目录中；MSI ODAC 只能安装到 MSI ODAC 主目录中；xcopy ODAC 只能安装到 xcopy ODAC 主目录中。

检查卸载过程中是否已删除现有 ORACLE_HOME 目录中的 oci.dll。如果未删除 oci.dll，请执行以下步骤以删除 DLL。

1. 请首先参阅发行说明，了解所有已知问题或限制。
2. 通过将下载文件大小与下载页面上列出的文件大小进行比较，检查是否已正确下载 Oracle Data Access Components。
3. 如果您已在同一台计算机上安装多个 Oracle 主目录（例如 Oracle 12c 版本 1 客户端和 Oracle 12c 版本 2 客户端），则一旦安装 Oracle 12.2 客户端，OUI 就会将此客户端设定为所有现有应用将使用的 Oracle 主目录。有关将多个 Oracle 主目录与 ODP.NET 非托管驱动程序结合使用的更多信息，请参阅 ODP.NET 文档。
4. 强烈建议将 ODAC 安装到新的 Oracle 主目录中。在现有的 Oracle 主目录上安装 ODAC 可能会中断现有 Oracle 应用。如果您在现有 Oracle 主目录上安装了 ODAC，请确保停止所有使用该 Oracle 主目录的 Windows 服务（例如 OracleMTSRecoveryService）且 ODAC 是 Oracle Client 主目录。


5. a) 将 oci.dll 重命名为 oci.dll.delete。
   b) 重启机器。
   c) 删除 oci.dll.delete（重启后不再处于使用中状态）。
   d) 安装新的 ODAC。
6. 如果在现有的 Oracle 12.2c 主目录上安装 ODAC，默认情况下将不会安装已安装的 ODAC 组件。在安装过程中，您必须手动选择要安装的 ODAC 组件（即选中要安装的 ODAC 组件旁边的复选框）。建议对要使用的所有 ODAC 组件（尤其是 ODP.NET）执行此操作。
7. 此安装提供的策略配置文件可将现有的 10.2 和 11.1 ODP.NET 应用重定向到当前的 ODP.NET 版本。策略文件位于 ORACLE_HOME\odp.net\PublisherPolicy\2.x 和 ORACLE_HOME\odp.net\PublisherPolicy\4 目录中。安装 ODP.NET 不会将 ODP.NET 策略 DLL 放入 GAC 中，这意味着现有应用将继续使用先前使用的相同版本的 ODP.NET。
8. 将 ODP.NET 安装到新的 Oracle 主目录中意味着，您可能无权访问先前安装中的任何 Oracle 数据源别名。为了确保您正在使用这些现有的数据源属性，请将 ORACLE_HOME\network\admin 目录中的 tnsnames.ora 文件从以前安装的 Oracle 主目录复制到新安装的同一目录中。或者，您可按照先前的连接设置快速入门操作，手动创建连接别名。
9. Oracle Database 支持使用在安装 Oracle Database 时指定的 Oracle 主目录用户。Oracle 主目录用户用于为 Oracle 主目录运行 Windows 服务。Oracle 主目录用户可以是虚拟帐户、标准 Windows 用户帐户（非管理员帐户）或 Windows 内置帐户。要了解有关 Oracle 主目录用户的更多信息，请参阅适用于 Microsoft Windows 的 Oracle Database 平台指南。
10. 如果一台计算机上安装了 Oracle Developer Tools (ODT) for Visual Studio 12.1.0.2.0（ODAC 12c 版本 3 的一部分）或更高版本，且该计算机将降级到 ODT 12.1.0.1.2（ODAC 12c 版本 2 的一部分）或早期版本，则必须先卸载较新版本的 ODT，然后才能安装旧版本的 ODT。如果不这样做，则会导致某些 ODT 功能（例如 PL/SQL 调试）无法正常工作。
11. 卸载 ODAC 12c 版本 3 之前的 ODP.NET 可能会导致在 .NET 4.0 machine.config 中输入带有 .NET 2.x 程序集引用的条目。除非从 .NET 4.0 machine.config 中手动删除引用 2.x 版本 Oracle.DataAccess.Client 的“oracle.unmanageddataaccess.client”的配置部分条目，否则上述操作会导致并行执行错误。此外，建议您也手动删除引用 2.x 版本 Oracle.DataAccess.Client 的 DbProviderFactories 条目。

查看 ODP.NET 文档

可从 ORACLE_HOME\ODACDoc\DocumentationLibrary\welcome.html 页面查看 PDF 和 HTML 文档。要查看此页面，请转至“开始”菜单 --> Oracle - < Oracle 主目录 > --> 应用开发 --> Oracle Data Access Components 文档。

此外，Oracle 文档将作为 Visual Studio Dynamic 帮助的一部分安装。

支持和错误报告

要了解任何错误和问题，您可加入 ODAC 的任一 OTN 论坛。