| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384 |
- Metadata-Version: 2.1
- Name: clickhouse-connect
- Version: 0.8.10
- Summary: ClickHouse Database Core Driver for Python, Pandas, and Superset
- Home-page: https://github.com/ClickHouse/clickhouse-connect
- Author: ClickHouse Inc.
- Author-email: clients@clickhouse.com
- License: Apache License 2.0
- Keywords: clickhouse,superset,sqlalchemy,http,driver
- Classifier: Development Status :: 4 - Beta
- Classifier: Intended Audience :: Developers
- Classifier: License :: OSI Approved :: Apache Software License
- Classifier: Programming Language :: Python :: 3.8
- Classifier: Programming Language :: Python :: 3.9
- Classifier: Programming Language :: Python :: 3.10
- Classifier: Programming Language :: Python :: 3.11
- Classifier: Programming Language :: Python :: 3.12
- Classifier: Programming Language :: Python :: 3.13
- Requires-Python: ~=3.8
- Description-Content-Type: text/markdown
- License-File: LICENSE
- Requires-Dist: certifi
- Requires-Dist: urllib3>=1.26
- Requires-Dist: pytz
- Requires-Dist: zstandard
- Requires-Dist: lz4
- Provides-Extra: sqlalchemy
- Requires-Dist: sqlalchemy<2.0,>1.3.21; extra == "sqlalchemy"
- Provides-Extra: numpy
- Requires-Dist: numpy; extra == "numpy"
- Provides-Extra: pandas
- Requires-Dist: pandas; extra == "pandas"
- Provides-Extra: arrow
- Requires-Dist: pyarrow; extra == "arrow"
- Provides-Extra: orjson
- Requires-Dist: orjson; extra == "orjson"
- Provides-Extra: tzlocal
- Requires-Dist: tzlocal>=4.0; extra == "tzlocal"
- ## ClickHouse Connect
- A high performance core database driver for connecting ClickHouse to Python, Pandas, and Superset
- * Pandas DataFrames
- * Numpy Arrays
- * PyArrow Tables
- * Superset Connector
- * SQLAlchemy 1.3 and 1.4 (limited feature set)
- ClickHouse Connect currently uses the ClickHouse HTTP interface for maximum compatibility.
- ### Installation
- ```
- pip install clickhouse-connect
- ```
- ClickHouse Connect requires Python 3.8 or higher.
- ### Superset Connectivity
- ClickHouse Connect is fully integrated with Apache Superset. Previous versions of ClickHouse Connect utilized a
- dynamically loaded Superset Engine Spec, but as of Superset v2.1.0 the engine spec was incorporated into the main
- Apache Superset project and removed from clickhouse-connect in v0.6.0. If you have issues connecting to earlier
- versions of Superset, please use clickhouse-connect v0.5.25.
- When creating a Superset Data Source, either use the provided connection dialog, or a SqlAlchemy DSN in the form
- `clickhousedb://{username}:{password}@{host}:{port}`.
- ### SQLAlchemy Implementation
- ClickHouse Connect incorporates a minimal SQLAlchemy implementation (without any ORM features) for compatibility with
- Superset. It has only been tested against SQLAlchemy versions 1.3.x and 1.4.x, and is unlikely to work with more
- complex SQLAlchemy applications.
- ### Asyncio Support
- ClickHouse Connect provides an async wrapper, so that it is possible to use the client in an `asyncio` environment.
- See the [run_async example](./examples/run_async.py) for more details.
- ### Complete Documentation
- The documentation for ClickHouse Connect has moved to
- [ClickHouse Docs](https://clickhouse.com/docs/en/integrations/language-clients/python/intro)
|
