Развертывание и настройка ODP.NET для работы без установки с Entity Framework

Этот ответ обобщает (надеюсь) все необходимые шаги, многие из которых задокументированы в разных местах в Интернете и могут сэкономить кому-то часы поиска в Google.

A. Как развернуть и настроить Oracle.DataAccess.Client.

А.1. Загрузите ODAC112030Xcopy_64bit.zip или ODAC112030Xcopy_32bit.zip.

А.1.1. Извлеките содержимое следующих папок из zip-файла в папку bin/setup вашего приложения/хоста:

А.1.1.1. мгновенный клиент_11_2

А.1.1.2. odp.net4\bin\

А.1.1.3. odp.net4\odp.net\bin\

А.1.1.4. odp.net4\odp.net\PublisherPolicy\4\

А.2. Добавьте следующий раздел в начало файла app.config/web.config вашего приложения/хоста (если у вас уже есть элемент configSections, добавьте в него раздел:

<configSections>
  <section name="oracle.dataaccess.client"
    type="System.Data.Common.DbProviderConfigurationHandler, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</configSections>

А.3. Добавьте следующие разделы в конец файла app.config/web.config вашего приложения/хоста:

А.4. Из папки ODAC112030Xcopy выполните:

configure.bat odp.net4 somename

Я рекомендую использовать oraclehome112030_32 или oraclehome112030_64 в качестве имени выше.

<system.data>
  <DbProviderFactories>
    <!-- Remove in case this is already defined in machine.config -->
    <remove invariant="Oracle.DataAccess.Client" />
    <add name="Oracle Data Provider for .NET"
         invariant="Oracle.DataAccess.Client"
         description="Oracle Data Provider for .NET"
         type="Oracle.DataAccess.Client.OracleClientFactory, Oracle.DataAccess, Version=4.112.3.0, Culture=neutral, PublicKeyToken=89b483f429c47342"/>
  </DbProviderFactories>
</system.data>

<oracle.dataaccess.client>
  <settings>
    <add name="bool" value="edmmapping number(1,0)" />
    <add name="byte" value="edmmapping number(3,0)" />
    <add name="int16" value="edmmapping number(5,0)" />
    <add name="int32" value="edmmapping number(10,0)" />
    <add name="int64" value="edmmapping number(19,0)" />
    <add name="int16" value="edmmapping number(38,0)" />
    <add name="int32" value="edmmapping number(38,0)" />
    <add name="int64" value="edmmapping number(38,0)" />
  </settings>
</oracle.dataaccess.client>

B. Как развернуть и настроить Oracle.ManagedDataAccess.Client.

Б.1. Загрузите ODP.NET_Managed_1120350_Beta.zip

Б.1.1. Извлеките следующие файлы в папку bin/setup вашего приложения/хоста.

Б.1.1.1. Oracle.ManagedDataAccess.dll

Б.1.1.2. x64\Oracle.ManagedDataAccessDTC.dll или x86\Oracle.ManagedDataAccessDTC.dll

БИ 2. Добавьте следующий раздел в начало файла app.config/web.config вашего приложения/хоста (если у вас уже есть элемент configSections, добавьте в него раздел:

<configSections>
  <section name="oracle.manageddataaccess.client"
    type="OracleInternal.Common.ODPMSectionHandler, Oracle.ManagedDataAccess, Version=4.112.3.50, Culture=neutral, PublicKeyToken=89b483f429c47342" />
</configSections>

Б.3. Добавьте следующие разделы в конец файла app.config/web.config вашего приложения/хоста:

<system.data>
  <DbProviderFactories>
    <!-- Remove in case this is already defined in machine.config -->
    <remove invariant="Oracle.ManagedDataAccess.Client" />
    <add name="ODP.NET, Managed Driver"
         invariant="Oracle.ManagedDataAccess.Client"
         description="Oracle Data Provider for .NET, Managed Driver"
         type="Oracle.ManagedDataAccess.Client.OracleClientFactory, Oracle.ManagedDataAccess, Version=4.112.3.50, Culture=neutral, PublicKeyToken=89b483f429c47342" />
  </DbProviderFactories>
</system.data>

<oracle.manageddataaccess.client>
  <version number="*">
    <settings>
      <!-- Set this path if you are using TNS aliases as connection strings (not recommended) -->
      <!-- Instead you can use "SERVER_NAME:PORT/SERVICE_NAME" as your data source -->
      <setting name="TNS_ADMIN" value="C:\"/>
    </settings>
    <edmMappings>
      <edmMapping dataType="number">
        <add name="bool" precision="1"/>
        <add name="byte" precision="2" />
        <add name="int16" precision="5" />
      </edmMapping>
    </edmMappings>
  </version>
</oracle.manageddataaccess.client>

C. Для строительства:

С.1. Добавьте этот раздел в app.config вашей сборки EDMX:

(Еще не пробовал это с Oracle.ManagedDataAccess.Client)

<oracle.dataaccess.client>
  <settings>
    <add name="bool" value="edmmapping number(1,0)" />
    <add name="byte" value="edmmapping number(3,0)" />
    <add name="int16" value="edmmapping number(5,0)" />
    <add name="int32" value="edmmapping number(10,0)" />
    <add name="int64" value="edmmapping number(19,0)" />
    <add name="int16" value="edmmapping number(38,0)" />
    <add name="int32" value="edmmapping number(38,0)" />
    <add name="int64" value="edmmapping number(38,0)" />
  </settings>
</oracle.dataaccess.client>

С.2. Добавьте в ту же сборку файл с именем Oracle.xsd с содержимым:

<?xml version="1.0" encoding="utf-8"?>
<xs:schema id="odpnetappconfigmappings" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:complexType name="addtype">
    <xs:attribute name="name" type="xs:string" />
    <xs:attribute name="value" type="xs:string" />
  </xs:complexType>

  <xs:complexType name="settingstype">
    <xs:sequence minOccurs="0" maxOccurs="unbounded">
      <xs:element name="add" type="addtype" />
    </xs:sequence>
  </xs:complexType>

  <xs:complexType name="oracledataaccessclienttype">
    <xs:sequence minOccurs="0" maxOccurs="1">
      <xs:element name="settings" type="settingstype" />
    </xs:sequence>
  </xs:complexType>

  <xs:element name="oracle.dataaccess.client" type="oracledataaccessclienttype" />

</xs:schema>

С.3. Добавьте приведенный выше XSD в приведенный выше список схем app.config.

С.4. Если вы получаете ошибки для логических сопоставлений во время сборки, даже если сборка выполняется успешно, добавьте сопоставления app.config в файл devenv.exe.config Visual Studio.

С.5. Если вы хотите использовать Oracle.ManagedDataAccess.Client, либо отредактируйте атрибут поставщика данных в EDMX вручную перед сборкой (я этого не пробовал), либо отредактируйте его до создания контекста во время выполнения и загрузите MSSL из отредактированной копии, а не из ресурс (похоже, это работает, и я также использую аналогичный прием, чтобы выбрать, какой MSSL загружать для разных поставщиков БД).

D. Для поддержки дизайнера:

Д.1. Загрузите win64_11gR2_client.zip или win32_11gR2_client.zip и установите.

Д.1.1. В качестве типа установки выберите «Администратор».

Д.2. загрузите ODT и установите.

Я попробовал это (A и B) на пустой машине (VM) с Windows 7 x64.

Эта процедура не работает с версией Oracle.DataAccess.Client x86 в Windows x64.

Эта процедура работает с 64-разрядной версией Oracle.DataAccess.Client в Windows x64 и с обеими версиями Oracle.ManagedDataAccess.Client.

Обновление:

Миграция с Oracle.DataAccess.Client на Oracle.ManagedDataAccess.Client v12.1.0 (12c) простым способом:

Изменить: ссылка для скачивания управляемого ODAC v12c Release 1.

Если вы загружаете winx64_12c_client.zip или winnt_12c_client32.zip, извлеките их и установите (полная (административная) установка или выборочная установка с компонентом ODP.NET, установка клиента не включает этот компонент) на виртуальной машине вы найдете папку \odp.net\managed в папке «клиент».

В этой папке вы найдете common\Oracle.ManagedDataAccess.dll, x86\Oracle.ManagedDataAccessDTC.dll и x64\Oracle.ManagedDataAccessDTC.dll.

Скопируйте Oracle.ManagedDataAccess.dll в свой каталог bin и либо скопируйте правильную платформу Oracle.ManagedDataAccessDTC.dll в свой каталог bin x86/x64, либо, для каждого клиента, установите правильную платформу этой конкретной DLL в GAC, сохранив свой bin как AnyCPU.

Версия сборки новой DLL - 4.121.1.0, PublicKeyToken вроде тот же (не проверял, но заработало и без меня).

Как и прежде, добавьте этот раздел в раздел конфигурации/configSections app.config (в начало файла app.config):

<configuration>
   <configSections>

Раздел:

    <section name="oracle.manageddataaccess.client"
        type="OracleInternal.Common.ODPMSectionHandler, Oracle.ManagedDataAccess, Version=4.121.1.0, Culture=neutral, PublicKeyToken=89b483f429c47342" />

и закрыть с помощью:

</configSections>

В system.data/DbProviderFactories (после вышеизложенного):

<system.data>
  <DbProviderFactories>

добавлять:

    <remove invariant="Oracle.DataAccess.Client" />
    <remove invariant="Oracle.ManagedDataAccess.Client" />

Чтобы убедиться, что у вас нет конфликтов в файле machine.config

затем добавьте:

  <add name="ODP.NET, Managed Driver" invariant="Oracle.DataAccess.Client"
       description="Oracle Data Provider for .NET, Managed Driver"
       type="Oracle.ManagedDataAccess.Client.OracleClientFactory, Oracle.ManagedDataAccess, Version=4.121.1.0, Culture=neutral, PublicKeyToken=89b483f429c47342" />

и закрыть с помощью:

  </DbProviderFactories>
</system.data>

Примечание Я использовал Oracle.DataAccess.Client в качестве инварианта вместо официального Oracle.ManagedDataAccess.Client. Это связано с тем, что я не хочу менять все свои EDMX и перекомпилировать их сборки, чтобы заставить их использовать новый управляемый клиент вместо старого неуправляемого.

Затем добавьте следующий раздел (после приведенного выше) в ваш app.config.

 <oracle.manageddataaccess.client>
    <version number="*">
      <edmMappings>
        <edmMapping dataType="number">
          <add name="bool" precision="1"/>
          <add name="byte" precision="2" />
          <add name="int16" precision="5" />
        </edmMapping>
      </edmMappings>
    </version>
  </oracle.manageddataaccess.client>

Это прошло мое первоначальное тестирование, хотя еще не тестировалось полностью.