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

Databrain を ClickHouse に接続する

Community Maintained

Databrain は、組み込み型のアナリティクスプラットフォームであり、インタラクティブなダッシュボード、メトリクス、データ可視化を作成して顧客と共有できます。Databrain は HTTPS インターフェース経由で ClickHouse に接続し、モダンでユーザーフレンドリーなインターフェースから ClickHouse データを容易に可視化・分析できるようにします。

ClickHouse データの可視化を表示している Databrain ダッシュボードのインターフェース

このガイドでは、Databrain を ClickHouse インスタンスに接続する手順を説明します。

前提条件​

  • 独自のインフラストラクチャ上で、または ClickHouse Cloud 上でホストされている ClickHouse データベース。
  • Databrain アカウント。
  • データソースを接続するための Databrain ワークスペース。

Databrain を ClickHouse に接続する手順​

1. 接続情報を準備する​

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

Parameter(s)Description
HOST and PORT通常、TLS を使用する場合のポートは 8443、TLS を使用しない場合のポートは 8123 です。
DATABASE NAME既定で default という名前のデータベースが用意されています。接続したいデータベースの名前を使用してください。
USERNAME and PASSWORD既定のユーザー名は default です。用途に応じて適切なユーザー名を使用してください。

ClickHouse Cloud サービスに関する詳細情報は、ClickHouse Cloud コンソールで確認できます。 サービスを選択し、Connect をクリックします。

ClickHouse Cloud サービスの Connect ボタン

HTTPS を選択します。接続情報は、サンプルの curl コマンド内に表示されます。

ClickHouse Cloud HTTPS 接続詳細

自己管理型の ClickHouse を使用している場合、接続情報は ClickHouse 管理者によって設定されます。

2. Databrain の IP アドレスを許可する（必要な場合）​

ClickHouse インスタンスで IP フィルタリングが有効になっている場合は、Databrain の IP アドレスを許可リストに追加する必要があります。

ClickHouse Cloud をご利用の場合:

  1. ClickHouse Cloud コンソールで対象のサービスに移動します
  2. Settings → Security に進みます
  3. Databrain の IP アドレスを許可リストに追加します
ヒント

最新の許可対象 IP アドレス一覧については、Databrain の IP アドレス許可設定ドキュメントを参照してください。

3. Databrain で ClickHouse をデータソースとして追加する​

  1. Databrain アカウントにログインし、データソースを追加したいワークスペースに移動します。

  2. ナビゲーションメニューで Data Sources をクリックします。

Databrain のデータソースメニュー

  1. Add a Data Source または Connect Data Source をクリックします。

  2. 利用可能なコネクタ一覧から ClickHouse を選択します。

ClickHouse オプションが表示された Databrain のコネクタ選択画面
  1. 接続情報を入力します:
    • Destination Name: この接続を識別しやすい名前を入力します（例: "Production ClickHouse" や "Analytics DB"）
    • Host: ClickHouse のホスト URL を入力します（例: https://your-instance.region.aws.clickhouse.cloud）
    • Port: 8443 を入力します（ClickHouse のデフォルト HTTPS ポート）
    • Username: ClickHouse のユーザー名を入力します
    • Password: ClickHouse のパスワードを入力します
設定フィールドが表示された Databrain の ClickHouse 接続フォーム

  1. Test Connection をクリックして、Databrain から ClickHouse インスタンスへ接続できることを確認します。

  2. 接続が成功したら、Save または Connect をクリックしてデータソースを追加します。

4. ユーザー権限を構成する​

接続に使用する ClickHouse ユーザーに、必要な権限が付与されていることを確認します。

-- スキーマ情報を読み取る権限を付与します
GRANT SELECT ON information_schema.* TO your_databrain_user;

-- データベースおよびテーブルを読み取る権限を付与します
GRANT SELECT ON your_database.* TO your_databrain_user;

your_databrain_user と your_database を、実際に使用するユーザー名とデータベース名に置き換えてください。

ClickHouse で Databrain を使用する​

データを探索する​

  1. 接続後、Databrain のワークスペースに移動します。

  2. データエクスプローラーに ClickHouse のテーブル一覧が表示されます。

ClickHouse テーブルを表示している Databrain のデータエクスプローラー
  1. テーブルをクリックして、そのスキーマを確認し、データをプレビューします。

メトリクスと可視化を作成する​

  1. Create Metric をクリックして、ClickHouse データから可視化の作成を開始します。

  2. ClickHouse のデータソースを選択し、可視化したいテーブルを選びます。

  3. Databrain の直感的なインターフェースを使用して、次の操作を行います。

    • ディメンションとメジャーを選択する
    • フィルターと集約を適用する
    • 可視化タイプを選択する（棒グラフ、折れ線グラフ、円グラフ、テーブルなど）
    • 高度な分析のためにカスタム SQL クエリを追加する

  4. メトリクスを保存して、複数のダッシュボードで再利用できるようにします。

ダッシュボードを作成する​

  1. Create Dashboard をクリックして、ダッシュボードの作成を開始します。

  2. 保存済みメトリクスをドラッグ＆ドロップして、ダッシュボードにメトリクスを追加します。

  3. ダッシュボードのレイアウトと外観をカスタマイズします。

複数の ClickHouse 可視化を含む Databrain ダッシュボード
  1. ダッシュボードをチームと共有するか、アプリケーションに埋め込みます。

高度な機能​

Databrain は、ClickHouse を使用する際にいくつかの高度な機能を提供します。

  • Custom SQL Console: ClickHouse データベースに対してカスタム SQL クエリを直接作成・実行できます
  • マルチテナンシーおよびシングルテナンシー: シングルテナントおよびマルチテナントアーキテクチャのいずれでも ClickHouse データベースに接続できます
  • レポートスケジューリング: 自動レポートをスケジュールし、ステークホルダーにメール送信できます
  • AI によるインサイト: AI を使用して、データからサマリーやインサイトを自動生成できます
  • 埋め込みアナリティクス: ダッシュボードとメトリクスをアプリケーションに直接埋め込めます
  • セマンティックレイヤー: 再利用可能なデータモデルとビジネスロジックを作成できます

トラブルシューティング​

接続に失敗する​

ClickHouse に接続できない場合は、次の点を確認してください。

  1. 認証情報の確認: ユーザー名、パスワード、ホスト URL を再確認してください
  2. ポートの確認: HTTPS を利用している場合はポート 8443 を、SSL を使用しない HTTP の場合は 8123 を使用していることを確認してください
  3. IP ホワイトリスト: Databrain の IP アドレスが ClickHouse のファイアウォール／セキュリティ設定でホワイトリストに登録されていることを確認してください
  4. SSL/TLS: HTTPS を使用している場合は SSL/TLS が正しく構成されていることを確認してください
  5. ユーザー権限: 対象ユーザーが information_schema および対象データベースに対する SELECT 権限を持っていることを確認してください

クエリのパフォーマンスが低い​

クエリの実行が遅い場合は、次の点を検討してください。

  1. クエリの最適化: フィルターや集約を効率的に使用してください
  2. マテリアライズドビューの作成: 頻繁に参照される集約に対しては、ClickHouse にマテリアライズドビューを作成することを検討してください
  3. 適切なデータ型の使用: ClickHouse のスキーマで最適なデータ型を使用していることを確認してください
  4. インデックスの最適化: ClickHouse のプライマリキーとスキップインデックスを活用してください

さらに詳しく​

Databrain の機能や、強力な分析機能を構築する方法の詳細については、以下を参照してください。