資料閘道疑難排解

在資料閘道代理程式中，請使用「導覽器」選項顯示狀態、日誌以及查詢頁面，以監督遠端連線流量並針對一般連線和效能問題進行疑難排解。

主題

按一下「導覽器」以存取「資料閘道」頁面。

以下為 GUID-12258C9F-20C9-4812-AED5-9A886A025BFE-default.png 的說明

.png

使用狀態頁面診斷連線問題

您可以使用此頁面複查資料閘道代理程式對遠端資料庫提出的資料庫要求。

在資料閘道代理程式中，依序按一下導覽器和狀態，即可複查資料庫要求。

若要診斷問題，請搜尋日期或工作狀態：

若要搜尋日期，請在搜尋要求欄位中，以 "YYYY-MM-DD HH-MM-SS" 格式輸入全部或部分的日期與時間。例如，若輸入 "2022-03-28"，便會尋找 2022 年 3 月 28 日的項目。
若要搜尋失敗的工作，請在搜尋要求欄位中輸入 "REQUEST FINISHED WITH ERRORS"。

清除搜尋要求欄位即可複查所有工作。
以下為 GUID-0476B3A6-F490-44F2-B7D4-E1EDE0FD0B49-default.png 的說明
.png

按一下工作即可檢視詳細的狀態資訊。
以下為 GUID-DDFD4D08-83CA-4134-A739-517DE4EBBC0B-default.png 的說明
.png

使用日誌頁面診斷連線問題

您可以使用此頁面複查資料閘道代理程式的日誌項目，以便分析連線流量。

在資料閘道代理程式中，依序按一下導覽器和日誌，即可複查日誌項目。將啟用日誌輪詢選項啟用，並且選取適當的日誌記錄層級。例如，若要診斷連線問題，可以將日誌類型設為除錯。
以下為 GUID-B3F74324-7D86-492D-AF32-DD13F152A57F-default.png 的說明
.png

Oracle 建議您在完成疑難排解後，將啟用日誌輪詢停用，或調整日誌類型以擷取較少資訊。

使用查詢頁面診斷連線問題

您可以使用此頁面從資料閘道代理程式查詢遠端資料庫以測試連線及評定效能。

在資料閘道代理程式中，依序按一下導覽器和查詢，以直接從資料閘道代理程式對 (內部部署) 資料庫執行 SQL 敘述句。例如，您可以複製狀態頁面中所列失敗工作的查詢字串、連線字串和驅動程式類別。提供資料庫證明資料並執行查詢，以複查結果和效能統計資料 (使用的時間)。注意：遠端資料庫必須支援使用 JDBC 連線字串的連線。
以下為 GUID-D263ECAE-DE5F-4FC7-8A4E-D468B24E0A90-default.png 的說明
.png

遠端連線問題和秘訣

以下是一些您可能會遇到的連線問題，以及如何解決這些問題的秘訣。

儀表板和分析問題

回報的問題	解決方法
錯誤代碼 603 - 未連線任何代理程式	確定資料閘道代理程式在執行中，並且在「資料閘道組態」頁面中啟用。Linux 上的資料閘道：執行 $ <Data Gateway Install Directory>/domain/bin/status.sh，查看「資料閘道狀態」是 UP 還是 DOWN。Windows 上的資料閘道：檢查「工作管理員」>「詳細資料」索引標籤中的 "datagateway.exe" 處理序。
[nQSError: 77031] 呼叫遠端服務 DatasourceService 時發生錯誤。詳細資訊：[JDSError : 78] URL 格式錯誤	複查語意模型中的連線集區，並且檢查「一般」頁籤和「其他」頁籤中的設定值。

連線或資料集問題

回報的問題	解決方法
錯誤代碼 603 - 未連線任何代理程式	確認資料閘道代理程式在執行中。Linux 上的資料閘道：執行 $ <Data Gateway Install Directory>/domain/bin/status.sh，查看「資料閘道狀態」是 UP 還是 DOWN。若為 Windows 上的資料閘道代理程式，請檢查「工作管理員」之「詳細資料」索引標籤中的 "datagateway.exe" 處理序。
無法儲存連線。提供的連線詳細資訊無效。請輸入正確的詳細資訊，然後再試一次。	建立 DB2 或 SQL Server 連線時，您會在「連線」對話方塊中看到此錯誤。在代理程式的狀態頁面中，您還會看到 `"REQUEST FINISHED WITH ERRORS"`，如果按一下這些要求，則會看到 `"[JDSError : 110] JDS - Invalid connect string / URL to external source, Cause: Invalid Oracle URL specified"`。解決方法：編輯 `<Data Gateway Install Directory>/oracle_common/jdk1.8.0_333/jre/lib/security/java.security 檔案`。在第 720 行找出以下文字： `jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1, RC4, DES, MD5withRSA, \` 將該文字變更為： `jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1, RC4, DES, MD5withRSA, \` 使用 `<Data Gateway Install Directory>/domain/bin/stopJetty.sh`，後面接著 `<Data Gateway Install Directory>/domain/bin/startJetty.sh` 以重新啟動代理程式。
JDSError：110 - 外部來源的連線字串/URL 無效	確認資料閘道代理程式可以連線至資料來源。例如，若是連線至 Oracle Database，請在安裝資料閘道的機器上使用 "telnet <hostname> <port>" 進行測試。
未顯示資料欄	升級資料閘道代理程式。使用的資料閘道代理程式更新若是與 Oracle Analytics Cloud 更新不相符的較舊版本，通常便會發生此問題。
遺漏使用遠端資料連線選項	確認主控台的遠端資料連線頁面中已啟用啟用資料閘道選項。

一般問題

回報的問題	解決方法
代理程式狀態變更失敗，錯誤：未指定代理程式名稱或 Oracle Analytics Cloud URL，或未產生金鑰組	按一下儲存，再按一下啟用。若持續發生問題，請重新啟動應用程式。若有需要，可檢查網路。
測試時傳回「認證失敗，錯誤碼：401」。可能的原因包括： - 尚未將資料閘道代理程式金鑰複製到 Oracle Analytics Cloud 主控台中的「遠端資料連線」頁面。例如，可能在將金鑰貼到 OAC > 主控台 >「遠端資料連線」頁面之前，先按下了「測試」按鈕。 - 已重新產生了資料閘道代理程式金鑰，但尚未將新的金鑰複製到 Oracle Analytics Cloud 主控台中的「遠端資料連線」頁面。例如，可能已經在主控台的「遠端資料連線」頁面中註冊了資料閘道代理程式，但它的 ID 與資料閘道代理程式首頁中金鑰的 ID 不符。 .png	如果尚未複製資料閘道代理程式金鑰，請將金鑰貼到主控台中以註冊代理程式。如果已重新產生了資料閘道代理程式金鑰，請至主控台刪除資料閘道代理程式，然後將金鑰貼到主控台中以重新註冊代理程式。
儲存時傳回「認證失敗，錯誤碼：404」 Oracle Analytics 執行處理如果已更新，通常便會發生此情況。	請參閱： - Guidance For Using Remote Data Gateway on Environments Upgraded From Oracle Analytics Cloud 105.2 and Lower (文件 ID 2574387.1) - Oracle Analytics Cloud - Classic : How to Enable Remote Data Gateway in Customer Managed Oracle Analytics Cloud-Classic Instance Upgraded from 105.2 or Lower Release (文件 ID 2632064.1)。
OAC URL 無效/不明的主機異常狀況，或測試未傳回錯誤/訊息。可能的原因包括： - 資料閘道代理程式首頁中指定的 URL 不正確。例如，可能提供了像 https://oacinst-tenancy.analytics.ocp.oraclecloud.com/dv/ui 或 https://oacinst-tenancy.analytics.ocp.oraclecloud.com/analytics 的 URL - 資料閘道代理程式與 Oracle Analytics Cloud 執行處理之間沒有適當的網路路由。例如，網際網路存取可能透過代理主機伺服器，而防火牆阻擋了從資料閘道代理程式存取 Oracle Analytics Cloud。如果不需要使用代理主機伺服器，請確認執行資料閘道的機器與 Oracle Analytics Cloud 的連線。	資料閘道代理程式首頁中指定的 URL 若不正確，請更新 URL 欄位中的 URL。例如，如果 Oracle Analytics Cloud URL 是 `https://<instance details>.oraclecloud.com/dv/ui`，請指定此 URL：`https://<instance details>.oraclecloud.com`。資料閘道代理程式與 Oracle Analytics Cloud 執行處理之間沒有適當的網路路由： - 在 Linux 上，發出 $ sudo traceroute -T -p 443 https://<instance details>.oraclecloud.com 命令 - 在 Windows 上，發出 C:\> telnet https://<instance details>.oraclecloud.com 443 命令。如果需要使用代理主機伺服器，請檢查資料閘道的代理主機詳細資訊。請參閱 Oracle Analytics Cloud URL 無效 (資料閘道無法與 Oracle Analytics Cloud 通訊)。
Oracle Analytics Cloud URL 無效 (資料閘道無法與 Oracle Analytics Cloud 通訊)	確定在 Oracle Analytics Cloud 主控台中已啟用與設定資料閘道。確定您可以從資料閘道執行的環境連線至 Oracle Analytics Cloud URL。例如在 Linux 上，可以使用 `traceroute` 命令，像是 `sudo traceroute -T -p 443 <Oracle Analytics Cloud 執行處理的完整網域名稱>`。確定沒有任何其他項目會透過防火牆阻擋通訊。如果您使用代理主機，請瀏覽至資料閘道代理程式的首頁，然後檢查主機、連接埠、使用者以及密碼等代理主機設定值。
效能降低	複查「日誌」頁面並搜尋：日期失敗的工作工作 ID 'REMOTE' 找到日誌項目之後，請按一下工作並複查「要求狀態」對話方塊以查看所使用的時間 (毫秒)。詢問您的銷售客戶團隊，以取得調整資料閘道大小的指引。
主控台頁面的遠端資料連線測試失敗	如果測試失敗，資料閘道代理程式會因各種原因而無法認證，包括：尚未將資料閘道代理程式金鑰複製到 Oracle Analytics Cloud 主控台中的遠端資料連線頁面。已重新產生了資料閘道代理程式金鑰，但尚未將新的金鑰複製到 Oracle Analytics Cloud 主控台中的遠端資料連線頁面。資料閘道代理程式與 Oracle Analytics Cloud 之間沒有適當的網路路由。