安装 ODBC 客户端驱动程序

要安装 ODBC，请按照您的平台说明进行操作。有关受支持平台的列表，请参阅客户端驱动程序支持。

本页介绍非 FIPS 安装。要在符合 FIPS 的系统上安装 ODBC，请参阅为 ODBC 和 vsql 安装 FIPS 客户端驱动程序。

在 Linux 上安装

从 RPM 安装 Vertica 会自动安装 ODBC 客户端驱动程序，因此您无需在运行 Vertica 的计算机上再次安装它们。要在这种情况下使用 ODBC 客户端驱动程序，请创建 DSN。

要在其他计算机上手动安装 ODBC 客户端驱动程序：

以 root 身份登录客户端系统。
验证您的系统是否装有受支持的 ODBC 驱动程序管理器。
以适合您的发行版的格式，下载适用于 Linux 的 ODBC 客户端驱动程序。
安装或解压缩驱动程序：
- 如果您下载了 .rpm，请安装该驱动程序：
  
  注意
  如果客户端驱动程序已安装在您的系统上（通过手动安装或通过 Vertica RPM 自动安装），则在您尝试手动重新安装，会收到错误消息。要跳过这些错误并覆盖现有的驱动程序安装，请使用 --force 标志。
```
$ rpm -Uvh driver_name.rpm
```
- 如果您下载了 .tar，则创建 /opt/vertica/ 目录（如果该目录不存在），将 .tar 复制到其中，导航到它，然后解压缩 .tar：
```
$ mkdir -p /opt/vertica/
$ cp driver_name.tar.gz /opt/vertica/
$ tar vzxf driver_name.tar.gz
```
  这将创建两个目录：
  - /opt/vertica/include：包含头文件。
  - /opt/vertica/lib64/（64 位）或 /opt/vertica/lib/（32 位）：包含库文件。
在 vertica.ini 中设置以下 ODBC 驱动程序设置。有关每个设置的详细信息，请参阅 ODBC 驱动程序设置：
- ErrorMessagesPath：必需，包含 ODBC 驱动程序的错误消息文件的目录路径。
- ODBCInstLib：ODBC 安装程序库的路径。仅当驱动管理器的安装库不在环境变量 LD_LIBRARY_PATH 或 LIB_PATH 中时才需要。
- DriverManagerEncoding：驱动程序管理器使用的 UTF 编码标准。仅当您的驱动程序管理器不使用 UTF-8 时才需要。
下面是 vertica.ini 中的示例配置：
- 使用 64 位 UNIXODBC 驱动程序管理器的编码。
- 使用标准 Vertica 64 位 ODBC 驱动程序安装目录中定义的错误消息。
- 将所有警告和严重性更高的消息记录到日志文件 /tmp/
```
[Driver]
DriverManagerEncoding=UTF-16
ODBCInstLib=/usr/lib64/libodbcinst.so
ErrorMessagesPath=/opt/vertica
LogLevel=4
LogPath=/tmp
```
创建 DSN。

在 macOS 上安装

注意

在 macOS 系统上，每个版本的 ODBC 驱动程序只能安装一个。这是因为每个安装都由包 ID 和版本号标识，并且包 ID 在驱动程序的版本之间不会更改。

要在 macOS 上安装 ODBC 客户端驱动程序：

验证您的系统是否装有兼容的驱动程序管理器。该驱动程序旨在与 macOS 附带的标准 iODBC 驱动程序管理器一起使用。您也可以使用 unixODBC。
下载 ODBC 客户端驱动程序。
如果已安装以前版本的 ODBC 驱动程序，则系统可能已注册了名为“Vertica”的驱动程序。在从 .pkg 安装程序安装新版本之前，您必须移除或重命名旧版本的驱动程序。重命名旧版本可让您在安装新版本后保留旧版本。
运行安装程序。
创建 DSN。

静默安装

通过以下两种方式之一登录客户端 macOS：
- 以管理员帐户登录（如果您安装驱动程序是为了在系统范围使用）。
- 以需要使用 Vertica ODBC 驱动程序的用户身份登录。
打开终端。

使用以下命令安装包含 ODBC 驱动程序的 .pkg 文件：

sudo installer -pkg path/to/client/driver/vertica-odbc-xx.x.x-x.pkg -target /

在 Windows 上安装

要在 Windows 上安装 ODBC 客户端驱动程序：

下载适用于 Windows 的客户端驱动程序安装程序。
运行安装程序。
创建 DSN。

静默安装

以管理员身份打开终端。
运行以下命令将驱动程序静默安装到 C:\Program Files\Vertica Systems：
```
VerticaSetup.exe -q -install InstallFolder="C:\Program Files\Vertica Systems"
```