clickhouse-driver 0.2.6__cp311-cp311-win32.whl → 0.2.7__cp311-cp311-win32.whl

clickhouse_driver/__init__.py

@@ -3,7 +3,7 @@ from .client import Client
 from .dbapi import connect
 
 
-VERSION = (0, 2, 6)
+VERSION = (0, 2, 7)
 __version__ = '.'.join(str(x) for x in VERSION)
 
 __all__ = ['Client', 'connect']

clickhouse_driver/client.py

@@ -63,6 +63,11 @@ class Client(object):
                            tuple set ``namedtuple_as_json`` to ``False``.
                            Default: True.
                            New in version *0.2.6*.
+        * ``server_side_params`` -- Species on which side query parameters
+                           should be rendered into placeholders.
+                           Default: False. Means that parameters are rendered
+                           on driver's side.
+                           New in version *0.2.7*.
     """
 
     available_client_settings = (
@@ -74,7 +79,8 @@ class Client(object):
         'opentelemetry_tracestate',
         'quota_key',
         'input_format_null_as_default',
-        'namedtuple_as_json'
+        'namedtuple_as_json',
+        'server_side_params'
     )
 
     def __init__(self, *args, **kwargs):
@@ -107,6 +113,9 @@ class Client(object):
             ),
             'namedtuple_as_json': self.settings.pop(
                 'namedtuple_as_json', True
+            ),
+            'server_side_params': self.settings.pop(
+                'server_side_params', False
             )
         }
 
@@ -592,12 +601,12 @@ class Client(object):
         self.connection.send_query(query_without_data, query_id=query_id)
         self.connection.send_external_tables(external_tables,
                                              types_check=types_check)
-
         sample_block = self.receive_sample_block()
+
         if sample_block:
             rv = self.send_data(sample_block, data,
                                 types_check=types_check, columnar=columnar)
-            self.receive_end_of_query()
+            self.receive_end_of_insert_query()
             return rv
 
     def receive_sample_block(self):
@@ -651,8 +660,15 @@ class Client(object):
             self.connection.send_data(block)
             inserted_rows += block.num_rows
 
+            # Starting from the specific revision there are profile events
+            # sent by server in response to each inserted block
+            self.receive_profile_events()
+
         # Empty block means end of data.
         self.connection.send_data(block_cls())
+        # If enabled by revision profile events are also sent after empty block
+        self.receive_profile_events()
+
         return inserted_rows
 
     def receive_end_of_query(self):
@@ -663,7 +679,7 @@ class Client(object):
                 break
 
             elif packet.type == ServerPacketTypes.PROGRESS:
-                continue
+                self.last_query.store_progress(packet.progress)
 
             elif packet.type == ServerPacketTypes.EXCEPTION:
                 raise packet.exception
@@ -675,11 +691,64 @@ class Client(object):
                 pass
 
             elif packet.type == ServerPacketTypes.PROFILE_EVENTS:
-                pass
+                self.last_query.store_profile(packet.profile_info)
+
+            else:
+                message = self.connection.unexpected_packet_message(
+                    'Exception, EndOfStream, Progress, TableColumns, '
+                    'ProfileEvents or Log', packet.type
+                )
+                raise errors.UnexpectedPacketFromServerError(message)
+
+    def receive_end_of_insert_query(self):
+        while True:
+            packet = self.connection.receive_packet()
+
+            if packet.type == ServerPacketTypes.END_OF_STREAM:
+                break
+
+            elif packet.type == ServerPacketTypes.LOG:
+                log_block(packet.block)
+
+            elif packet.type == ServerPacketTypes.PROGRESS:
+                self.last_query.store_progress(packet.progress)
+
+            elif packet.type == ServerPacketTypes.EXCEPTION:
+                raise packet.exception
 
             else:
                 message = self.connection.unexpected_packet_message(
-                    'Exception, EndOfStream or Log', packet.type
+                    'EndOfStream, Log, Progress or Exception', packet.type
+                )
+                raise errors.UnexpectedPacketFromServerError(message)
+
+    def receive_profile_events(self):
+        revision = self.connection.server_info.used_revision
+        if (
+            revision <
+            defines.DBMS_MIN_PROTOCOL_VERSION_WITH_PROFILE_EVENTS_IN_INSERT
+        ):
+            return None
+
+        while True:
+            packet = self.connection.receive_packet()
+
+            if packet.type == ServerPacketTypes.PROFILE_EVENTS:
+                self.last_query.store_profile(packet.profile_info)
+                break
+
+            elif packet.type == ServerPacketTypes.PROGRESS:
+                self.last_query.store_progress(packet.progress)
+
+            elif packet.type == ServerPacketTypes.LOG:
+                log_block(packet.block)
+
+            elif packet.type == ServerPacketTypes.EXCEPTION:
+                raise packet.exception
+
+            else:
+                message = self.connection.unexpected_packet_message(
+                    'ProfileEvents, Progress, Log or Exception', packet.type
                 )
                 raise errors.UnexpectedPacketFromServerError(message)
 
@@ -706,6 +775,10 @@ class Client(object):
             # prints: SELECT 1234, 'bar'
             print(substituted_query)
         """
+        # In case of server side templating we don't substitute here.
+        if self.connection.context.client_settings['server_side_params']:
+            return query
+
         if not isinstance(params, dict):
             raise ValueError('Parameters are expected in dict form')
 

clickhouse_driver/columns/datecolumn.py

@@ -6,7 +6,7 @@ from .base import FormatColumn
 epoch_start = date(1970, 1, 1)
 epoch_end = date(2149, 6, 6)
 
-epoch_start_date32 = date(1925, 1, 1)
+epoch_start_date32 = date(1900, 1, 1)
 epoch_end_date32 = date(2283, 11, 11)
 
 
@@ -34,7 +34,7 @@ class DateColumn(FormatColumn):
                 items[i] = null_value
                 continue
 
-            if type(item) != date:
+            if item is not date:
                 item = date(item.year, item.month, item.day)
 
             if min_value <= item <= max_value:

clickhouse_driver/columns/uuidcolumn.py

@@ -54,7 +54,7 @@ class UUIDColumn(FormatColumn):
 
             try:
                 if not isinstance(item, UUID):
-                    item = UUID(item)
+                    item = UUID(int=item) if item is null_value else UUID(item)
 
             except ValueError:
                 raise errors.CannotParseUuidError(

clickhouse_driver/connection.py

@@ -20,7 +20,7 @@ from .log import log_block
 from .progress import Progress
 from .protocol import Compression, ClientPacketTypes, ServerPacketTypes
 from .queryprocessingstage import QueryProcessingStage
-from .reader import read_binary_str
+from .reader import read_binary_str, read_binary_uint64
 from .readhelpers import read_exception
 from .settings.writer import write_settings, SettingsFlags
 from .streams.native import BlockInputStream, BlockOutputStream
@@ -303,6 +303,7 @@ class Connection(object):
 
         version = ssl_options.get('ssl_version', ssl.PROTOCOL_TLS)
         context = ssl.SSLContext(version)
+        context.check_hostname = self.verify_cert
 
         if 'ca_certs' in ssl_options:
             context.load_verify_locations(ssl_options['ca_certs'])
@@ -496,6 +497,17 @@ class Connection(object):
                     defines.DBMS_MIN_REVISION_WITH_VERSION_PATCH:
                 server_version_patch = read_varint(self.fin)
 
+            if used_revision >= defines. \
+                    DBMS_MIN_PROTOCOL_VERSION_WITH_PASSWORD_COMPLEXITY_RULES:
+                rules_size = read_varint(self.fin)
+                for _i in range(rules_size):
+                    read_binary_str(self.fin)  # original_pattern
+                    read_binary_str(self.fin)  # exception_message
+
+            if used_revision >= defines. \
+                    DBMS_MIN_REVISION_WITH_INTERSERVER_SECRET_V2:
+                read_binary_uint64(self.fin)  # read_nonce
+
             self.server_info = ServerInfo(
                 server_name, server_version_major, server_version_minor,
                 server_version_patch, server_revision,
@@ -702,10 +714,13 @@ class Connection(object):
         write_binary_str(query, self.fout)
 
         if revision >= defines.DBMS_MIN_PROTOCOL_VERSION_WITH_PARAMETERS:
-            # Always settings_as_strings = True
-            escaped = escape_params(
-                params or {}, self.context, for_server=True
-            )
+            if self.context.client_settings['server_side_params']:
+                # Always settings_as_strings = True
+                escaped = escape_params(
+                    params or {}, self.context, for_server=True
+                )
+            else:
+                escaped = {}
             write_settings(escaped, self.fout, True, SettingsFlags.CUSTOM)
 
         logger.debug('Query: %s', query)

clickhouse_driver/defines.py

@@ -26,9 +26,13 @@ DBMS_MIN_PROTOCOL_VERSION_WITH_INITIAL_QUERY_START_TIME = 54449
 DBMS_MIN_PROTOCOL_VERSION_WITH_INCREMENTAL_PROFILE_EVENTS = 54451
 DBMS_MIN_REVISION_WITH_PARALLEL_REPLICAS = 54453
 DBMS_MIN_REVISION_WITH_CUSTOM_SERIALIZATION = 54454
+DBMS_MIN_PROTOCOL_VERSION_WITH_PROFILE_EVENTS_IN_INSERT = 54456
 DBMS_MIN_PROTOCOL_VERSION_WITH_ADDENDUM = 54458
 DBMS_MIN_PROTOCOL_VERSION_WITH_QUOTA_KEY = 54458
 DBMS_MIN_PROTOCOL_VERSION_WITH_PARAMETERS = 54459
+DBMS_MIN_PROTOCOL_VERSION_WITH_SERVER_QUERY_TIME_IN_PROGRESS = 54460
+DBMS_MIN_PROTOCOL_VERSION_WITH_PASSWORD_COMPLEXITY_RULES = 54461
+DBMS_MIN_REVISION_WITH_INTERSERVER_SECRET_V2 = 54462
 
 # Timeouts
 DBMS_DEFAULT_CONNECT_TIMEOUT_SEC = 10
@@ -44,7 +48,7 @@ CLIENT_NAME = 'python-driver'
 CLIENT_VERSION_MAJOR = 20
 CLIENT_VERSION_MINOR = 10
 CLIENT_VERSION_PATCH = 2
-CLIENT_REVISION = DBMS_MIN_PROTOCOL_VERSION_WITH_PARAMETERS
+CLIENT_REVISION = DBMS_MIN_REVISION_WITH_INTERSERVER_SECRET_V2
 
 BUFFER_SIZE = 1048576
 

clickhouse_driver/log.py

@@ -2,7 +2,8 @@ import logging
 
 logger = logging.getLogger(__name__)
 
-
+# Keep in sync with ClickHouse priorities
+# https://github.com/ClickHouse/ClickHouse/blob/master/src/Interpreters/InternalTextLogsQueue.cpp
 log_priorities = (
     'Unknown',
     'Fatal',
@@ -12,9 +13,12 @@ log_priorities = (
     'Notice',
     'Information',
     'Debug',
-    'Trace'
+    'Trace',
+    'Test',
 )
 
+num_priorities = len(log_priorities)
+
 
 def log_block(block):
     if block is None:
@@ -25,7 +29,7 @@ def log_block(block):
     for row in block.get_rows():
         row = dict(zip(column_names, row))
 
-        if 1 <= row['priority'] <= 8:
+        if 1 <= row['priority'] <= num_priorities:
             priority = log_priorities[row['priority']]
         else:
             priority = row[0]

clickhouse_driver/progress.py

@@ -9,6 +9,7 @@ class Progress(object):
         self.total_rows = 0
         self.written_rows = 0
         self.written_bytes = 0
+        self.elapsed_ns = 0
 
         super(Progress, self).__init__()
 
@@ -24,9 +25,14 @@ class Progress(object):
             self.written_rows = read_varint(fin)
             self.written_bytes = read_varint(fin)
 
+        if revision >= defines. \
+                DBMS_MIN_PROTOCOL_VERSION_WITH_SERVER_QUERY_TIME_IN_PROGRESS:
+            self.elapsed_ns = read_varint(fin)
+
     def increment(self, another_progress):
         self.rows += another_progress.rows
         self.bytes += another_progress.bytes
         self.total_rows += another_progress.total_rows
         self.written_rows += another_progress.written_rows
         self.written_bytes += another_progress.written_bytes
+        self.elapsed_ns += another_progress.elapsed_ns

{clickhouse_driver-0.2.6.dist-info → clickhouse_driver-0.2.7.dist-info}/METADATA

@@ -1,201 +1,201 @@
-Metadata-Version: 2.1
-Name: clickhouse-driver
-Version: 0.2.6
-Summary: Python driver with native interface for ClickHouse
-Home-page: https://github.com/mymarilyn/clickhouse-driver
-Author: Konstantin Lebedev
-Author-email: kostyan.lebedev@gmail.com
-License: MIT
-Project-URL: Documentation, https://clickhouse-driver.readthedocs.io
-Project-URL: Changes, https://github.com/mymarilyn/clickhouse-driver/blob/master/CHANGELOG.md
-Keywords: ClickHouse db database cloud analytics
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Information Technology
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: SQL
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-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 :: Implementation :: PyPy
-Classifier: Topic :: Database
-Classifier: Topic :: Software Development
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Scientific/Engineering :: Information Analysis
-Requires-Python: >=3.7, <4
-License-File: LICENSE
-Requires-Dist: pytz
-Requires-Dist: tzlocal
-Provides-Extra: lz4
-Requires-Dist: clickhouse-cityhash (>=1.0.2.1) ; extra == 'lz4'
-Requires-Dist: lz4 ; (implementation_name != "pypy") and extra == 'lz4'
-Requires-Dist: lz4 (<=3.0.1) ; (implementation_name == "pypy") and extra == 'lz4'
-Provides-Extra: numpy
-Requires-Dist: numpy (>=1.12.0) ; extra == 'numpy'
-Requires-Dist: pandas (>=0.24.0) ; extra == 'numpy'
-Provides-Extra: zstd
-Requires-Dist: zstd ; extra == 'zstd'
-Requires-Dist: clickhouse-cityhash (>=1.0.2.1) ; extra == 'zstd'
-
-ClickHouse Python Driver
-========================
-
-.. image:: https://img.shields.io/pypi/v/clickhouse-driver.svg
-    :target: https://pypi.org/project/clickhouse-driver
-
-.. image:: https://coveralls.io/repos/github/mymarilyn/clickhouse-driver/badge.svg?branch=master
-    :target: https://coveralls.io/github/mymarilyn/clickhouse-driver?branch=master
-
-.. image:: https://img.shields.io/pypi/l/clickhouse-driver.svg
-    :target: https://pypi.org/project/clickhouse-driver
-
-.. image:: https://img.shields.io/pypi/pyversions/clickhouse-driver.svg
-    :target: https://pypi.org/project/clickhouse-driver
-
-.. image:: https://img.shields.io/pypi/dm/clickhouse-driver.svg
-    :target: https://pypi.org/project/clickhouse-driver
-
-.. image:: https://github.com/mymarilyn/clickhouse-driver/actions/workflows/actions.yml/badge.svg
-   :target: https://github.com/mymarilyn/clickhouse-driver/actions/workflows/actions.yml
-
-ClickHouse Python Driver with native (TCP) interface support.
-
-Asynchronous wrapper is available here: https://github.com/mymarilyn/aioch
-
-Features
-========
-
-- External data for query processing.
-
-- Query settings.
-
-- Compression support.
-
-- TLS support.
-
-- Types support:
-
-  * Float32/64
-  * [U]Int8/16/32/64/128/256
-  * Date/Date32/DateTime('timezone')/DateTime64('timezone')
-  * String/FixedString(N)
-  * Enum8/16
-  * Array(T)
-  * Nullable(T)
-  * Bool
-  * UUID
-  * Decimal
-  * IPv4/IPv6
-  * LowCardinality(T)
-  * SimpleAggregateFunction(F, T)
-  * Tuple(T1, T2, ...)
-  * Nested
-  * Map(key, value)
-
-- Query progress information.
-
-- Block by block results streaming.
-
-- Reading query profile info.
-
-- Receiving server logs.
-
-- Multiple hosts support.
-
-- Python DB API 2.0 specification support.
-
-- Optional NumPy arrays support.
-
-Documentation
-=============
-
-Documentation is available at https://clickhouse-driver.readthedocs.io.
-
-Usage
-=====
-
-There are two ways to communicate with server:
-
-- using pure Client;
-- using DB API.
-
-Pure Client example:
-
-    .. code-block:: python
-
-        >>> from clickhouse_driver import Client
-        >>>
-        >>> client = Client('localhost')
-        >>>
-        >>> client.execute('SHOW TABLES')
-        [('test',)]
-        >>> client.execute('DROP TABLE IF EXISTS test')
-        []
-        >>> client.execute('CREATE TABLE test (x Int32) ENGINE = Memory')
-        []
-        >>> client.execute(
-        ...     'INSERT INTO test (x) VALUES',
-        ...     [{'x': 100}]
-        ... )
-        1
-        >>> client.execute('INSERT INTO test (x) VALUES', [[200]])
-        1
-        >>> client.execute(
-        ...     'INSERT INTO test (x) '
-        ...     'SELECT * FROM system.numbers LIMIT %(limit)s',
-        ...     {'limit': 3}
-        ... )
-        []
-        >>> client.execute('SELECT sum(x) FROM test')
-        [(303,)]
-
-DB API example:
-
-    .. code-block:: python
-
-        >>> from clickhouse_driver import connect
-        >>>
-        >>> conn = connect('clickhouse://localhost')
-        >>> cursor = conn.cursor()
-        >>>
-        >>> cursor.execute('SHOW TABLES')
-        >>> cursor.fetchall()
-        [('test',)]
-        >>> cursor.execute('DROP TABLE IF EXISTS test')
-        >>> cursor.fetchall()
-        []
-        >>> cursor.execute('CREATE TABLE test (x Int32) ENGINE = Memory')
-        >>> cursor.fetchall()
-        []
-        >>> cursor.executemany(
-        ...     'INSERT INTO test (x) VALUES',
-        ...     [{'x': 100}]
-        ... )
-        >>> cursor.rowcount
-        1
-        >>> cursor.executemany('INSERT INTO test (x) VALUES', [[200]])
-        >>> cursor.rowcount
-        1
-        >>> cursor.execute(
-        ...     'INSERT INTO test (x) '
-        ...     'SELECT * FROM system.numbers LIMIT %(limit)s',
-        ...     {'limit': 3}
-        ... )
-        >>> cursor.rowcount
-        0
-        >>> cursor.execute('SELECT sum(x) FROM test')
-        >>> cursor.fetchall()
-        [(303,)]
-
-License
-=======
-
-ClickHouse Python Driver is distributed under the `MIT license
-<http://www.opensource.org/licenses/mit-license.php>`_.
+Metadata-Version: 2.1
+Name: clickhouse-driver
+Version: 0.2.7
+Summary: Python driver with native interface for ClickHouse
+Home-page: https://github.com/mymarilyn/clickhouse-driver
+Author: Konstantin Lebedev
+Author-email: kostyan.lebedev@gmail.com
+License: MIT
+Project-URL: Documentation, https://clickhouse-driver.readthedocs.io
+Project-URL: Changes, https://github.com/mymarilyn/clickhouse-driver/blob/master/CHANGELOG.md
+Keywords: ClickHouse db database cloud analytics
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: SQL
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+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 :: Implementation :: PyPy
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.7, <4
+License-File: LICENSE
+Requires-Dist: pytz
+Requires-Dist: tzlocal
+Provides-Extra: lz4
+Requires-Dist: clickhouse-cityhash >=1.0.2.1 ; extra == 'lz4'
+Requires-Dist: lz4 ; (implementation_name != "pypy") and extra == 'lz4'
+Requires-Dist: lz4 <=3.0.1 ; (implementation_name == "pypy") and extra == 'lz4'
+Provides-Extra: numpy
+Requires-Dist: numpy >=1.12.0 ; extra == 'numpy'
+Requires-Dist: pandas >=0.24.0 ; extra == 'numpy'
+Provides-Extra: zstd
+Requires-Dist: zstd ; extra == 'zstd'
+Requires-Dist: clickhouse-cityhash >=1.0.2.1 ; extra == 'zstd'
+
+ClickHouse Python Driver
+========================
+
+.. image:: https://img.shields.io/pypi/v/clickhouse-driver.svg
+    :target: https://pypi.org/project/clickhouse-driver
+
+.. image:: https://coveralls.io/repos/github/mymarilyn/clickhouse-driver/badge.svg?branch=master
+    :target: https://coveralls.io/github/mymarilyn/clickhouse-driver?branch=master
+
+.. image:: https://img.shields.io/pypi/l/clickhouse-driver.svg
+    :target: https://pypi.org/project/clickhouse-driver
+
+.. image:: https://img.shields.io/pypi/pyversions/clickhouse-driver.svg
+    :target: https://pypi.org/project/clickhouse-driver
+
+.. image:: https://img.shields.io/pypi/dm/clickhouse-driver.svg
+    :target: https://pypi.org/project/clickhouse-driver
+
+.. image:: https://github.com/mymarilyn/clickhouse-driver/actions/workflows/actions.yml/badge.svg
+   :target: https://github.com/mymarilyn/clickhouse-driver/actions/workflows/actions.yml
+
+ClickHouse Python Driver with native (TCP) interface support.
+
+Asynchronous wrapper is available here: https://github.com/mymarilyn/aioch
+
+Features
+========
+
+- External data for query processing.
+
+- Query settings.
+
+- Compression support.
+
+- TLS support.
+
+- Types support:
+
+  * Float32/64
+  * [U]Int8/16/32/64/128/256
+  * Date/Date32/DateTime('timezone')/DateTime64('timezone')
+  * String/FixedString(N)
+  * Enum8/16
+  * Array(T)
+  * Nullable(T)
+  * Bool
+  * UUID
+  * Decimal
+  * IPv4/IPv6
+  * LowCardinality(T)
+  * SimpleAggregateFunction(F, T)
+  * Tuple(T1, T2, ...)
+  * Nested
+  * Map(key, value)
+
+- Query progress information.
+
+- Block by block results streaming.
+
+- Reading query profile info.
+
+- Receiving server logs.
+
+- Multiple hosts support.
+
+- Python DB API 2.0 specification support.
+
+- Optional NumPy arrays support.
+
+Documentation
+=============
+
+Documentation is available at https://clickhouse-driver.readthedocs.io.
+
+Usage
+=====
+
+There are two ways to communicate with server:
+
+- using pure Client;
+- using DB API.
+
+Pure Client example:
+
+    .. code-block:: python
+
+        >>> from clickhouse_driver import Client
+        >>>
+        >>> client = Client('localhost')
+        >>>
+        >>> client.execute('SHOW TABLES')
+        [('test',)]
+        >>> client.execute('DROP TABLE IF EXISTS test')
+        []
+        >>> client.execute('CREATE TABLE test (x Int32) ENGINE = Memory')
+        []
+        >>> client.execute(
+        ...     'INSERT INTO test (x) VALUES',
+        ...     [{'x': 100}]
+        ... )
+        1
+        >>> client.execute('INSERT INTO test (x) VALUES', [[200]])
+        1
+        >>> client.execute(
+        ...     'INSERT INTO test (x) '
+        ...     'SELECT * FROM system.numbers LIMIT %(limit)s',
+        ...     {'limit': 3}
+        ... )
+        []
+        >>> client.execute('SELECT sum(x) FROM test')
+        [(303,)]
+
+DB API example:
+
+    .. code-block:: python
+
+        >>> from clickhouse_driver import connect
+        >>>
+        >>> conn = connect('clickhouse://localhost')
+        >>> cursor = conn.cursor()
+        >>>
+        >>> cursor.execute('SHOW TABLES')
+        >>> cursor.fetchall()
+        [('test',)]
+        >>> cursor.execute('DROP TABLE IF EXISTS test')
+        >>> cursor.fetchall()
+        []
+        >>> cursor.execute('CREATE TABLE test (x Int32) ENGINE = Memory')
+        >>> cursor.fetchall()
+        []
+        >>> cursor.executemany(
+        ...     'INSERT INTO test (x) VALUES',
+        ...     [{'x': 100}]
+        ... )
+        >>> cursor.rowcount
+        1
+        >>> cursor.executemany('INSERT INTO test (x) VALUES', [[200]])
+        >>> cursor.rowcount
+        1
+        >>> cursor.execute(
+        ...     'INSERT INTO test (x) '
+        ...     'SELECT * FROM system.numbers LIMIT %(limit)s',
+        ...     {'limit': 3}
+        ... )
+        >>> cursor.rowcount
+        0
+        >>> cursor.execute('SELECT sum(x) FROM test')
+        >>> cursor.fetchall()
+        [(303,)]
+
+License
+=======
+
+ClickHouse Python Driver is distributed under the `MIT license
+<http://www.opensource.org/licenses/mit-license.php>`_.

{clickhouse_driver-0.2.6.dist-info → clickhouse_driver-0.2.7.dist-info}/RECORD

@@ -1,29 +1,29 @@
-clickhouse_driver/__init__.py,sha256=QRMXgeBnkcW_DpTqqIh29_xG072_EPoTyLy-1ik1MP0,158
+clickhouse_driver/__init__.py,sha256=Zc8GO1dmRR77BGXAzQx9tuX5pBumMtqQzQ4SH3xmBfU,158
 clickhouse_driver/block.py,sha256=t2zZhtCzwp4aJj0CuDqXlDEgHXgwc6GRsIks2aaIZvI,6311
 clickhouse_driver/blockstreamprofileinfo.py,sha256=nYx9QXWAS8aPiRbtAzwLRT5JIlJ8S103JMkudncwpFg,712
-clickhouse_driver/bufferedreader.cp311-win32.pyd,sha256=ZNn9tr_UfgmcIvMwGNwo2zLY5wMvH2wIeKqSy6pWCTM,58880
-clickhouse_driver/bufferedwriter.cp311-win32.pyd,sha256=rp0PhQSMM4uNmPmdaUqnT6OwiSWNl-LgutytZU04nrc,59392
-clickhouse_driver/client.py,sha256=c0IyAj5wxiHZgJLbFXvZm6ym5DIg1UXgPIsM2xuR3Mo,31798
+clickhouse_driver/bufferedreader.cp311-win32.pyd,sha256=0-rJtsw2Mg-y-VJLpOXI-wELbhzIXztZO4sN_5eMiAQ,82944
+clickhouse_driver/bufferedwriter.cp311-win32.pyd,sha256=Cl2UI4LTBY_r4JzCt1vRw9EKR2cuACmOcf8CB4Yf0U0,82944
+clickhouse_driver/client.py,sha256=Zk_gnfqOSz1_3uaTsBLtOHNGX0rsiklJUPpk-1aqnXQ,34707
 clickhouse_driver/clientinfo.py,sha256=Tw3NbuDHglT6_f0AcT0IdhqW_hVePtzh9pypx5nk5ZE,4260
-clickhouse_driver/connection.py,sha256=DTw_NofAVNS5spk5E0G-BkX-0H4gp3LZEJ59nmW8WZc,27679
+clickhouse_driver/connection.py,sha256=Lzx6bjPDEZleEtFaede4_BcRmALIbJyQLymSmj7zAHY,28399
 clickhouse_driver/context.py,sha256=yPkJ_BN4LGODvKCOjNlDGqABwxAMQTQl7w1vIGRPBDg,909
-clickhouse_driver/defines.py,sha256=jM3nFdT4EPUIIj1add1BOu7T9DJv_-UOzfdbX6k3uEk,1704
+clickhouse_driver/defines.py,sha256=hXIR10BvH_sxUN35pk-f-VeIbM7CA0Ll2B2yNuAy10A,1958
 clickhouse_driver/errors.py,sha256=mffBg-Y2LFOSRzvE9V34RwFcvmfh67yqLeEBhrdjeXE,14343
-clickhouse_driver/log.py,sha256=VLeOYXn5DW2hJ53m2w5bPsMrWG5cWnq5whE4e6euK_M,888
+clickhouse_driver/log.py,sha256=P9VS_YDY3a4JQsNOeUNNK0L1AAallTC1GF4FG5gCrac,1091
 clickhouse_driver/opentelemetry.py,sha256=GIzHCxdB8LB1ozXtUjIpxsdznmRABAts64G2u2l4C_A,1622
-clickhouse_driver/progress.py,sha256=aQUPzOg0S1kRthV1aYo-KsTmlcdM0uXVZDLDtoyKSUY,1045
+clickhouse_driver/progress.py,sha256=MagDPiLzWG-2Arecu5O6JlK98242ayt9yPa9H7v9o5k,1288
 clickhouse_driver/protocol.py,sha256=ZRJuawN_v8wXFrHrcpSiBqu7idKsPd3tQnCcDuTlIw8,2561
 clickhouse_driver/queryprocessingstage.py,sha256=lbV-bB5jWUp0hqYBTsUcRYkJhCgCTfN2G21AykMoAp0,186
 clickhouse_driver/reader.py,sha256=PWKOKwjszu0sJbG-dd_TyGn8tQAzxg2gCJVbz27G3-8,1322
 clickhouse_driver/readhelpers.py,sha256=tXOmSL9GSeHLdKE2yBlk0epfy-hGJ3bTOLq3Q6sXIkw,717
 clickhouse_driver/result.py,sha256=RpjBUvRQJ70xISye7u6gxgQBJwc2UkNuusLkaZF7SmM,4098
-clickhouse_driver/varint.cp311-win32.pyd,sha256=kqEDS8fKaeTatZwfniN5fOGj_4ii_LvD4vdz421Ht28,21504
+clickhouse_driver/varint.cp311-win32.pyd,sha256=KraGjAjFuAJrbpKWLAPeMnuTGpO0F6yIrUW8r1l8wps,32256
 clickhouse_driver/writer.py,sha256=yf5f1vTr56YFtL-Swpi_jBsPw5bQS56j53joB0Acdyk,1286
 clickhouse_driver/columns/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 clickhouse_driver/columns/arraycolumn.py,sha256=UiA48jw3o4-ert8BnzEbl2h1jVmtDH3jtcP1BTPru2w,5322
 clickhouse_driver/columns/base.py,sha256=jRThD8Ol7gwNy3x0M7vvslkm0RDOsCLJqKGf0arsa0w,6504
 clickhouse_driver/columns/boolcolumn.py,sha256=QgVCqbZWoFD1yvpppc92iiXIzReCVEh692efNSNH4UE,127
-clickhouse_driver/columns/datecolumn.py,sha256=Xg6qHb7Lj5twtMa0jL74qoffgYMt2gK_AY9mycRxBqQ,1931
+clickhouse_driver/columns/datecolumn.py,sha256=FzgS5ayxW6zfyM5qD1NXXiR4PTKz0tXEC48TwtQvbyI,1929
 clickhouse_driver/columns/datetimecolumn.py,sha256=pO8g1exACp6EfUO0prra5X3T_gg1MJ8bSoi5Rt2Vxjg,6691
 clickhouse_driver/columns/decimalcolumn.py,sha256=MBczjN6AtI0jgbVTNguwVE7ZdWql0XuMl-QohxV-sN0,3450
 clickhouse_driver/columns/enumcolumn.py,sha256=GCSW-fjtJC4_5YKo9oKtG8GT9UhLcRWCjrBVhEAUp-A,3219
@@ -33,7 +33,7 @@ clickhouse_driver/columns/intcolumn.py,sha256=ntpxyMiu44VQYJ0HyHlglwxMgUtnIgf3JE
 clickhouse_driver/columns/intervalcolumn.py,sha256=oQeybb4qrcp07LeVYfqgeZuHYGH5RaY7KnWVoIsDe1I,600
 clickhouse_driver/columns/ipcolumn.py,sha256=LIt-NiUy70-8u5Amu0v0tlAlrolZ8gXzlFxcJYmjRAk,4095
 clickhouse_driver/columns/jsoncolumn.py,sha256=SeCLSrmRoEg9wlvoehs7-EmrV8XkOL3lknzeOORhbJg,1175
-clickhouse_driver/columns/largeint.cp311-win32.pyd,sha256=EN5xh0RIOTBuR6qE8n-AFyfO9eT47v83Sxc7r_D4mjE,39424
+clickhouse_driver/columns/largeint.cp311-win32.pyd,sha256=PlMuWugzWGzsqY1cALUcrjp3M3WreIs4EyBY9-zry-s,52736
 clickhouse_driver/columns/lowcardinalitycolumn.py,sha256=vMlhYYUPNmFhQiUAS77pE25KjI8TrO6ySz6w0ByBdZQ,4920
 clickhouse_driver/columns/mapcolumn.py,sha256=tKr9R0JvW1_7ExKs7XfRhHI6Z6UgBW76A0jaCMM_TLk,2084
 clickhouse_driver/columns/nestedcolumn.py,sha256=7x3xNYR22kEmgV4_3rPVZea2zCTU364O1tlOewMgw3M,303
@@ -45,7 +45,7 @@ clickhouse_driver/columns/simpleaggregatefunctioncolumn.py,sha256=zDWBd_Hc7AktHF
 clickhouse_driver/columns/stringcolumn.py,sha256=C-l7HaReg9AcJGQvgpSH07aV-CZMBP1jKArPHZi8Q2k,2059
 clickhouse_driver/columns/tuplecolumn.py,sha256=DnwtEwVXzm-YyL5-cPe9MiOLOoTEcDhcYeBY6SuuZZQ,2040
 clickhouse_driver/columns/util.py,sha256=5DRGBsWSTldqZRZJ53J85zh_jepkwkAsYXhAeDJQW4I,1395
-clickhouse_driver/columns/uuidcolumn.py,sha256=d-dR_CIgtQd-CzCO90HJoeR86j7ejVchOnAKu73rVoQ,1823
+clickhouse_driver/columns/uuidcolumn.py,sha256=7CLPxsHJtV6Zt9jxILSkE0LAwffloLmrjjbwCZH34mA,1865
 clickhouse_driver/columns/numpy/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 clickhouse_driver/columns/numpy/base.py,sha256=Wk1ADpoQGWQv5X8sWi0esA2jmQGEoDakXZxImuYM2eM,1410
 clickhouse_driver/columns/numpy/boolcolumn.py,sha256=0_RwEroY2-ZqMuxKeTNG27ZCWN_y9BxYZzbuFKeqoQg,140
@@ -82,8 +82,8 @@ clickhouse_driver/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 clickhouse_driver/util/compat.py,sha256=wIB_6ULSapKx-Fi64lZ0YJ-TtWOQXePHE90wZopIM1I,876
 clickhouse_driver/util/escape.py,sha256=4RPfNzC5IvatoZB9llmJM4436XArCXQDEqT_cqdwCBk,2256
 clickhouse_driver/util/helpers.py,sha256=1oLkkkILXZnEbdjAe2Ags-Y-T-Bq9rk94W6edh-1ZLU,1448
-clickhouse_driver-0.2.6.dist-info/LICENSE,sha256=b2SjNa4zGQk6XzJwmeE1dQjjtWRvX_zxJIAl_ZbN_S8,1143
-clickhouse_driver-0.2.6.dist-info/METADATA,sha256=zbQaiQr4hkzP8Zhce0EIpgAEfKgD7YuYQvtdrerVFvk,6099
-clickhouse_driver-0.2.6.dist-info/WHEEL,sha256=ZFq5jXtyqHWnKeYLzD3mUo8rAiNhy_FNqiMNKNc1pHA,98
-clickhouse_driver-0.2.6.dist-info/top_level.txt,sha256=PrE0Lrs4d-gRQwzABaABfym9Qvr4nN6uTrDy6Q7zQME,18
-clickhouse_driver-0.2.6.dist-info/RECORD,,
+clickhouse_driver-0.2.7.dist-info/LICENSE,sha256=b2SjNa4zGQk6XzJwmeE1dQjjtWRvX_zxJIAl_ZbN_S8,1143
+clickhouse_driver-0.2.7.dist-info/METADATA,sha256=nm1U-XpLBm_B8vyg_AS7v8GFDNOkjKLo0cCR_U06VFk,6290
+clickhouse_driver-0.2.7.dist-info/WHEEL,sha256=1hQMSMLa8wpOIN866ksgBSFaZ-xM7VQgzYiKWe8vFok,98
+clickhouse_driver-0.2.7.dist-info/top_level.txt,sha256=PrE0Lrs4d-gRQwzABaABfym9Qvr4nN6uTrDy6Q7zQME,18
+clickhouse_driver-0.2.7.dist-info/RECORD,,

{clickhouse_driver-0.2.6.dist-info → clickhouse_driver-0.2.7.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.37.1)
+Generator: bdist_wheel (0.41.2)
 Root-Is-Purelib: false
 Tag: cp311-cp311-win32