

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 타블로 데스크톱에서 Amazon DocumentDB에 연결
<a name="connect-jdbc-tableau"></a>

**Topics**
+ [Amazon DocumentDB JDBC 드라이버 추가](#connect-jdbc-tableau-adddriver)
+ [타블로를 사용하여 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 Exchange 웹 사이트](https://exchange.tableau.com/products/821)에서 DocumentDB Tableau 커넥터(TACO 파일)를 다운로드하여 *내 Tableau 리포지토리/커넥터 디렉터리*에 복사합니다.
   + *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)에서 사용 가능)로 업그레이드해야 합니다.

## 타블로를 사용하여 Amazon DocumentDB에 연결하기 - SSH 터널
<a name="connect-jdbc-tableau-ssh"></a>

DocumentDB 클러스터의 VPC 외부에 있는 클라이언트 컴퓨터에서 Tableau에 연결하려면 아래 단계를 수행하기 전에 SSH 터널을 설정해야 합니다.

1. Tableau Desktop 애플리케이션을 실행합니다.

1. **연결** **> **서버로 > 기타로** 이동합니다.**

1.  **설치된 **커넥터에서 Amazon Web Services의 Amazon DocumentDB를** 선택합니다.**  
![서버로 섹션 아래 추가... 하위 메뉴를 보여주는 Tableau 데스크톱의 연결 인터페이스입니다. 설치된 커넥터 하위 메뉴에 Amazon DocumentDB 옵션이 강조 표시됩니다.](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/jdbc/tableau-choose-docdb.png)

**타블로를 사용하여 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](https://github.com/aws/amazon-documentdb-jdbc-driver/blob/develop/src/markdown/setup/connection-string.md) 드라이버 github 설명서를 참조하세요.  
![호스트 이름, 포트, 데이터베이스, 사용자 이름 및 암호 필드를 보여주는 Amazon DocumentDB 커넥터 인터페이스의 일반 탭입니다.](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/jdbc/tableau-connect.png)

1. **(선택 사항) 고급 탭에서 고급 옵션을 찾을 수 있습니다.**  
![추가 연결 옵션을 보여주는 Amazon DocumentDB 커넥터 인터페이스의 고급 탭입니다.](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/jdbc/tableau-advanced.png)

1. **로그인**을 선택합니다.

**타블로를 사용하여 Amazon DocumentDB에 연결 - 내부 SSH 터널**
**참고**  
터미널을 사용하여 SSH 터널을 설정하지 않으려는 경우 Tableau GUI를 사용하여 JDBC 드라이버가 SSH 터널을 생성하는 데 기본적으로 사용할 EC2 인스턴스 세부 정보를 지정할 수 있습니다.

1. **고급 탭에서 SSH 터널 활성화** **옵션을 선택하여 추가 속성을 검토하세요.**  
![SSH 터널 활성화가 선택되고 추가 SSH 입력 필드를 보여주는 Amazon DocumentDB 커넥터 인터페이스의 고급 탭입니다.](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/jdbc/tableau-advanced-Enablessh.png)

1. **SSH 사용자, SSH** **호스트 이름 및 **SSH**** 개인 키 파일을 입력합니다.

1. (선택 사항) 알려진 호스트 파일에 대한 호스트 키 검사를 우회하는 **SSH 엄격한 호스트 키 검사** 옵션을 비활성화할 수 있습니다.
**참고**  
[이 옵션을 비활성화하면 중간자 공격으로 이어질 수 있으므로 보안이 취약합니다.](https://en.wikipedia.org/wiki/Man-in-the-middle_attack)  
![SSH 엄격한 호스트 키 확인 옵션이 비활성화된 Amazon DocumentDB 커넥터 인터페이스의 고급 탭입니다.](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/jdbc/tableau-advanced-sshhostkeycheck.png)

1. ****필수 파라미터 (**호스트 이름, 포트, **데이터베이스**, 사용자 이름** **및 암호**) 를 입력합니다.****
**참고**  
내부 SSH 터널 옵션을 사용할 때는 로컬 호스트가 아닌 DocumentDB 클러스터 엔드포인트를 사용해야 합니다.  
![호스트 이름, 포트, 데이터베이스, 사용자 이름 및 암호 필드를 보여주는 Amazon DocumentDB 커넥터 인터페이스의 일반 탭입니다.](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/jdbc/tableau-hostname.png)

1. **Sign In(로그인)**을 선택합니다.