> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Amazon QuickSight는 데이터 기반 조직을 위한 통합 비즈니스 인텔리전스(BI)를 제공합니다.
# QuickSight
export const ClickHouseSupportedBadge = () => {
return ;
};
export const Image = ({img, alt, size}) => {
return
;
};
QuickSight는 공식 MySQL 데이터 소스와 Direct Query 모드를 사용해 MySQL 인터페이스를 통해 온프레미스 ClickHouse 환경(23.11+)에 연결할 수 있습니다.
## 온프레미스 ClickHouse 서버 설정
MySQL 인터페이스를 활성화한 ClickHouse 서버를 설정하는 방법은 [공식 문서](/ko/concepts/features/interfaces/mysql)를 참조하십시오.
서버의 `config.xml`에 항목을 추가하는 것 외에도
```xml theme={null}
9004
```
MySQL 인터페이스를 사용할 사용자에게는 [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 '-'
```
출력은 다음과 같아야 합니다:
```text theme={null}
LZOQYnqQN4L/T6L0
fbc958cc745a82188a51f30de69eebfc67c40ee4
```
첫 번째 줄은 생성된 비밀번호이고, 두 번째 줄은 ClickHouse 구성에 사용할 수 있는 해시입니다.
다음은 생성된 해시를 사용하는 `mysql_user`의 예시 구성입니다:
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
fbc958cc745a82188a51f30de69eebfc67c40ee4
::/0
default
default
```
`password_double_sha1_hex` 항목을 생성한 Double SHA1 해시 값으로 대체하십시오.
QuickSight를 사용하려면 MySQL 사용자 프로필에 몇 가지 추가 설정이 필요합니다.
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
1
1
1
```
하지만 기본 프로필 대신 MySQL 사용자가 사용할 수 있는 별도의 프로필에 할당하는 것이 좋습니다.
마지막으로, ClickHouse 서버가 원하는 IP 주소에서 수신하도록 구성합니다.
`config.xml`에서 모든 주소에서 수신하려면 다음 항목의 주석을 해제합니다:
```bash theme={null}
::
```
`mysql` 바이너리를 사용할 수 있으면 명령줄에서 연결을 테스트할 수 있습니다.
위의 예시 사용자 이름(`mysql_user`)과 비밀번호(`LZOQYnqQN4L/T6L0`)를 사용하면 명령줄 명령은 다음과 같습니다.
```bash theme={null}
mysql --protocol tcp -h localhost -u mysql_user -P 9004 --password=LZOQYnqQN4L/T6L0
```
```response theme={null}
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.
```
## QuickSight를 ClickHouse에 연결하기
먼저 [https://quicksight.aws.amazon.com](https://quicksight.aws.amazon.com)으로 이동한 다음, Datasets로 이동하여 "New dataset"을 클릭합니다:
QuickSight에 포함된 공식 MySQL 커넥터(이름은 **MySQL**)를 검색합니다:
연결 정보를 입력합니다. MySQL 인터페이스 포트의 기본값은 9004이며,
서버 구성에 따라 달라질 수 있습니다.
이제 ClickHouse에서 데이터를 가져오는 방법은 두 가지입니다. 먼저 목록에서 테이블을 선택할 수 있습니다:
또는 데이터를 가져오기 위해 사용자 지정 SQL을 지정할 수 있습니다:
"Edit/Preview data"를 클릭하면 감지된 테이블 구조를 확인하거나, 해당 방식으로 데이터에 액세스하기로 했다면 사용자 지정 SQL을 조정할 수 있습니다:
UI의 왼쪽 아래에서 "Direct Query" 모드가 선택되어 있는지 확인합니다:
이제 데이터셋을 게시하고 새 시각화를 만들 수 있습니다!
## 알려진 제한 사항
* SPICE 가져오기가 예상대로 작동하지 않으므로 대신 Direct Query 모드를 사용하십시오. 자세한 내용은 [#58553](https://github.com/ClickHouse/ClickHouse/issues/58553)을 참조하십시오.