> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> Looker Studio は、旧 Google Data Studio の名称で、データをカスタマイズ可能で有益なレポートやダッシュボードに変換できるオンラインツールです。
# Looker Studio
export const PartnerBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
Looker Studio は、Google 公式の MySQL データソースを使用して、MySQL インターフェイス経由で ClickHouse に接続できます。
## ClickHouse Cloud の設定
Connect your app を選択 } id="select-connect-your-app">
ClickHouse Cloud サービスを作成したら、`Connect your app` 画面でドロップダウンから MySQL を選択します。
このサービスで MySQL インターフェイスを有効にするには、スイッチをオンにします。
これにより、このサービスでポート `3306` が公開され、固有の MySQL ユーザー名を含む MySQL 接続画面が表示されます。
また、既存のサービスで MySQL インターフェイスを有効にする場合は、次の手順に従います。
Connect を選択 } id="select-connect">
サービスが `Running` 状態であることを確認してから、MySQL インターフェイスを有効にしたいサービスをクリックします。
左側のメニューから "Connect" を選択します。
MySQL を選択 } id="choose-mysql">
`Connect With` ドロップダウンから `MySQL` を選択します。
このサービスで MySQL インターフェイスを有効にするには、スイッチをオンにします。
これにより、このサービスでポート `3306` が公開され、固有の MySQL ユーザー名を含む MySQL 接続画面が表示されます。
## ClickHouse Cloud で読み取り専用の MySQL ユーザーを作成する
ClickHouse Cloud では、デフォルトユーザーと同じパスワードを共有する `mysql4` ユーザーが自動的に作成されます。
`` の部分は、ClickHouse Cloud のホスト名の先頭部分に対応します。
このユーザー名形式は、安全な接続を確立しても TLS ハンドシェイクに [SNI (Server Name Indication)](https://www.cloudflare.com/learning/ssl/what-is-sni) 情報を含めないツールとの互換性のために必要です。
SNI 情報がないと、システムは適切な内部ルーティングを実行できないため、ユーザー名に埋め込まれたサブドメイン情報が必要なルーティング情報を補います。
MySQL コンソールクライアントは、その一例です。
ベストプラクティスとして、新しい読み取り専用の MySQL ユーザーを作成することを推奨します。
ClickHouse Cloud のホスト名が `foobar.us-east1.aws.clickhouse.cloud` の場合、`` の部分は `foobar` で、カスタム MySQL ユーザー名は `mysql4foobar_team1` のようになります。
読み取り専用ユーザーに適用する [設定プロファイル](/docs/ja/reference/statements/create/settings-profile) を作成し、
`readonly` 設定を `1` にします。
```sql theme={null}
CREATE SETTINGS PROFILE readonly_profile SETTINGS readonly = 1
```
次の形式の名前で [ユーザーを作成](/docs/ja/reference/statements/create/user) します。
```sql theme={null}
mysql4_
```
新しいユーザーに `readonly_profile` を適用し、パスワードがダブル SHA1 フォーマットであることを確認してください。例:
```sql theme={null}
CREATE USER mysql4foobar_readonly
IDENTIFIED WITH double_sha1_password BY 'YourPassword42$'
SETTINGS PROFILE 'readonly_profile';
```
必要なテーブルまたはデータベースを操作できるように、新しいユーザーに必要な権限を [付与](/docs/ja/reference/statements/grant) します。
たとえば、`system.query_log` のみにアクセスを許可する場合は次のとおりです。
```sql theme={null}
GRANT SELECT ON system.query_log TO mysql4foobar_readonly;
```
読み取り専用ユーザーには、アクセスさせたいテーブルに対して `SELECT` 権限のみを付与してください。
新しく作成したユーザーは、MySQL インターフェイスを使用して ClickHouse Cloud サービスに接続する際に利用できます。
### ClickHouse Cloud で複数の MySQLユーザーをトラブルシューティングする
新しい MySQLユーザーを作成し、MySQL CLI クライアント経由で接続した際に次のエラーが表示される場合:
```
ERROR 2013 (HY000): Lost connection to MySQL server at 'reading authorization packet', system error: 54
```
この場合、ユーザー名が[上記](#creating-multiple-mysql-users-in-clickhouse-cloud)で説明した `mysql4_` 形式に従っていることを確認してください。
## オンプレミスのClickHouseサーバーのセットアップ
MySQL インターフェイスを有効にした ClickHouse server の設定方法については、[公式ドキュメント](/docs/ja/concepts/features/interfaces/mysql)を参照してください。
サーバーの `config.xml` にエントリを追加する以外に
```xml theme={null}
9004
```
また、MySQL インターフェイスを使用するユーザーには、
[ダブル SHA1 パスワード暗号化](/docs/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 '-'
```
出力は以下のようになります。
```
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 ハッシュに置き換えてください。
さらに、`SHOW [FULL] COLUMNS` クエリの結果に ClickHouse の型ではなくネイティブな MySQL 型を表示するため、`use_mysql_types_in_show_columns` を使用することを推奨します。
これにより、MySQL コネクタを使用する際に、BI ツールがデータベースのスキーマを適切に解析できるようになります。
例:
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
1
```
または、デフォルトではなく別のプロファイルに割り当てます。
`mysql` バイナリが利用できる場合は、コマンドラインから接続をテストできます。
上記のサンプルのユーザー名 (`mysql_user`) とパスワード (`LZOQYnqQN4L/T6L0`) を使用すると、コマンドラインは次のようになります。
```bash theme={null}
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.
```
最後に、ClickHouse Server が指定した IP アドレスで待ち受けるよう設定します。たとえば、`config.xml` で全アドレスを待ち受けるには、以下のコメントアウトを解除します。
```bash theme={null}
::
```
## Looker Studio を ClickHouse に接続する
まず、Google アカウントで [https://lookerstudio.google.com](https://lookerstudio.google.com) にログインし、新しいデータソースを作成します。
Google が提供する公式の MySQL コネクタ (名前は **MySQL**) を検索します。
接続情報を指定します。MySQL インターフェイスのポートはデフォルトで 9004 ですが、
サーバー設定によって異なる場合があるので注意してください。
ここからは、ClickHouse からデータを取得する方法が 2 つあります。1 つ目は、Table Browser 機能を使用する方法です。
または、カスタムクエリを指定してデータを取得することもできます。
最後に、自動認識されたテーブル構造を確認し、必要に応じてデータ型を調整できます。
これで、データの探索や新しいレポートの作成に進めます。
## ClickHouse Cloud で Looker Studio を使用する
ClickHouse Cloud を使用する場合は、まず MySQL インターフェイスを有効にする必要があります。これは接続ダイアログの「MySQL」タブで設定できます。
Looker Studio の UI で、「Enable SSL」オプションを選択します。ClickHouse Cloud の SSL 証明書は [Let's Encrypt](https://letsencrypt.org/certificates/) によって署名されています。このルート証明書は [こちら](https://letsencrypt.org/certs/isrgrootx1.pem) からダウンロードできます。
以降の手順は、前のセクションに記載したものと同じです。
