本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 从 Tableau Desktop 连接到 Amazon DocumentDB
<a name="connect-jdbc-tableau"></a>

**Topics**
+ [添加 Amazon DocumentDB JDBC 驱动程序](#connect-jdbc-tableau-adddriver)
+ [使用 Tableau 连接到 Amazon DocumentDB：SSH 隧道](#connect-jdbc-tableau-ssh)

## 添加 Amazon DocumentDB JDBC 驱动程序
<a name="connect-jdbc-tableau-adddriver"></a>

要从 Tableau Desktop 连接到 Amazon DocumentDB，您必须下载并安装 Amazon DocumentDB JDBC 驱动程序和 DocumentDB Tableau 连接器。

1. 从 [Amazon DocumentDB JDBC 驱动程序存储库](https://github.com/aws/amazon-documentdb-jdbc-driver/releases)下载 Amazon DocumentDB JDBC 驱动程序 JAR 文件，然后根据您的操作系统将其复制到以下目录之一：
   + *Windows*：`C:\Program Files\Tableau\Drivers`
   + *MacOS*：`~/Library/Tableau/Drivers`

1. 从 Tableau E [xchange 网站下载 DocumentDB Tableau](https://exchange.tableau.com/products/821) 连接器（TACO 文件），然后将其复制到你的 “*我*的 Tableau” 目录中。 Repository/Connectors 
   + *Windows*：`C:\Users\[user]\Documents\My Tableau Repository\Connectors`
   + *MacOS*：`/Users/[user]/Documents/My Tableau Repository/Connectors`

有关更多信息，请参阅 [Tableau 文档](https://tableau.github.io/connector-plugin-sdk/docs/run-taco)。

**注意**  
[如果您使用的是较新的 CA 证书，请务必将 JDBC 驱动程序升级到 v1.4.5（在此 AWS GitHub 存储库中可用。）。](https://github.com/aws/amazon-documentdb-jdbc-driver/releases/tag/v1.4.5)

## 使用 Tableau 连接到 Amazon DocumentDB：SSH 隧道
<a name="connect-jdbc-tableau-ssh"></a>

若要从 DocumentDB 集群的 VPC 外部的客户端计算机连接到 Tableau，您必须先设置一个 SSH 隧道，然后再执行以下步骤：

1. 启动 Tableau Desktop 应用程序。

1. 导航至**连接** > **至服务器** > **更多**。

1.  在**已安装的连接器**下选择 **Amazon DocumentDB by Amazon Web Services**。  
![Tableau Desktop 上的“连接”界面在“到服务器”部分下显示“更多...”子菜单。Amazon DocumentDB 选项在“已安装的连接器”子菜单中突出显示。](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/jdbc/tableau-choose-docdb.png)

**使用 Tableau 连接到 Amazon DocumentDB：外部 SSH 隧道**

1. 输入所需的连接参数**主机名**、**端口**、**数据库**、**用户名**和**密码**。以下示例中的连接参数相当于 JDBC 连接字符串：

   `jdbc:documentdb://localhost:27019/test? tls=true&tlsAllowInvalidHostnames=true&scanMethod=random&scanLimit=1000&loginTimeoutSec=0&readPreference=primary&retryReads=true&schemaName=_default` 在属性集合中分别传递用户名和密码参数。有关连接字符串参数的更多信息，请参阅[Amazon DocumentDB JDBC 驱动程序 github 文档](https://github.com/aws/amazon-documentdb-jdbc-driver/blob/develop/src/markdown/setup/connection-string.md)。  
![Amazon DocumentDB 连接器界面中的“常规”选项卡，其中显示了主机名、端口、数据库、用户名和密码等字段。](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/jdbc/tableau-connect.png)

1. （可选）更多高级选项可在**高级**选项卡上找到。  
![Amazon DocumentDB 连接器界面中的“高级”选项卡，其中显示了其他连接选项。](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/jdbc/tableau-advanced.png)

1. 选择**登录**。

**使用 Tableau 连接到 Amazon DocumentDB：内部 SSH 隧道**
**注意**  
如果您不希望使用终端设置 SSH 隧道，则可以使用 Tableau GUI 来指定 EC2 实例详细信息，JDBC 驱动程序将使用这些详细信息自动创建一个 SSH 隧道。

1. 在**高级**选项卡上，选择**启用 SSH 隧道**选项以查看更多属性。  
![Amazon DocumentDB 连接器界面中的“高级”选项卡，其中选择了“启用 SSH 隧道”，并显示了其他 SSH 输入字段。](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/jdbc/tableau-advanced-Enablessh.png)

1. 输入 **SSH 用户**、**SSH 主机名**和 **SSH 私钥文件**。

1. （可选）您可以禁用 **SSH 严格主机密钥检查**选项，该选项会绕过针对已知主机文件的主机密钥检查。
**注意**  
禁用此选项不太安全，因为它可能导致[man-in-the-middle](https://en.wikipedia.org/wiki/Man-in-the-middle_attack)攻击。  
![Amazon DocumentDB 连接器界面中的“高级”选项卡，其中禁用了“SSH 严格主机密钥检查”选项。](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/jdbc/tableau-advanced-sshhostkeycheck.png)

1. 输入所需的参数；**主机名**、**端口**、**数据库**、**用户名**和**密码**。
**注意**  
使用内部 SSH 隧道选项时，请确保使用 DocumentDB 集群端点而不是本地主机。  
![Amazon DocumentDB 连接器界面中的“常规”选项卡，其中显示了主机名、端口、数据库、用户名和密码等字段。](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/jdbc/tableau-hostname.png)

1. 选择**登录**。