用Oracle的ODP.NET来搞实体数据模型，步骤和注意点分享

用Oracle的ODP.NET来搞实体数据模型，步骤和注意点分享 主要参考了Oracle官方文档、一些技术博客上的实践经验分享以及常见的社区问题讨论，下面我就把这些信息整合起来,直接告诉你该怎么做和要注意什么。

第一部分：准备工作，先把环境弄好

你想用ODP.NET来连接Oracle数据库并创建实体数据模型，第一步不是直接打开Visual Studio，而是要先确保你的电脑上有了正确的“武器”，根据Oracle官方文档的说明，ODP.NET有几个不同的部署版本,你得选对。

最常见的是ODP.NET, Managed Driver，这个版本的好处是纯托管代码，配置简单，直接通过NuGet包就能安装，不需要在电脑上安装臃肿的Oracle客户端，对于大多数新项目，建议你就用这个，具体做法是，在Visual Studio里，打开你的项目，然后通过NuGet包管理器，搜索“Oracle.ManagedDataAccess.EntityFramework”并安装，注意，你一定要安装这个带EntityFramework后缀的包，因为它包含了EF6所需的特定组件，如果你只安装了“Oracle.ManagedDataAccess”，那只能进行基础的数据库连接,无法创建实体数据模型。

另一种是ODP.NET, Unmanaged Driver，这个版本需要你在电脑上预先安装一个Oracle客户端软件，配置起来比较麻烦，比如要设置环境变量TNS_ADMIN指向网络服务名配置文件tnsnames.ora的位置，根据一些技术博客的提醒，除非你有非常特殊的遗留系统需求，否则现在的新项目强烈不推荐用这个，用Managed Driver能省去一大堆麻烦。

准备工作总结一下：在Visual Studio里，用NuGet安装“Oracle.ManagedDataAccess.EntityFramework”这个包就行了,这是最简单直接的路。

第二部分：创建实体数据模型的具体步骤

环境准备好之后，就可以开始创建模型了，这个过程在Visual Studio里是向导式的,但有几个关键点容易出错。

1. 添加新项：在项目上右键，选择“添加” -> “新建项”，在弹出的窗口里，找到“数据”类别，然后选择“ADO.NET 实体数据模型”，给它起个名字，OracleModel.edmx”,然后点击添加。

2. 选择模型内容：接下来会弹出一个向导，这里你要选择“来自数据库的EF Designer”，这是最常用的方式,直接从已有的Oracle数据库表生成实体类和数据模型图。

3. 连接数据库（最关键的一步）：点击“新建连接”，这时会弹出选择数据源的窗口。这里有个大坑，根据社区问题反馈，很多人会发现默认的数据源列表里没有Oracle选项，如果没看到，你别慌，点一下“更改”按钮，在弹出的“选择数据源”新窗口里，左边列表应该就会有“Oracle 数据库”的选项了，数据提供程序通常会默认选择“Oracle.ManagedDataAccess.Client”，这正是我们想要的，如果这里什么都没有，那说明你前面的NuGet包可能没安装成功,回去检查一下。

4. 填写连接信息：连接属性窗口里，你需要填写服务器名（就是你的Oracle数据库地址和端口，/192.168.1.100:1521/orcl）、用户名和密码，这里填写方式有两种,根据技术博客的分享：

   • 简单法：直接在“数据源”一栏，把整个连接字符串信息填进去，格式类似于 (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=你的主机名)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=你的服务名)))，这个串可以从你公司DBA那里或者已有的tnsnames.ora文件里找到。
   • 分解法：在HOST名那里只填服务器IP或主机名，在端口号填1521，在服务名那里填数据库的服务名（比如orcl），这种方式更直观。 填好后，可以点“测试连接”确保网络和密码都没问题，然后勾选“在App.config文件中保存连接设置”，这样连接字符串会保存到配置文件里,以后修改起来方便。

5. 选择数据库对象：连接成功后，下一步就是选择你要把数据库里的哪些表、视图或者存储过程变成实体模型，你勾选需要的表就行，通常还会建议你勾选“确定所生成对象名称的单复数形式”和“在模型中加入外键列”这两个选项,这样EF会帮你做一些命名规范化和关系映射。

6. 完成：点击完成，Visual Studio就会开始生成edmx文件，你会看到一个图形化的模型设计器,里面就是你选择的表和他们之间的关系图。

第三部分：开发中和部署时的注意点

模型生成好了不代表就万事大吉了,用的时候还有些细节要注意。

• 数据类型映射：Oracle的一些数据类型和.NET的类型不是完全一一对应的，比如Oracle的NUMBER类型，如果没有指定精度，EF可能会映射成decimal，但你可能希望它是int或者double，你可以在edmx设计器里，点击实体属性，在属性窗口中手动修改它的Type，这个映射问题在Oracle官方文档里有详细说明,需要留意。
• 大小写敏感问题：Oracle数据库默认对象名是大写的，如果你在代码里用Linq查询时，写的是c => c.Name，但数据库列名其实是“NAME”，可能会出问题，根据经验分享，最好保持一致性，或者在模型设计器里把实体属性名改成和数据库列名完全一致（包括大小写）。
• 连接字符串权限：部署到服务器上时，要确保运行你程序的账户（比如IIS应用程序池账户）有权限访问Oracle客户端（如果用的是Unmanaged Driver）或者有网络权限连接到你的Oracle数据库服务器，对于Managed Driver,一般只需要网络通就行。
• 性能考量：EF虽然方便，但生成的SQL可能不是最优的，对于非常复杂的查询，如果发现性能不佳，可以考虑使用ODP.NET原生的DataReader方式，或者直接在数据库端写视图/存储过程，然后让EF来调用，这不是ODP.NET的问题,是使用ORM的通用考量。
• 版本兼容性：注意你使用的ODP.NET版本、Entity Framework版本以及Oracle数据库版本之间的兼容性，一般Oracle官方文档会提供一个兼容性矩阵，在升级任何一方之前最好先查阅一下,避免出现奇怪的问题。

用ODP.NET创建实体数据模型，核心就是选对Managed Driver的NuGet包，然后在创建连接时注意数据源的选择和连接字符串的正确性，之后在使用中多留意数据类型和命名映射这些细节,就能比较顺利地开展工作了。