Установка драйвера
Драйвер Elasticsearch SQL ODBC можно установить в Microsoft Windows с помощью пакета MSI. Процесс установки простой и состоит из стандартных шагов мастера MSI.
Предварительные требования
Рекомендуемая платформа — Windows 10 64-разрядная или Windows Server 2016 64-разрядная.
Перед установкой драйвера Elasticsearch SQL ODBC необходимо выполнить следующие предварительные требования:
- .NET Framework 4.0 full — https://www.microsoft.com/en-au/download/details.aspx?id=17718
-
Microsoft Visual C++ Redistributable для Visual Studio 2017 или более поздних версий — https://support.microsoft.com/en-au/help/2977003/the-latest-supported-visual-c-downloads
- 64-разрядный драйвер требует x64 redistributable
- 32-разрядный драйвер требует x86 или x64 redistributable (последний также устанавливает компоненты, необходимые для 32-разрядного драйвера)
- Права администратора для пользователя, выполняющего установку.
Если не выполнены какие-либо предварительные требования, установщик отобразит сообщение об ошибке и прервет установку.
Невозможно выполнить инкрементное обновление с помощью MSI. Для обновления необходимо сначала удалить старый драйвер, а затем установить новый.
При установке MSI программа Windows Defender SmartScreen может предупредить о запуске неизвестного приложения. Если пакет MSI был загружен с веб-сайта Elastic, безопасно принять сообщение, разрешив продолжить установку (Run anyway).
Совместимость версий
Ваш драйвер должен быть совместим с версией вашего сервера Elasticsearch.
Версия драйвера не может быть новее, чем версия сервера Elasticsearch. Например, сервер 7.10.0 несовместим с драйверами 7.17.28.
| Версия сервера Elasticsearch | Совместимые версии драйверов | Пример |
|---|---|---|
7.7.1-7.17.28 |
| Сервер 7.10.0 совместим с драйверами 7.7.0-7.10.0. |
7.7.0 и более ранние версии |
| Сервер 7.6.1 совместим только с драйверами 7.6.1. |
Загрузка пакета(ов) .msi
Загрузите пакет .msi для драйвера Elasticsearch SQL ODBC 7.17.28 с сайта: https://www.elastic.co/downloads/odbc-client
Доступны две версии установщика:
- 32-разрядный драйвер (x86) для использования с пакетом Microsoft Office 2016; в частности, с Microsoft Excel и Microsoft Access, а также другими 32-разрядными программами.
- 64-разрядный драйвер (x64) рекомендуется для использования со всеми другими приложениями.
Пользователям рекомендуется загрузить и установить как 32-, так и 64-разрядные драйверы для максимальной совместимости с приложениями, установленными в системе.
Установка с помощью графического интерфейса пользователя (GUI)
Дважды щелкните загруженный пакет .msi, чтобы запустить мастер GUI, который проведет вас через процесс установки.
Сначала будет представлен экран приветствия:
Нажатие на Далее откроет лицензионное соглашение с конечным пользователем. Вам необходимо принять условия лицензионного соглашения, чтобы продолжить установку.
На следующем экране можно настроить путь установки файлов драйвера Elasticsearch ODBC.
Стандартный путь установки имеет формат: %ProgramFiles%\Elastic\ODBCDriver\7.17.28
Теперь можно приступить к установке драйвера.
Для установки потребуются права администратора.
Предполагая, что установка прошла без ошибок, вы увидите экран выполнения, а затем экран завершения:
На экране завершения можно запустить окно администрирования источников данных ODBC, установив флажок в диалоговом окне. Это автоматически запустит окно настройки (32-разрядное или 64-разрядное), где можно настроить DSN.
Как и в любом пакете MSI, файл журнала процесса установки можно найти в каталоге %TEMP% под случайным именем, соответствующим формату MSI<random>.LOG.
Если во время установки возникла ошибка, рекомендуем открыть вопрос на https://github.com/elastic/elasticsearch-sql-odbc/issues, прикрепить файл журнала установки и предоставить дополнительные сведения для расследования.
Установка с помощью командной строки
Приведённые ниже примеры относятся к установке 64-битного MSI-пакета. Для достижения того же результата с 32-битным MSI-пакетом используйте суффикс файла windows-x86.msi
Пакет .msi также можно установить с помощью командной строки. Самая простая установка с теми же значениями по умолчанию, что и в графическом интерфейсе, достигается путём перехода в каталог загрузки, а затем выполнением:
msiexec.exe /i esodbc-7.17.28-windows-x86_64.msi /qn
По умолчанию, msiexec.exe не ждёт завершения процесса установки, так как он выполняется в подсистеме Windows. Для ожидания завершения процесса и обеспечения правильной установки %ERRORLEVEL% рекомендуется использовать start /wait для создания процесса и ожидания его завершения:
start /wait msiexec.exe /i esodbc-7.17.28-windows-x86_64.msi /qn
Как и в случае с любым MSI-установочным пакетом, журнал процесса установки можно найти в каталоге %TEMP% с случайно сгенерированным именем в формате MSI<random>.LOG. Путь к файлу журнала можно указать с помощью аргумента командной строки /l
start /wait msiexec.exe /i esodbc-7.17.28-windows-x86_64.msi /qn /l install.log
Аргументы командной строки для Windows Installer можно просмотреть, используя:
msiexec.exe /help
…или обратившись к опциям командной строки Windows Installer SDK.
Параметры командной строки
Все настройки, доступные в графическом интерфейсе, также доступны в качестве аргументов командной строки (называемых свойствами в документации Windows Installer), которые можно передать в msiexec.exe:
| | Каталог установки. По умолчанию |
Для передачи значения просто добавьте имя и значение свойства в формате <PROPERTYNAME>="<VALUE>" к команде установки. Например, для использования другого каталога установки вместо значения по умолчанию:
start /wait msiexec.exe /i esodbc-7.17.28-windows-x86_64.msi /qn INSTALLDIR="c:\CustomDirectory"
Дополнительные правила, связанные со значениями, содержащими кавычки, см. в документации по параметрам командной строки Windows Installer SDK.
Удаление с помощью "Установка и удаление программ"
Пакет .msi обрабатывает удаление всех каталогов и файлов, добавленных в ходе установки.
Удаление удалит все содержимое, созданное в ходе установки.
Установленную программу можно удалить, нажав клавишу Windows и набрав add or remove programs, чтобы открыть системные настройки.
После открытия найдите установленный драйвер Elasticsearch ODBC в списке установленных приложений, нажмите на него и выберите Uninstall:
Удаление с помощью командной строки
Удаление также можно выполнить из командной строки, перейдя в каталог с пакетом .msi и выполнив:
start /wait msiexec.exe /x esodbc-7.17.28-windows-x86_64.msi /qn
Аналогично процессу установки, путь к журналу процесса удаления можно указать с помощью аргумента командной строки /l
start /wait msiexec.exe /x esodbc-7.17.28-windows-x86_64.msi /qn /l uninstall.log
© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/sql-odbc-installation.html
