メインコンテンツへスキップ
メインコンテンツへスキップ

ClickHouse を Holistics に接続する

Community Maintained

Holistics は、信頼できる一貫したメトリクスのためのプログラマブルなセマンティックレイヤーを備えた、AI ネイティブなセルフサービス BI プラットフォームです。

ClickHouse を Holistics に接続すると、チームはコードベースのセマンティックレイヤーに基づく、高速で信頼性の高い AI 活用型のセルフサービス環境を利用できます。ビジネスユーザーはドラッグ＆ドロップと AI を用いて自信を持ってデータを探索でき、同時にメトリクス定義を再利用可能かつ組み合わせ可能な形で維持し、Git でバージョン管理することができます。

前提条件​

接続を行う前に、以下を確認してください。

  • 権限: 新しいデータソースを追加するには、Holistics 上の管理者権限が必要です。
  • ネットワークアクセス: ClickHouse サーバーが Holistics の IP アドレス からアクセス可能である必要があります。
  • データベースユーザー: 管理者アカウントは使用せず、Holistics 用に専用の読み取り専用ユーザーを作成してください。

専用ユーザーには、クエリを実行したいテーブルに対する SELECT 権限に加えて、スキーマ検出のために system テーブルに対する SELECT 権限が必要です。

-- Example: Grant read access to a specific database
GRANT SELECT ON my_database.* TO holistics_user;

-- Grant access to system metadata
GRANT SELECT ON system.* TO holistics_user;

接続情報を確認する​

HTTP(S) を使用して ClickHouse に接続するには、次の情報が必要です。

ParameterDescription
HostClickHouse サーバーのホスト名（例: mz322.eu-central-1.aws.clickhouse.cloud）。
PortClickHouse Cloud の場合は 8443（SSL/TLS）。SSL なしのセルフマネージドなインスタンスの場合は 8123。
Database Name接続したいデータベース名。デフォルトは通常 default。
Usernameデータベースユーザー。デフォルトは default。
Passwordデータベースユーザーのパスワード。

これらの情報は、ClickHouse Cloud コンソールで Connect ボタンをクリックし、HTTPS を選択することで確認できます。

ClickHouse Cloud コンソールにおける Connect ボタンの位置

ネットワークアクセスを設定する​

Holistics はクラウドベースのアプリケーションのため、そのサーバーからデータベースに到達できる必要があります。次の 2 つのオプションがあります。

  1. ダイレクト接続（推奨）: Holistics の IP アドレスをファイアウォールまたは ClickHouse Cloud の IP Access List に Allowlist 登録します。IP の一覧は IP Whitelisting ガイドで確認できます。

    ClickHouse Cloud における IP Allowlisting の例

  2. リバース SSH トンネル: データベースがプライベートネットワーク（VPC）内にあり、パブリックに公開できない場合は、Reverse SSH Tunnel を使用します。

Holistics にデータソースを追加する​

  1. Holistics で Settings → Data Sources に移動します。

    Holistics の設定で Data Sources へ移動する操作

  2. New Data Source をクリックし、ClickHouse を選択します。

    新規データソースの一覧から ClickHouse を選択する画面

  3. ステップ1で収集した情報をフォームに入力します。

    FieldSetting
    Host使用している ClickHouse のホスト名
    Port8443（または 8123）
    Require SSLポート 8443 を使用する場合は ON に切り替え（ClickHouse Cloud では必須）。
    Database Namedefault（または使用している特定の DB）
    Holistics で ClickHouse の接続情報を入力する画面

  4. Test Connection をクリックします。

    Holistics で ClickHouse への接続テストが成功した画面

既知の制限事項​

Holistics は ClickHouse の標準的な SQL 機能の大部分をサポートしていますが、以下の例外があります。

  • Running Total: この分析関数は、現時点では ClickHouse でのサポートが限定的です。
  • ネストされたデータ型: 深くネストされた JSON や Array 構造は、可視化の前に SQL モデルでフラット化する必要がある場合があります。

サポートされている機能の完全な一覧については、Database-specific Limitations ページを参照してください。