chore(docs): Fix quick start example

README.rst

@@ -43,28 +43,34 @@ Define table
     .. code-block:: python
 
         from sqlalchemy import create_engine, Column, MetaData
-
-        from clickhouse_sqlalchemy import (
-            Table, make_session, get_declarative_base, types, engines
-        )
-
+        from sqlalchemy.orm import declarative_base, sessionmaker
+
+        from clickhouse_sqlalchemy import types, engines
+
         uri = 'clickhouse+native://localhost/default'
-
+
+        # Create an engine.
         engine = create_engine(uri)
-        session = make_session(engine)
-        metadata = MetaData(bind=engine)
-
-        Base = get_declarative_base(metadata=metadata)
-
+
+        # Create a session.
+        Session = sessionmaker(bind=engine)
+        session = Session()
+
+        # Define the base class using the declarative base.
+        Base = declarative_base()
+
         class Rate(Base):
+            __tablename__ = 'rate'
             day = Column(types.Date, primary_key=True)
             value = Column(types.Int32)
-
+        
             __table_args__ = (
                 engines.Memory(),
             )
+
+        # Create the table.
+        Rate.__table__.create(bind=engine)
 
-        Rate.__table__.create()
 
 
 Insert some data

docs/features.rst

@@ -12,28 +12,26 @@ Both declarative and constructor-style tables supported:
 
     .. code-block:: python
 
-        from sqlalchemy import create_engine, Column, MetaData, literal
-
+        from sqlalchemy import create_engine, Column, MetaData
+        
         from clickhouse_sqlalchemy import (
             Table, make_session, get_declarative_base, types, engines
         )
-
-        uri = 'clickhouse://default:@localhost/test'
-
+        
+        uri = 'clickhouse+native://localhost/default'
+        
         engine = create_engine(uri)
         session = make_session(engine)
         metadata = MetaData(bind=engine)
-
+        
         Base = get_declarative_base(metadata=metadata)
-
+        
         class Rate(Base):
             day = Column(types.Date, primary_key=True)
-            value = Column(types.Int32, comment='Rate value')
-            other_value = Column(types.DateTime)
-
+            value = Column(types.Int32)
+
             __table_args__ = (
                 engines.Memory(),
-                {'comment': 'Store rates'}
             )
 
         another_table = Table('another_rate', metadata,

docs/quickstart.rst

@@ -18,27 +18,27 @@ Let's define some table, insert data into it and query inserted data.
     .. code-block:: python
 
         from sqlalchemy import create_engine, Column, MetaData
-
+        
         from clickhouse_sqlalchemy import (
             Table, make_session, get_declarative_base, types, engines
         )
-
+        
         uri = 'clickhouse+native://localhost/default'
-
+        
         engine = create_engine(uri)
         session = make_session(engine)
         metadata = MetaData(bind=engine)
-
+        
         Base = get_declarative_base(metadata=metadata)
-
+        
         class Rate(Base):
             day = Column(types.Date, primary_key=True)
             value = Column(types.Int32)
-
+        
             __table_args__ = (
                 engines.Memory(),
             )
-
+        
         # Emits CREATE TABLE statement
         Rate.__table__.create()
 
@@ -69,4 +69,4 @@ Let's query inserted data
             .scalar()
 
 Now you are ready to :ref:`configure your connection<connection>` and see more
-ClickHouse :ref:`features<features>` support.
+ClickHouse :ref:`features<features>` support.