` 포맷을 따르는지 확인하십시오.
## 온프레미스 ClickHouse 서버 설정
MySQL 인터페이스가 활성화된 ClickHouse 서버를 설정하는 방법은
[공식 문서](/ko/concepts/features/interfaces/mysql)를 참조하십시오.
서버의 `config.xml`에 항목을 추가하는 것 외에
```xml theme={null}
9004
```
또한 MySQL interface를 사용할 사용자에게는
[Double SHA1 비밀번호 암호화](/ko/concepts/features/configuration/settings/settings-users#user-namepassword)를
사용하는 것이 *필수*입니다.
셸에서 Double SHA1로 암호화된 임의의 비밀번호를 생성하는 방법:
```shell theme={null}
PASSWORD=$(base64 < /dev/urandom | head -c16); echo "$PASSWORD"; echo -n "$PASSWORD" | sha1sum | tr -d '-' | xxd -r -p | sha1sum | tr -d '-'
```
출력은 다음과 같이 표시됩니다:
```
LZOQYnqQN4L/T6L0
fbc958cc745a82188a51f30de69eebfc67c40ee4
```
첫 번째 줄은 생성된 비밀번호이고, 두 번째 줄은 ClickHouse 구성에 사용할 수 있는 hash입니다.
다음은 생성된 hash를 사용하는 `mysql_user`의 예시 구성입니다:
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
fbc958cc745a82188a51f30de69eebfc67c40ee4
::/0
default
default
```
`password_double_sha1_hex` 항목을 직접 생성한 Double SHA1 해시로 대체하십시오.
또한 `SHOW [FULL] COLUMNS` 쿼리 결과에서 ClickHouse 타입 대신 네이티브 MySQL 타입을 표시하도록 `use_mysql_types_in_show_columns`를 사용하는 것이 좋습니다.
이렇게 하면 MySQL connector를 사용할 때 BI 도구가 데이터베이스 스키마를 올바르게 파악할 수 있습니다.
예시:
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
1
```
또는 기본 프로필 대신 다른 프로필에 할당할 수 있습니다.
`mysql` 실행 파일을 사용할 수 있으면 명령줄에서 연결을 테스트할 수 있습니다.
위의 예시 사용자 이름(`mysql_user`)과 비밀번호(`LZOQYnqQN4L/T6L0`)를 사용하면 명령줄은 다음과 같습니다.
```bash theme={null}
mysql --protocol tcp -h localhost -u mysql_user -P 9004 --password=LZOQYnqQN4L/T6L0
```
```
mysql> show databases;
+--------------------+
| name |
+--------------------+
| INFORMATION_SCHEMA |
| default |
| information_schema |
| system |
+--------------------+
4 rows in set (0.00 sec)
Read 4 rows, 603.00 B in 0.00156 sec., 2564 rows/sec., 377.48 KiB/sec.
```
마지막으로, ClickHouse 서버가 원하는 IP 주소에서 연결을 수신하도록 구성합니다. 예를 들어, 모든 주소에서 수신하려면 `config.xml`에서 다음 항목의 주석을 해제하세요:
```bash theme={null}
::
```
## SSL 없이 ClickHouse에 Tableau Online 연결하기(온프레미스)
Tableau Cloud 사이트에 로그인한 후 새 Published 데이터 소스를 추가합니다.
사용 가능한 커넥터 목록에서 "MySQL"을 선택합니다.
ClickHouse 설정 과정에서 확인한 연결 정보를 입력합니다.
Tableau Online은 데이터베이스를 분석하여 사용 가능한 테이블 목록을 표시합니다. 원하는 테이블을 오른쪽 캔버스로 끌어다 놓습니다. 또한 "Update Now"를 클릭해 데이터를 미리 보고, 자동으로 인식된 필드 타입이나 이름을 세부 조정할 수도 있습니다.
그다음에는 오른쪽 상단의 "Publish As"를 클릭하기만 하면 되며, 새로 생성한 데이터셋을 Tableau Online에서 평소처럼 사용할 수 있습니다.
참고: Tableau Online을 Tableau Desktop과 함께 사용하면서 ClickHouse 데이터셋을 서로 공유하려면, 데이터 소스 드롭다운에서 MySQL을 선택했을 때 [여기](https://www.tableau.com/support/drivers)에 표시되는 설정 가이드를 따라 Tableau Desktop에서도 기본 MySQL 커넥터를 사용해야 합니다. M1 Mac을 사용 중이라면 드라이버 설치 우회 방법은 [이 문제 해결 스레드](https://community.tableau.com/s/question/0D58b0000Ar6OhvCQE/unable-to-install-mysql-driver-for-m1-mac)에서 확인하십시오.
## Tableau Online을 ClickHouse에 연결하기(SSL을 사용하는 Cloud 또는 온프레미스 설정)
Tableau Online의 MySQL 연결 설정 마법사에서는 SSL 인증서를 제공할 수 없으므로,
Tableau Desktop에서 연결을 설정한 다음 Tableau Online으로 내보내는 방법만 사용할 수 있습니다. 다만 이 과정은 매우 간단합니다.
Windows 또는 Mac 컴퓨터에서 Tableau Desktop을 실행한 다음 "Connect" -> "To a Server" -> "MySQL"을 선택하십시오.
대부분 먼저 컴퓨터에 MySQL 드라이버를 설치해야 합니다.
데이터 소스 드롭다운에서 MySQL을 선택하면 [여기](https://www.tableau.com/support/drivers)에 표시되는 설정 가이드를 따라 설치할 수 있습니다.
M1 Mac을 사용하는 경우 드라이버 설치 우회 방법은 [이 문제 해결 스레드](https://community.tableau.com/s/question/0D58b0000Ar6OhvCQE/unable-to-install-mysql-driver-for-m1-mac)를 확인하십시오.
MySQL 연결 설정 UI에서 "SSL" 옵션이 활성화되어 있는지 확인하십시오.
ClickHouse Cloud의 SSL 인증서는 [Let's Encrypt](https://letsencrypt.org/certificates/)에서 서명한 인증서입니다.
이 루트 인증서는 [여기](https://letsencrypt.org/certs/isrgrootx1.pem)에서 다운로드할 수 있습니다.
ClickHouse Cloud 인스턴스의 MySQL 사용자 자격 증명과 다운로드한 루트 인증서의 경로를 입력하십시오.
평소처럼 원하는 테이블을 선택하고(Tableau Online과 비슷함),
"Server" -> "Publish 데이터 소스" -> Tableau Cloud를 선택하십시오.
중요: "Authentication" 옵션에서 "Embedded password"를 선택해야 합니다.
추가로 "Update workbook to use the published data source"를 선택하십시오.
마지막으로 "Publish"를 클릭하면, 자격 증명이 포함된 데이터 소스가 Tableau Online에서 자동으로 열립니다.
## 알려진 제한 사항 (ClickHouse 23.11)
알려진 모든 제한 사항은 ClickHouse `23.11`에서 해결되었습니다. 그 밖에 다른 호환성 문제가 있으면 [문의해 주십시오](https://clickhouse.com/company/contact) 또는 [새 이슈](https://github.com/ClickHouse/ClickHouse/issues)를 생성해 주십시오.