Oracle 连接错误故障排除

通常，纠正“高级 Oracle 连接”对话框中的路由或命名语法，或者使用 .WORLD 数据库全名，即可解决大部分 Oracle 连接问题。如果连接错误需要进一步进行故障排除，请参阅下面列出的 5 种常见连接错误。

• ORA-03113：通信信道上的文件结尾
• ORA-12154：TNS：无法解析指定的连接标识符：HOST 值不正确或全局名称不正确或未知
• ORA-12514：目前，TNS 侦听器无法识别连接描述符请求的服务：SERVICE 值不正确
• ORA-12541：TNS：无侦听器：PORT 值不正确
• ORA-00932：数据类型不一致

ORA-03113：通信信道上的文件结尾

ORA-03113 是任何干扰 Oracle 会话的问题的全捕获类型错误。造成该错误的原因可能有很多。请参阅下表，了解故障排除指南。

• 请参阅特定于此错误的 Oracle 文档：我的 Oracle 支持。
  • 请参阅 Oracle 的 B 常见错误故障排除页面。
• Oracle 建议您检查网络问题并审查 SQL*Net 设置。
• 如果连接到 Oracle 9.2.0.5，在多数情况下，此错误的主要原因是 Oracle 漏洞 3010227。请 Oracle 数据库管理员应用 Oracle 补丁 9.2.0.6 或其他适用于服务器的补丁。
• 将 Oracle 初始化参数“STAR_TRANSFORMATION_ENABLED”设置为 FALSE。
• 测试更改数据提取刷新的计划时间
• 或者，如果您想进一步测试此问题，请遵循下面列出的可选过程。

步骤 1 

从 Tableau Desktop 开始页面，选择“连接到数据”。

步骤 2 

在“连接”页面上，单击“Oracle”，然后单击“确定”。

有关完成连接步骤的更多信息，请参阅 Desktop 帮助中的 Oracle 数据库主题。

步骤 3 

1. 在联接区域，悬停在自定义 SQL 表上，直到显示编辑图标，然后单击该图标。
2. 复制“编辑自定义 SQL”对话框中的查询。

步骤 4 

在连接到此数据库的 SQL 会话中，粘贴并运行查询。预期响应为错误 ORA-7445：遭遇异常：核心转储，确认问题为预期的 ORA-3113。

ORA-12154：TNS：无法解析指定的连接标识符

透明网络底层 (TNS) 无法解析服务名称时，出现 ORA-12154。服务名称在 TNSNames.ora 文件中指定，该文件位于 %ORACLE_HOME%\network\admin\ 文件夹下。通常，TNSNames.ora 文件中的信息不正确时会出现此错误。例如：

• 数据库名称不包含 .world 扩展名。
• SERVICE_NAME 或 HOST 变量不正确。

要解决此问题，请按照下面列出的顺序，尝试以下 3 种故障排除选项中的其中一种。

• 选项 1：设置 Oracle 连接使用 TNSNames.ora 或 LDAP.ora
• 选项 2：在未使用 TNSNames.ora 的情况下连接到 Oracle 时出现“ORA-12154”错误

选项 1：编辑 TNSNames.ora

 提供数据库全名，包括位于以下两个位置的 .world 扩展名：

• TNSNames.ora 文件。

  以及

• “连接”页面的“服务器”文本框。

选项 2：确保 Tableau Server 运行身份用户帐户具有访问 TNSNames.ora 的权限（仅限 Tableau Server）

如果安装了 Tableau Server，请完成以下过程以确保 Tableau Server 运行身份用户帐户具有访问 TNSNames.ora 文件位置的权限。如果运行身份用户帐户不具有权限，则 Tableau Server 无法访问 Oracle 数据源详细信息。

步骤 1 

验证计算机上 TNSNames.ora 文件或者等效的 SQLNET.ora 或 LDAP.ora 文件的位置。

注意：默认情况下，TNSNames.ora 文件位于 <oracle 目录>\network\admin 目录下。例如，C:\Oracle_Client\network\admin。

步骤 2 

确认 TNS_ADMIN 变量指向步骤 1 中描述的一个或多个文件的位置。

注意：要检查 TNS_ADMIN 变量，请单击“开始”按钮，然后选择控制面板 > 系统。单击“高级系统设置”，单击“高级”标签，然后单击“环境变量”按钮。
系统变量文件路径必须采用 UNC 格式。

步骤 3 

使用浏览器打开 TSM：https://<tsm-computer-name>：8850；有关更多信息，请查看登录 Tableau 服务管理器 Web UI。

步骤 4 

单击安全性选项卡，然后单击以服务帐户身份运行选项卡。
在服务器运行身份用户下方，复制用户名字段中的信息。

步骤 5 

转到 TNSNames.ora 文件所在的文件夹。

步骤 6 

右键单击文件夹并选择“属性”。单击“安全”标签，然后单击“编辑”按钮。

步骤 7 

在组或用户名称下，单击“添加”按钮。

步骤 8 

在“输入要选择的对象名称”文本框中，粘贴在步骤 6 中复制的运行身份用户帐户的详细信息。

步骤 9 

完成后，单击“确定”。

步骤 10 

在“权限”区域，确保选中“完全控制”和“修改”复选框。

步骤 11 

单击“确定”以关闭对话框。

选项 3：验证 TNSNames.ora 中的所有信息是否正确无误

 如果以上故障排除步骤未解决问题，请继续阅读并完成过程，以验证 TNSNames.ora 文件中的其他信息是否正确提供。

TNSNames.ora 文件如下所示：

QAORCL10.world =

(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = MY_HOST_NAME)(PORT = 1521))

)

(CONNECT_DATA =

(SERVICE_NAME = MY_SERVICE_NAME)

)

)

在文件中，感兴趣的 3 个变量是 HOST、PORT 和 SERVICE_NAME。从 TNSNames.ora 文件复制这些变量，并将其保持可用。这些变量区分大小写。以下步骤描述如何为您的连接提供这些变量。

步骤 1 

从 Tableau Desktop 开始页面，选择“连接到数据”。

步骤 2 

在“连接”页面上，单击“Oracle”。

步骤 3 

提供 TNSNames.ora 文件中的以下信息：

• 在服务器名称文本框中，键入 HOST 名称。
• 在服务文本框中，键入 SERVICE_NAME。
• 在端口文本框中，键入 PORT 编号。
• 指定是使用 Windows 身份验证还是特定的用户名和密码，然后单击“连接”。

注意：变量区分大小写。

步骤 4 

从“架构”下拉列表中选择一个架构，将一个表格拖到联接区域，然后单击“转到工作表”。

步骤 5 

完成设置 Oracle 连接以使用 TNSNames.ora 或 LDAP.ora 一文中的步骤。

重要信息：

• 确保以 ASCII 编码保存您使用的 TNSNames.ora 文件。使用除 ASCII 之外的任何其他编码（例如 UTF-8 或 Unicode）会导致 ORA-12154 错误消息。
• 即使已在计算机上安装 Oracle 软件，通常也需要进行这些步骤。

步骤 6

ORA-12514：TNS 侦听器当前无法识别连接描述符中请求的服务

通常，SERVICE 值不正确时出现此错误。

要解决此问题，需找出正确的 SERVICE 值，打开位于 %ORACLE_HOME%\network\admin\ 文件夹下的 TNSNames.ora 文件。必要时，参阅 ORA_12154 下的步骤。

ORA-12541：TNS：无侦听器

通常，PORT 值不正确时出现此错误。

要解决此问题，使用 1521 或 1526 替换 PORT 值。请尝试目前未使用的值。

ORA-00932：数据类型不一致

连接到 Oracle 时或从 Oracle 数据源创建数据提取时，出现此错误。通常，此错误由安装了不正确的 Oracle 驱动程序而引起。

要解决此问题，请从驱动程序页面安装适用于您当前使用的 Tableau 版本的正确 Oracle 驱动程序。

除了上述常见错误之外，如果您使用 Tableau Desktop/Server 2020.2 或更高版本并出现性能问题，例如解压缩刷新时间过长，您可以尝试下载并安装 Oracle OCI 驱动程序。 请参阅相关链接中的文章。您可在此处下载驱动程序。