本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從 Tableau 桌面連線至 Amazon DocumentDB
<a name="connect-jdbc-tableau"></a>

**Topics**
+ [新增 Amazon DocumentDB JDBC 驅動程式](#connect-jdbc-tableau-adddriver)
+ [使用 Tableau - SSH 通道連線至 Amazon DocumentDB](#connect-jdbc-tableau-ssh)

## 新增 Amazon DocumentDB JDBC 驅動程式
<a name="connect-jdbc-tableau-adddriver"></a>

若要從 Tableau 桌面連線至 Amazon DocumentDB，您必須下載並安裝 Amazon DocumentDB JDBC 驅動程式和 DocumentDB Tableau 連接器。

1. 從 Amazon DocumentDB JDBC 驅動程式[儲存庫下載 Amazon DocumentDB JDBC 驅動程式](https://github.com/aws/amazon-documentdb-jdbc-driver/releases) JAR 檔案，並根據作業系統將其複製到下列其中一個目錄：
   + *Windows* - `C:\Program Files\Tableau\Drivers`
   + *MacOS* - `~/Library/Tableau/Drivers`

1. 從 [Tableau Exchange 網站](https://exchange.tableau.com/products/821)下載 DocumentDB Tableau 連接器 (TACO 檔案），並將其複製到 *My Tableau 儲存庫/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 - SSH 通道連線至 Amazon DocumentDB
<a name="connect-jdbc-tableau-ssh"></a>

若要從 DocumentDB 叢集 VPC 外部的用戶端機器連線至 Tableau，您必須先設定 SSH 通道，才能執行下列步驟：

1. 啟動 Tableau 桌面應用程式。

1. 導覽至**連線** > **至伺服器** > **更多**。

1.  在**已安裝的連接器**下，選擇 **Amazon Web Services 的 Amazon DocumentDB**。  
![Tableau Desktop 上的 Connect 界面會在連線到伺服器區段下顯示更多...子功能表。Amazon DocumentDB 選項會在 Installed Connectors 子功能表中反白顯示。](http://docs.aws.amazon.com/zh_tw/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_tw/documentdb/latest/developerguide/images/jdbc/tableau-connect.png)

1. （選用） 更多進階選項可在**進階**索引標籤中找到。  
![Amazon DocumentDB 連接器介面中的進階索引標籤，顯示其他連線選項。](http://docs.aws.amazon.com/zh_tw/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_tw/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_tw/documentdb/latest/developerguide/images/jdbc/tableau-advanced-sshhostkeycheck.png)

1. 輸入必要的參數：**主機名稱**、**連接埠**、**資料庫**、**使用者名稱和密碼******。
**注意**  
使用內部 SSH 通道選項時，請務必使用 DocumentDB 叢集端點，而非 localhost。  
![Amazon DocumentDB 連接器界面中的一般索引標籤，顯示主機名稱、連接埠、資料庫、使用者名稱和密碼欄位。](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/jdbc/tableau-hostname.png)

1. 選擇 **Sign In (登入)**。