前提条件
- 権限: 新しいデータソースを追加するには、Holistics で Admin 権限を持っている必要があります。
- ネットワークアクセス: ClickHouse server が Holistics の IP アドレス からアクセス可能である必要があります。
- データベースユーザー: 管理者アカウントは使用せず、Holistics 専用の読み取り専用ユーザーを作成してください。
推奨権限
SELECT権限に加え、systemテーブルに対する権限 (スキーマ検出用) も必要です。
1
接続情報を確認する
HTTP(S) を使用して ClickHouse に接続するには、次の情報が必要です。これらの情報は、ClickHouse Cloud console で Connect ボタンをクリックし、HTTPS を選択すると確認できます。
2
ネットワークアクセスを設定する
Holistics はクラウドベースのアプリケーションのため、その server から database に接続できる必要があります。方法は 2 つあります。- Direct Connection (推奨) : ファイアウォールまたは ClickHouse Cloud の IP Access List で、Holistics の IP アドレスを許可リストに追加します。IP アドレスの一覧は IP Whitelisting guide で確認できます。
- Reverse SSH Tunnel: database がプライベートネットワーク (VPC) 内にあり、公開できない場合は、Reverse SSH Tunnel を使用します。
3
Holistics で data source を追加する
- Holistics で Settings → データソース に移動します。
- New Data Source をクリックし、ClickHouse を選択します。
-
ステップ 1 で確認した情報をフォームに入力します。
-
Test Connection をクリックします。
- Success: Save をクリックします。
- Failure: username/password を確認し、Holistics の IP が許可リストに追加されていることを確認してください。
既知の制限事項
- Running Total: この分析関数は、現在 ClickHouse ではサポートが限定的です。
- Nested Data Types: JSON や Array が深くネストされた構造は、可視化する前に SQLモデルを使ってフラット化する必要がある場合があります。