云数据库OceanBase入门教程 OceanBase ODC 常见问题

2024-02-26 开发教程 云数据库OceanBase入门教程 匿名 4

客户端版 ODC 安装问题

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

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

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

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

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

Q:客户端版 ODC 安装或启动失败时如何查看日志?

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

  • Linux: ~/.config/odc/

  • MacOS: ~/Library/Logs/odc/

  • Windows: %USERPROFILE%\AppData\Roaming\odc\

Q:客户端版 ODC 安装或启动失败,提示端口冲突问题时该如何排查?

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

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

    lsof -i tcp:8989
  • 使用以下语句在 Win 系统下查看端口号占用情况:

    netstat -ano|findstr 8989

Q:客户端版 ODC 安装或启动失败,提示 Java 版本问题时该如何

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

java -version

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语句直接查询目标视图或表的完整结构语句。