smiklosovic commented on code in PR #1684:
URL: https://github.com/apache/cassandra/pull/1684#discussion_r942908132


##########
conf/cassandra.yaml:
##########
@@ -1757,6 +1757,23 @@ drop_compact_storage_enabled: false
 # write_consistency_levels_warned: []
 # write_consistency_levels_disallowed: []
 #
+# Guardrail to warn or fail when writing column values larger than threshold.
+# This guardrail is only applied to the values of regular columns because both 
the serialized partitions keys and the
+# values of the components of the clustering key already have a fixed, 
relatively small size limit of 65535 bytes, which
+# is probably lesser than the thresholds defined here.
+# Deleting individual elements of non-frozen sets and maps involves creating 
tombstones that contain the value of the
+# deleted element, independently on whether the element existed or not. That 
tombstone value is also guarded by this
+# guardrail, to prevent the insertion of tombstones over the threshold. The 
downside is that enabling or raising this
+# threshold can prevent users from deleting set/map elements that were written 
when the guardrail was disabled or with a
+# lower value. Deleting the entire column, row or partition is always allowed, 
since the tombstones created for those
+# operations don't contain the CQL column values.
+# This guardrail is different to max_value_size. max_value_size is checked 
when deserializing any value to detect
+# sstable corruption, whereas this guardrail is checked on the CQL layer at 
write time to reject regular user queries
+# inserting too large columns.
+# The two thresholds default to null to disable.
+# column_value_size_warn_threshold:

Review Comment:
   I had a hard time to realise what is the actual unit of size we are 
supporting here. I guess it is in bytes but it is not obvious from this 
comment. Maybe we might explicitly mention it?



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to