Tableau Oracle 驱动下载与安装指南

喜乐君 1 min read

Tableau 连接 Oracle 数据库的 JDBC 与 OCI 驱动完整安装指南，覆盖 Windows、Mac、Linux 三大平台，含 Desktop / Server / Prep 各版本对应关系与下载地址。

📌 Oracle Instant Client：Tableau 连接 Oracle 数据库的必需驱动，从 Oracle 官网下载对应操作系统版本

📌 环境配置：设置环境变量与 tnsnames.ora 文件，确保 Oracle 客户端正确识别数据库服务

📌 JDBC 连接：配置完成后，即可在 Tableau 中使用 JDBC 连接字符串接入 Oracle 数据源

一、驱动类型速览

Tableau 连接 Oracle 数据库支持两种驱动方式：JDBC 驱动（通用，跨平台）和 OCI 驱动（仅 Windows，性能更优）。

| 驱动  | 适用平台          | 文件          | 说明                       |
| JDBC | Windows/Mac/Linux | ojdbc11/ojdbc8 | 通用，复制 jar 到指定目录    |
| OCI  | 仅 Windows        | .msi 安装包    | 版本绑定，性能更优，需管理员 |

二、Windows 环境

2.1 Tableau Desktop（2023.2 – 2026.2）

方式 A：JDBC 驱动

1. 从 Oracle 官网下载 ojdbc11.jar：

https://www.oracle.com/database/technologies/appdev/jdbc-ucp-19c-downloads.html

2. 复制到（如目录不存在则手动创建）：

C:\Program Files\Tableau\Drivers

方式 B：OCI 驱动（版本绑定）

1. 根据 Tableau Desktop 版本下载对应 .msi 安装包：

  • 2026.2：https://downloads.tableau.com/drivers/oracle/desktop/tableau2026.2-oracle-driver-x64.msi
  • 2026.1：https://downloads.tableau.com/drivers/oracle/desktop/tableau2026.1-oracle-driver-x64.msi
  • 2025.3：https://downloads.tableau.com/drivers/oracle/desktop/tableau2025.3-oracle-driver-x64.msi
  • 2025.2：https://downloads.tableau.com/drivers/oracle/desktop/tableau2025.2-oracle-driver-x64.msi
  • 2025.1：https://downloads.tableau.com/drivers/oracle/desktop/tableau2025.1-oracle-driver-x64.msi
  • 2024.3：https://downloads.tableau.com/drivers/oracle/desktop/tableau2024.3-oracle-driver-x64.msi
  • 2024.2：https://downloads.tableau.com/drivers/oracle/desktop/tableau2024.2-oracle-driver-x64.msi
  • 2024.1：https://downloads.tableau.com/drivers/oracle/desktop/tableau2024.1-oracle-driver-x64.msi
  • 2023.3：https://downloads.tableau.com/drivers/oracle/desktop/tableau2023.3-oracle-driver-x64.msi
  • 2023.2：https://downloads.tableau.com/drivers/oracle/desktop/tableau2023.2-oracle-driver-x64.msi

2. 双击安装，重启 Tableau Desktop。

2.2 Tableau Server（2024.2 – 2026.2）

方式 A：JDBC 驱动

1. 下载 ojdbc11.jar（同上地址）

2. 复制到 C:\Program Files\Tableau\Drivers

方式 B：OCI 驱动（版本绑定）

  • 2026.2：https://downloads.tableau.com/drivers/oracle/desktop/tableau2026.2-oracle-driver-x64.msi
  • 2025.3：https://downloads.tableau.com/drivers/oracle/desktop/tableau2025.3-oracle-driver-x64.msi
  • 2025.1：https://downloads.tableau.com/drivers/oracle/desktop/tableau2025.1-oracle-driver-x64.msi
  • 2024.2：https://downloads.tableau.com/drivers/oracle/desktop/tableau2024.2-oracle-driver-x64.msi

安装步骤：

  1. 1. 卸载旧版 OCI 驱动：在「添加或删除程序」中搜索 "oracle"，卸载已有的 Tableau Oracle Driver
  2. 2. 以管理员身份打开命令行，执行：
msiexec /i <安装包路径>\tableau<版本号>-oracle-driver-x64.msi INSTALLDIR="C:\Program Files\Tableau\Drivers\oracle"

示例：

msiexec /i tableau2025.1-oracle-driver-x64.msi INSTALLDIR="C:\Program Files\Tableau\Drivers\oracle"
  1. 3. 验证 DLL 是否就位：
dir "C:\Program Files\Tableau\Drivers\oracle\bin\oci.dll"
  1. 4. 重启 Tableau Server。

三、Mac 环境（Intel / Apple Silicon）

3.1 Tableau Desktop（2024.2 – 2026.2）

1. 下载 ojdbc11.jar（同上地址）

2. 复制到（如目录不存在则手动创建）：

~/Library/Tableau/Drivers

3.2 Tableau Prep（2024.2 – 2026.2）

1. 下载 ojdbc8.jar（注意是 8，非 11）

2. 复制到：

~/Library/Tableau/Drivers

四、Linux 环境

Tableau Server（2023.3 – 2026.2）

1. 下载 ojdbc8.jar（同上地址）

2. 复制到（如目录不存在则手动创建）：

/opt/tableau/tableau_driver/jdbc

⚠️ 若 ojdbc8.jar 遇到问题，可尝试同一页面下载 ojdbc11.jar 替代。

五、快速对照表

| 产品      | 平台     | JDBC 版本  | 驱动目录                                  | OCI 支持 |
| Desktop   | Windows  | ojdbc11    | C:\\Program Files\\Tableau\\Drivers       | ✅       |
| Server    | Windows  | ojdbc11    | C:\\Program Files\\Tableau\\Drivers       | ✅       |
| Desktop   | Mac      | ojdbc11    | ~/Library/Tableau/Drivers                | ❌       |
| Prep      | Mac      | ojdbc8     | ~/Library/Tableau/Drivers                | ❌       |
| Server    | Linux    | ojdbc8/11  | /opt/tableau/tableau_driver/jdbc          | ❌       |

六、参考来源

  • Tableau 官方驱动下载页面：https://www.tableau.com/support/drivers
  • Oracle JDBC 驱动下载：https://www.oracle.com/database/technologies/appdev/jdbc-ucp-19c-downloads.html
  • Tableau 连接 Oracle 官方文档：https://help.tableau.com/current/pro/desktop/zh-cn/examples_oracle.htm

No comments yet

Continue reading