> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.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 = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
QuickSight は、公式の MySQL データソースと Direct Query モードを使用して、MySQL インターフェイス経由でオンプレミスの ClickHouse 環境 (23.11+) に接続できます。
## オンプレミスでの ClickHouse サーバー のセットアップ
MySQL インターフェイスを有効にした ClickHouse サーバー の設定方法については、[公式ドキュメント](/ja/concepts/features/interfaces/mysql)を参照してください。
ClickHouse サーバー の `config.xml` にエントリを追加するだけでなく
```xml theme={null}
9004
```
また、MySQL インターフェイスを使用するユーザーでは、[ダブル SHA1 によるパスワード暗号化](/ja/concepts/features/configuration/settings/settings-users#user-namepassword)の使用が*必須*です。
シェルからダブル 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
```
1行目は生成されたパスワードで、2行目はClickHouseの設定に使用するハッシュです。
以下は、生成されたハッシュを使う `mysql_user` の設定例です。
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
fbc958cc745a82188a51f30de69eebfc67c40ee4
::/0
default
default
```
`password_double_sha1_hex` エントリを、ご自身で生成したダブル 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 からデータを取得する方法は 2 つあります。1 つ目は、一覧からテーブルを選択する方法です。
また、データを取得するためのカスタム SQL を指定することもできます。
「Edit/Preview data」をクリックすると、解析されたテーブル構造を確認したり、必要に応じてカスタム SQL を調整したりできます。
UI の左下隅で「Direct Query」モードが選択されていることを確認してください。
これで、データセットを公開し、新しい可視化を作成できます。
## 既知の制限
* SPICE インポートは想定どおりに動作しないため、代わりに Direct Query モードを使用してください。詳細は [#58553](https://github.com/ClickHouse/ClickHouse/issues/58553) を参照してください。