Skip to main content

ClickHouse Pool for Python

PyPI PyPI - License Read the Docs

A thread-safe connection pool for ClickHouse. Inspired by psycopg2 and using clickhouse-driver for connections.

Installation

pip install clickhouse-pool

Quick Start

from clickhouse_pool import ChPool

pool = ChPool()

with pool.get_client() as client:
    # execute sql and print the result
    result = client.execute("SELECT * FROM system.numbers LIMIT 5")
    print(result)

# always close all connections in the pool once you're done with it
pool.cleanup()

Connection Pool Size

To change the connection pool size,

pool = ChPool(connections_min=20, connections_max=40)

with pool.get_client() as client:
    result = client.execute("SELECT * FROM system.numbers LIMIT 5")
    print(result)

# always close all connections in the pool once you're done with it
pool.cleanup()

Testing Locally

To run tests locally ensure you have an instance of clickhouse-server running on localhost. The easiest way is to use docker:

docker run -d -p 9000:9000 yandex/clickhouse-server
python tests.py

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clickhouse-pool-0.4.2.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

clickhouse_pool-0.4.2-py3-none-any.whl (4.8 kB view details)

Uploaded Python 3

File details

Details for the file clickhouse-pool-0.4.2.tar.gz.

File metadata

  • Download URL: clickhouse-pool-0.4.2.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.52.0 CPython/3.8.6

File hashes

Hashes for clickhouse-pool-0.4.2.tar.gz
Algorithm Hash digest
SHA256 c8a9538e50def60cc19ff62d391f57e134f90a4347d61f865f84cfc473dd3d99
MD5 3be309f80984522b0e2db4064bea0db5
BLAKE2b-256 7d53b0186aeb3c0be225559a1b6b43c0176edd6d59f47b95e6adf75295ea04e9

See more details on using hashes here.

File details

Details for the file clickhouse_pool-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: clickhouse_pool-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 4.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.52.0 CPython/3.8.6

File hashes

Hashes for clickhouse_pool-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4f524ccd2c15a39fffd881270a3db902253bf2c0e8cfaceea1252bb59e867714
MD5 26cdeff67c40af1783a00c47668d1e2c
BLAKE2b-256 6e7df9fd0cf04d7246fdf50f920724a0ebb66d195bd39be8719eaccadc249d49

See more details on using hashes here.

Release history Release notifications | RSS feed

0.6.1

2 files

0.6.0

2 files

0.5.3

2 files

0.5.0

2 files

0.4.3

2 files

This release

0.4.2 This release

2 files

0.4.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page