OceanBase ODC 常見(jiàn)問(wèn)題

客戶端版 ODC 安裝問(wèn)題

1. Q：客戶端版 ODC 安裝預(yù)檢查時(shí)會(huì)檢查哪些項(xiàng)目？

   A：客戶端版 ODC 預(yù)檢查項(xiàng)目如下所示：

• Windows 操作系統(tǒng)版本檢查：僅支持 Windows 7 及以上版本。

• 端口檢查：查看 8989 是否被占用。在 ODC V2.3.0 后采用動(dòng)態(tài)端口將不再檢查該項(xiàng)。

• Java 運(yùn)行環(huán)境檢查：建議安裝 JDK 1.8.0 及以上版本。

2. Q：客戶端版 ODC 安裝或啟動(dòng)失敗時(shí)如何查看日志？

   A：在日志文件 main.log 中查看報(bào)錯(cuò)信息。日志的存放路徑如下所示：

• Linux： ~/.config/odc/

• MacOS： ~/Library/Logs/odc/

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

3. Q：客戶端版 ODC 安裝或啟動(dòng)失敗，提示端口沖突問(wèn)題時(shí)該如何排查？

   A：查看占用了端口號(hào) 8989 的進(jìn)程，關(guān)閉相關(guān)進(jìn)程后再重新安裝或啟動(dòng)。如果您使用的是 ODC V2.3.0 及以上版本將不會(huì)出現(xiàn)該問(wèn)題，因?yàn)?ODC V2.3.0 后將采用動(dòng)態(tài)端口技術(shù)。

• 使用以下命令在 MAC 系統(tǒng)下查看端口號(hào)占用情況：

  lsof -i tcp:8989

• 使用以下語(yǔ)句在 Win 系統(tǒng)下查看端口號(hào)占用情況：

  netstat -ano|findstr 8989

4. Q：客戶端版 ODC 安裝或啟動(dòng)失敗，提示 Java 版本問(wèn)題時(shí)該如何

   A：使用以下命令查看 Java 運(yùn)行環(huán)境，建議安裝 JDK 1.8.0 及以上版本，若版本太低請(qǐng)更新 JDK 并重啟電腦后重新安裝或啟動(dòng)：

   java -version

5. Q：安裝時(shí)提示應(yīng)用未經(jīng)過(guò)安全監(jiān)測(cè)無(wú)法安裝。

   A：請(qǐng)查看當(dāng)前機(jī)器的安全設(shè)置信息并允許本次安裝。

連接信息相關(guān)問(wèn)題

1. Q：如何備份 ODC 中的連接信息？

   A：若您使用的是 Web 版 ODC，可直接遷移或備份部署 ODC 時(shí)創(chuàng)建的元數(shù)據(jù)庫(kù)。若您使用的是客戶端版 ODC 可備份用戶目錄下的文件 odc2.0.mv.db，需要恢復(fù)連接時(shí)，拷貝或替換該文件至到原目錄下即可。

2. Q：執(zhí)行 SQL 超時(shí)時(shí)，應(yīng)如何解決？

   A：當(dāng)執(zhí)行 SQL 超時(shí)時(shí)，可手動(dòng)設(shè)置查詢超時(shí)時(shí)間。在連接信息編輯頁(yè)面的高級(jí)配置中，加大 SQL 查詢超時(shí)時(shí)間 項(xiàng)的值。該設(shè)置項(xiàng)從 ODC V2.2.0 版本開始支持，若您使用的是低版本應(yīng)用，請(qǐng)升級(jí)至 ODC V2.2.0 及以上版本。

3. Q：當(dāng)看到 proxyro 用戶不存在的報(bào)錯(cuò)時(shí)，應(yīng)如何解決？

   A：當(dāng)您看到報(bào)錯(cuò)信息 proxyro 用戶不存在時(shí)，可在在連接信息編輯頁(yè)面的高級(jí)配置中，配置 查詢 sys 租戶視圖 項(xiàng)來(lái)設(shè)置擁有查詢 sys 租戶視圖權(quán)限的用戶。該設(shè)置項(xiàng)從 ODC V2.2.0 版本開始支持，若您使用的是低版本應(yīng)用，請(qǐng)升級(jí)至 ODC V2.2.0 及以上版本。

命令行工具相關(guān)問(wèn)題

1. Q：Windows 系統(tǒng)下桌面版 ODC 使用命令行工具建立連接后，如下圖所示出現(xiàn)連接卡住后并斷開的問(wèn)題，應(yīng)如何解決？ A：這是因?yàn)榄h(huán)境中缺少 Windows 下系統(tǒng)庫(kù)文件 msvcp120.dll 和 msvcr120.dll，請(qǐng)安裝官方 Visual Studio 補(bǔ)丁。

編碼相關(guān)問(wèn)題

1. Q：當(dāng)遇到 GBK 租戶亂碼問(wèn)題時(shí)，應(yīng)如何解決？

   A：若您使用的是 ODC V2.2.0 及之前版本時(shí)，當(dāng)遇到 GBK 租戶亂碼問(wèn)題時(shí)，可在會(huì)話屬性中修改以下三個(gè)參數(shù)的值為 utf8mb4 以保證會(huì)話級(jí)別字符集編碼統(tǒng)一：

• 客戶端編碼參數(shù) character_set_client

• 連接編碼參數(shù) character_set_connection

• 結(jié)果集編碼參數(shù) character_set_results

數(shù)據(jù)導(dǎo)出導(dǎo)入問(wèn)題

1. Q：導(dǎo)入或?qū)С鰯?shù)據(jù)失敗時(shí)，任務(wù)匯總信息中拋出異常： javax.crypto.BadPaddingException: Given final block not properly padded 時(shí)該如何處理？

   A：看到該異常的原因是 OBProxy 密碼解密失敗?？赏ㄟ^(guò)以下三種方法解決：

• 方法一：建議直接安裝使用 Open JDK 1.8 及以上版本，這樣可以保證 Jre 和 Jce 的版本一致。

• 方法二：從 Oracle 官網(wǎng)下載與當(dāng)前使用的 JDK 版本一致的 jce_policy 插件，解壓后將其中的 local_policy.jar 和 US_export_policy.jar 文件替換原來(lái)的 Jar 文件即可。

• 方法三：升級(jí)您的 ODC 應(yīng)用至 V2.3.0 及以后版本。由于策略改變，ODC V2.3.0 后將不再出現(xiàn)這個(gè)問(wèn)題。

DDL 語(yǔ)句展示問(wèn)題

1. Q：在視圖或表管理頁(yè)面查看視圖或表的 DDL 語(yǔ)句時(shí)，所展示的語(yǔ)句不全被截?cái)嗔恕?/p>

   A：數(shù)據(jù)庫(kù)對(duì)象管理頁(yè)面的 DDL 頁(yè)簽調(diào)用了系統(tǒng)表 all_views 中字段 text 的內(nèi)容，在 OBServer V2.2.70 之前， all_views 表中字段 text 的內(nèi)容太長(zhǎng)時(shí)會(huì)被截?cái)?，這個(gè)問(wèn)題的 OBServer V2.2.70 后被修復(fù)了。您也可以使用 SHOW CREATE VIEW/TABLE 語(yǔ)句直接查詢目標(biāo)視圖或表的完整結(jié)構(gòu)語(yǔ)句。