Установка драйвера
Драйвер Elasticsearch SQL ODBC можно установить в Microsoft Windows с помощью пакета MSI. Процесс установки прост и состоит из стандартных шагов мастера MSI.
Предварительные требования к установке
Рекомендуемая платформа для установки — Windows 10 64-разрядная или Windows Server 2016 64-разрядная.
Перед установкой драйвера Elasticsearch SQL ODBC необходимо выполнить следующие предварительные требования:
- .NET Framework 4.x полный, последняя версия - https://dotnet.microsoft.com/download/dotnet-framework
-
Microsoft Visual C++ Redistributable для Visual Studio 2017 или более поздней версии - https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist
- Для 64-разрядного драйвера требуется 64-разрядное дополнение
- Для 32-разрядного драйвера требуется 32-разрядное или 64-разрядное дополнение (последнее также устанавливает компоненты, необходимые для 32-разрядного драйвера)
- Права администратора для пользователя, выполняющего установку.
Если какие-либо предварительные требования не выполнены, установщик отобразит сообщение об ошибке и прервет установку.
Невозможно выполнить обновление «на месте» с помощью MSI. Для обновления необходимо сначала удалить старый драйвер, а затем установить новый.
При установке MSI программа SmartScreen Windows Defender может предупредить о запуске неизвестного приложения. Если пакет MSI был загружен с веб-сайта Elastic, можно безопасно принять сообщение, разрешив продолжение установки (Run anyway).
Совместимость версий
Ваш драйвер должен быть совместим с вашей версией Elasticsearch.
Версия драйвера не может быть новее версии Elasticsearch. Например, версия Elasticsearch 7.10.0 не совместима с драйверами 8.17.3.
| Версия Elasticsearch | Совместимые версии драйвера | Пример |
|---|---|---|
8.0.0–8.17.3 |
| Elasticsearch 8.17.3 совместим с драйверами 8.17.3 и более ранними версиями 8.x. Elasticsearch 8.17.3 также совместим с драйверами 7.7.0 и более поздними версиями 7.x. |
7.7.1-7.17 |
| Elasticsearch 7.10.0 совместим с драйверами 7.7.0-7.10.0. |
7.7.0 и более ранние версии |
| Elasticsearch 7.6.1 совместим только с драйверами 7.6.1. |
Загрузка пакета(ов) .msi
Загрузите пакет .msi для драйвера Elasticsearch SQL ODBC 8.17.3 с сайта: 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\8.17.3
Теперь вы можете установить драйвер.
Для установки потребуются права администратора.
При успешной установке вы увидите экран прогресса, за которым последует экран завершения:
На экране завершения можно запустить окно «Администрирование источников данных 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-8.17.3-windows-x86_64.msi /qn
По умолчанию, msiexec.exe не ждёт завершения процесса установки, так как он выполняется в подсистеме Windows. Для ожидания завершения процесса и обеспечения правильной установки %ERRORLEVEL% рекомендуется использовать start /wait для создания процесса и ожидания его завершения:
start /wait msiexec.exe /i esodbc-8.17.3-windows-x86_64.msi /qn
Как и в случае с любым MSI-установочным пакетом, журнал процесса установки можно найти в каталоге %TEMP% с случайно сгенерированным именем в формате MSI<random>.LOG. Путь к файлу журнала можно указать с помощью аргумента командной строки /l
start /wait msiexec.exe /i esodbc-8.17.3-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-8.17.3-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-8.17.3-windows-x86_64.msi /qn
Аналогично процессу установки, путь к журналу процесса удаления можно указать с помощью аргумента командной строки /l
start /wait msiexec.exe /x esodbc-8.17.3-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/8.17/sql-odbc-installation.html
