ClickHouse を Deepnote に接続する

使い慣れたノートブック環境で、非常に大規模なデータセットに効率的にクエリを実行し、分析やモデリングを行えます。

Deepnote は、チームでインサイトを見つけて共有するために設計された、コラボレーション向けのデータノートブックです。Jupyter 互換であることに加え、Cloud 上で動作し、データサイエンスプロジェクトで効率的に共同作業を進めるための一元的な作業環境を提供します。

このガイドでは、すでに Deepnote アカウントを所有しており、稼働中の ClickHouse インスタンスがあることを前提としています。

​

インタラクティブな例

Deepnote のデータノートブックから ClickHouse にクエリを実行するインタラクティブな例を試すには、下のボタンをクリックして、ClickHouse playground に接続されたテンプレートプロジェクトを起動してください。

​

ClickHouse に接続する

1. Deepnote で「Integrations」の概要ページを開き、ClickHouse のタイルをクリックします。

2. ClickHouse インスタンスの接続情報を入力します。

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 をクリックします。

HTTPS を選択します。接続情報は curl コマンドの例として表示されます。

セルフマネージド ClickHouse を使用している場合、接続情報は ClickHouse 管理者によって設定されます。

注: ClickHouse への接続が IP Access List で保護されている場合は、Deepnote の IP アドレスを許可する必要があることがあります。詳細は、Deepnote のドキュメントを参照してください。

3. これで完了です。Deepnote で ClickHouse を利用できるようになりました。

​

ClickHouse 連携を使用する

1. まず、ノートブックの右側にある ClickHouse 連携に接続します。

2. 次に、新しい ClickHouse クエリブロックを作成してデータベースにクエリを実行します。クエリ結果は DataFrame として保存され、SQL ブロックで指定した変数に格納されます。

3. 既存の SQL ブロック を ClickHouse ブロックに変換することもできます。