Этот раздел объясняет, где загрузить 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 | Как поставить |
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.
Перед установкой 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.
MSI это очень простой метод для установки драйверов Connector/ODBC. Выполните эти шаги, чтобы закончить установку:
Дважды щелкните по автономному инсталлятору, который вы извлекли, или файлу MSI, который вы загрузили.
Запустится MySQL Connector/ODBC Setup Wizard. Нажмите
, чтобы начать процесс установки.Рис. 4.1. Connector/ODBC Windows Installer - Welcome
После принятия лицензионного соглашения выберите тип установки. Typical обеспечивает стандартные файлы, чтобы соединиться с базой данных MySQL, используя ODBC. Complete устанавливает все доступные файлы, включая сервисные компоненты и отладку. Oracle рекомендует выбрать один из этих двух вариантов. Если вы выбираете один из этих методов, нажмите и продолжаете двигаться к шагу 5.
Можно также выбрать Custom, где вы выбираете отдельные компоненты, чтобы установить. Если вы выбираете этот метод, нажмите и перейдите к шагу 4.
Рис. 4.2. Connector/ODBC Windows Installer - выбор типа установки
Если вы выбрали пользовательскую установку, используйте всплывающие окна, чтобы выбрать который компонент установить, затем нажмите
.Рис. 4.3. Connector/ODBC Windows Installer - заказная установка
Если вы получаете сообщение об ошибке Error 1918 во время установки, это означает, что у вас нет необходимого пакета Microsoft Visual C++ 2013 Redistributable. См. подробности здесь. Установите пакет, прежде чем вы нажмете .
Рис. 4.4 Connector/ODBC Windows Installer - Error 1918
Как только файлы копируются к их заключительным местоположениям, драйверы регистрируются в Windows ODBC manager. Нажмите
.Рис. 4.5. Connector/ODBC Windows Installer - все!
Теперь, когда установка завершена, сформируйте свои связи ODBC, используя главу 5.
Если вы загрузили пакет zipped DLL:
Распакуйте файлы установки.
Запустите комплектный скрипт, чтобы выполнить установку к местоположениям по умолчанию.
Альтернативно, установите отдельные файлы, требуемые для Connector/ODBC вручную.
Следующие инструкции работают только на 32-битных системах Windows. Если у вас есть 64-битная система Windows, используйте инсталлятор MSI, который устанавливает 32-битные и 64-битные драйверы.
Используйте файл скрипта:
Распакуйте файлы установки.
Откройте командную строку.
Перейдите в каталог распаковки.
Запустите Install.bat
:
C:\> Install.bat
Это копирует необходимые файлы в местоположение по умолчанию, и затем регистрирует драйвер Connector/ODBC в Windows ODBC manager.
Изменение или добавление нового DSN (имя источника данных) могут быть достигнуты, используя GUI или от командной строки, используя myodbc-installer.exe.
Хотя Oracle рекомендует установить эти файлы в стандартном местоположении, можно также скопировать файлы вручную к альтернативному местоположению, например, чтобы проверить различные версии драйвера Connector/ODBC на той же самой машине. Чтобы скопировать файлы к местоположению по Вашему выбору, используйте следующие шаги:
Распакуйте файлы установки.
Откройте командную строку.
Перейдите в каталог распаковки.
Скопируйте файлы библиотеки к подходящему каталогу.
Местоположение по умолчанию: системный каталог 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
Скопируйте инструменты Connector/ODBC.
Они должны быть помещены в каталог, который находится в системной переменной
%PATH%
. По умолчанию они ставятся в системный
каталог Windows \Windows\System32
:
C:\> copy bin\myodbc-installer.exe \Windows\System32
Произвольно, скопируйте справочные файлы. Для этих файлов, чтобы быть доступными через систему справочной информации, они должны быть установлены в системном каталоге Windows:
C:\> copy doc\*.hlp \Windows\System32
Наконец, зарегистрируйте драйвер 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 в вышеупомянутой команде.
Есть три метода, доступные для установки Connector/ODBC на Unix. Для большей части Unix вы будете использовать дистрибутив tarball. Для Linux есть RPM через MySQL Yum repository (для некоторых платформ) или прямая загрузка.
unixODBC 2.2.12 или выше.
OpenSSL.
Репозитарий 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.
Чтобы поставить драйвер из файла .tar.gz
),
загрузите последнюю версию для вашей операционной системы и выполните эти
шаги, заменив соответствующим файлом и именами каталогов на основе пакета,
который вы загружаете (некоторые шаги ниже могут
потребовать привилегий суперпользователя):
Распакуйте архив:
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
Дополнительный каталог содержит два подкаталога,
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
.
Если вам не нужны оба драйвера, можно просто скопировать тот, который вы
хотите. Посмотрите подробности
здесь.
Наконец, зарегистрируйте версию драйвера по Вашему
выбору (версия 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"
Проверьте, что драйвер устанавливается и зарегистрирован с использованием менеджера ODBC или утилиты myodbc-installer:
shell> myodbc-installer -d -l
Далее см. главу 5.5 о том, как формировать DSN для Connector/ODBC.
Чтобы установить или модернизировать 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
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 (некоторые шаги ниже могут потребовать привилегий суперпользователя):
Скачайте архив tar.
Распакуйте этот архив:
shell> tar xvzf mysql-connector-odbc-x.y.z
-osx10.z
-x86-(32|64)
bit.tar.gz
Созданный каталог содержит два подкаталога,
lib
и bin
.
Скопируйте их к подходящему местоположению, например,
/usr/local
:
shell> cp bin/* /usr/local/bin shell> cp lib/* /usr/local/lib
Наконец, зарегистрируйте драйвер в 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 с использованием сжатого образа диска. Посмотрите здесь.
Скачайте образ диска.
Дважды щелкните по образу диска, чтобы открыть его. Вы видите инсталлятор Connector/ODBC.
Дважды щелкните по инсталлятору Connector/ODBC, и вы будете проведены через остальную часть процесса установки. Вам нужны привилегии суперпользователя, чтобы закончить установку.
Чтобы проверить установленные драйверы, используйте ODBC Administrator или утилиту myodbc-installer:
shell> myodbc-installer -d -l
Необходимо построить 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.
Вам нужны следующие инструменты, чтобы построить 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 найти заголовки 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=
:
Используйте, когда каталог включаемых файлов ODBC
не найден в системной dir_name
$PATH
.
-DODBC_LIB_DIR=
: Используйте, когда каталог
библиотеки ODBC не найден в системной dir_name
$PATH
.
-DWITH_UNIXODBC=
: Включить поддержку unixODBC.
1
iODBC
библиотека ODBC по умолчанию при сборке
Connector/ODBC в Linux. unixODBC
может
использоваться, устанавливая этот выбор в 1.
-DMYSQLCLIENT_STATIC_LINKING=
: Компоновать статически с библиотекой
клиента MySQL. Начиная с выпуска 5.3.10, собирая Connector/ODBC из
исходных текстов, динамическая компоновка с библиотекой клиента MySQL
выбрана по умолчанию, то есть,
boolean
MYSQLCLIENT_STATIC_LINKING
в
cmake =
FALSE
по умолчанию (однако, двоичные
дистрибутивы Connector/ODBC от Oracle скомпонованы статически с библиотекой
клиента). Если вы хотите компоновать статически с библиотекой клиента MySQL,
установите опцию в TRUE
. См. также описание для
опции -DMYSQLCLIENT_LIB_NAME=
.client_lib_name_with_extension
-DBUNDLE_DEPENDENCIES=
: Разрешить установить внешние зависимости
времени выполнения библиотеки, такие как OpenSSL, вместе с пакетом.
Для зависимостей, унаследованных от библиотеки клиента MySQL, это работает
только, если эти зависимости связаны с самой библиотекой клиента.
Выбор добавляется в v8.0.11.
boolean
-DMYSQLCLIENT_LIB_NAME=
:
Местоположение библиотеки клиента MySQL. См. описание для
client_lib_name_with_extension
MYSQLCLIENT_STATIC_LINKING
.
Для выпуска 5.3.10 и позже, если вы хотите компоновать статически с
библиотекой клиента MySQL, используют эту опцию, чтобы дать название
библиотеки клиента статической компоновки. Также используйте это, если хотите
компоновать динамически с библиотекой клиента MySQL кроме
libmysqlclient.so
.
cmake
ищет библиотеку клиента под местоположением, определенным переменной
окружения MYSQL_LIB_DIR
, если переменная не
определяется, cmake
ищет под местоположениями по умолчанию в каталоге, определенном переменной
окружения MYSQL_DIR
.
-DMYSQL_CONFIG_EXECUTABLE=
:
Определяет местоположение утилиты
mysql_config, которая используется, чтобы получить значения
переменных /path/to/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
.
Чтобы собрать библиотеки драйвера, выполните make:
shell> make
Если какие-либо ошибки происходят, исправьте их и продолжите сборку. Если вы не в состоянии закончить сборку, см. раздел 9.1.
Чтобы установить библиотеки драйвера, выполните следующую команду:
shell> make install
Для получения дополнительной информации о процессе сборки обратитесь к
файлу BUILD
, который идет с исходными текстами.
Некоторые тесты Connector/ODBC обеспечиваются в дистрибутиве с библиотеками, которые вы построили. Чтобы запустить тесты:
Удостоверьтесь, что вы имеете файл
odbc.ini
в котором можно формировать записи
DSN. Образец файла odbc.ini
произведен процессом сборки в каталоге test
.
Установите переменную окружения ODBCINI
к
местоположению вашего файла odbc.ini
.
Настройте тестовый DSN в вашем файле
odbc.ini
(см.
раздел 5.5).
Типовая запись DSN, которую можно использовать для тестов, может быть найдена
в образце файла odbc.ini
.
Установите переменную окружения
TEST_DSN
к названию вашего теста DSN.
Установите переменную окружения
TEST_UID
и возможно также
TEST_PASSWORD
к имени пользователя и паролю для
тестов, в случае необходимости. По умолчанию тесты используют
root в качестве пользователя и не вводят пароль,
если вы хотите, чтобы тесты использовали другое имя пользователя или пароль,
надлежит соответственно установить TEST_UID
и
TEST_PASSWORD
.
Удостоверьтесь, что ваш сервер MySQL работает.
Запустите процесс следующей командой:
shell> make test
Чтобы собрать Connector/ODBC в macOS, следуйте инструкциям в
разделе 4.5
. Заметьте, что iODBC
это библиотека ODBC по
умолчанию для сборки Connector/ODBC в macOS.
Альтернативно, unixODBC
может использоваться,
устанавливая опцию -DWITH_UNIXODBC=
.1
Этот раздел только для пользователей, которые интересуются помощью нам, чтобы проверить наш новый код. Чтобы просто получить и поставить 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, чтобы обновить ваш код согласно последней версии.