RussianLDP Рейтинг@Mail.ru
WebMoney: 
WMZ Z294115950220 
WMR R409981405661 
WME E134003968233 
Visa 
4274 3200 2453 6495 

Глава 4. Установка Connector/ODBC

Этот раздел объясняет, где загрузить Connector/ODBC, как управлять инсталлятором, скопировать файлы вручную или построить из исходных текстов.

Где взять Connector/ODBC

Можно получить копию последней версии Connector/ODBC с сайта https://dev.mysql.com/downloads/Connector/ODBC/.

Выбор метода установки

Можно установить Connector/ODBC двумя различными методами:

  • Двоичная установка является самой легкой. Вы получаете все необходимые библиотеки и другие предварительно построенные файлы с программой инсталлятора или скриптом пакетной обработки, чтобы выполнить все необходимое копирование и конфигурацию.

  • Установка из исходных текстов предназначается для платформ, где двоичный инсталляционный пакет недоступен, или в ситуациях, где вы хотите настроить или изменить процесс установки Connector/ODBC перед установкой.

Двоичные дистрибутивы Connector/ODBC включают файл INFO_BIN, который описывает окружающую среду и параметры конфигурации. Если вы установили Connector/ODBC из двоичного дистрибутива, это может помочь проверить параметры настройки, которые использовались, чтобы построить дистрибутив на этой платформе. Все дистрибутивы включают файл INFO_SRC, который предоставляет информацию о версии продукта и исходном хранилище, из которого был произведен дистрибутив. Эта информация была добавлена в Connector/ODBC 8.0.14.

Поддерживаемые платформы

Connector/ODBC может использоваться на всех основных платформах, поддержанных MySQL, согласно https://www.mysql.com/en/support/supportedplatforms/database.html. Это включает Windows, большинство подобных Unix операционных систем и macOS.

На всех платформах не-Windows, кроме macOS, драйвер строится для unixODBC и ожидает 2 байта SQLWCHAR, а не 4 байта, как в iODBC. Поэтому двоичные модули совместимы are только с unixODBC, повторно соберите драйвер для iODBC, чтобы использовать их вместе. Для получения дополнительной информации посмотрите раздел 3.2.

Для дальнейших инструкций консультируйтесь с документацией, соответствующей платформе, где вы устанавливаете пакет:

Платформа Двоичный дистрибутив Сборка из исходных текстов
Windows Как поставить Как собрать
Unix/Linux Как поставить Как собрать
macOS Как поставить

Выбор драйвера Unicode или ANSI

Connector/ODBC предлагает гибкость, чтобы обработать данные, используя любой набор символов через Unicode-драйвер или или максимальную скорость для более ограниченного диапазона наборов символов через ANSI-драйвер . Оба вида драйверов обеспечиваются в том же самом пакете загрузки и оба устанавливаются на ваши системы программой установки, которая идет с пакетом загрузки. Пользователи, которые устанавливают Connector/ODBC и регистрируют его в менеджере ODBC вручную, могут установить и регистрировать один или оба из драйверов, они опознаются буквой w (для wide characters) для Unicode и буквой a для ANSI в конце названия библиотеки. Например, myodbc8w.dll против myodbc8a.dll или libmyodbc8w.so против libmyodbc8a.so.

Ранее описанные имена файлов содержат "8", например, myodbc8a.dll, что означает, что они для Connector/ODBC 8.x. Имена файлов с "5", например, myodbc5a.dll, для Connector/ODBC 5.x.

4.1. Установка Connector/ODBC в Windows

Перед установкой Connector/ODBC в Windows:

  • Удостоверьтесь, что обновлен Microsoft Data Access Components (MDAC). Можно получить последнюю версию с сайта Microsoft Data Access and Storage.

  • Удостоверьтесь, что установлен Visual C++ Redistributable for Visual Studio.

    • Connector/ODBC 8.0.14 или выше: VC++ Runtime 2015 или VC++ Runtime 2017.

    • Connector/ODBC 8.0.11 до 8.0.13: VC++ Runtime 2015.

    • Connector/ODBC 5.3: VC++ Runtime 2013.

    Используйте версию пакета, который соответствует системному типу вашего драйвера Connector/ODBC: 64-bit (помечена x64 в имени файла), если вы управляете 64-битным драйвером и 32-bit (помечена x86 в имени файла) для 32-битного.

  • OpenSSL это необходимая зависимость. Пакет MSI включает библиотеки OpenSSL, использовавшиеся Connector/ODBC, в то время как Zip-архив требует, чтобы вы установили OpenSSL в системе.

Есть различные типы дистрибутивов для установки в Windows. Программное обеспечение, которое устанавливается, идентично в каждом случае, только метод установки отличается.

  • MySQL Installer (рекомендуется): MySQL Installer for Windows может установить, модернизировать, формировать и управлять большинством продуктов MySQL, включая Connector/ODBC. Загрузите его с http://dev.mysql.com/downloads/windows/installer/ и см. MySQL Installer documentation. Это не специальный инсталлятор для Connector/ODBC.

  • MSI: Windows MSI Installer Package это мастер, который устанавливает Connector/ODBC. Загрузите его с https://dev.mysql.com/downloads/connector/odbc/. См. раздел 4.1.1 для деталей.

  • Zip-архив: содержит файлы DLL, которые должны быть вручную установлены. Посмотрите раздел 4.1.2 для подробностей.

Драйвер OLE DB/ODBC для Windows 64-bit доступен на Microsoft Downloads.

4.1.1. Установка Connector/ODBC в Windows через установщик

MSI это очень простой метод для установки драйверов Connector/ODBC. Выполните эти шаги, чтобы закончить установку:

  1. Дважды щелкните по автономному инсталлятору, который вы извлекли, или файлу MSI, который вы загрузили.

  2. Запустится MySQL Connector/ODBC Setup Wizard. Нажмите Next, чтобы начать процесс установки.

    Рис. 4.1. Connector/ODBC Windows Installer - Welcome

    The welcome page displayed after starting the installer.
The available buttons are "Next" to continue the installation process or
"Cancel" to quit the installer.
  3. После принятия лицензионного соглашения выберите тип установки. Typical обеспечивает стандартные файлы, чтобы соединиться с базой данных MySQL, используя ODBC. Complete устанавливает все доступные файлы, включая сервисные компоненты и отладку. Oracle рекомендует выбрать один из этих двух вариантов. Если вы выбираете один из этих методов, нажмите Next и продолжаете двигаться к шагу 5.

    Можно также выбрать Custom, где вы выбираете отдельные компоненты, чтобы установить. Если вы выбираете этот метод, нажмите Next и перейдите к шагу 4.

    Рис. 4.2. Connector/ODBC Windows Installer - выбор типа установки

    A list of available setup types to choose from named Typical, Complete,
and Custom.
  4. Если вы выбрали пользовательскую установку, используйте всплывающие окна, чтобы выбрать который компонент установить, затем нажмите Next.

    Рис. 4.3. Connector/ODBC Windows Installer - заказная установка

    Content is described in the surrounding text.
  5. Если вы получаете сообщение об ошибке Error 1918 во время установки, это означает, что у вас нет необходимого пакета Microsoft Visual C++ 2013 Redistributable. См. подробности здесь. Установите пакет, прежде чем вы нажмете Retry.

    Рис. 4.4 Connector/ODBC Windows Installer - Error 1918

    Shows an "Error 1918" popup window containing the key phrase
"This module cannot be found." Available buttons shown are "Abort", "Retry",
and "Ignore".
  6. Как только файлы копируются к их заключительным местоположениям, драйверы регистрируются в Windows ODBC manager. Нажмите Finish.

    Рис. 4.5. Connector/ODBC Windows Installer - все!

    Content is described in the surrounding text.

Теперь, когда установка завершена, сформируйте свои связи ODBC, используя главу 5.

4.1.2. Установка Connector/ODBC Driver в Windows, используя пакет Zipped DLL

Если вы загрузили пакет zipped DLL:

  1. Распакуйте файлы установки.

  2. Запустите комплектный скрипт, чтобы выполнить установку к местоположениям по умолчанию.

  3. Альтернативно, установите отдельные файлы, требуемые для Connector/ODBC вручную.

Следующие инструкции работают только на 32-битных системах Windows. Если у вас есть 64-битная система Windows, используйте инсталлятор MSI, который устанавливает 32-битные и 64-битные драйверы.

Используйте файл скрипта:

  1. Распакуйте файлы установки.

  2. Откройте командную строку.

  3. Перейдите в каталог распаковки.

  4. Запустите Install.bat:

    C:\> Install.bat
    

    Это копирует необходимые файлы в местоположение по умолчанию, и затем регистрирует драйвер Connector/ODBC в Windows ODBC manager.

Изменение или добавление нового DSN (имя источника данных) могут быть достигнуты, используя GUI или от командной строки, используя myodbc-installer.exe.

Хотя Oracle рекомендует установить эти файлы в стандартном местоположении, можно также скопировать файлы вручную к альтернативному местоположению, например, чтобы проверить различные версии драйвера Connector/ODBC на той же самой машине. Чтобы скопировать файлы к местоположению по Вашему выбору, используйте следующие шаги:

  1. Распакуйте файлы установки.

  2. Откройте командную строку.

  3. Перейдите в каталог распаковки.

  4. Скопируйте файлы библиотеки к подходящему каталогу. Местоположение по умолчанию: системный каталог Windows \Windows\System32:

    Для Connector/ODBC 8.x:

    C:\> copy lib\myodbc8S.dll \Windows\System32
    C:\> copy lib\myodbc8S.lib \Windows\System32
    
    Для Unicode-драйвера:
    C:\> copy lib\myodbc8w.dll \Windows\System32
    C:\> copy lib\myodbc8w.lib \Windows\System32
    
    Для ANSI-драйвера:
    C:\> copy lib\myodbc8a.dll \Windows\System32
    C:\> copy lib\myodbc8a.lib \Windows\System32
    

    Для Connector/ODBC 5.x:

    C:\> copy lib\myodbc5S.dll \Windows\System32
    C:\> copy lib\myodbc5S.lib \Windows\System32
    
    Для Unicode-драйвера:
    C:\> copy lib\myodbc5w.dll \Windows\System32
    C:\> copy lib\myodbc5w.lib \Windows\System32
    
    Для ANSI-драйвера:
    C:\> copy lib\myodbc5a.dll \Windows\System32
    C:\> copy lib\myodbc5a.lib \Windows\System32
    
  5. Скопируйте инструменты Connector/ODBC. Они должны быть помещены в каталог, который находится в системной переменной %PATH%. По умолчанию они ставятся в системный каталог Windows \Windows\System32:

    C:\> copy bin\myodbc-installer.exe \Windows\System32
    
  6. Произвольно, скопируйте справочные файлы. Для этих файлов, чтобы быть доступными через систему справочной информации, они должны быть установлены в системном каталоге Windows:

    C:\> copy doc\*.hlp \Windows\System32
    
  7. Наконец, зарегистрируйте драйвер Connector/ODBC в ODBC manager:

    Для Connector/ODBC 8.x:

    Для Unicode-драйвера:
    C:\> myodbc-installer -a -d -t"MySQL ODBC 8.0 Driver;\
    DRIVER=myodbc8w.dll;SETUP=myodbc8S.dll"
    
    Для ANSI-драйвера:
    C:\> myodbc-installer -a -d -t"MySQL ODBC 8.0 Driver;\
    DRIVER=myodbc8a.dll;SETUP=myodbc8S.dll"
    

    Для Connector/ODBC 5.3:

    Для Unicode-драйвера:
    C:\> myodbc-installer -a -d -t"MySQL ODBC 5.3 Driver;\
    DRIVER=myodbc5w.dll;SETUP=myodbcS.dll"
    
    Для ANSI-драйвера:
    C:\> myodbc-installer -a -d -t"MySQL ODBC 5.3 Driver;\
    DRIVER=myodbc5a.dll;SETUP=myodbc5S.dll"
    

    Если вы установили эти файлы в местоположение не по умолчанию, измените ссылки на файлы DLL в вышеупомянутой команде.

4.2. Установка Connector/ODBC в Unix-системах

Есть три метода, доступные для установки Connector/ODBC на Unix. Для большей части Unix вы будете использовать дистрибутив tarball. Для Linux есть RPM через MySQL Yum repository (для некоторых платформ) или прямая загрузка.

Требования

  • unixODBC 2.2.12 или выше.

  • OpenSSL.

4.2.1. Установка Connector/ODBC через MySQL Yum

Репозитарий MySQL Yum для Oracle Linux, Red Hat Enterprise Linux, CentOS и Fedora предоставляет Connector/ODBC RPM через MySQL Yum repository. У вас должен быть MySQL Yum repository в списке хранилищ вашей системы (см. Adding the MySQL Yum Repository). Удостоверьтесь, что ваша установка хранилища актуальна:

shell> su root
shell> yum update mysql-community-release

Можно установить Connector/ODBC следующей командой:

shell> yum install mysql-connector-odbc

См. Installing Additional MySQL Products and Components with Yum.

4.2.2. Установка Connector/ODBC из двоичного архива Tarball

Чтобы поставить драйвер из файла .tar.gz), загрузите последнюю версию для вашей операционной системы и выполните эти шаги, заменив соответствующим файлом и именами каталогов на основе пакета, который вы загружаете (некоторые шаги ниже могут потребовать привилегий суперпользователя):

  1. Распакуйте архив:

    shell> gunzip mysql-connector-odbc-8.0.18-i686-pc-linux.tar.gz
    shell> tar xvf mysql-connector-odbc-8.0.18-i686-pc-linux.tar
    
  2. Дополнительный каталог содержит два подкаталога, lib и bin. Скопируйте их содержание к надлежащим местоположениям на вашей системе (мы используем /usr/local/bin и /usr/local/lib в примере, замените их местами назначения по Вашему выбору):

    shell> cp bin/* /usr/local/bin
    shell> cp lib/* /usr/local/lib
    

    Последняя команда копирует Connector/ODBC ANSI и Unicode из lib в /usr/local/lib. Если вам не нужны оба драйвера, можно просто скопировать тот, который вы хотите. Посмотрите подробности здесь.

  3. Наконец, зарегистрируйте версию драйвера по Вашему выбору (версия ANSI, версия Unicode или обе) в менеджере ODBC вашей системы (например, iODBC или unixodbc) с использованием инструмента myodbc-installer, который был включен в пакет в каталоге bin (и находится теперь в /usr/local/bin, если последний шаг был выполнен), например, это регистрирует Unicode-драйвер:

    Для Connector/ODBC 8.0:

    // Registers the Unicode driver:
    shell> myodbc-installer -a -d -n "MySQL ODBC 8.0 Driver" -t "Driver=/usr/local/lib/libmyodbc8w.so"
    
    // Registers the ANSI driver
    shell> myodbc-installer -a -d -n "MySQL ODBC 8.0" -t "Driver=/usr/local/lib/libmyodbc8a.so"
    

    Для Connector/ODBC 5.3:

    // Registers the Unicode driver:
    shell> myodbc-installer -a -d -n "MySQL ODBC 5.3 Driver" -t "Driver=/usr/local/lib/libmyodbc5w.so"
    
    // Registers the ANSI driver
    shell> myodbc-installer -a -d -n "MySQL ODBC 5.3" -t "Driver=/usr/local/lib/libmyodbc5a.so"
    
  4. Проверьте, что драйвер устанавливается и зарегистрирован с использованием менеджера ODBC или утилиты myodbc-installer:

    shell> myodbc-installer -d -l
    

Далее см. главу 5.5 о том, как формировать DSN для Connector/ODBC.

4.2.3. Установка Connector/ODBC из RPM

Чтобы установить или модернизировать Connector/ODBC из RPM в Linux, просто загрузите пакет RPM последней версии Connector/ODBC и следуйте инструкциям ниже. Используйте su root, чтобы стать root и установить RPM.

Если вы устанавливаете впервые:

shell> su root
shell> rpm -ivh mysql-connector-odbc-8.0.18.i686.rpm

Если драйвер существует, модернизируйте его:

shell> su root
shell> rpm -Uvh mysql-connector-odbc-8.0.18.i686.rpm

Если есть какая-либо ошибка зависимости для библиотеки клиента MySQL, libmysqlclient, просто проигнорируйте это, подставляя опцию --nodeps и затем удостоверьтесь, что разделяемая библиотека клиента MySQL находится в пути или указана в LD_LIBRARY_PATH.

Это устанавливает библиотеки и связанные документы в /usr/local/lib и /usr/share/doc/MyODBC, соответственно, см. главу 5.5 для постинсталляционных шагов конфигурации.

Чтобы удалить драйвер, от имени root выполните команду:

shell> su root
shell> rpm -e mysql-connector-odbc

4.3. Установка Connector/ODBC в macOS

macOS основана на FreeBSD, и можно обычно использовать сетевой порт MySQL для соединения с серверами MySQL на других машинах. Установка Connector/ODBC позволяет вам соединиться с базами данных MySQL по любой платформе через интерфейс ODBC. Если ваше приложение требует интерфейса ODBC, установите Connector/ODBC. Приложения, которые требуют или могут использовать ODBC, включают ColdFusion, Filemaker Pro, 4th Dimension и много других.

В macOS ODBC Administrator основан на iODBC, предоставляет легкое управление драйверами ODBC и конфигурацией, позволяя обновления основного файла настроек iODBC через GUI. Инструмент включен в macOS v10.5 и ранее, пользователи более поздних версий macOS должны загрузить его с http://www.iodbc.org/dataspace/doc/iodbc/wiki/iodbcWiki/Downloads .

OpenSSL требуется. Инсталляционные двоичные пакеты macOS включают OpenSSL, в то время как сжатые архивы требуют, чтобы вы установили OpenSSL на своей системе перед процессом установки.

Есть два способа установить Connector/ODBC на macOS. Можно использовать пакет, обеспеченный в сжатом архиве, который вы вручную устанавливаете или сжатый образ диска (.dmg), который включает инсталлятор.

Для установки с использованием сжатого архива tar (некоторые шаги ниже могут потребовать привилегий суперпользователя):

  1. Скачайте архив tar.

  2. Распакуйте этот архив:

    shell> tar xvzf mysql-connector-odbc-x.y.z-osx10.z-x86-(32|64)bit.tar.gz
    
  3. Созданный каталог содержит два подкаталога, lib и bin. Скопируйте их к подходящему местоположению, например, /usr/local:

    shell> cp bin/* /usr/local/bin
    shell> cp lib/* /usr/local/lib
    
  4. Наконец, зарегистрируйте драйвер в iODBC утилитой myodbc-installer, которая включена в пакет:

    Для Connector/ODBC 8.0:

    shell> myodbc-installer -a -d -n "MySQL ODBC 8.0 Driver" -t "Driver=/usr/local/lib/libmyodbc8w.so"
    

    Для Connector/ODBC 5.3:

    shell> myodbc-installer -a -d -n "MySQL ODBC 5.3 Driver" -t "Driver=/usr/local/lib/libmyodbc5w.so"
    

Для установки, используя сжатый образ диска (.dmg):

Для Connector/ODBC 5.3.7 и позже iODBC 3.52.12 или выше должен быть установлен на macOS-системе, прежде чем можно будет установить Connector/ODBC с использованием сжатого образа диска. Посмотрите здесь.

  1. Скачайте образ диска.

  2. Дважды щелкните по образу диска, чтобы открыть его. Вы видите инсталлятор Connector/ODBC.

  3. Дважды щелкните по инсталлятору Connector/ODBC, и вы будете проведены через остальную часть процесса установки. Вам нужны привилегии суперпользователя, чтобы закончить установку.

Чтобы проверить установленные драйверы, используйте ODBC Administrator или утилиту myodbc-installer:

shell> myodbc-installer -d -l

4.4. Сборка Connector/ODBC из исходных текстов в Windows

Необходимо построить Connector/ODBC в Windows, чтобы изменить инсталляционное местоположение или исходные тексты. Если вы не уверены, установить ли из исходных текстов, пожалуйста, используйте двоичную установку, детализированную в разделе 4.1.

Сборка Connector/ODBC в Windows требует многих различных инструментов и пакетов:

  • MDAC, Microsoft Data Access SDK с http://support.microsoft.com/kb/110093.

  • Подходящий компилятор C++, такой как Microsoft Visual C++ или компилятор C++, включенный в Microsoft Visual Studio 2015 или выше. Для Connector/ODBC 5.3 можно использовать VS 2013.

  • CMake.

  • Библиотека клиента MySQL и включаеемые файлы от MySQL 8.0 или выше для Connector/ODBC 8.0 или MySQL 5.7 для Connector/ODBC 5.3. Это требуется, потому что Connector/ODBC использует требования и структуры, которые не существуют в более старых версиях библиотеки. Чтобы получить библиотеку клиента и файлы, посетите https://dev.mysql.com/downloads/.

Сборка по шагам

Установите переменные окружения для набора инструментальных средств Visual Studio. Visual Studio включает пакетный файл, чтобы установить их для вас и устанавливает короткий путь в меню Start, который открывает командную строку с этими переменными.

Установите MYSQL_DIR к инсталляционному пути сервера MySQL, используя имена файлов короткого стиля. Например:

C:\> set MYSQL_DIR=C:\PROGRA~1\MySQL\MYSQLS~1.0

Соберите Connector/ODBC Connector/ODBC с использованием cmake, выполнив из исходного корневого каталога (в окне командной строки):

C:\> cmake -G "Visual Studio 12 2013"

Это производит файл проекта, который можно открыть Visual Studio или построить из командной строки любой из следующих команд:

C:\> devenv.com MySQL_Connector_ODBC.sln /build Release

Начиная с выпуска 5.3.10, собирая Connector/ODBC динамическая компоновка с библиотекой клиента MySQL выбрана по умолчанию, то есть, опция MYSQLCLIENT_STATIC_LINKING в cmake = FALSE по умолчанию (однако, двоичные дистрибутивы Connector/ODBC от Oracle связаны статически с библиотекой клиента). Если вы хотите компоновать статически с библиотекой клиента MySQL, установите опцию MYSQLCLIENT_STATIC_LINKING в TRUE и используйте опцию MYSQLCLIENT_LIB_NAME, чтобы указать название библиотеки клиента статической компоновки:

C:\> cmake -G "Visual Studio 12 2013" -DMYSQLCLIENT_STATIC_LINKING:BOOL=TRUE\
   DMYSQLCLIENT_LIB_NAME=client_lib_name_with_extension

Также используйте опцию MYSQLCLIENT_LIB_NAME, чтобы компоновать динамически с библиотекой клиента MySQL кроме libmysql.dll. cmake ищет библиотеку клиента под местоположением, определенным опцией MYSQL_LIB_DIR, если она не задана, cmake ищет под местоположениями по умолчанию в папке, определенной опцией MYSQL_DIR.

Начиная с Connector/ODBC 8.0.11, надо использовать BUNDLE_DEPENDENCIES, чтобы устанавливать внешние зависимости библиотеки времени выполнения, такие как OpenSSL. Для зависимостей, унаследованных от библиотеки клиента MySQL, это работает только, если эти зависимости связаны самой библиотекой клиента.

INFO_SRC: этот файл предоставляет информацию о версии продукта и исходном хранилище, из которого был произведен дистрибутив. Был добавлен в Connector/ODBC 8.0.14.

Начиная с Connector/ODBC 5.3.9, можно скомпоновать Connector/ODBC статически (эквивалентно параметру компилятора /MT в Visual Studio) или динамически (эквивалентно параметру компилятора /MD в Visual Studio) с Visual C++ runtime. Опция по умолчанию должна компоновать динамически, если вы хотите компоновать статически, установите STATIC_MSVCRT:BOOL=TRUE:

C:\> cmake -G "Visual Studio 12 2013" -DSTATIC_MSVCRT:BOOL=TRUE

Опции STATIC_MSVCRT и MYSQLCLIENT_STATIC_LINKING независимы друг от друга, то есть, можно скомпоновать Connector/ODBC динамически с Visual C++ runtime, но статически с библиотекой клиента MySQL и наоборот. Однако, если вы компонуете динамически с Visual C++ runtime, также необходимо компоновать с библиотекой клиента MySQL, которая самостоятельно скомпонована динамически с Visual C++ runtime и точно так же статическая компоновка Connector/ODBC с Visual C++ runtime требует компоновки с библиотекой клиента MySQL, которая самостоятельно скомпонована с Visual C++ runtime статически.

Чтобы собрать отладочную сборку, установите тип сборки в cmake так, чтобы правильные версии библиотек клиента MySQL использовались, также, поскольку библиотека клиента MySQL C, построенная Oracle, не строится с параметрами отладки, при компоновке с ней в режиме отладки, используйте опцию WITH_NODEFAULTLIB, чтобы сказать cmake игнорировать неотлаживаемый non-debug C++:

C:\> cmake -G "Visual Studio 14 2015" -DWITH_DEBUG=1-DWITH_NODEFAULTLIB=libcmt

Создайте отладочную сборку этой командой:

C:\> devenv.com MySQL_Connector_ODBC.sln /build Debug

После завершения исполняемые файлы находятся в подкаталогах bin/ и lib/.

См. раздел 4.1.2 о том, как закончить установку, копируя двоичные файлы к правильным местоположениям и регистрируя Connector/ODBC в менеджере ODBC.

4.5. Сборка Connector/ODBC из исходных текстов в Unix

Вам нужны следующие инструменты, чтобы построить MySQL из исходных текстов в Unix:

  • Работающий компилятор ANSI C++. GCC 4.2.1 или позже, Sun Studio 12.1 или позже, как известно, работают.

  • CMake.

  • Библиотеки клиента MySQL и включаемые файлы. Чтобы получить библиотеки клиента и файлы, посетите https://dev.mysql.com/downloads/.

  • Должен быть установлен совместимый менеджер ODBC. Connector/ODBC, как известно, работает с iODBC и unixODBC, см. раздел 3.2.

  • При использовании набора символов, который не собран в библиотеку клиента MySQL, установите определения символов MySQL из подкаталога charsets в каталоге SHAREDIR (по умолчанию это /usr/local/mysql/share/mysql/charsets). Они должны существовать, если вы установили сервер MySQL на той же самой машине. Посмотрите Character Sets, Collations, Unicode.

Как только вы имеете все необходимые файлы, распаковываете исходные файлы в отдельный каталог и вызываете cmake следующей командой:

shell> cmake -G "Unix Makefiles"

Типичные параметры cmake

Вы, возможно, должны были бы помочь cmake найти заголовки MySQL и библиотеки, установив переменные окружения MYSQL_INCLUDE_DIR, MYSQL_LIB_DIR и MYSQL_DIR к соответствующим местоположениям, например:

shell> export MYSQL_INCLUDE_DIR=/usr/local/mysql/include
shell> export MYSQL_LIB_DIR=/usr/local/mysql/lib
shell> export MYSQL_DIR=/usr/local/mysql

Когда вы запускаете cmake, вы могли бы добавить опции в командной строке. Вот некоторые примеры:

  • -DODBC_INCLUDES= dir_name: Используйте, когда каталог включаемых файлов ODBC не найден в системной $PATH.

  • -DODBC_LIB_DIR= dir_name: Используйте, когда каталог библиотеки ODBC не найден в системной $PATH.

  • -DWITH_UNIXODBC= 1: Включить поддержку unixODBC. iODBC библиотека ODBC по умолчанию при сборке Connector/ODBC в Linux. unixODBC может использоваться, устанавливая этот выбор в 1.

  • -DMYSQLCLIENT_STATIC_LINKING= boolean: Компоновать статически с библиотекой клиента MySQL. Начиная с выпуска 5.3.10, собирая Connector/ODBC из исходных текстов, динамическая компоновка с библиотекой клиента MySQL выбрана по умолчанию, то есть, MYSQLCLIENT_STATIC_LINKING в cmake = FALSE по умолчанию (однако, двоичные дистрибутивы Connector/ODBC от Oracle скомпонованы статически с библиотекой клиента). Если вы хотите компоновать статически с библиотекой клиента MySQL, установите опцию в TRUE. См. также описание для опции -DMYSQLCLIENT_LIB_NAME= client_lib_name_with_extension.

  • -DBUNDLE_DEPENDENCIES= boolean: Разрешить установить внешние зависимости времени выполнения библиотеки, такие как OpenSSL, вместе с пакетом. Для зависимостей, унаследованных от библиотеки клиента MySQL, это работает только, если эти зависимости связаны с самой библиотекой клиента. Выбор добавляется в v8.0.11.

  • -DMYSQLCLIENT_LIB_NAME= client_lib_name_with_extension: Местоположение библиотеки клиента MySQL. См. описание для MYSQLCLIENT_STATIC_LINKING. Для выпуска 5.3.10 и позже, если вы хотите компоновать статически с библиотекой клиента MySQL, используют эту опцию, чтобы дать название библиотеки клиента статической компоновки. Также используйте это, если хотите компоновать динамически с библиотекой клиента MySQL кроме libmysqlclient.so. cmake ищет библиотеку клиента под местоположением, определенным переменной окружения MYSQL_LIB_DIR, если переменная не определяется, cmake ищет под местоположениями по умолчанию в каталоге, определенном переменной окружения MYSQL_DIR.

  • -DMYSQL_CONFIG_EXECUTABLE= /path/to/mysql_config: Определяет местоположение утилиты mysql_config, которая используется, чтобы получить значения переменных MYSQL_INCLUDE_DIR, MYSQL_LIB_DIR, MYSQL_LINK_FLAGS и MYSQL_CXXFLAGS. Значения из mysql_config перекрыты значениями, предоставленными непосредственно как параметры cmake .

  • -DMYSQL_LINK_FLAGS= Параметры компоновки MySQL

  • -DMYSQL_CXXFLAGS= Параметры компоновки MySQL C++

  • -DMYSQL_CXX_LINKAGE= 1: Позволяет компоновать C++ с библиотекой клиента MySQL. По умолчанию MYSQL_CXX_LINKAGE включена для MySQL 5.6.4 или позже. Для MySQL 5.6.3 и ранее, этот выбор должен быть установлен явно в 1.

Сборка под Unix

Чтобы собрать библиотеки драйвера, выполните make:

shell> make

Если какие-либо ошибки происходят, исправьте их и продолжите сборку. Если вы не в состоянии закончить сборку, см. раздел 9.1.

Установка библиотек драйвера

Чтобы установить библиотеки драйвера, выполните следующую команду:

shell> make install

Для получения дополнительной информации о процессе сборки обратитесь к файлу BUILD, который идет с исходными текстами.

Тестирование Connector/ODBC в Unix

Некоторые тесты Connector/ODBC обеспечиваются в дистрибутиве с библиотеками, которые вы построили. Чтобы запустить тесты:

  1. Удостоверьтесь, что вы имеете файл odbc.ini в котором можно формировать записи DSN. Образец файла odbc.ini произведен процессом сборки в каталоге test. Установите переменную окружения ODBCINI к местоположению вашего файла odbc.ini.

  2. Настройте тестовый DSN в вашем файле odbc.ini (см. раздел 5.5). Типовая запись DSN, которую можно использовать для тестов, может быть найдена в образце файла odbc.ini.

  3. Установите переменную окружения TEST_DSN к названию вашего теста DSN.

  4. Установите переменную окружения TEST_UID и возможно также TEST_PASSWORD к имени пользователя и паролю для тестов, в случае необходимости. По умолчанию тесты используют root в качестве пользователя и не вводят пароль, если вы хотите, чтобы тесты использовали другое имя пользователя или пароль, надлежит соответственно установить TEST_UID и TEST_PASSWORD.

  5. Удостоверьтесь, что ваш сервер MySQL работает.

  6. Запустите процесс следующей командой:

    shell> make test
    

4.6. Сборка Connector/ODBC в macOS

Чтобы собрать Connector/ODBC в macOS, следуйте инструкциям в разделе 4.5 . Заметьте, что iODBC это библиотека ODBC по умолчанию для сборки Connector/ODBC в macOS. Альтернативно, unixODBC может использоваться, устанавливая опцию -DWITH_UNIXODBC= 1.

4.7. Установка Connector/ODBC из дерева исходных текстов

Этот раздел только для пользователей, которые интересуются помощью нам, чтобы проверить наш новый код. Чтобы просто получить и поставить MySQL Connector/ODBC используйте стандартный выпуск.

Репозитарий кода Connector/ODBC использует Git. Чтобы проверить последний исходный код, посетите GitHub: https://github.com/mysql/mysql-connector-odbc. Чтобы клонировать хранилище Git к вашей машине, используйте эту команду:

git clone https://github.com/mysql/mysql-connector-odbc.git

У вас должна теперь быть копия всего исходного дерева Connector/ODBC в каталоге mysql-connector-odbc. Чтобы построить и затем установить библиотеки из этого исходного дерева на Unix или Linux, используйте шаги, обрисованные в общих чертах в разделе 4.5 .

В Windows используйте Windows Makefiles WIN-Makefile или WIN-Makefile_debug. См. раздел 4.4 .

После начальной операции по контролю, чтобы получить исходное дерево, регулярно выполняйте git pull, чтобы обновить ваш код согласно последней версии.

Поиск

 

Найди своих коллег!

Вы можете направить письмо администратору этой странички, Алексею Паутову. mailto:alexey.v.pautov@mail.ru