数据网关故障排除

在数据网关代理中，使用“导航器”选项显示“状态”、“日志”和“查询”页以监视远程连接流量以及对常见连接和性能问题进行故障排除。

主题

单击“导航器”以访问数据网关页。

.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，查看 "Data Gateway Status" 为 UP 还是 DOWN。对于 Windows 上的数据网关：在“任务管理器”>“详细信息”选项卡中检查 "datagateway.exe" 进程。
[nQSError: 77031] 调用远程服务 DatasourceService 时出错。详细信息：[JDSError: 78] 格式错误的 URL	查看语义模型中的连接池，并在“一般信息”选项卡和“其他”选项卡中验证设置。

连接或数据集问题

报告的问题	执行此操作
错误代码 603 — 未连接代理	检查数据网关代理是否正在运行。对于 Linux 上的数据网关：运行 $ <Data Gateway Install Directory>/domain/bin/status.sh，查看 "Data Gateway Status" 为 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, RC4, DES, MD5withRSA, \` 使用 `<Data Gateway Install Directory>/domain/bin/stopJetty.sh` 和 `<Data Gateway Install Directory>/domain/bin/startJetty.sh`，重新启动代理。
JDSError：110 — 外部源的连接字符串/URL 无效	检查数据网关代理是否可以连接到数据源。例如，如果您要连接到 Oracle 数据库，则在安装了数据网关的计算机上使用 "telnet <hostname> <port>" 进行测试。
无列显示	升级数据网关代理。通常在您使用的是早期数据网关代理更新而此更新与您的 Oracle Analytics Cloud 更新不匹配时出现此问题。
缺少“使用远程数据连接”选项	检查是否在控制台的远程数据连接页上启用了启用数据网关选项。

一般问题

报告的问题	执行此操作
代理状态更改失败，出现错误：未指定代理名称或 Oracle Analytics Cloud URL，或者未生成密钥对	依次单击保存和启用。如果问题仍然存在，则重新启动应用程序。如果需要，请检查网络。
测试时返回“验证失败，出现错误：401”。可能的原因包括： — 数据网关代理密钥尚未复制到 Oracle Analytics Cloud 控制台中的“远程数据连接”页。例如，您可能在 OAC > 控制台 >“远程数据连接”页中粘贴密钥之前单击了“测试”按钮。 — 已重新生成数据网关代理密钥，但新密钥尚未复制到 Oracle Analytics Cloud 控制台中的“远程数据连接”页。例如，您可能已经在控制台中的“远程数据连接”页中注册了数据网关代理，但它的 ID 与数据网关代理主页中的密钥 "id" 不匹配。 .png 的说明	如果尚未复制数据网关代理密钥，请在控制台中粘贴该密钥以注册代理。如果重新生成了数据网关代理密钥，请在控制台中删除数据网关代理，然后在控制台中粘贴该密钥以重新注册代理。
保存时返回“验证失败，出现错误：404”。通常在更新了 Oracle Analytics 实例时出现此问题。	请参见： — 有关在从 Oracle Analytics Cloud 105.2 及更低版本升级的环境中使用远程数据网关的指导（文档 ID 2574387.1） — Oracle Analytics Cloud - Classic：如何在从 105.2 或更低版本升级的客户管理的 Oracle Analytics Cloud - Classic 实例中启用远程数据网关（文档 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 实例没有合适的网络路由。例如，您可能有一个用于 Internet 访问的代理服务器，并且某个防火墙阻止了从数据网关代理到 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 <Fully qualified domain name of your Oracle Analytics Cloud instance>`）。确保没有其他任何情况阻止通过防火墙进行通信。如果您要使用代理，请导航到数据网关代理中的主页，然后检查代理设置：主机、端口、用户和密码。
性能低下	查看“日志”页并按以下内容搜索：日期失败的作业作业 ID 'REMOTE' 找到日志条目后，单击作业并检查“请求状态”对话框以查看所用时间（毫秒）。向销售客户团队寻求调整数据网关大小方面的指导。
控制台的远程数据连接页中的测试失败	如果测试失败，数据网关代理会因为各种原因无法进行验证，其中包括以下原因：数据网关代理密钥尚未复制到 Oracle Analytics Cloud 控制台中的远程数据连接页。已重新生成数据网关代理密钥，但新密钥尚未复制到 Oracle Analytics Cloud 控制台中的远程数据连接页。从数据网关代理到 Oracle Analytics Cloud 没有合适的网络路由。