QuickSight
QuickSightは、公式のMySQLデータソースとDirect Queryモードを使用して、オンプレミスのClickHouseセットアップ(23.11以上)に接続できます。
オンプレミスのClickHouseサーバーセットアップ
ClickHouseサーバーをMySQLインターフェースでセットアップする方法については、公式ドキュメントを参照してください。
サーバーのconfig.xml
にエントリーを追加することに加え、
MySQLインターフェースを使用するユーザーに対してダブルSHA1パスワード暗号化を使用することが必須です。
シェルからダブルSHA1で暗号化されたランダムパスワードを生成するには:
出力は以下のようになります:
最初の行は生成されたパスワードで、2行目はClickHouseを構成するために使用できるハッシュです。
生成されたハッシュを使用したmysql_user
の設定例:
/etc/clickhouse-server/users.d/mysql_user.xml
password_double_sha1_hex
エントリーを自分の生成したダブルSHA1ハッシュに置き換えます。
QuickSightには、MySQLユーザーのプロファイルにいくつかの追加設定が必要です。
/etc/clickhouse-server/users.d/mysql_user.xml
ただし、デフォルトのプロファイルではなく、MySQLユーザーが使用できる別のプロファイルに割り当てることをお勧めします。
最後に、Clickhouseサーバーが希望するIPアドレスでリスニングするように構成します。 config.xml
で、すべてのアドレスをリスニングするために以下のコメントを外します:
mysql
バイナリが利用可能な場合は、コマンドラインから接続をテストできます。
上記のサンプルユーザー名(mysql_user
)とパスワード(LZOQYnqQN4L/T6L0
)を使用すると、コマンドラインは以下のようになります:
QuickSightをClickHouseに接続する
まず最初に、https://quicksight.aws.amazon.com に移動し、「データセット」に移動して「新しいデータセット」をクリックします:

QuickSightにバンドルされている公式のMySQLコネクタ(単にMySQLと呼ばれる)を検索します:

接続の詳細を指定します。デフォルトでMySQLインターフェースポートは9004ですので、サーバーの設定によって異なる場合があります。

次に、ClickHouseからデータを取得する方法が2つあります。まず、リストからテーブルを選択できます:

または、カスタムSQLを指定してデータを取得することもできます:

「データを編集/プレビュー」をクリックすると、内包されたテーブル構造を見ることができるか、カスタムSQLを調整できます。データにアクセスする方法を決めた場合です:

UIの左下隅にある「Direct Query」モードが選択されていることを確認してください:

これで、データセットを公開し、新しい視覚化を作成する準備が整いました!
既知の制限事項
- SPICEインポートは期待通りに動作しません。代わりにDirect Queryモードを使用してください。#58553を参照してください。