Как установить мгновенный клиент oracle windows

Обновлено: 21.11.2024

Чтобы использовать ODPI-C в собственном проекте, загрузите его исходный код с GitHub. Образец Makefile предоставляется, если вы хотите собрать ODPI-C как разделяемую библиотеку. В противном случае добавьте исходный код ODPI-C в свой проект. В Windows требуется Visual Studio 2008 или выше. В macOS требуется Xcode 6 или выше. В Linux требуется GCC 4.4 или выше.

ODPI-C был протестирован на Linux, Windows и macOS. Другие платформы также должны работать, но не проверялись.

Для проектов, использующих ODPI-C, необходимо установить клиентские библиотеки Oracle. Библиотеки обеспечивают необходимое сетевое подключение, позволяющее приложениям получать доступ к экземпляру базы данных Oracle. Они также предоставляют базовые и расширенные функции управления подключением и данными для приложений ODPI-C.

Загрузка клиентской библиотеки Oracle¶

Самый простой клиент Oracle — это бесплатный Oracle Instant Client. Требуется только пакет «Basic» или «Basic Light». Библиотеки Oracle Client также доступны при любой установке Oracle Database или при полной установке Oracle Client.

ODPI-C динамически загружает доступные библиотеки Oracle Client во время выполнения. Это позволяет создавать код, использующий ODPI-C, только один раз, а затем запускать его с использованием любых доступных библиотек Oracle Client 21, 19, 18, 12 или 11.2. Если клиентские библиотеки Oracle не найдены, возникает ошибка «DPI-1047: не удается найти клиентскую библиотеку Oracle». Если клиентская библиотека Oracle найдена, но ее версию определить невозможно, возникает ошибка «DPI-1072: версия клиентской библиотеки Oracle не поддерживается». Например, это может быть связано с тем, что версия библиотеки Oracle Client слишком старая (до 10g) или полностью не поддерживается (например, Oracle Client 19 в Windows 7).

Если член dpiContextCreateParams.oracleClientLibDir указан при вызове dpiContext_createWithParams() , поиск библиотек Oracle Client выполняется только в этом каталоге.

Если каталог не указан, то библиотеки Oracle Client ищутся в том же каталоге, в котором находится библиотека ODPI-C (или бинарный файл приложения). Если они не найдены, то они ищутся в стандартном путь поиска операционной системы, например PATH в Windows или LD_LIBRARY_PATH в Linux. См. стандартный порядок поиска в библиотеке Windows или стандартный порядок поиска в библиотеке Linux. Наконец, на платформах, отличных от Windows, также выполняется поиск в $ORACLE_HOME/lib.

При использовании Instant Client в Linux и связанных операционных системах этот каталог всегда должен быть в пути поиска системной библиотеки.

При использовании каталога библиотеки из полной установки клиента или базы данных дополнительно необходимо настроить среду приложения для использования этого программного обеспечения, например, задав переменную среды ORACLE_HOME. Это необходимо сделать до инициализации ODPI-C.

Убедитесь, что у приложения есть права доступа к каталогам и файлам для библиотек Oracle Client. В Linux убедитесь, что libclntsh.so существует. В macOS убедитесь, что libclntsh.dylib существует. ODPI-C не будет напрямую загружать файлы libclntsh.*.XX.1 в dpiContextCreateParams.oracleClientLibDir или из каталога, где находится библиотека ODPI-C (или двоичный файл приложения). Обратите внимание, что другие файлы, используемые libclntsh*, также необходимы.

Чтобы отслеживать загрузку библиотек Oracle Client, для переменной среды DPI_DEBUG_LEVEL можно установить значение 64 перед запуском приложения. См. раздел Отладка ODPI-C .

В следующих разделах объясняется, как обеспечить правильную установку и настройку клиента Oracle на различных платформах, чтобы ODPI-C мог его найти.

Взаимодействие клиента Oracle и базы данных Oracle¶

Стандартная сетевая совместимость клиент-сервер Oracle позволяет устанавливать соединения между различными версиями Oracle Client и Oracle Database. Сертифицированные конфигурации см. в документе службы поддержки Oracle с идентификатором 207303.1. Таким образом, Oracle Client 21 может подключаться к Oracle Database 12.1 или более поздней версии. Oracle Client 19, 18 и 12.2 могут подключаться к Oracle Database 11.2 или более поздней версии. Oracle Client 12.1 может подключаться к Oracle Database 10.2 или более поздней версии. Oracle Client 11.2 может подключаться к Oracle Database 9.2 или более поздней версии. Технические ограничения на создание соединений могут быть более гибкими. Например, Oracle Client 12.2 может успешно подключиться к Oracle Database 10.2.

Поскольку один двоичный файл ODPI-C может использовать несколько версий клиента и обращаться к нескольким версиям базы данных, важно, чтобы ваше приложение было протестировано в предполагаемых средах выпуска. Более новые клиенты Oracle поддерживают новые функции, такие как внешний файл конфигурации oraaccess.xml, доступный для клиентов 12.1 или более поздних версий, улучшения пула сеансов, тайм-ауты вызовов для клиентов 18 или более поздних версий и другие усовершенствования.

Функция dpiContext_getClientVersion() может использоваться для определения используемой версии Oracle Client, а функция dpiConn_getServerVersion() может использоваться для определения версии базы данных Oracle, к которой осуществляется доступ.Затем их можно использовать для соответствующей настройки поведения приложения. Попытки использовать некоторые функции Oracle, которые не поддерживаются определенной комбинацией клиент/сервер, могут привести к ошибкам во время выполнения. К ним относятся:

  • при попытке доступа к атрибутам, которые не поддерживаются текущей библиотекой Oracle Client, вы получите сообщение об ошибке "ORA-24315: недопустимый тип атрибута"

  • при попытке использовать неявные результаты с Oracle Client 11.2 для Oracle Database 12c вы получите сообщение об ошибке "ORA-29481: неявные результаты не могут быть возвращены клиенту"

  • при попытке получить количество строк массива DML с помощью Oracle Client 11.2 вы получите сообщение об ошибке "DPI-1050: клиентская библиотека Oracle должна быть версии 12.1 или выше"

Линукс¶

Для ODPI-C требуются библиотеки Oracle Client, которые находятся в Oracle Instant Client, или в установке Oracle Database, или в полной установке Oracle Client, см. Загрузка клиентской библиотеки Oracle. Библиотеки должны быть 32-разрядными или 64-разрядными, соответствующими вашему приложению и библиотеке ODPI-C (если она создается отдельно).

Zip-файлы Oracle Instant Client¶

Для запуска приложений ODPI-C с zip-файлами Oracle Instant Client:

Разархивируйте пакет в каталог, доступный для вашего приложения. Например:

Установите пакет libaio операционной системы с помощью sudo или от имени пользователя root. Например:

В некоторых дистрибутивах Linux этот пакет называется libaio1.

В последних версиях Linux, таких как Oracle Linux 8, вам также может потребоваться установить пакет libnsl при использовании Oracle Instant Client 19.

Если на компьютере нет другого программного обеспечения Oracle, которое будет затронуто, навсегда добавьте Instant Client в путь ссылки во время выполнения. Например, с помощью sudo или от имени пользователя root:

В качестве альтернативы задайте для переменной среды LD_LIBRARY_PATH соответствующий каталог для версии Instant Client. Например:

Если вы используете дополнительные файлы конфигурации Oracle, такие как tnsnames.ora , sqlnet.ora или oraaccess.xml , поместите файлы в доступный каталог. Затем установите элемент dpiContextCreateParams.oracleClientConfigDir при вызове dpiContext_createWithParams() .

В качестве альтернативы задайте для переменной среды TNS_ADMIN имя этого каталога.

В качестве альтернативы создайте подкаталог network/admin Instant Client, если он не существует. Например, с мгновенным клиентом 12.2:

Поместите файлы в этот каталог. Это каталог конфигурации Oracle по умолчанию для приложений, связанных с этим мгновенным клиентом.

RPM-файлы Oracle Instant Client¶

Для запуска приложений ODPI-C с RPM-пакетами Oracle Instant Client:

Дополнительную информацию о Instant Client см. на главной странице Instant Client.

Инструкции по установке находятся внизу страницы.

Взаимодействие между версиями Oracle Client и Oracle Database подробно описано в документе с идентификатором 207303.1. Например, приложения, использующие Oracle Call Interface 19, могут подключаться к Oracle Database 11.2 или более поздней версии. Некоторые инструменты могут иметь другие ограничения.

Версия 21.3.0.0.0

Base — требуется один из этих пакетов

Скачать

Описание

(85 461 658 байт) (cksum - 1666423509)

(42 591 158 байт) (cksum - 1880984339)

Инструменты — дополнительные пакеты

Скачать

Описание

(1 020 742 байта) (cksum - 2718342532)

(1 151 133 байта) (cksum - 977494416)

Разработка и среда выполнения — дополнительные пакеты

Скачать

Описание

(1 428 493 байта) (cksum - 2028374070)

(1 586 895 байт) (cksum - 1132199626)

(1 029 197 байт) (cksum - 3142687000)

Версия 19.14.0.0.0

Base — требуется один из этих пакетов

Скачать

Описание

(80 354 651 байт) (cksum - 1937894464)

(40 101 623 байта) (cksum - 2042620384)

Инструменты — дополнительные пакеты

Скачать

Описание

(974 129 байт) (cksum - 422268577)

(1 207 031 байт) (cksum - 2442276638)

Разработка и среда выполнения — дополнительные пакеты

Скачать

Описание

(1 862 248 байт) (cksum - 2034449656)

(1 586 268 байт) (cksum - 4138501784)

(862 944 байта) (cksum - 24903183)

Версия 18.5.0.0.0

Base — требуется один из этих пакетов

Скачать

Описание

(77 769 261 байт) (cksum - 1317689833)

Мгновенная установка клиента для 64-разрядной версии Microsoft Windows

Дополнительную информацию о пакетах Instant Client см. на главной странице Instant Client.

Взаимодействие версий клиент-сервер подробно описано в документе с идентификатором 207303.1. Например, Oracle Call Interface 19, 18 и 12.2 могут подключаться к Oracle Database 11.2 или более поздней версии. Некоторые инструменты могут иметь другие ограничения.

  1. Загрузите соответствующие пакеты Instant Client для вашей платформы.Для всех установок требуется пакет Basic или Basic Light.
  2. Разархивируйте пакеты в один каталог, например C:\oracle\instantclient_19_3
  3. Добавьте этот каталог в переменную среды PATH. Если у вас установлено несколько версий библиотек Oracle, убедитесь, что новый каталог стоит первым в пути. Перезапустите все окна терминала или иным образом убедитесь, что ваши приложения используют новый PATH.
  4. Загрузите и установите правильный распространяемый компонент Visual Studio с веб-сайта Microsoft. Для Instant Client 19 требуется распространяемый компонент Visual Studio 2017. Для Instant Client 18 и 12.2 требуется распространяемый компонент Visual Studio 2013. Для Instant Client 12.1 требуется распространяемый компонент Visual Studio 2010.
  5. Если вы собираетесь размещать дополнительные файлы конфигурации Oracle, такие как tnsnames.ora, sqlnet.ora, ldap.ora или oraaccess.xml, вместе с Instant Client, создайте подкаталог, например C:\oracle\instantclient_19_3\network. \админ

Это каталог конфигурации клиента Oracle по умолчанию для приложений, связанных с этим мгновенным клиентом.

Кроме того, файлы конфигурации клиента Oracle можно поместить в другой доступный каталог. Затем задайте для переменной среды TNS_ADMIN имя этого каталога.

Для Oracle R Enterprise требуется клиентское программное обеспечение Oracle Database.

Oracle Instant Client подходит для большинства конфигураций Oracle R Enterprise.

Эта тема включает следующие разделы:

Похожие темы

6.2.1 Установка Oracle Database Instant Client в Windows

Чтобы установить Oracle Instant Client в Windows:

Создайте каталог установки для клиентских компонентов Oracle R Enterprise. Например:

Перейдите на страницу Oracle Database Instant Client в сети Oracle Technology Network.

Выберите Просмотреть загрузки Instant Client для всех платформ .

На странице загрузки Instant Client выберите Instant Client для Microsoft Windows (x64) .

На странице Instant Client Downloads for Microsoft Windows (x64) примите лицензионное соглашение.

Выберите Instant Client Package — Basic для вашей версии Oracle Database.

Сохраните файл в каталоге установки, созданном на шаге 1. Например:

Разархивируйте файл. Файлы извлекаются в подкаталог с именем InstantClient_version, где version — это ваша версия Oracle Database. Например:

Вернуться на страницу мгновенных загрузок клиентов для Microsoft Windows (x64).

Примите лицензионное соглашение и выберите Instant Client Package — SDK для вашей версии Oracle Database.

Сохраните файл в каталоге установки, созданном на шаге 1.

Разархивируйте файл. Файлы извлекаются в подкаталог InstantClient_version.

Добавьте полный путь к Instant Client в переменные среды OCI_LIB64 и PATH. Следующие шаги задают для переменных путь, используемый в этом примере, c:\myoreclient\instantclient_12_1 :

В панели управления Windows выберите «Система» и нажмите «Дополнительные параметры системы».

На вкладке "Дополнительно" нажмите "Переменные среды" .

В разделе «Системные переменные» создайте OCI_LIB64, если она еще не существует. Установите для OCI_LIB64 значение c:\oreclient\instantclient_12_1 .

В разделе "Системные переменные" измените PATH, включив в него c:\oreclient\instantclient_12_1.

6.2.2 Установка Oracle Database Instant Client в Linux или UNIX

Вы можете установить Oracle Database Instant Client из ZIP-файла в системах Linux или UNIX.

Кажется, я не могу понять, как установить клиент Oracle на Windows Server 2008.

Я скачал версию x64 (первый файл в списке) здесь. Внизу этой страницы есть инструкции по установке:

Шаг 2 ("мгновенный клиент")

Какой исполняемый файл следует запустить?

Я разархивировал, но setup.exe отсутствует. я вижу только следующие файлы приложений: adrci, genezi и uidrvci

Для здравого смысла вы пытаетесь установить полный клиент Oracle (то, что вы бы установили, если бы хотели запустить графический интерфейс, такой как TOAD)? Или вы пытаетесь установить Oracle Instant Client — очень урезанную версию клиента, которая предназначена для установки в комплекте с приложением, которое вы пишете и устанавливаете? Похоже, вы загрузили мгновенный клиент, но если вам нужен установщик, вам нужен полный клиент.

5 ответов 5

Instantclient работает только путем определения папки в переменной среды Windows PATH. Но вы можете «установить» вручную, чтобы создать некоторые ключи в реестре Windows. Как?

2) Разархивируйте ZIP-файл (например, c:\oracle\instantclient).

3) Включите указанный выше путь в PATH.

4) Создайте раздел реестра:

  • Windows 32-разрядная: [HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE]
  • Windows 64-разрядная: [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ORACLE]

5) В приведенном выше разделе реестра создайте подраздел, начинающийся с «KEY_», за которым следует имя нужной установки:

  • Windows 32-разрядная: [HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_INSTANTCLIENT]
  • Windows 64-разрядная: [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ORACLE\KEY_INSTANTCLIENT]

6) Теперь создайте как минимум три строковых значения в указанном выше ключе:

Те, кто использует Quest SQL Navigator или Quest Toad для Oracle, увидят, что это работает. Отображает сообщение «Дом действителен».

Ключи реестра теперь отображаются для выбора клиента oracle:

Хорошо, в Windows для установки соединений ODBC с помощью Oracle Instant Client необходимо загрузить три вещи: 1) базовый пакет мгновенного клиента, 2) сопутствующий пакет ODBC и 3) необходимый распространяемый компонент Visual Studio. Установите распространяемый пакет VS, разархивируйте все файлы мгновенного клиента oracle в один каталог и запустите файл odbc_install.exe. Теперь, когда вы вызываете диалоговое окно настройки ODBC, Oracle Instant Client должен быть вариантом. (Все еще проверяю, нужно ли мне настроить файл tnsnames.ora.)

Мне удалось установить драйверы Oracle Instant Client (Basic) 11g2 и Oracle ODBC (32-разрядная версия) на моем ПК с 32-разрядной ОС Windows 7. Примечание: вам понадобится файл tnsnames.ora, потому что его нет в комплекте. Вы можете погуглить примеры и скопировать/вставить в текстовый файл, изменить параметры для вашей среды.

Настройка Oracle Instant Client-Basic 11g2 (32-разрядная версия Win7)
(я думаю, что есть еще один или два шага, если вы используете 64-разрядную версию)

Мгновенный клиент Oracle

  • Разархивировать клиент Oracle Instant Client — базовый
  • Поместите содержимое в папку типа "C:\instantclient"
  • Измените переменную среды PATH, добавьте путь к папке Instant Client в значение переменной.
  • Добавить новую переменную с именем "TNS_ADMIN", указывающую на ту же папку, что и Instant Client.
  • Мне пришлось создать файл "tnsnames.ora", потому что его не было в комплекте. Поместите его в ту же папку, что и клиент.
  • перезагрузите компьютер или используйте диспетчер задач, чтобы убить «explorer.exe», и перезапустите его, чтобы обновить переменные среды PATH.

Драйверы ODBC

  • Разархивируйте драйверы ODBC
  • Скопировать все файлы в папку клиента "C:\instantclient"
  • Используйте командную строку для запуска "odbc_install.exe" (должно быть указано, что он прошел успешно)

Примечание: «незадокументированные» вещи, которые меня подвешивали.
- Все файлы (Клиент и Драйверы) должны находиться в одной папке (ничего в подпапках).
- Запуск драйвера ODBC из командной строки позволит вам проверить, успешно ли он установлен. Двойной щелчок по установщику только что высветил окно на экране, и я не знал, что он не работает, потому что нет диалогового окна с ошибкой.

После этого вы сможете настроить новый источник данных DSN с помощью драйвера Oracle ODBC.
-Надеюсь, это поможет кому-то еще.

Читайте также: