OceanBase ODC 常见问题

客户端版 ODC 安装问题

1. Q：客户端版 ODC 安装预检查时会检查哪些项目？

   A：客户端版 ODC 预检查项目如下所示：

• Windows 操作系统版本检查：仅支持 Windows 7 及以上版本。

• 端口检查：查看 8989 是否被占用。在 ODC V2.3.0 后采用动态端口将不再检查该项。

• Java 运行环境检查：建议安装 JDK 1.8.0 及以上版本。

2. Q：客户端版 ODC 安装或启动失败时如何查看日志？

   A：在日志文件 main.log 中查看报错信息。日志的存放路径如下所示：

• Linux： ~/.config/odc/

• MacOS： ~/Library/Logs/odc/

• Windows： %USERPROFILE%AppDataRoamingodc

3. Q：客户端版 ODC 安装或启动失败，提示端口冲突问题时该如何排查？

   A：查看占用了端口号 8989 的进程，关闭相关进程后再重新安装或启动。如果您使用的是 ODC V2.3.0 及以上版本将不会出现该问题，因为 ODC V2.3.0 后将采用动态端口技术。

• 使用以下命令在 MAC 系统下查看端口号占用情况：

  lsof -i tcp:8989

• 使用以下语句在 Win 系统下查看端口号占用情况：

  netstat -ano|findstr 8989

4. Q：客户端版 ODC 安装或启动失败，提示 Java 版本问题时该如何

   A：使用以下命令查看 Java 运行环境，建议安装 JDK 1.8.0 及以上版本，若版本太低请更新 JDK 并重启电脑后重新安装或启动：

   java -version

5. Q：安装时提示应用未经过安全监测无法安装。

   A：请查看当前机器的安全设置信息并允许本次安装。

连接信息相关问题

1. Q：如何备份 ODC 中的连接信息？

   A：若您使用的是 Web 版 ODC，可直接迁移或备份部署 ODC 时创建的元数据库。若您使用的是客户端版 ODC 可备份用户目录下的文件 odc2.0.mv.db，需要恢复连接时，拷贝或替换该文件至到原目录下即可。

2. Q：执行 SQL 超时时，应如何解决？

   A：当执行 SQL 超时时，可手动设置查询超时时间。在连接信息编辑页面的高级配置中，加大 SQL 查询超时时间 项的值。该设置项从 ODC V2.2.0 版本开始支持，若您使用的是低版本应用，请升级至 ODC V2.2.0 及以上版本。

3. Q：当看到 proxyro 用户不存在的报错时，应如何解决？

   A：当您看到报错信息 proxyro 用户不存在时，可在在连接信息编辑页面的高级配置中，配置 查询 sys 租户视图 项来设置拥有查询 sys 租户视图权限的用户。该设置项从 ODC V2.2.0 版本开始支持，若您使用的是低版本应用，请升级至 ODC V2.2.0 及以上版本。

命令行工具相关问题

1. Q：Windows 系统下桌面版 ODC 使用命令行工具建立连接后，如下图所示出现连接卡住后并断开的问题，应如何解决？
   A：这是因为环境中缺少 Windows 下系统库文件 msvcp120.dll 和 msvcr120.dll，请安装官方 Visual Studio 补丁。

编码相关问题

1. Q：当遇到 GBK 租户乱码问题时，应如何解决？

   A：若您使用的是 ODC V2.2.0 及之前版本时，当遇到 GBK 租户乱码问题时，可在会话属性中修改以下三个参数的值为 utf8mb4 以保证会话级别字符集编码统一：

• 客户端编码参数 character_set_client

• 连接编码参数 character_set_connection

• 结果集编码参数 character_set_results

数据导出导入问题

1. Q：导入或导出数据失败时，任务汇总信息中抛出异常： javax.crypto.BadPaddingException: Given final block not properly padded 时该如何处理？

   A：看到该异常的原因是 OBProxy 密码解密失败。可通过以下三种方法解决：

• 方法一：建议直接安装使用 Open JDK 1.8 及以上版本，这样可以保证 Jre 和 Jce 的版本一致。

• 方法二：从 Oracle 官网下载与当前使用的 JDK 版本一致的 jce_policy 插件，解压后将其中的 local_policy.jar 和 US_export_policy.jar 文件替换原来的 Jar 文件即可。

• 方法三：升级您的 ODC 应用至 V2.3.0 及以后版本。由于策略改变，ODC V2.3.0 后将不再出现这个问题。

DDL 语句展示问题

1. Q：在视图或表管理页面查看视图或表的 DDL 语句时，所展示的语句不全被截断了。

   A：数据库对象管理页面的 DDL 页签调用了系统表 all_views 中字段 text 的内容，在 OBServer V2.2.70 之前， all_views 表中字段 text 的内容太长时会被截断，这个问题的 OBServer V2.2.70 后被修复了。您也可以使用 SHOW CREATE VIEW/TABLE 语句直接查询目标视图或表的完整结构语句。