Looker Studio は、Google 公式の MySQL データソースを使用して、MySQL インターフェイス経由で ClickHouse に接続できます。
Connect your app を選択
ClickHouse Cloud サービスを作成したら、Connect your app 画面でドロップダウンから MySQL を選択します。MySQL インターフェイスを有効にする
このサービス専用の MySQL インターフェイスを有効にするには、スイッチをオンにします。
これにより、このサービスでポート 3306 が公開され、固有の MySQL ユーザー名を含む MySQL 接続画面が表示されます。または、既存のサービスで MySQL インターフェイスを有効にするには、次の手順に従います。Connect を選択
サービスが Running 状態であることを確認してから、MySQL インターフェイスを有効にしたいサービスをクリックします。
左側のメニューから「Connect」を選択します。MySQL を選択
Connect With ドロップダウンから MySQL を選択します。MySQL インターフェイスを有効にする
このサービス専用の MySQL インターフェイスを有効にするには、スイッチをオンにします。
これにより、このサービスでポート 3306 が公開され、固有の MySQL ユーザー名を含む MySQL 接続画面が表示されます。ClickHouse Cloud で読み取り専用の MySQL ユーザーを作成する
mysql4<subdomain> ユーザーが自動的に作成されます。
<subdomain> の部分は、ClickHouse Cloud のホスト名の先頭部分に対応します。
このユーザー名形式は、安全な接続を確立するものの、TLS ハンドシェイクに SNI (Server Name Indication) 情報を含めないツールとの互換性のために必要です。
SNI 情報がないと、システムは適切な内部ルーティングを実行できないため、ユーザー名に埋め込まれたサブドメイン情報が必要なルーティング情報を補います。
MySQL コンソールクライアントは、その一例です。
ベストプラクティスとして、新しい読み取り専用の MySQL ユーザーを作成することを推奨します。
ClickHouse Cloud のホスト名が foobar.us-east1.aws.clickhouse.cloud の場合、<subdomain> の部分は foobar で、カスタム MySQL ユーザー名は mysql4foobar_team1 のようになります。
読み取り専用の設定プロファイルを作成する
読み取り専用ユーザーに適用する 設定プロファイル を作成し、
readonly 設定を 1 にします。CREATE SETTINGS PROFILE readonly_profile SETTINGS readonly = 1
新しい読み取り専用の MySQL ユーザーを作成する
次の形式の名前で ユーザーを作成 します。mysql4<subdomain>_<username>
readonly_profile を適用し、パスワードがダブル SHA1 フォーマットであることを確認してください。例:CREATE USER mysql4foobar_readonly
IDENTIFIED WITH double_sha1_password BY 'YourPassword42$'
SETTINGS PROFILE 'readonly_profile';
新しいユーザーに必要なテーブルへのアクセス権限を付与する
必要なテーブルまたはデータベースを操作できるように、新しいユーザーに必要な権限を 付与 します。
たとえば、system.query_log のみにアクセスを許可する場合は次のとおりです。GRANT SELECT ON system.query_log TO mysql4foobar_readonly;
読み取り専用ユーザーには、アクセスさせたいテーブルに対して SELECT 権限のみを付与してください。
ClickHouse Cloud で複数の MySQLユーザーをトラブルシューティングする
ERROR 2013 (HY000): Lost connection to MySQL server at 'reading authorization packet', system error: 54
mysql4<subdomain>_<username> 形式に従っていることを確認してください。
オンプレミスのClickHouseサーバーのセットアップ
config.xml にエントリを追加する以外に
<clickhouse>
<mysql_port>9004</mysql_port>
</clickhouse>
PASSWORD=$(base64 < /dev/urandom | head -c16); echo "$PASSWORD"; echo -n "$PASSWORD" | sha1sum | tr -d '-' | xxd -r -p | sha1sum | tr -d '-'
LZOQYnqQN4L/T6L0
fbc958cc745a82188a51f30de69eebfc67c40ee4
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 エントリを、自分で生成したダブル SHA1 ハッシュに置き換えてください。
さらに、SHOW [FULL] COLUMNS クエリの結果に ClickHouse の型ではなくネイティブな MySQL 型を表示するため、use_mysql_types_in_show_columns を使用することを推奨します。
これにより、MySQL コネクタを使用する際に、BI ツールがデータベースのスキーマを適切に解析できるようになります。
例:
/etc/clickhouse-server/users.d/mysql_user.xml
<profiles>
<default>
<use_mysql_types_in_show_columns>1</use_mysql_types_in_show_columns>
</default>
</profiles>
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.
config.xml で全アドレスを待ち受けるには、以下のコメントアウトを解除します。
<listen_host>::</listen_host>
Looker Studio を ClickHouse に接続する
ClickHouse Cloud で Looker Studio を使用する
