- Установка диспетчера драйверов
- Установка диспетчера драйверов для Microsoft ODBC Driver 13, 13.1 и 17
- Установка диспетчера драйверов для Microsoft ODBC Driver 11 for SQL Server
- Installing and Configuring the ODBC Driver for macOS¶
- Prerequisites¶
- Operating System¶
- iODBC¶
- ODBC Manager — Optional/Recommended¶
- Step 1: Install the ODBC Driver¶
- Step 2: Configure the ODBC Driver¶
- Creating a DSN Using ODBC Manager¶
- Creating a DSN by Adding an Entry in the odbc.ini File¶
- Step 3: Test the ODBC Driver¶
- Установка Microsoft ODBC Driver for SQL Server (macOS)
- Microsoft ODBC 17
- Предыдущие версии
- ODBC 13.1
- Файлы драйвера
- Загрузка файла ресурсов
- Устранение неполадок
- Дальнейшие действия
Установка диспетчера драйверов
Скачать драйвер ODBC
Эта статья содержит инструкции по установке диспетчера драйверов unixODBC для использования со всеми версиями драйвера Microsoft ODBC для SQL Server в Linux и macOS.
Перед установкой диспетчера драйверов unixODBC удалите с компьютера все установленные пакеты диспетчера драйверов. Установка диспетчера драйверов unixODBC может вызвать сбой существующего диспетчера драйверов.
Установка диспетчера драйверов для Microsoft ODBC Driver 13, 13.1 и 17
Зависимость диспетчера драйверов разрешается автоматически системой управления пакетами при установке Microsoft ODBC Driver 13, 13.1 или 17 for SQL Server в Linux или macOS по инструкциям в следующих статьях.
Установка диспетчера драйверов для Microsoft ODBC Driver 11 for SQL Server
(SUSE и только в Red Hat Linux).
Использование скрипта установки
Эти инструкции ссылаются на msodbcsql-11.0.2270.0.tar.gz (файл установки для Red Hat Linux). В случае установке предварительной версии для SUSE Linux файл называется msodbcsql-11.0.2260.0.tar.gz .
Порядок установки диспетчера драйверов:
Убедитесь, что у вас есть корневое разрешение.
Перейдите в каталог, куда программа скачивания драйвера ODBC Driver MicrosoftSQL Server поместила файл с именем msodbcsql-11.0.2270.0.tar.gz . Убедитесь в наличии файла *.TAR.GZ, который соответствует вашей версии Linux. Чтобы извлечь файлы, выполните следующую команду: tar xvzf msodbcsql-11.0.2270.0.tar.gz.
Перейдите в каталог msodbcsql-11.0.2270.0 , где должен находиться файл build_dm.sh . Можно запустить build_dm.sh для установки диспетчера драйверов unixODBC.
Чтобы просмотреть список доступных параметров, выполните следующую команду: ./build_dm.sh —help.
Когда все готово к установке, а ваш компьютер имеет доступ к внешнему сайту по протоколу FTP, выполните следующую команду: ./build_dm.sh.
Если компьютер не может получить доступ к внешнему сайту по протоколу FTP, получите unixODBC-2.3.0.tar.gz . Файл unixODBC-2.3.0.tar.gz можно получить на сайте http://www.unixodbc.org. Щелкните ссылку Скачать в левой части страницы, чтобы перейти на страницу скачивания. Щелкните соответствующую ссылку для скачивания unixODBC-2.3.0 (не unixODBC-2.3.1). В этом выпуске Microsoft ODBC Driver 11 for SQL Server версия UnixODBC-2.3.1 не поддерживается. Выполните следующую команду, чтобы начать установки диспетчера драйверов unixODBC: ./build_dm.sh —download-url=file://unixODBC-2.3.0.tar.gz.
Введите YES, чтобы приступить к распаковке файлов. Эта часть процесса может занять около 5 минут.
После завершения выполнения скрипта следуйте инструкциям на экране, чтобы установить диспетчер драйверов unixODBC
Теперь все готово для установки драйвера. Дополнительные сведения см. в инструкциях по установке драйвера ODBC для Linux или macOS.
Установка вручную
Если скрипту установки не удалось завершить работу, самостоятельно выполните настройку и сборку подходящего диспетчера драйверов.
Удалите все старые установленные версии unixODBC (например, unixODBC 2.2.11). В Red Hat Enterprise Linux 5 или 6 выполните следующую команду: yum remove unixODBC. В SUSE Linux Enterprise zypper удалить unixODBC.
Перейдите на сайт http://www.unixodbc.org. Щелкните ссылку Скачать в левой части страницы, чтобы перейти на страницу скачивания. Щелкните соответствующую ссылку, чтобы сохранить файл unixODBC-2.3.0.tar.gz на компьютере. В этом выпуске Microsoft ODBC Driver 11 for SQL Server версия UnixODBC-2.3.1 не поддерживается.
На компьютере Linux выполните команду: tar xvzf unixODBC-2.3.0.tar.gz.
Перейдите в каталог unixODBC-2.3.0.
В командной строке выполните команду: CPPFLAGS=»-DSIZEOF_LONG_INT=8″ .
В командной строке выполните команду: export CPPFLAGS.
В командной строке выполните команду: «./configure —prefix=/usr —libdir=/usr/lib64 —sysconfdir=/etc —enable-gui=no —enable-drivers=no —enable-iconv —with-iconv-char-enc=UTF8 —with-iconv-ucode-enc=UTF16LE» .
В командной строке (выполнив вход в корень) выполните команду: make.
В командной строке (выполнив вход в корень) выполните команду: make install.
Теперь все готово для установки драйвера. Дополнительные сведения см. в инструкциях по установке драйвера ODBC для Linux или macOS.
Источник
Installing and Configuring the ODBC Driver for macOS¶
Similar to Windows, macOS utilizes named data sources (DSNs) for connecting ODBC-based client applications to Snowflake.
In this Topic:
Prerequisites¶
Operating System¶
For a list of the operating systems supported by Snowflake clients, see Operating System Support .
iODBC¶
The Snowflake ODBC driver for Mac requires iODBC, which is available for download from:
To install iODBC:
After downloading iODBC, double-click on the downloaded .dmg file.
Double-click on the installer file, iODBC-SDK.pkg , and follow the prompts.
iODBC provides a GUI administrator tool for configuring drivers and DSNs; however, this tool has not been tested for use with Snowflake and, therefore, should not be used to create or manage DSNs. Use ODBC Manager instead.
ODBC Manager — Optional/Recommended¶
ODBC Manager is a GUI tool for configuring drivers and creating/managing DSNs. The tool is optional because you can also create DSNs manually by editing the appropriate odbc.ini file. ODBC Manager is available from:
To install ODBC Manager:
After downloading ODBC Manager, double-click on the downloaded .dmg file.
Double-click on the installer file, ODBC Manager.pkg , and follow the prompts.
The installer installs ODBC Manager in the
Step 1: Install the ODBC Driver¶
To install the Snowflake ODBC driver for macOS:
If you haven’t already downloaded the driver, download it now. For details, see Downloading the ODBC Driver .
Double-click on the downloaded .dmg file, snowflake_odbc_mac- .dmg .
Double-click on the installer file, snowflakeODBC_ .pkg , and follow the prompts.
You will likely be prompted for the administrator/sudo password for the machine on which you are installing the driver.
If you choose the default directory when prompted, the installer installs the ODBC driver files in the following directories:
Step 2: Configure the ODBC Driver¶
To configure the ODBC driver for macOS, create one or more data source (DSNs), which are stored in the following files, depending on the type of DSN you create:
System DSNs: /Library/ODBC/odbc.ini
To create a DSN, either use ODBC Manager or edit the appropriate odbc.ini file.
Creating a DSN Using ODBC Manager¶
To create a DSN in ODBC Manager:
Start ODBC Manager.
Click on User DSN or System DSN .
Click the Add button.
Select the driver to use ( Snowflake ) and click OK .
Enter the name of the DSN and optionally a description.
Create a Keyword/Value pair for each DSN parameter:
Click Add to create a Keyword/Value pair.
Select Keyword and replace it with the parameter name.
Select Value and replace it with the value for the parameter.
Repeat this process for each parameter. For details about the parameters that can be set for each DSN, see ODBC Configuration and Connection Parameters .
Click OK to create the DSN.
If you are creating the first user or system DSN for the ODBC driver, ODBC Manager creates the odbc.ini file in the corresponding directory for the type of DSN you are creating. If you are creating additional DSNs, ODBC Manager adds entries for each DSN to the existing odbc.ini file.
Creating a DSN by Adding an Entry in the odbc.ini File¶
If a user or system DSN has already been created for the driver, add the new entry to the odbc.ini file that already exists in the corresponding directory for the type of DSN you are creating. If you are creating the first DSN for the driver, you must manually create the odbc.ini file and add the entry to the file.
For each DSN, specify:
DSN name and driver name (Snowflake), in the form of = .
Directory path and name of the driver file, in the form of Driver = /opt/snowflake/snowflakeodbc/lib/universal/libSnowflake.dylib .
Connection parameters, such as server and uid (user login name). Any connection parameters you add to the DSN do not need to be specified in the ODBC connect string.
Any additional parameters, such as default role , database , and warehouse .
Parameters are specified in the form of
= . For details about the parameters that can be set for each DSN, see ODBC Configuration and Connection Parameters .
The following example illustrates an odbc.ini file that configures two data sources that use different forms of an account identifier in the server URL:
testodbc1 uses an account identifier that uses an account identifier that specifies the account myaccount in the organization myorganization .
testodbc2 uses the account locator xy12345 as the account identifier.
Note that testodbc2 uses an account in the AWS US West (Oregon) region. If the account is in a different region or if the account uses a different cloud provider, you need to specify additional segments after the account locator .
Note the following:
Both testodbc1 and testodbc2 have default roles.
testodbc2 also has a default database and warehouse.
Step 3: Test the ODBC Driver¶
You can use the iodbctest command line utility provided with iODBC to test the DSNs you create.
When prompted for the ODBC connect string, enter the required connection parameters (DSN name, server, user login name, and password), as well as any other parameters that you would like to enter as part of the connect string. The connect string takes parameters in the form of
= , e.g. dsn=testodbc2 , with each parameter separated by a semi-colon ( ; ) and no blank spaces. For the list of supported parameters, see ODBC Configuration and Connection Parameters .
If you set the server and user login name in the DSN, the only required parameters in the connect string are the DSN name and user password.
Источник
Установка Microsoft ODBC Driver for SQL Server (macOS)
В этой статье объясняется, как установить Microsoft ODBC Driver for SQL Server в macOS. В ней также содержатся инструкции для необязательных средств командной строки для SQL Server ( bcp и sqlcmd ) и заголовков разработки unixODBC.
В этой статье приведены команды для установки драйвера ODBC из оболочки bash. Сведения о том, как загрузить пакеты напрямую, см. в разделе Скачивание драйвера ODBC Driver for SQL Server.
Драйвер Microsoft ODBC Driver for SQL Server в macOS поддерживается только в 64-разрядной архитектуре до версии 17.7. Apple M1 (ARM64) поддерживается начиная с версии 17.8. Будет обнаружена архитектура, и с помощью формулы Homebrew автоматически установится правильный пакет. Если командная строка работает в режиме эмуляции x64 на оборудовании M1, будет установлен пакет x64. Если командная строка не работает в режиме эмуляции, будет установлен пакет ARM64.
Microsoft ODBC 17
Чтобы установить Microsoft ODBC Driver 17 для SQL Server в macOS, выполните следующие команды:
Если вы установили пакет msodbcsql версии 17, который был доступен непродолжительное время, его следует удалить перед установкой пакета msodbcsql17 . Это позволит избежать конфликтов. Пакет msodbcsql17 можно установить параллельно с пакетом msodbcsql версии 13.
Предыдущие версии
В следующих разделах приведены инструкции по установке предыдущих версий драйвера Microsoft ODBC в macOS.
ODBC 13.1
Используйте следующие команды для установки драйвера Microsoft ODBC Driver 13.1 for SQL Server в OS X 10.11 (El Capitan) и macOS 10.12 (Sierra):
Файлы драйвера
Драйвер ODBC в macOS состоит из следующих компонентов.
Компонент | Описание |
---|---|
libmsodbcsql.17.dylib или libmsodbcsql.13.dylib | Файл динамической библиотеки ( dylib ), содержащий все функциональные возможности драйвера. Этот файл устанавливается в папке /usr/local/lib/ . |
msodbcsqlr17.rll либо msodbcsqlr13.rll | Сопутствующий файл ресурса для библиотеки драйвера. Этот файл устанавливается в папке [driver .dylib directory]../share/msodbcsql17/resources/en_US/ для версии 17 драйвера и в папке [driver .dylib directory]../share/msodbcsql/resources/en_US/ для версии 13. |
msodbcsql.h | Файл заголовка, содержащий все новые определения, необходимые для использования драйвера. Примечание. Нельзя сочетать в одной программе ссылки на msodbcsql.h и odbcss.h. Файл msodbcsql.h устанавливается в папке /usr/local/include/msodbcsql17/ для версии 17 драйвера и в папке /usr/local/include/msodbcsql/ для версии 13. |
LICENSE.txt | Текстовый файл с условиями лицензионного соглашения. Этот файл помещается в папку /usr/local/share/doc/msodbcsql17/ для версии 17 драйвера и в папку /usr/local/share/doc/msodbcsql/ для версии 13. |
RELEASE_NOTES | Текстовый файл с заметками о выпуске. Этот файл помещается в папку /usr/local/share/doc/msodbcsql17/ для версии 17 драйвера и в папку /usr/local/share/doc/msodbcsql/ для версии 13. |
Загрузка файла ресурсов
Чтобы драйвер работал, он должен загрузить файл ресурсов. Этот файл имеет имя msodbcsqlr17.rll или msodbcsqlr13.rll в зависимости от версии драйвера. Файл .rll располагается по пути относительно расположения самого драйвера ( so или dylib ), указанного в таблице выше. Кроме того, начиная с версии 17.1 драйвер пытается загрузить файл .rll из каталога по умолчанию, если его не удалось загрузить по относительному пути. Путь к файлу ресурсов по умолчанию в macOS: /usr/local/share/msodbcsql17/resources/en_US/
Устранение неполадок
Некоторые пользователи столкнулись с проблемой при попытке подключения после установки драйвера ODBC и получили сообщение об ошибке следующего вида: «[01000] [unixODBC][Driver Manager]Can’t open lib ‘ODBC Driver 17 for SQL Server’ : file not found (0) (SQLDriverConnect)» . Возможно, это произошло потому, что не удалось найти зарегистрированные драйверы из-за неправильной настройки unixODBC. В таких случаях проблему можно устранить, создав пару символических ссылок.
Сведения о других ситуациях, в которых не удается установить подключение к SQL Server с помощью драйвера ODBC, см. в статье, посвященной устранению известных неполадок подключения.
Дальнейшие действия
После установки драйвера можно попробовать пример приложения C++ ODBC. Подробнее о разработке приложений ODBC см. в разделе Разработка приложений.
Дополнительные сведения см. в статьях с заметками о выпуске и требованиями к системе для драйвера ODBC.
Источник