Metadata-Version: 2.1
Name: ClickSQL
Version: 0.1.6
Summary: SQL programming
Home-page: http://www.github.com/sn0wfree/ClickSQL
Author: sn0wfree
Author-email: snowfreedom0815@gmail.com
License: MIT Licence
Description: # ClickSQL: ClickHouse client for Humans 
         
        
         
        Package information:
        
         
        ClickSQL is a smart client for ClickHouse database, which may help users to use ClickHouse more easier and smoother. 
        
        
        more information for ClickHouse can be found at [here](http://clickhouse.tech)
        
        
        
        ## Installation
        
        `pip install ClickSQL`
        
        ## Usage
        ### initial connection
        
        #### *Approach 1*
        ```python
        from ClickSQL import ClickHouseTableNode
        
        conn_str = "clickhouse://default:test121231@99.99.9.9:8123/system"
        ct = ClickHouseTableNode(conn_str)
        
        >>> connection test:  Ok.
        
        ``` 
        
        #### *Approach 2*
        ```python
        from ClickSQL import ClickHouseTableNode
        
        
        
        conn_str = {'name':'clickhouse','host':'99.99.9.9','port':8123,'user':'default',
                    'password':'test121231','database':'system'}
        ct = ClickHouseTableNode(**conn_str)
        
        >>> connection test:  Ok.
        
        ``` 
        ### Query
        
        ```python
        from ClickSQL import ClickHouseTableNode
        
        conn_str = "clickhouse://default:test121231@99.99.9.9:8123/system"
        ct = ClickHouseTableNode(conn_str)
        
        ct.query('show tables from system limit 1')
        
        >>> connection test:  Ok.
        >>>                             name
        >>> 0  aggregate_function_combinators
        ```
        
        ## update
        
        ```python
        from ClickSQL import BaseSingleFactorTableNode as factortable
        
        factor = factortable(
                'clickhouse://default:default@127.0.0.1:8123/sample.sample',
                cols=['cust_no', 'product_id', 'money'],
                order_by_cols=['money asc'],
                money='money >= 100000'
            )
        
        factor >> 'test.test'
            
        
        ```
        
        
        ```python
        from ClickSQL import BaseSingleFactorTableNode
        
        factor = factortable(
                'clickhouse://default:default@127.0.0.1:8123/sample.sample',
                cols=['cust_no', 'product_id', 'money'],
                order_by_cols=['money asc'],
                money='money >= 100000'
            )
        
        
        factor['money'].head(10)
        
        >>> connection test:  Ok.
        >>>        money
        >>> 0  1000000.0
        >>> 1  1000000.0
        >>> 2  1000000.0
        >>> 3  1000000.0
        >>> 4  1000000.0
        >>> 5  1000000.0
        >>> 6  1000000.0
        >>> 7  1000000.0
        >>> 8  1000000.0
        >>> 9  1000000.0
        
        
        ```
        
        ### Contribution
        there is welcome to do more work to improve this package more convenient
        
        ## Author
        sn0wfree
        
        ## functions
        1. get data from clickhouse
        2. insert data into clickhouse
        3. create 
        4. alter
        
        
        # Plan
        ## Available function 
        1. access clickhouse service
        2. execute standard SQL and transform into dataframe
        3. able to execute select query 
        4. able to execute insert query 
        5. no require clickhouse-client
        6. auto create table sql
        
        ## schedule
        
        2. create a pandas_liked executable function, which can compatible with pandas 
        3. can execute explain query
        4. can execute user role query
        5. create analysis component
        6. auto report system
        7. table register system
        8. data manager system
        8. meta data manager
        9. distributed query（query+insert）
        
        
        
        
Keywords: ClickSQL,Databases
Platform: UNKNOWN
Requires-Python: >=3.7.0
Description-Content-Type: text/markdown
