comments for supported codecs

1 files changed, 20 insertions, 0 deletions

diff --git a/ydb/public/api/protos/ydb_topic.proto b/ydb/public/api/protos/ydb_topic.proto
index 6af719120fe..3ebab230c35 100644
--- a/ydb/public/api/protos/ydb_topic.proto
+++ b/ydb/public/api/protos/ydb_topic.proto
@@ -598,8 +598,10 @@ message Consumer {
     // All messages with smaller server written_at timestamp will be skipped.
     google.protobuf.Timestamp read_from = 3;
     reserved 4; // supported_format
+
     // List of supported codecs by this consumer.
     // supported_codecs on topic must be contained inside this list.
+    // If empty, codec compatibility check for the consumer is disabled.
     SupportedCodecs supported_codecs = 5;
 
     // Attributes of consumer
@@ -631,8 +633,10 @@ message AlterConsumer {
     // All messages with smaller server written_at timestamp will be skipped.
     google.protobuf.Timestamp set_read_from = 3;
     reserved 4; // supported_format
+
     // List of supported codecs by this consumer.
     // supported_codecs on topic must be contained inside this list.
+    // If empty, codec compatibility check for the consumer is disabled.
     SupportedCodecs set_supported_codecs = 5;
 
     // User and server attributes of consumer. Server attributes starts from "_" and will be validated by server.
@@ -674,6 +678,7 @@ enum MeteringMode {
 // Create topic request sent from client to server.
 message CreateTopicRequest {
     Ydb.Operations.OperationParams operation_params = 1;
+
     // Topic path.
     string path = 2;
 
@@ -686,17 +691,22 @@ message CreateTopicRequest {
     // How long data in partition should be stored. Must be greater than 0 and less than limit for this database.
     // Default limit - 36 hours.
     google.protobuf.Duration retention_period = 4;
+    
     // How much data in partition should be stored. Must be greater than 0 and less than limit for this database.
     // Zero value means infinite limit.
     int64 retention_storage_mb = 5 [(Ydb.value) = ">= 0"];
 
     reserved 6; // supported_format.
+
     // List of allowed codecs for writers.
     // Writes with codec not from this list are forbidden.
+    // If empty, codec compatibility check for the topic is disabled.
     SupportedCodecs supported_codecs = 7;
+
     // Partition write speed in bytes per second. Must be less than database limit.
     // Zero value means default limit: 1 MB per second.
     int64 partition_write_speed_bytes_per_second = 8 [(Ydb.value) = ">= 0"];
+
     // Burst size for write in partition, in bytes. Must be less than database limit.
     // Zero value means default limit: 1 MB.
     int64 partition_write_burst_bytes = 9 [(Ydb.value) = ">= 0"];
@@ -750,6 +760,7 @@ message DescribeTopicResult {
 
     // Settings for partitioning
     PartitioningSettings partitioning_settings = 2;
+    
     // Partitions description.
     repeated PartitionInfo partitions = 3;
 
@@ -758,17 +769,22 @@ message DescribeTopicResult {
     //
     // How long data in partition should be stored.
     google.protobuf.Duration retention_period = 4;
+    
     // How much data in partition should be stored.
     // Zero value means infinite limit.
     int64 retention_storage_mb = 5;
 
     reserved 6; // supported_format.
+
     // List of allowed codecs for writers.
     // Writes with codec not from this list are forbidden.
+    // If empty, codec compatibility check for the topic is disabled.
     SupportedCodecs supported_codecs = 7;
+    
     // Partition write speed in bytes per second.
     // Zero value means default limit: 1 MB per second.
     int64 partition_write_speed_bytes_per_second = 8;
+
     // Burst size for write in partition, in bytes.
     // Zero value means default limit: 1 MB.
     int64 partition_write_burst_bytes = 9;
@@ -916,16 +932,20 @@ message AlterTopicRequest {
     // How long data in partition should be stored. Must be greater than 0 and less than limit for this database.
     // Default limit - 36 hours.
     google.protobuf.Duration set_retention_period = 4;
+    
     // How much data in partition should be stored. Must be greater than 0 and less than limit for this database.
     optional int64 set_retention_storage_mb = 5 [(Ydb.value) = ">= 0"];
 
     reserved 6; // supported_format.
+
     // List of allowed codecs for writers.
     // Writes with codec not from this list are forbidden.
+    // If empty, codec compatibility check for the topic is disabled.
     SupportedCodecs set_supported_codecs = 7;
 
     // Partition write speed in bytes per second. Must be less than database limit. Default limit - 1 MB/s.
     optional int64 set_partition_write_speed_bytes_per_second = 8 [(Ydb.value) = ">= 0"];
+    
     // Burst size for write in partition, in bytes. Must be less than database limit. Default limit - 1 MB.
     optional int64 set_partition_write_burst_bytes = 9 [(Ydb.value) = ">= 0"];