メインコンテンツまでスキップ
メインコンテンツまでスキップ

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コネクタの検索

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

接続の詳細を指定

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

リストからテーブルを選択

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

データを取得するためのカスタムSQLの使用

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

内包されたテーブル構造を表示

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

Direct Queryモードを選択

これで、データセットを公開し、新しい視覚化を作成する準備が整いました!

既知の制限事項

  • SPICEインポートは期待通りに動作しません。代わりにDirect Queryモードを使用してください。#58553を参照してください。