Skip to content

Commit d075881

Browse files
Add documentation of tablet awareness
1 parent e8815b9 commit d075881

File tree

2 files changed

+14
-0
lines changed

2 files changed

+14
-0
lines changed

Diff for: README.rst

+1
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ Features
2626
* `Concurrent execution utilities <http://python-driver.docs.scylladb.com/stable/api/cassandra/concurrent.html>`_
2727
* `Object mapper <http://python-driver.docs.scylladb.com/stable/object-mapper.html>`_
2828
* `Shard awareness <http://python-driver.docs.scylladb.com/stable/scylla-specific.html#shard-awareness>`_
29+
* `Tablet awareness <http://python-driver.docs.scylladb.com/stable/scylla-specific.html#tablet-awareness>`_
2930

3031
Installation
3132
------------

Diff for: docs/scylla-specific.rst

+13
Original file line numberDiff line numberDiff line change
@@ -109,3 +109,16 @@ New Error Types
109109
self.session.execute(prepared.bind((123, 456)))
110110
except RateLimitReached:
111111
raise
112+
113+
114+
Tablet Awareness
115+
----------------
116+
117+
**scylla-driver** is tablet aware, which mean that it is able to parse `TABLETS_ROUTING_V1` extension to ProtocolFeatures, recieve tablet information send by Scylla in `custom_payload` part of `RESULT` message, and utilize it.
118+
Thanks to that queries to tablet based tables are still shard aware.
119+
120+
Details on the scylla cql protocol extensions
121+
https://github.com/scylladb/scylladb/blob/master/docs/dev/protocol-extensions.md#negotiate-sending-tablets-info-to-the-drivers
122+
123+
Details on the sending tablet information to the drivers
124+
https://github.com/scylladb/scylladb/blob/master/docs/dev/protocol-extensions.md#sending-tablet-info-to-the-drivers

0 commit comments

Comments
 (0)