[Server] Introduce Default Max bucket number for a table

[MehulBatra]

Purpose

Introduce a cluster-level config, which limits the maximum number of buckets that can be created for a partitioned table to avoid creating too many buckets. Default 128000

Linked issue: close #688, #582

Brief change log

• New configuration parameter max.bucket.num with default value 128000 to limit the total number of buckets across all partitions of a table
• New exception class TooManyBucketsException extending ApiException to handle bucket limit violations
• Method getTotalBucketNumber(TablePath tablePath) in ZooKeeperClient to count buckets across partitions
• Check in TableDescriptorValidation.checkDistribution() to enforce limit while table creation
• Bucket count validation in MetadataManager.createPartition() to enforce limits
• Exception handling in AutoPartitionManager to gracefully handle bucket limit exceptions
• MetadataManager constructor to store maxBucketNum as a final field for consistent application of limits
• AutoPartitionManager.createPartitions() to catch and log TooManyBucketsException for auto-partitioning

Tests

• Added testAddTooManyBuckets() to FlussAdminITCase to verify the API behavior when bucket limits are reached for a partitioned table.
• Added testMaxBucketNum() to AutoPartitionManagerTest to verify that auto-partitioning respects bucket limits in AutoPartitionManagerTest
• Added testBucketLimitForNonPartitionedTable() to FlussAdminITCase to verify the API behavior when bucket limits are reached for a non-partitioned table

Documentation

• Added JavaDoc comments explaining the bucket limitation behavior
• Added max bucket num limit in the maintenance/configuration.md

[MehulBatra]

@wuchong, please help me review it. I have tried to do it the way we discussed in #688
Thank you!

[MehulBatra]

@wuchong addressed the comments, Please have a look whenever you get a chance.

[wuchong]

LGTM. I pushed a commit to fix the minor comments.