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

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 ページを参照してください。