Skip to content

Conversation

@dkropachev
Copy link
Collaborator

Summary

  • Add documentation about ScyllaDB's built-in 1MB page size limit in docs/scylla-specific.rst
  • Add integration tests for NumpyProtocolHandler with wide tables (200+ columns)
  • Document the fetch_size=None workaround for getting larger pages

Details

ScyllaDB has a built-in 1MB page size limit that Cassandra does not have. This causes fewer rows per page than requested when working with wide tables, which is particularly noticeable when using NumpyProtocolHandler.

The workaround is to set session.default_fetch_size = None to let ScyllaDB control page sizes.

Test plan

  • New tests pass: NumpyWideTableTest::test_numpy_wide_table_paging
  • New tests pass: NumpyWideTableTest::test_numpy_wide_table_no_fetch_size
  • All existing tests in test_cython_protocol_handlers.py still pass

Fixes #65

Add documentation about ScyllaDB's built-in 1MB page size limit which
can cause fewer rows per page than requested when working with wide
tables. This is particularly relevant for NumpyProtocolHandler users.

Also add integration tests for wide tables (200+ columns) to verify
correct behavior and the fetch_size=None workaround.

Fixes #65
@dkropachev dkropachev force-pushed the issue-65-wide-table-paging-docs branch from 06eb9a4 to ef4e87d Compare January 31, 2026 01:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Got a fetch_size limitation when query very big table using NumpyProtocolHandler with Scylladb

2 participants