QuickSight

ClickHouse Supported

QuickSight는 공식 MySQL 데이터 소스와 Direct Query 모드를 사용하여 MySQL 인터페이스를 통해 온프레미스 환경의 ClickHouse(23.11 이상)에 연결할 수 있습니다.

온프레미스 ClickHouse 서버 설정

MySQL 인터페이스가 활성화된 ClickHouse 서버를 설정하는 방법은 공식 문서를 참조하십시오.

서버의 config.xml에 항목을 추가하는 것 외에도

<clickhouse>
    <mysql_port>9004</mysql_port>
</clickhouse>

MySQL 인터페이스를 사용할 사용자에게는 Double SHA1 비밀번호 암호화를 반드시 사용해야 합니다.

셸에서 Double SHA1로 암호화된 무작위 비밀번호 생성:

PASSWORD=$(base64 < /dev/urandom | head -c16); echo "$PASSWORD"; echo -n "$PASSWORD" | sha1sum | tr -d '-' | xxd -r -p | sha1sum | tr -d '-'

출력은 다음과 같아야 합니다:

LZOQYnqQN4L/T6L0
fbc958cc745a82188a51f30de69eebfc67c40ee4

첫 번째 줄은 생성된 비밀번호이고, 두 번째 줄은 ClickHouse 설정에 사용할 수 있는 해시 값입니다.

다음은 생성된 해시를 사용하는 mysql_user에 대한 예제 구성입니다:

/etc/clickhouse-server/users.d/mysql_user.xml

<users>
    <mysql_user>
        <password_double_sha1_hex>fbc958cc745a82188a51f30de69eebfc67c40ee4</password_double_sha1_hex>
        <networks>
            <ip>::/0</ip>
        </networks>
        <profile>default</profile>
        <quota>default</quota>
    </mysql_user>
</users>

password_double_sha1_hex 항목을 직접 생성한 Double SHA1 해시 값으로 교체하십시오.

QuickSight에서는 MySQL 사용자 프로필에 몇 가지 추가 설정이 필요합니다.

/etc/clickhouse-server/users.d/mysql_user.xml

<profiles>
    <default>
        <prefer_column_name_to_alias>1</prefer_column_name_to_alias>
        <mysql_map_string_to_text_in_show_columns>1</mysql_map_string_to_text_in_show_columns>
        <mysql_map_fixed_string_to_text_in_show_columns>1</mysql_map_fixed_string_to_text_in_show_columns>
    </default>
</profiles>

그러나 기본 프로필 대신 MySQL 사용자가 사용할 수 있는 다른 프로필을 할당하는 것이 좋습니다.

마지막으로 ClickHouse Server가 원하는 IP 주소(들)에서 수신하도록 구성합니다. config.xml에서 모든 주소에서 수신하도록 다음 항목의 주석을 해제하십시오:

<listen_host>::</listen_host>

mysql 바이너리가 사용 가능한 경우, 명령줄에서 연결을 테스트할 수 있습니다. 위의 예시 사용자 이름(mysql_user)과 비밀번호(LZOQYnqQN4L/T6L0)를 사용할 때 명령줄에서 실행할 명령은 다음과 같습니다.

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.