Vertica 集成 DbVisualizer：连接指南¶

关于 Vertica 连接指南¶

Vertica 连接指南提供将第三方合作伙伴产品连接到 Vertica 的基本说明。连接指南基于我们在特定版本的 Vertica 和合作伙伴产品上的测试。

Vertica 和 DbVisualizer：最新测试版本¶

软件	版本
合作伙伴产品	DbVisualizer Free 13.0.4
Desktop 平台	Windows 10 Enterprise
Vertica 客户端	JDBC 11.0.0
Vertica 服务器	Vertica Database 11.1.1

DbVisualizer 概述¶

DbVisualizer 是一款可视化 SQL 客户端，包含以下主要功能：

广泛的数据库和平台支持
SQL 命令工具
数据库浏览
对象管理
表数据管理

提供 Free 和 Pro 两个版本。Free Edition 是 Pro Edition 功能的子集。详见 DbVisualizer 网站。

开始之前¶

DbVisualizer Free for Vertica 的分发方式有所更新。此前，Vertica Marketplace 上有 DbVisualizer Free for Vertica，DbVisualizer 网站上有 Free 和 Pro 版本。现在可以通过从 DbVisualizer 下载页面下载并安装 DbVisualizer Free Edition，然后从 Vertica 下载并安装特殊许可证来访问 DbVisualizer Free for Vertica。该许可证激活了 DbVisualizer Free 版本中的 Vertica 特定功能。

注：DbVisualizer Pro Edition 包含所有 Vertica 特定功能，使用 DbVis 的标准 Pro 许可证。

安装 DbVisualizer¶

系统要求：参阅 DbVisualizer 网站
下载说明：参阅 DbVisualizer 网站
安装说明：参阅 DbVisualizer 网站

我们的测试中下载了 Recommended Windows 64-bit 发行版并运行安装程序（包含所需的 Java JRE）。如果选择不带 JRE 的安装程序，它会检查是否存在所需的 Java JVM，并在不存在时提供安装选项。

安装 Vertica 客户端驱动程序¶

不需要安装 Vertica 驱动程序。DbVisualizer 附带内置的 Vertica JDBC 驱动程序。

10.0.14 之前的 DbVisualizer 版本包含 Vertica 7.2 JDBC 驱动程序，向前兼容 Vertica Server 7.2 及以上版本。
本次测试的最新版本 13.0.4 包含 Vertica 11.0.0 驱动程序，向后兼容 Vertica Server 7.2，向前兼容未来版本。

安装 DbVisualizer Free for Vertica 许可证¶

右键点击此处并选择 "Save link as..." 下载特殊许可证密钥文件。
将 dbvisfreeforvertica.license 文件保存到本地磁盘。
启动 DbVisualizer，选择 Help > License Key。
选择 License Key File 作为 License Type。
在 License Key File 字段中，输入刚保存的 dbvis.license 文件路径，或点击 Browse 浏览文件。
点击 Install License。
按提示重启 DbVisualizer。DbVisualizer 主窗口标题应显示 "DbVisualizer Free 13.0.4 for Vertica"。

连接 DbVisualizer 到 Vertica¶

从首页菜单选择 Database > Create Database Connection。
在左侧驱动程序窗格中，滚动并找到 Vertica 驱动程序。
双击 Vertica 驱动程序。
在下一个屏幕中，输入以下数据库信息：
Name：输入唯一名称帮助识别数据库
Settings Format：选择 Server Info
Database Server：输入 Vertica 服务器的 IP 地址或主机名
Database Port：5433
Database name：输入 Vertica 服务器上运行的数据库名称
Database Userid：输入要连接的 Vertica 数据库用户
Database Password：输入数据库用户密码
Auto Commit：选中复选框
Save Database Password：选择 Save Between Sessions
Permission Mode：选择 Development
点击 Ping Server 按钮验证连接。
连接成功后点击 Connect。
Database Connection 屏幕出现，可以查看数据库和驱动程序信息，管理数据类型处理以及连接、驱动程序和数据库属性。

故障排查¶

在 SQL Commander 窗口中创建 Vertica 函数时可能会出现错误，如：

[CREATE - 0 rows, 0.001 secs] [Code: 4856, SQL State: 42601] [Vertica][VJDBC](4856) ERROR: Syntax error at or near "EOL"

这是因为 CREATE FUNCTION 有多个语句结束字符作为 CREATE 命令语法的一部分。需要向 DbVisualizer 传递提示以临时更改分隔符。我们成功使用了 @delimiter 提示。详见 DbVisualizer 用户指南中的 Executing Complex Statements 部分。

值得注意的是，Tools 菜单下有一个调试窗口，为 DbVisualizer 和/或 JDBC 驱动程序提供详细的跟踪信息。这在调试连接或 keep alive 相关问题时非常有用。更多信息请参阅 Debugging DbVisualizer 文档。

已知限制¶

要获得不同数值数据类型所需的显示效果，可能需要在结果屏幕格式化对话框或 Menu > Tools > Tool Properties > General 选项卡下的 Data Formatting 中更改格式。
时间格式化最多可显示毫秒。添加微秒会显示前导零。
如果来自 Vertica 的多语言字符显示为乱码，可能是字体无法正确显示。转到 Tool Properties > General > Appearance > Fonts 更改字体。
在某些情况下，Navigator 窗口中连接别名上显示的连接状态符号可能不准确。例如，如果因 TCP 或 keep alive 超时导致连接断开，但 Connection 窗格的数据库别名状态仍显示绿色对勾表示活动连接。可能需要先断开连接才能重新连接。