2017-10-01

使用 EntityFramework 連線 Oracle - Database First

之前工作一直使用 EntityFramework 加速專案開發速度,主要是因為過去公司都使用 MS-SQL,與 EntityFramework 整合度很高,配合 Visual Studio Scaffolding 功能,可以很迅速地將專案骨架展開,讓工程師可以直接進入商業邏輯及其他需求功能開發,是非常方便好用的工具,但 EntityFramework 有不少缺點:像是無法控制轉譯後的 SQL 及預設的 change tracking 讓資料使用情境的效能大降都使得不少人卻步

最近為了加速專案開發,打算透過 EntityFramework 搭配 Oracle 先長出專案的主框架,過程中遇到不少問題,順手紀錄一下


環境說明

  1. Visual Studio 2017
  2. EntityFramework 6
  3. .Net Framework 4.6.2
  4. Oacle 11g XE
  5. Windows 10

安裝 Oracle Developer Tools for Visual Studio

請至 Oracle 官網下載對應的版本 Oracle Data Access Components (ODAC) for Windows Downloads,下列示範將使用 Oracle Developer Tools for Visual Studio 2017 - MSI Installer,這會加入 Oracle Data provider,讓 EntityFramework 能與 Oracle 溝通

  • 安裝前

    1nooracle

  • 安裝後

    2oracle

  • 如果這邊看不出用途沒關係,後面會有更詳細的說明,記得先安裝就對了

安裝 Oracle Driver

安裝 Oracle.ManagedDataAccess.EntityFramework 支援 EntityFramework 6,順帶安裝的 Oracle.ManagedDataAccess 則是 oracle 官方的 data provider

3oracleMDAEF

4oracleMDAEF

加入 ADO.NET Entity Data Model (.edmx)

  1. Model 加入新項目

    專案 Model 資料夾上按右鍵 --> Add --> New Item...

    5addedmx

  2. 選擇 ADO.NET Entity Data Model

    Data --> ADO.NET Entity Data Model

    6addedmx2

  3. 選擇 Model 內容

    7modelcontent

  4. 設定連線資料

    8connection1

    9connection2

    10connection3

    11connection4

    12connection5

  5. 選擇要轉換為 model 為資料庫物件

    13connection6

  6. 儲存 .edmx 並重新編譯

    14edmx

使用 Scaffolding 產生程式碼

  1. 加入 Controller

    Controllers 資料夾上按右鍵 --> Add --> Controller...

    15controller1

  2. 選擇 Scaffold template

    16controller2

  3. 選擇 model、context 並指定名稱

    17controller3

可能問題

  1. 無法使用 EntityFramework 6

    An Entity Framework database provider compatible with the laest version of Entity 
    Framework could not be found for your data connection. If you have already installed a 
    compatible provider, ensure you have rebuilt your project performing this action. 
    Otherwise, exit this wizard, install acompatible provider and rebuild your project before 
    performing this action.
    

    18noef6

    • 預設安裝的 data provider 僅支援 EntityFramework 5 -
    • 解決方式:安裝 Oracle.ManagedDataAccess.EntityFramework
  2. 無法使用 Scaffolding

    Error
    
    There was an error running the selected code gernerator:
    'Could not load file or assmbly 'EntityFramework,
    Version=5.0.0.0,Culture=neutual,
    PublicKeyToken=b77a5c561934e089' or one of its dependencies.
    The located assembly's manifest definition does not match the
    assembly reference.(Exception from HRESULT:0x80131040)'
    

    19noscaffold

    • 重新檢查專案設定,會發現 EntityFramework 被升級為 6.x 版本,建立時說不能用 EntityFramework 6,現在又幫我升級XD
    • 解決方式:安裝 Oracle.ManagedDataAccess.EntityFramework
  3. 無法使用 Scaffolding

    Error
    
    There was an error running the selected code generator:
    'Unable to retrieve metadata for 
    'xxxx'.Schema specified is not valid. Errors:.........
    

    20typeerror

    • .edmx 中定義的型別不正確
    • 解決方式:重新產生 .edmx

心得

不知道是不是我被微軟養大胃口了,覺得與 Oracle 的整合好麻煩,一下缺東一下缺西的,安裝說明跟錯誤訊息都不是很明確,不是很好 debug,使用體驗很差,明明設定步驟不多,操作也不複雜,但著實花了我一整天才搞定,希望這關過了後面可以順利些

參考資訊

  1. Oracle Data Access Components (ODAC) for Windows Downloads
  2. Entity Framework 6, database-first with Oracle

沒有留言:

張貼留言