Skip to main content
Edit this page

ClickHouse を Deepnote に接続する

Deepnote は、チームが発見や知見を共有するために構築された協力型データノートブックです。Jupyter 互換であることに加えて、クラウドで動作し、データサイエンスプロジェクトを効率的に進めるための中央集権的な場所を提供します。

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

インタラクティブな例​

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

ClickHouse に接続する​

  1. Deepnote で「Integrations」概要を選択し、ClickHouse タイルをクリックします。
ClickHouse integration tile

  1. ClickHouse インスタンスの接続詳細を入力します:

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

    • HOST と PORT: 通常、TLS を使用する場合のポートは 8443、TLS を使用しない場合は 8123 です。

    • データベース名: デフォルトで default という名前のデータベースがありますが、接続したいデータベースの名前を使用してください。

    • ユーザー名とパスワード: デフォルトでユーザー名は default です。使用ケースに適したユーザー名を使用してください。

    ClickHouse Cloud サービスの詳細は、ClickHouse Cloud コンソールで確認できます。 接続するサービスを選択し、接続 をクリックします:

    ClickHouse Cloud service connect button

    HTTPS を選択すると、サンプルの curl コマンドで詳細が確認できます。

    ClickHouse Cloud HTTPS connection details

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

    ClickHouse details dialog

    注意: ClickHouse への接続が IP アクセスリストで保護されている場合、Deepnote の IP アドレスを許可する必要があるかもしれません。詳細は Deepnote のドキュメントを参照してください。

  2. おめでとうございます！これで ClickHouse が Deepnote に統合されました。

ClickHouse 統合の使用方法​

  1. ノートブックの右側で ClickHouse 統合に接続を開始します。

    ClickHouse details dialog

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

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