Skip to main content
このガイドでは、chDBからリモートのClickHouseサーバーにクエリする方法を学びます。

準備

まず、仮想環境を作成しましょう。
次に、chDBをインストールします。 バージョン 2.0.2 以上であることを確認してください:
次に、pandasipython をインストールします:
このガイドの以降では、コマンドの実行に ipython を使用します。次を実行して起動できます。
このコードは、Python スクリプトやお好みのノートブックでも使用できます。

ClickPy の概要

これからクエリを実行するリモートの ClickHouseサーバーは、ClickPy です。 ClickPy は PyPI パッケージのすべてのダウンロードを追跡しており、UI を通じて各パッケージの統計を確認できます。 基盤となるデータベースには、play ユーザーを使ってクエリを実行できます。 ClickPy の詳細については、GitHub リポジトリをご覧ください。

ClickPy ClickHouse service に対してクエリを実行する

まず、chDB をインポートします:
remoteSecure 関数を使用して ClickPy にクエリを実行します。 この関数には、最低でもホスト名、テーブル名、ユーザー名を指定する必要があります。 次のクエリを記述すると、openai パッケージ の1日あたりのダウンロード数を Pandas DataFrame として取得できます。
それでは同様に、scikit-learn のダウンロード数を取得してみましょう。

Pandas DataFramesのマージ

これで2つのDataFrameがそろったので、日付 (xカラム) を基準に、次のようにマージできます。
次のように、OpenAI のダウンロード数に対する scikit-learn のダウンロード数の比率を計算できます。

Pandas DataFrames のクエリ

次に、比率が最も高い日付と最も低い日付を見つけるとします。 chDB に戻って、それらの値を計算できます。
Pandas DataFrames へのクエリについて詳しくは、Pandas DataFrames 開発者ガイドを参照してください。
最終更新日 2026年7月23日